小岳
2026-11-17
点 赞
0
热 度
1
评 论
0

Memos:把随手记贴回自己的服务器

  1. 首页
  2. 开源分享
  3. Memos:把随手记贴回自己的服务器

文章摘要

摸鱼小助手

凌晨想查一个上周记下的配置参数,点开收藏的在线笔记,弹窗提醒会员过期,历史条目只让看标题。这一刻很多人会下决心:随手记这种东西,就该放在自己的机器上。Memos 是一个开源自托管备忘应用,一条 docker 命令就能跑起来,所有数据落在本地一个文件夹里,导出、备份、搬家都由你说了算。

项目名片

项目 内容
仓库 usememos/memos
Star / Fork 64,506 / 4,965(2026-11-17 抓取)
技术栈 Go + React,单二进制,SQLite
许可证 MIT
最新版本 26.11.1(2026-11-16 发布)
默认端口 5230
最近提交 2026-11-16,主分支 main

它解决什么问题

随手记的特点是高频、零碎、随手就来:一个报错截图、一句部署参数、一条待办。放在线服务里,要么限免额度,要么关停导出收费;放本地纯文本,又少了检索、标签和时间线。Memos 把「一条 memo」做成最小单位:短则一句话,长则带图片和代码块,按天排成时间线,井号标签把相关内容串起来。

它替掉的是托管在别人服务器上的便签应用,某些场景可替代收费云笔记——替不掉的是双向链接、多层级目录这类重度知识管理,它刻意不做这些。数据主权是它给的,深度整理还得靠别的工具。

核心机制

  1. 单二进制加 SQLite:整个服务是一个 Go 二进制,数据全在挂载目录下的 SQLite 文件和附件文件夹里,备份就是拷目录。
  2. 时间线优先:每条 memo 绑定写下的那一天,回看按天排布,不搞文件夹层级,靠标签检索。
  3. 可见性三级:单条 memo 可以设为私有、对站点内用户可见,或者生成公开链接分享。
  4. 生态接口:官方提供 API 和 MCP server,浏览器装 Web Clipper 插件能把网页剪藏成 Markdown 存进来(README「Around Memos」一节)。

(推断:单文件加单目录的设计,明显是为了把个人用户的备份和迁移成本压到最低,这是它和重型笔记应用最大的分野。)

跑起来

装好 Docker 后,一行命令启动(README Quick start 原文):

docker run -d \
  --name memos \
  -p 5230:5230 \
  -v ~/.memos:/var/opt/memos \
  neosmemo/memos:stable

注意 -v ~/.memos:/var/opt/memos 这一行必须带上,它把数据目录挂到宿主机。然后浏览器打开服务器的 5230 端口,第一件事是创建管理员账号。镜像标签有三个可选:stable 跟随每月稳定版,26.10 这样的月份标签锁定某个月,canary 是开发版(README「Upgrading」一节),日常自用选 stable 即可。想用 Docker Compose 或裸二进制部署,官方文档 usememos.com/docs/deploy 里都有现成模板。

从零到能用

  1. 在服务器上执行上面的 docker run 命令。
  2. 浏览器访问 你的服务器IP:5230,注册第一个账号(自动成为管理员)。
  3. 在输入框写下第一条 memo,试试井号标签和图片上传。
  4. 右上角设置里调整可见性默认值和语言(支持简体中文)。
  5. 浏览器装 Web Clipper 扩展,绑定站点地址,把网页一键剪藏。
  6. 在设置页生成访问令牌,之后就能用 API 批量读写你的 memo。

适合谁用 / 别用

适合:有自己服务器或 NAS、想给碎片信息找个永久存放点的人;写技术周报、攒部署笔记的学生和工程师,标签加时间线就是现成的素材库。查一条旧记录时,搜索框输入关键词或者点标签,两步就能定位到那天的原文,不用在文件夹层级里来回跳。

别用:需要多人在线协作编辑同一篇长文档的团队;想在手机上离线编辑、依赖完整 Markdown 目录树的重度笔记党——它没有官方移动客户端。

三个真实的坑

  1. 升级后数据全丢:issue #2590「Lost all memos after updating docker image」里,作者升级镜像后所有 memo 消失。根因是启动时没挂载数据卷,数据写在容器层,换镜像就清空。对策:务必带 -v 参数,并定期备份 ~/.memos 目录。
  2. 老版本升级要先中转:README「Upgrading」一节写明:从 v0.31.0 之前的版本升级,必须先跑一次 v0.31.0 完成数据库迁移,再切到新版(见 store/migration/README.md)。直接拉最新镜像启动会迁移失败。
  3. Markdown 表格不渲染:issue #1899「Markdown table not rendered」反馈,Memos 内置编辑器不是完整 Markdown 渲染器,表格等语法可能不生效。写复杂表格前先测试,别整篇粘贴长文档。

小结

回到开头那个会员过期的夜晚:如果那些随手记从一开始就落在你自己的 SQLite 文件里,到期、关停、涨价都与你无关。Memos 用一条 docker 命令换来了这份踏实,代价是没有花哨的组织方式。今晚就可以在你的服务器上贴出第一条。

参考资料

  • 仓库:https://github.com/usememos/memos
  • README(Quick start / Upgrading):https://github.com/usememos/memos#readme
  • Release 26.11.1:https://github.com/usememos/memos/releases/tag/26.11.1
  • Issue #2590:https://github.com/usememos/memos/issues/2590
  • Issue #1899:https://github.com/usememos/memos/issues/1899
  • 部署文档:https://usememos.com/docs/deploy

Memos 部署与数据流示意


本站站长,主角光环,怎么滴,你还想攻击你的站长吗,真是好big的狗胆

小岳

intp 逻辑家

站长

不具版权性
不具时效性

文章内容不具时效性。若文章内容有错误之处,请您批评指正。

目录

欢迎来到摸鱼干货栈,这里为您提供开源与摸鱼源码

43 文章数
7 分类数
0 评论数
47标签数
最近评论