openwrtclub/memos

Memos Docker镜像文档

镜像概述

Memos是一款轻量级自托管笔记应用，旨在提供简洁高效的记录体验。该Docker镜像openwrtclub/memos:latest封装了Memos应用的完整运行环境，支持数据持久化存储，可快速部署在个人服务器或本地环境中。

核心功能与特性

• 轻量级设计：资源占用低，启动快速，适合个人服务器或小型环境部署
• 数据本地化：支持本地文件系统存储笔记数据，确保数据隐私与可控性
• 简洁界面：直观的用户界面，专注于笔记记录与管理的核心需求
• 跨平台兼容：通过Docker容器化，可在Linux、macOS、Windows等系统运行

使用场景

• 个人日常备忘录与想法记录
• 团队内部快速信息共享与协作
• 作为轻量级知识库构建工具
• 本地环境下的私人笔记管理

使用方法

前置要求

• 已安装Docker Engine (20.10.0+)
• 已安装Docker Compose (可选，用于编排部署)

快速部署 (Docker Run)

通过以下命令快速启动Memos容器：

bash
docker run -d \
  --name memos \
  -p 5230:5230 \
  -v ~/.memos/:/var/opt/memos \
  openwrtclub/memos:latest

参数说明：

• -d：后台运行容器
• --name memos：指定容器名称为memos
• -p 5230:5230：映射容器端口5230到主机端口5230
• -v ~/.memos/:/var/opt/memos：挂载主机目录~/.memos/到容器内数据目录，实现数据持久化

Docker Compose部署

创建docker-compose.yaml文件，内容如下：

yaml
version: "3.0"
services:
  memos:
    image: openwrtclub/memos:latest
    container_name: memos
    volumes:
      - ~/.memos/:/var/opt/memos  # 数据持久化目录
    ports:
      - 5230:5230  # 端口映射
    restart: unless-stopped  # 可选：容器退出时自动重启

执行以下命令启动服务：

bash
docker-compose up -d

访问应用

部署完成后，通过浏览器访问 http://<主机IP>:5230 即可使用Memos应用。首次访问会引导创建管理员账户，之后即可开始记录笔记。

数据管理

• 所有笔记数据存储在主机的~/.memos/目录下，备份该目录即可实现数据备份
• 如需迁移数据，只需将该目录复制到新环境并保持挂载配置不变

注意事项

• 确保主机端口5230未被其他服务占用，如需修改端口，可调整-p参数（如-p 8080:5230将主机8080端口映射到容器5230端口）
• 生产环境建议设置容器自动重启策略（如restart: unless-stopped）以提高服务可用性
• 定期备份~/.memos/目录，防止数据丢失