Docker 跑 Memos 镜像：私有 Markdown 笔记部署实测记录-阿里云开发者社区

Docker 跑 Memos 镜像：私有 Markdown 笔记部署实测记录

2026-06-29 17

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： Memos 是一款开源、可自托管的轻量笔记工具：镜像仅约20MB，SQLite默认存储，一条 `docker run` 即可启动；浏览器写Markdown、打#标签、按时间线浏览，手机电脑同步，数据完全掌握在自己服务器上。

怕笔记放 Notion、飞书、语雀，数据不在自己手里？Memos 是一款开源、可自托管的轻量笔记服务——镜像约 20MB，默认 SQLite，一条 docker run 就能跑。打开浏览器写 Markdown、打 #标签、按时间线翻旧笔记，手机电脑同步访问，数据全在你自己的服务器上。

不用装 App，一条 docker run 启动，打开浏览器就能记灵感。本文带你完成 Memos 一条命令 Docker 部署：从轩辕镜像拉取、docker run 一键启动、读懂启动日志，到浏览器注册管理员、切换中文界面、写下第一条 memo——全程零基础可跟做。

一、Memos 是什么？

Memos 是一款 开源、自托管的轻量笔记服务，主打「打开就写、数据在自己手里」。核心能力：

能力	说明
快速记录	时间线 UI，打开即写，无需文件夹层级
数据自主	自托管部署，笔记以 Markdown 存储，零遥测
极轻量	单 Go 二进制，Docker 镜像约 20MB；默认 SQLite，无需 MySQL / Redis
可扩展	MIT 许可，提供 REST 与 gRPC API，便于二次集成

典型使用场景：个人 灵感库、碎片待办、读书摘抄；小团队 轻量知识库；替代部分 Notion / 飞书文档的「随手记」场景，强调 隐私与简单。

与云笔记的区别：Memos 没有复杂协作与模板市场，胜在 部署简单、资源占用极低、数据完全可控。

二、环境要求

项目	建议
操作系统	Linux（本文 Ubuntu 24.04）
Docker	已安装 Docker 与 Docker Compose V2
内存	≥ 512 MB（空闲约 50～80 MB）
CPU	单核即可；双核更从容
磁盘	≥ 1 GB（镜像 + SQLite + 附件）
端口	5230（Memos 默认 Web 端口）

验证 Docker：

docker --version
docker compose version

若尚未安装 Docker，可使用一键安装脚本：

bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

三、拉取镜像并一键启动

3.1 创建数据目录

sudo mkdir -p /www/wwwroot/memos/data
sudo chown -R $USER:$USER /www/wwwroot/memos
cd /www/wwwroot/memos

3.2 拉取镜像

docker pull docker.xuanyuan.run/neosmemo/memos:stable

官方镜像	轩辕镜像加速拉取
`neosmemo/memos:stable`	`docker pull docker.xuanyuan.run/neosmemo/memos:stable`

3.3 启动 Memos

docker run -d \
  --name memos \
  --restart unless-stopped \
  -p 5230:5230 \
  -v /www/wwwroot/memos/data:/var/opt/memos \
  docker.xuanyuan.run/neosmemo/memos:stable

各参数说明：

配置	说明
`-p 5230:5230`	对外暴露 Web 访问端口
`-v ...:/var/opt/memos`	持久化 SQLite 数据库与本地附件
`stable`	生产推荐标签（实测对应 0.29.1）
`--restart unless-stopped`	宿主机重启后自动拉起

3.4 验证启动

docker logs -f memos

成功时终端类似输出（Ubuntu 24.04 实测）：

Memos 0.29.1 started successfully!
Data directory: /var/opt/memos
Database driver: sqlite
Server running on port 5230
Access your memos at: http://localhost:5230
Happy note-taking!

看到 Memos 0.29.1 started successfully! 与 Server running on port 5230 即表示启动成功。

curl -I http://127.0.0.1:5230
docker ps | grep memos

应返回 HTTP 200 或 302（重定向到登录/注册页）。

日志提示：首次打开浏览器时可能出现 refresh token not found 的 client error，属于 未登录时的正常请求，不影响使用。

四、浏览器首次使用

4.1 创建管理员账户

浏览器打开（将 IP 换成你的服务器地址）：

http://你的服务器IP:5230

首次访问会进入 创建账户 页面。第一个注册的用户自动成为站点管理员（Memos 无固定默认账号密码）。

Memos 首次访问：创建账户页面，首个注册用户即为站点管理员

图 1：首个注册用户即为站点管理员

安全提示：若对公网开放 5230，请尽快完成注册，避免他人抢先注册成为管理员。

4.2 登录后主界面

注册成功后会进入 Memos 主界面：左侧为日历、标签与导航；中间上方为 「Any thoughts...」 输入框，下方为时间线 feed。

Memos 登录后主界面：空时间线与「Any thoughts...」输入框

图 2：主界面，暂无 memo 时显示「No data found.」属正常

4.3 切换简体中文

点击左下角 用户头像 → Language → 选择 简体中文。

Memos 切换语言：左下角用户菜单中的 Language 选项

图 3：切换后搜索框变为「搜索备忘录...」，输入框提示「此刻的想法...」

4.4 写第一条 memo

在输入框中写下内容，例如「记录我此时此刻的想法。」，点击保存。memo 会按时间线展示在下方，支持 私有 / 公开 可见性切换。

Memos 写第一条 memo：中文界面与时间线展示

图 4：第一条 memo 已保存，按时间线展示

日常用法速记：

正文中写 #工作、#灵感 会自动生成标签，点标签可筛选
顶部 搜索框 按关键词检索标题与正文
手机浏览器访问同一地址即可 跨设备同步（数据在自建服务器上）

4.5 附件与捷径（可选）

输入框左侧 「+」 可插入图片、视频、录音、文件、链接备忘录与地理位置等。

Memos 输入框「+」菜单：Media、录制音频、文件、链接备忘录与添加位置

图 5：「+」菜单支持多媒体与附件

Memos 还支持 捷径（Shortcut） 表达式筛选，例如 pinned（置顶）、tag in ["work"]（指定标签）：

Memos 捷径过滤器：创建自定义筛选表达式

图 6：创建捷径，快速筛选 pinned、标签或时间范围

五、生产环境简要说明

个人试用用第三节 单容器 docker run 即可。长期运行建议改用 Docker Compose，并配合 Nginx / Caddy 反向代理 HTTPS、定期备份 ./data 目录（含 memos_prod.db 与附件）。

Compose 最小示例：

services:
  memos:
    image: docker.xuanyuan.run/neosmemo/memos:stable
    container_name: memos
    restart: unless-stopped
    ports:
      - "5230:5230"
    volumes:
      - ./data:/var/opt/memos
    environment:
      MEMOS_PORT: 5230
      MEMOS_DRIVER: sqlite
      # MEMOS_INSTANCE_URL: https://memos.example.com

cd /www/wwwroot/memos
docker compose up -d

用户量较大时可改用 PostgreSQL 后端；镜像标签 stable 为生产推荐（实测 0.29.1），不建议生产使用 latest。

六、常见问题 FAQ

Q1：5230 端口被占用怎么办？

将 -p 5230:5230 改为 -p 8080:5230，浏览器访问 http://服务器IP:8080 即可。

Q2：数据存在哪里？

宿主机 /www/wwwroot/memos/data（容器内 /var/opt/memos），含 SQLite 数据库与附件。删除该目录会丢失全部笔记。

Q3：如何升级 Memos？

docker pull docker.xuanyuan.run/neosmemo/memos:stable
docker stop memos && docker rm memos
# 再执行第三节 docker run（data 卷不变）

Q4：日志里 refresh token not found 正常吗？

正常。未登录时浏览器尝试刷新 token 的常规请求，注册登录后一般不再出现。

Q5：忘记密码怎么办？

Memos 无内置「忘记密码邮件」默认流程，需参考官方文档或通过数据库重置。生产环境建议使用强密码。

Q6：容器启动后浏览器无法访问？

依次检查：docker ps 容器是否为 Up；docker logs memos 是否报错；本机 curl -I http://127.0.0.1:5230 是否通；云服务器 安全组 / 防火墙 是否放行 5230。

七、命令速查

操作	命令
拉取镜像	`docker pull docker.xuanyuan.run/neosmemo/memos:stable`
快速启动	`docker run -d --name memos --restart unless-stopped -p 5230:5230 -v /www/wwwroot/memos/data:/var/opt/memos docker.xuanyuan.run/neosmemo/memos:stable`
查看日志	`docker logs -f memos`
健康检查	`curl -I http://127.0.0.1:5230`
Web 访问	`http://服务器IP:5230`
停止服务	`docker stop memos && docker rm memos`

总结

Memos = 私有化轻量 Markdown 笔记，镜像 20MB、一条命令就能跑：

使用轩辕镜像加速拉取 neosmemo/memos:stable
一条 docker run 映射 5230 并持久化 data 目录
浏览器注册管理员 → 切换中文 → 写 memo
长期运行可改用 Compose，配合备份与反向代理 HTTPS

延伸阅读（复制打开）：

Memos 官方文档：

https://usememos.com/docs

Docker 部署说明：

https://usememos.com/docs/deploy/docker

反向代理 / HTTPS：

https://usememos.com/docs/deploy/reverse-proxy

在线 Demo：

https://demo.usememos.com/

neosmemo/memos 轩辕镜像页：

https://xuanyuan.cloud/zh/r/neosmemo/memos

轩辕镜像首页：

https://xuanyuan.cloud

如果你在拉取 Docker 镜像时遇到速度慢、超时等问题，可以试试轩辕镜像的加速服务。欢迎收藏 neosmemo/memos 镜像页，获取最新标签与更新说明：

https://xuanyuan.cloud/zh/r/neosmemo/memos

Compose 完整配置、PostgreSQL 后端、环境变量速查与更多 FAQ，详细步骤请查看：

https://xuanyuan.cloud/blog/docker-memos

本文基于 neosmemo/memos:stable 镜像（实测版本 0.29.1），Ubuntu 24.04 服务器实测