Docker 快速部署 Memos 私人笔记

本项目来自 Github 作者 usememos，请给开发者点个免费的 Star 支持一下。

介绍

Memos 是一款开源、轻量级的笔记服务。用它可以快速搭建一个完全属于自己的、干净无广告的私密“朋友圈”或“微博”。部署简单，资源占用极低，非常适合在已有的云服务器上作为增值应用。

• 全平台备忘录：随时打开网页记录，数据多端同步。
• 灵感收集箱：碎片化的想法先记下来，有空再整理成体系。
• 私密树洞：一个比日记更灵活、比社交媒体更私密的空间，数据完全由你掌控，安全放心。
• 好友圈子：邀请朋友一起使用，每条笔记都可以设置不同的可见权限（私密、圈内、公开），打造一个专属的小社区。

效果预览

资源占用低

部署前准备

在开始之前，请确保你已满足以下条件：

1. 一台 Linux 云服务器：并且你可以 SSH 连接 上它进入终端。（参考 云服务器重装系统、查看 IP、放行端口与 SSH 连接）
2. 防火墙端口放行：在你的云服务商后台（如阿里云、腾讯云等）的 安全组 或 防火墙 规则中，放行 5230 端口的 TCP 协议流量。

   

3. Docker 环境：服务器已安装 Docker 和 Docker Compose。（按照我的教程部署过云酒馆的机器已经安装过了）

检查 Docker 是否已安装

在 SSH 终端中执行以下命令，验证 Docker 环境是否就绪。

docker -v && docker compose version

备用 (旧版 Docker)

# 旧版 Docker 命令（若上一条命令提示 compose not found 试试这个）
# 注意：如果使用此命令成功了，后续所有 docker compose 中间都需要加短横杠 -
docker -v && docker-compose version

如果终端成功输出了 Docker 和 Docker Compose 的版本号（如下图所示，版本号数字不同没关系），则说明环境正常。如果提示 command not found，先试试上面的备用命令。

如果尚未安装 Docker 和 Docker Compose

部署流程

1. 创建项目目录

首先，创建一个专门存放 Memos 数据的文件夹，并进入该目录。

mkdir ~/memos && cd ~/memos

2. 创建 Docker Compose 配置文件

执行以下命令，一键生成 docker-compose.yml 配置文件。

cat <<EOF > docker-compose.yml
version: "3"

services:
  memos:
    image: neosmemo/memos:stable
    container_name: memos
    restart: unless-stopped
    volumes:
      - ./data:/var/opt/memos
    ports:
      - "5230:5230"
EOF

3. 启动 Memos 服务

执行启动命令。

docker compose up -d

🎉 恭喜！ Memos 已经成功在后台运行。就是这么简单！

初始化与配置

1. 访问并注册管理员

在浏览器中打开以下地址，第一个注册的用户将自动成为管理员。

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

2. 推荐设置

登录后，建议进行以下配置以获得更好的体验。

• 切换语言：

  • 点击左下角（移动端在左上角菜单内）的 Settings 进入设置。
  • 在 Preferences 标签页中，将 Language 修改为 简体中文。
  • 每位用户都需要自己设置这个。

• 系统设置：

  • 导航至 设置 -> 系统。
  • 网站信息：点击 服务器名称 后面的 编辑，可以自定义网站名称、图标、描述、语言等。
  • 禁用用户注册：邀请朋友们都注册完毕后，建议开启此项，防止陌生人注册。（开启后管理员仍可帮忙注册账号）
  • 周开始日：可以设置为 周一，更符合国内用户习惯。
  • 别忘了点击 保存！

• 启用评论：

  • 导航至 设置 -> 备忘录。
  • 开启 启用备忘录评论 功能，方便与朋友互动。

3. 使用技巧

• 权限控制：发布时可选择三种可见性。
  • 私有：仅自己可见。
  • 工作区：所有登录用户可见（相当于朋友圈）。
  • 公开：互联网上任何打开此网站的人都能看到。
• 标签分类：
  • 使用 #标签 来为你的笔记分类。
  • Memos 支持二级标签，例如 #games/剑网3、#games/黎明杀机，#生活/旅行 和 #生活/美食，便于精细化管理。

    

更多有趣的功能，就留给你自己探索啦！

日常运维与数据管理

服务管理

所有管理命令都需要在项目目录（~/memos）下执行。

• 重启 Memos

cd ~/memos && docker compose restart

• 更新 Memos 版本（拉取最新镜像并重启）

cd ~/memos && docker compose pull && docker compose up -d

• 停止 Memos

cd ~/memos && docker compose down

数据备份与迁移

迁移到新服务器：

1. 在旧服务器上，将整个 memos 文件夹打包。
2. 将打包好的文件下载并上传到新服务器的任意位置（推荐用户主目录）。
3. 在新服务器上解压文件。
4. cd 进入解压后的 memos 目录。
5. 执行 docker compose up -d 启动服务。
6. 最后，不要忘记在新服务器的防火墙/安全组中放行 5230 端口。