10分钟上手！Memos轻量级笔记系统的Docker极速部署指南

还在为复杂的笔记软件部署烦恼？本文将带你用Docker在10分钟内搭建Memos自托管笔记系统，无需专业技术背景，全程复制粘贴即可完成。读完你将获得：

• 单文件Docker Compose部署方案
• 数据持久化与备份策略
• 自定义端口与网络配置
• 基础使用与升级维护指南

项目简介

Memos是一款开源轻量级笔记服务（README.md），采用Go语言开发后端，React+TypeScript构建前端界面。其核心特点包括：

• 极简设计：专注笔记本质，无冗余功能
• 自托管部署：数据完全掌控在自己手中
• Markdown支持：丰富的格式化语法
• 多端同步：通过Web界面实现跨设备访问

部署准备

环境要求

• Docker Engine 20.10+
• Docker Compose v2+
• 至少100MB磁盘空间
• 512MB内存

文件结构

官方提供的部署配置位于项目的scripts目录下：

• Dockerfile：scripts/Dockerfile
• Docker Compose配置：scripts/compose.yaml
• 启动脚本：scripts/entrypoint.sh

极速部署步骤

1. 获取部署文件

创建项目目录并下载官方配置文件：

mkdir -p memos && cd memos
wget https://gitcode.com/GitHub_Trending/me/memos/raw/branch/master/scripts/compose.yaml

2. 配置Docker Compose

打开compose.yaml文件，核心配置如下（scripts/compose.yaml）：

services:
  memos:
    image: neosmemo/memos:latest
    container_name: memos
    volumes:
      - ~/.memos/:/var/opt/memos  # 数据持久化目录
    ports:
      - 5230:5230                 # 端口映射

自定义配置说明：

• 修改端口：将5230:5230改为自定义端口:5230
• 数据目录：替换~/.memos/为自定义路径，如/data/memos/

3. 启动服务

执行以下命令启动Memos服务：

docker compose up -d

首次启动会自动拉取最新镜像，等待约30秒后，通过浏览器访问：http://服务器IP:5230

初始化设置

创建管理员账户

首次访问会进入注册页面，创建管理员账户：

• 用户名：建议使用admin或你的常用ID
• 密码：至少8位，包含大小写字母和数字

基础配置

登录后进入设置页面（src/pages/Setting.tsx），建议完成：

1. 工作区名称：设置个性化站点名称
2. 时区设置：选择所在地区时区
3. 语言偏好：支持多语言界面（src/locales/）

数据管理

数据存储结构

Memos所有数据存储在宿主机的~/.memos/目录下（或自定义路径），结构如下：

.memos/
├── memos.db        # SQLite数据库
├── upload/         # 附件存储目录
└── config/         # 配置文件

备份策略

创建定时备份脚本：

#!/bin/bash
BACKUP_DIR="/path/to/backup"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
tar -czf $BACKUP_DIR/memos_backup_$TIMESTAMP.tar.gz ~/.memos/

高级配置

反向代理设置

如需通过域名访问，可配合Nginx使用。项目提供Nginx配置示例：scripts/nginx/conf.d/

典型配置片段：

server {
    listen 80;
    server_name memo.yourdomain.com;
    
    location / {
        proxy_pass http://localhost:5230;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

环境变量配置

通过compose.yaml可设置环境变量，支持的参数包括（scripts/Dockerfile）：

• TZ：时区设置，如Asia/Shanghai
• MEMOS_PORT：服务端口，默认5230
• MEMOS_MODE：运行模式，默认prod

维护与升级

版本升级

# 拉取最新镜像
docker compose pull
# 重启服务
docker compose up -d

日志查看

# 实时查看日志
docker logs -f memos
# 查看最近100行日志
docker logs --tail=100 memos

功能探索

Memos提供丰富的笔记功能，主要模块包括：

核心功能

• 笔记编辑：src/components/MemoEditor/
• 标签管理：src/components/TagTree.tsx
• 附件上传：src/components/MemoAttachment.tsx

高级特性

• 笔记关系图谱：src/components/MemoRelationForceGraph/
• 活动日历：src/components/ActivityCalendar/
• 多用户支持：src/pages/UserProfile.tsx

常见问题解决

服务无法启动

检查数据目录权限：

sudo chmod -R 755 ~/.memos/

忘记管理员密码

删除数据库中的admin用户后重启服务：

# 进入容器
docker exec -it memos sh
# 删除用户表
sqlite3 /var/opt/memos/memos.db "DELETE FROM user WHERE username='admin';"

总结

通过Docker部署Memos轻量级笔记系统，你获得了一个完全自托管、数据隐私可控的个人知识管理工具。官方还提供了更多高级功能，如Webhook集成（plugin/webhook/）、S3存储支持（plugin/storage/s3/）等，可根据需求进一步探索。

如有任何问题，可查阅官方文档或提交Issue：

• 官方文档：README.md
• API文档：proto/README.md
• 前端组件：web/src/components/

记得定期备份数据，并关注项目更新以获取新功能和安全补丁！