跳到主内容

memos 部署搭建教程:从一条 docker 命令到数据落盘备份,中间要过几道坎

memos 是什么,适合谁

64,039 个 star、单个 Go 二进制、一张不到 20MB 的 Docker 镜像——这是我 10 月 25 日通过 GitHub API 在 usememos/memos 仓库实测到的三个数字。memos 是一个开源自部署的轻量笔记应用,官方描述是"把你的日常想法收进一条个人时间线",数据完全存在自己服务器上,MIT 许可证,零遥测。

它解决的问题很具体:碎片记录。随手一条想法、一个链接、一段代码,打开就能写,不用纠结放进哪个文件夹——整个产品就是一条时间线加标签检索。反向说清楚它不适合什么:长文档、复杂排版、表格协作,都不是它的主场,那些需求该去找 Notion 或者知识库类工具。仓库 pushed 时间是 2026-10-24,最新 release v0.31.0 发布于 2026-09-19,项目维护活跃,这点对自部署工具很关键——死了的项目你部署得再顺也白搭。

环境与依赖

部署前先核对环境,路线不同要求不同。Docker 路线最省事:能跑 Docker 的机器就行,官方镜像叫 neosmemo/memos,stable 标签。二进制路线:官方给了安装脚本 install.sh,自动识别 Linux/macOS 和 amd64/arm64/armv7 架构,装到 /usr/local/bin,不依赖任何运行时。数据库默认 SQLite,零配置;要多人共用再换 MySQL 或 PostgreSQL。

有一个前置声明要做:本机没有 Docker 环境,这篇的容器部署部分是我拿官方仓库 v0.31.0 的 scripts/compose.yaml 和文档逐项静态核对的结果,没有实跑容器。所有命令以官方仓库为准。

顺带说个二手资料的坑:某聚合下载站页面写的还是 v0.28.0 安装包,而 GitHub 实测最新版已经是 v0.31.0——这类站点版本滞后很常见,版本号永远以 Release 页为准。

跑通步骤:Docker Compose 路线

官方 compose 模板只有 153 个字节、一个服务,我把它原文抄下来:

services:
  memos:
    image: neosmemo/memos:stable
    container_name: memos
    volumes:
      - ~/.memos/:/var/opt/memos
    ports:
      - 5230:5230

三个关键点:端口 5230 是 Web 界面;数据卷把宿主机 ~/.memos 挂到容器内 /var/opt/memos,备份就是备份这个目录;镜像 tag 用 stable 不用 latest,升级行为更可控。保存后 docker compose up -d,浏览器开 http://localhost:5230,第一个注册的用户自动成为管理员。

如果不想用 compose,官方同款的一条命令是 docker run -d --name memos --restart unless-stopped -p 5230:5230 -v ~/.memos:/var/opt/memos neosmemo/memos:stable。不过参数散在命令行历史里,重建容器时漏一个挂载参数,数据就"丢"了(其实还在宿主机,只是容器读不到)。我的建议明确一点:哪怕只有一台机器,也用 compose 把参数写进文件。

还有一个安全细节值得抄:把端口映射写成 -p 127.0.0.1:5230:5230,服务就只监听本机,公网访问交给前面的反向代理处理。裸奔在公网上的 5230 端口,等于把笔记挂给全网看。

跑通步骤:不用 Docker 的二进制路线

服务器上装不了 Docker 的话,官方脚本一条命令搞定:curl -fsSL scripts/install.sh | sh(仓库内路径,实际用时要带上完整的仓库地址),然后 memos --data /memos-data 启动,数据落在你指定的目录。默认 SQLite,起服务即用,这点和站内那篇SQLite 做本地数据仓库的实测是同一个逻辑:单机单人场景,SQLite 就是终点,不用为了"显得专业"上 MySQL。

开机自启和进程守护是二进制路线必须自己补的课:写个 systemd unit 或至少 nohup 加定时检查。站内开源论坛本地部署里那份"部署成服务的检查表"在这里同样适用——进程怎么守护、日志往哪落、备份多久一次,三问都能答再算上线。

常见报错与排查

第一类:页面打不开。先 docker logs memos 看启动日志,再确认 5230 有没有被别的进程占用,最后检查防火墙。排查顺序从外到内,别一上来就怀疑镜像。

第二类:重启后笔记消失。这是数据卷没挂对,容器内数据随容器删除一起没了。验证方法很简单:写一条笔记,docker restart memos,刷新页面笔记还在才算挂载正确。第一次部署就做这个测试,别等记了一个月才发现。

第三类:容器内写入报错。多半是宿主机数据目录权限问题,当前用户对 ~/.memos 没有写权限,容器照样写不进去。开源 Bang 那篇教程把这类归成"权限不足表现为启动即退出或写入报错",遇到先看日志再对清单。

适用边界

把话说透:memos 的定位是"快 capture",不是"全 knowledge"。它没有富文本编辑器、没有表格、没有双链,刻意保持极简——你要是冲着 Obsidian 那种插件生态来的,会失望,站内Obsidian 插件体系那篇对应的才是那种重度玩法。两者不冲突:一个管碎片输入,一个管长期沉淀,很多人是两个一起用。

备份责任完全在你自己:官方没有云备份,定期拷贝 ~/.memos 目录(或写个 cron)是使用成本的一部分。多人团队共用时建议直接上 PostgreSQL,别拿 SQLite 硬扛并发写。

最后给仓库地址:github.com/usememos/memos,部署文档和 compose 模板都在仓库里,版本号以 Releases 页为准。

常见问题

5000 字的长文档放 memos 合适吗?不合适。它的时间线交互是为短内容设计的,长文档用 Markdown 文件或专门的知识库工具,memos 里放个链接就行。

换服务器怎么迁移?停服务,把数据目录整个拷过去,新机器起服务指向同一个目录。SQLite 就是单文件,迁移动作很小。

手机上怎么用?浏览器访问自部署地址就能用,社区有第三方客户端,但官方主推的还是 Web 界面,选第三方客户端时留意它连的是不是你自己的实例。

会不会哪天项目就停更了?有可能,这是所有自部署工具的共同风险。但数据在你手里(Markdown 兼容存储),最坏情况是停止更新而不是数据被锁死。

相关阅读

分享到:

本文链接:https://www.biyeyuanma.cn/post/368.html

服务热线

加我微信

加我微信