Memos 群晖 Docker 部署文档

简介

Memos 是一款轻量开源备忘录服务，基于 SQLite 单文件数据库，无需额外数据库容器，占用资源低。支持 Markdown、标签管理、图片附件、全文检索、API，适合自建个人笔记、灵感随手记录。

特性：轻量化、数据全部本地持久化、支持多端访问、权限分级（私有/好友/公开）

一、前置准备

目录规划（群晖 File Station）

在 docker 共享文件夹下手动创建目录结构，必须预先建好 data 文件夹，防止挂载报错

docker/memos/
└── data/

data 目录：存放数据库、上传图片、附件，是核心数据目录，备份此文件夹即可完整备份所有笔记。

二、Docker Compose 配置

群晖 Container Manager → 项目 → 新增，使用自定义撰写文件

version: "3.8"
services:
memos:
image: neosmemo/memos:stable
container_name: memos
restart: always
volumes:
- ./data:/var/opt/memos
environment:
- TZ=Asia/Shanghai
ports:
- "5230:5230"

配置说明

  1. neosmemo/memos:stable：使用稳定版镜像，避免开发版BUG
  2. restart: always：开机自动重启容器
  3. TZ=Asia/Shanghai：设置时区为中国时区，保证笔记时间正确
  4. 端口：5230，容器内外端口一致，可按需修改宿主机端口

三、部署操作步骤

  1. 打开群晖 Container Manager，新建项目，项目名称填写 memos
  2. 项目路径选择 docker/memos
  3. 选择「使用 docker-compose.yml 手动编排」，粘贴上方yaml内容
  4. 点击下一步，创建并启动项目
  5. 等待镜像拉取、容器启动（约10秒）

四、访问与初始化

  1. 内网访问地址：http://内网IP:5230
  2. 首次进入页面：注册管理员账号（仅第一个注册用户为管理员）
  3. 登录后直接进入主界面，即可开始记录笔记

五、基础使用说明

  1. 输入框「此刻的想法」直接写笔记，原生支持 Markdown 语法
  2. 标签：输入 #标签名 自动创建标签，用于归类笔记
  3. 左侧日历：按日期回溯历史记录
  4. 权限下拉框：
    • 私有：仅自己可见（日常推荐）
    • 仅好友可见：指定用户查看
    • 公开：任何人可访问这条笔记
  5. 输入框左侧加号：上传图片、文件、添加待办任务清单
  6. 顶部搜索框：全文检索所有备忘录内容

六、数据备份与恢复

  • 备份：直接复制 docker/memos/data 整个文件夹到备份存储池
  • 恢复：停止容器，替换data目录文件，重启容器即可

    重要：升级容器前，建议先备份data目录，防止意外丢失笔记

七、外网 HTTPS 访问（可选扩展）

与 Vaultwarden 方案逻辑一致

  1. 配置反向代理 + SSL证书，对外域名HTTPS访问
  2. 路由器端口映射，暴露外网访问
  3. 手机端可使用 Memos 客户端，填写HTTPS域名进行同步

八、注意事项

  1. 内置 SQLite，不需要额外部署 MySQL/PostgreSQL，部署简单，资源占用极低
  2. 镜像更新：可搭配 Watchtower 自动检测更新镜像
  3. 安全建议：外网访问务必使用HTTPS，不要裸HTTP暴露公网