Memos 是一款开源的碎片化知识卡片管理工具,可以看作是 flomo 的私有化替代品。你可以用它快速记录每日计划、突发奇想、读书笔记等,其设计初衷之一甚至是替代微信的“文件传输助手”。它的核心是让你拥有一个完全由自己掌控的轻量级“卡片”笔记簿。
它的核心亮点在于:
- 隐私优先与数据自主:数据完全由你掌控,安全存储在本地。
- 极简高效:提供快速响应的纯文本写作体验,并深度支持 Markdown 语法。
- 轻量且强大:采用 Go + React 的前后端分离架构,确保高效运行。
- 开源可定制:代码透明,你可以自定义服务器名称、图标等。
📦 安装与部署
准备工作
确保你的系统(无论是Linux服务器,还是带有Docker Desktop的Windows/Mac电脑)已经安装了Docker。如果还没安装,可以访问 Docker 官网下载安装。
一键部署
-
创建数据目录(可选,但推荐):
为了持久化保存你的数据,防止容器删除后笔记丢失,可以先在主机上创建一个目录,比如/data/var/memos_docker/.memos/。如果目录不存在,Docker 在运行时会自动创建它。 -
执行部署命令:
复制以下命令到终端中执行。这个命令与您提供的完全一致,并附上了参数说明。docker run \ -d \ # 在后台运行容器 --restart always \ # 设置容器总是自动重启,确保服务高可用 -v /data/var/memos_docker/.memos/:/var/opt/memos \ # 将容器内的数据目录挂载到宿主机,实现数据持久化 -p 5230:5230 \ # 将容器的5230端口映射到宿主机的5230端口 --name "memos" \ # 为容器指定一个名称,便于管理 -h memos \ # 设置容器的主机名 neosmemo/memos:latest # 使用的镜像名称和标签这里也提供一个更清晰的表格说明:
参数 说明 -d后台运行容器,终端关闭后服务不受影响。 --restart always当Docker服务重启或容器意外退出时,自动重新启动容器。 -v /data/var/memos_docker/.memos/:/var/opt/memos关键! 将容器内的数据保存到主机,防止数据丢失。 -p 5230:5230端口映射,让你能通过浏览器访问Memos服务。 --name "memos"给容器起个名字,方便执行 docker start/stop memos等操作。neosmemo/memos:latest指定使用的Docker镜像。 -
验证部署:
命令执行后,在浏览器地址栏输入http://你的服务器IP:5230或http://localhost:5230(本地部署)。如果看到Memos的界面,说明部署成功!
🎯 快速上手使用
1. 初始设置
首次访问,点击"注册"创建你的第一个账户。这个账户将成为站点的管理员。
成功注册并登录后,建议先到设置里将语言切换为中文,并选择你喜欢的浅色或深色主题。
2. 记录你的第一条Memo
- 记录想法:在右侧的输入框中,直接输入文字,点击"Save"即可保存。
- 使用Markdown:Memos深度支持Markdown语法。例如,输入
# 一级标题可以创建大标题,## 二级标题创建副标题。 - 添加标签:在内容中输入
#你的标签(例如#读书笔记),就可以为内容添加标签,方便日后归类整理。
3. 进阶实用功能
- 待办事项:点击输入框下方的"复选块"图标,可以创建待办列表。比如输入"喝水500ml",保存后就会出现一个可以勾选完成的任务项。
- 上传图片与文件:Memos支持直接粘贴截图或上传图片,提交后即可保存。这个功能可以方便地在不同设备间传输文件。
- 代码片段:点击"代码块"图标,可以粘贴并高亮展示代码,方便你记录和查找有用的代码片段。
- 内容可见性:在输入框右上角,可以设置每条Memo的公开或私密状态。
- 查看历史:点击左侧的日历图标,可以看到有记录的日子会被高亮显示,方便你回顾特定日期的内容。
⚙️ 进阶配置与管理
配置反向代理(通过域名访问)
如果你不想用 IP:端口 的方式访问,可以通过Nginx配置反向代理,使用域名访问。
以下是一个基本的Nginx配置示例(假设你的域名是 memos.yourdomain.com):
server {
listen 80;
server_name memos.yourdomain.com; # 你的域名
location / {
proxy_pass http://localhost:5230; # 将请求转发给Memos服务
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
配置完成后,重载Nginx设置即可生效。为了安全,强烈建议同时配置SSL证书启用HTTPS。
🔄 维护指南
-
更新Memos:只需要拉取最新镜像并重新启动容器即可。
docker stop memos docker rm memos docker pull neosmemo/memos:latest # 再次执行最初的 `docker run...` 命令 -
数据备份:因为你已经通过
-v参数做了数据卷挂载,所以只需要定期备份主机上的/data/var/memos_docker/.memos/目录,就备份了所有的笔记数据。你可以使用简单的压缩命令进行备份。 -
问题排查:如果遇到无法访问的情况,可以首先检查容器状态:
docker ps -a | grep memos查看容器日志通常能找到问题原因:
docker logs memos
希望这份详细的教程能帮助你顺利搭建并开始使用属于你自己的Memos知识库!如果还有其他问题,随时可以再问我。