Memos 自托管笔记应用

Memos：安装说明

这个工具包里只有安装说明，由 Mindket 编写。Memos 本身来自制作者的 Docker 镜像、发布的二进制文件和源代码：https://github.com/usememos/memos

这些说明不是 Memos 维护者写的，也没有得到他们的认可。README 说 Memos 是“an open-source, self-hosted note-taking app that brings your everyday thoughts together in a personal timeline.”，意思是：一款开源、可自托管的笔记应用，把你日常的想法汇集在一条个人时间线上。文档在 https://usememos.com/docs

许可证：MIT。LICENSE 文件（https://github.com/usememos/memos/blob/main/LICENSE）是标准的 MIT 许可证文本，写的是“Copyright (c) 2025 Memos”。

文档说 Memos 在设计上就是自托管的：基础设施、存储和访问策略都由你控制。来源见 https://usememos.com/docs/configuration/security

会安装什么

• 一个 Memos 服务器：一个内嵌了网页前端资源的二进制文件，同时提供 API 和 MCP 端点。它以 Docker 镜像 neosmemo/memos 运行，或者用 GitHub 发布页上的二进制文件，或者用源代码构建的版本。来源见 https://usememos.com/docs/deploy
• 一个数据文件夹。Backup & Restore 页面给出的布局是一个名为 memos_prod.db 的 SQLite 数据库，加上存放上传文件的 assets/ 文件夹，在 Docker 命令里放在主机的 ~/.memos 下。Storage 页面说附件默认存在数据库里，本地文件和 S3 兼容存储是另外两个选项。来源见 https://usememos.com/docs/operations/backup-restore
• 你的编程智能体和浏览器里不会装任何东西，除非你加上可选的部分：MCP 连接（setup/claude-code.md 和 setup/other-mcp-clients.md）或者 Web Clipper 扩展（setup/web-clipper.md）。

事先需要准备

• 主要途径需要在运行 Memos 的机器上装好 Docker。来源见 https://usememos.com/docs/getting-started
• 走二进制文件的路线，则需要一台运行 Binary 页面所列平台之一的主机：Linux（amd64、arm64、armv7）、macOS（Intel 和 Apple Silicon）或 Windows（amd64）。来源见 https://usememos.com/docs/deploy/binary
• 一个浏览器。你创建的第一个账号会成为主机管理员。
• 要用 MCP 连接或 API，需要一个个人访问令牌，在应用的用户设置里创建。来源见 https://usememos.com/docs/integrations/api-access

主要安装命令

装好 Docker 之后，README 给的是下面这条命令。然后打开 http://localhost:5230，创建第一个账号。

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

来源见 https://github.com/usememos/memos/blob/main/README.md。README 说 Memos 保存的一切都在 ~/.memos 里，所以要备份的就是这一个文件夹。

各平台的说明

• setup/docker.md：完整的 Docker 路线，包括镜像标签、环境变量和外部数据库
• setup/docker-compose.md：可以提交进仓库的 Compose 文件
• setup/binary.md：发布的二进制文件，以及从源码构建
• setup/kubernetes.md：你已经在运营的集群
• setup/reverse-proxy-and-https.md：提供 HTTPS 地址
• setup/backup-and-upgrade.md：备份数据，以及升级
• setup/claude-code.md：在 Claude Code 里使用内置的 MCP 服务器
• setup/other-mcp-clients.md：其他任何 MCP 客户端
• setup/api-and-webhooks.md：个人访问令牌、API 和 webhook
• setup/web-clipper.md：把页面存成 memo 的浏览器扩展

更新或卸载

更新 Docker 路线的话，Docker 页面给了下面这几行。Upgrade 页面说要先备份，而且迁移跑过之后不支持降级。来源见 https://usememos.com/docs/deploy/docker

docker pull neosmemo/memos:stable
docker stop memos
docker rm memos
docker run -d \
  --name memos \
  --restart unless-stopped \
  -p 5230:5230 \
  -v ~/.memos:/var/opt/memos \
  neosmemo/memos:stable

README 说发布版本的标签是 YY.MM.N，候选版本是 YY.MM.N-rc.K，都没有 v 前缀。标签 stable 跟着稳定版本走，像 26.10 这样的月份标签跟着当月最新的稳定版本，canary 跟着开发构建。它还说，从早于 v0.31.0 的版本升级时，要先运行一次 v0.31.0。Upgrade 页面补充说，早于 0.22 的版本要先运行 0.25.3，再到 0.31.0，然后装 26.10，见 setup/backup-and-upgrade.md。来源见 https://github.com/usememos/memos/blob/main/README.md

这些说明所参考的页面没有给卸载步骤。手动的话，下面是 Mindket 的补充，不是制作者写的：用 docker stop memos 和 docker rm memos 停掉并删除容器。数据文件夹是分开的，所以删掉容器不会删掉你的 memo，而删掉 ~/.memos 才会。

使用数据和对外连接

这些说明所参考的页面没有提到服务器会发送使用数据。Web Clipper 页面说这个扩展没有分析、广告或使用跟踪。来源见 https://usememos.com/web-clipper

这些页面确实描述了下面这几条对外的路径。Webhook 会发往用户添加的地址，而 Memos 默认拒绝私有地址。S3 兼容的存储是附件存储的一个选项。API Reference 列出了一个 AI Service，它的 Transcribe 调用会把音频文件发给实例配置的转写服务（https://usememos.com/docs/api/latest）。Web Clipper 的引导式设置如果你选了那条路径，会用到 usememos.com 账号，而直接连接不需要。来源见 https://usememos.com/docs/integrations/webhooks ，https://usememos.com/docs/configuration/storage 和 https://usememos.com/web-clipper

来源

• README：https://github.com/usememos/memos/blob/main/README.md
• Getting Started：https://usememos.com/docs/getting-started
• Deploy：https://usememos.com/docs/deploy
• Docker：https://usememos.com/docs/deploy/docker
• Docker Compose：https://usememos.com/docs/deploy/docker-compose
• Binary：https://usememos.com/docs/deploy/binary
• Build From Source：https://usememos.com/docs/deploy/development
• Kubernetes：https://usememos.com/docs/deploy/kubernetes
• Reverse Proxy：https://usememos.com/docs/deploy/reverse-proxy
• Backup & Restore：https://usememos.com/docs/operations/backup-restore
• Upgrade：https://usememos.com/docs/operations/upgrade
• Security：https://usememos.com/docs/configuration/security
• Environment Variables：https://usememos.com/docs/configuration/environment-variables
• Storage：https://usememos.com/docs/configuration/storage
• MCP Server：https://usememos.com/docs/integrations/mcp
• API Access：https://usememos.com/docs/integrations/api-access
• Webhooks：https://usememos.com/docs/integrations/webhooks
• API Reference：https://usememos.com/docs/api/latest
• Export & Import：https://usememos.com/docs/usage/export-import
• Web Clipper：https://usememos.com/web-clipper