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 秒 | 包含跳转与首页渲染 |
| 用户数 | 1 | user 表 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 视图也没有验证,都不作结论。








