memos 是一个用 Go 写的自托管笔记服务,官方只发一个 exe。它不走桌面应用那套,双击之后浏览器打开一个地址就能用。这篇在 Windows 上把它从空目录跑到有三条笔记,记下每一步的耗时和落盘结果。

一个 exe 68 MB,双击就是一个站点

release 里的 Windows 包是个 zip,解开只有一个可执行文件,没有安装程序,也没有运行时依赖。

memos_0.31.0_windows_amd64.zip   22,181,849 字节
解压后                            memos.exe  68,137,472 字节
启动命令                          memos.exe --port 5231 --data D:\wb_cache\lab\memos\data
从执行到 HTTP 200                 1.1 秒

默认端口是 8081,实测时用 --port 换到 5231 避免和别的东西撞车。--data 指定数据目录,建库、建账号、写笔记全落在这个目录里,卸载就是删目录。

首次运行只问一个账号

第一次打开会跳到 /auth/signup,页面标题是「初始化实例」,只要求填用户名和密码,下方一行小字说明这个账号拥有实例设置、成员与身份提供商的管理权限。填完点「创建管理员账号」直接进主页,不用邮箱验证,也不发确认信。

项实测结果说明
初始化页/auth/signup标题「初始化实例」,只需用户名与密码
建号耗时约 3 秒包含跳转与首页渲染
用户数1user 表 1 行
默认语言简体中文跟随浏览器,可切 System

写的是 Markdown 源码,保存后渲染

输入框里放的是纯文本,#、**、反引号都原样显示。点 Save 之后卡片上才变成标题、粗体和带底色的行内代码,标签也会从正文里被抽出来变成小胶囊。

写进去的显示出来的
# 实测记录一级标题
**Windows**加粗
--data行内代码,带浅色底
#实测库 #工具两个标签胶囊

编辑区没有工具栏,也没有所见即所得,写 Markdown 的人不需要学新东西,不写 Markdown 的人得先记住这几个符号。

标签不用先建,写完自动统计

正文里敲 #实测库 就算打了标签,侧栏立刻多一行。三条笔记写完,侧栏的统计是这样:

实测库   2
备份     1
工具     1
memo 表  3 行
memo_relation 表  0 行

标签是实时算出来的,不用去某个设置页维护标签库。#备份 和 #工具 各出现一次,侧栏就各显示 1,匹配按出现次数算,不按笔记条数算。

数据全在一个 SQLite 文件里

跑完三条笔记,数据目录只有三个文件,主库还很小,绝大部分内容在 WAL 里等着合并。

memos_prod.db        4,096 字节
memos_prod.db-wal  259,592 字节
memos_prod.db-shm   32,768 字节
表数量                   14
memo 3 / user 1 / memo_relation 0

备份就是拷这三个文件,迁移就是整个目录搬走。代价是并发写只有单机水平,多用户同时写会排队;个人或小团队够用,公开服务要自己评估。

什么情况下起不来

故意用同一个端口起第二个实例,它先把数据库建好,再去抢端口,抢不到才退出。也就是说失败一次也会留下一个空的数据目录,重试前要自己清理。

第二个实例(同端口 5231)
  建库      database initialized successfully  schemaVersion=0.31.8
  启动失败  failed to listen: listen tcp :5231: bind: Only one usage of
            each socket address (protocol/network address/port) is normally permitted
  退出码    1
边界实测结果要注意什么
端口被占用报 bind 错误,退出码 1数据目录已生成,需要手动删
数据目录不存在自动创建不用提前建目录
数据库SQLite 单文件加 WAL并发写排队,多用户同时写会等
默认端口8081和别的服务冲突时用 --port 换

另外注意 schemaVersion 记的是 0.31.8,程序版本是 0.31.0,两者不是同一个号,排查升级问题时以数据库里这个版本为准。

适合谁用

版本 v0.31.0 发布于 2026-09-19,仓库 63,965 星,MIT 许可,语言是 Go。它把「装」这件事压到最低,剩下的取舍都在功能边界上。

场景结论理由
个人随手记合适一个 exe 起服务,手机浏览器也能开
要数据自主合适全部数据在本地 SQLite,可整目录搬走
多人协作写作不合适没有协同编辑,只有各自的时间线
要富文本排版不合适编辑区只有 Markdown 源码
要公网暴露先做功课默认没配 HTTPS 与反向代理

实测范围:Windows 10 22H2(10.0.19045.6466)、memos v0.31.0、Chrome 打开 1280×860 视口。多用户注册与附件上传没有验证,API、Docker 部署、Map 视图也没有验证,都不作结论。