Memos：轻量级自托管笔记部署与使用指南

📋 官方信息

项目名称	Memos
仓库地址	https://github.com/usememos/memos
官方网站	https://usememos.com
最新更新	2026年10月
项目定位	开源轻量级自托管笔记，像发朋友圈一样记录想法

🎯 项目背景

Memos 是一个极简主义的自托管笔记应用，设计理念是"像发社交媒体一样记笔记"。它借鉴了 Twitter/微博的时间线交互模式，但所有数据完全由你自己掌控。与 Notion、Obsidian 等重型笔记工具不同，Memos 刻意保持轻量——启动快、界面简洁、没有复杂的数据库结构，专注于快速捕捉和记录碎片化想法。

项目由 JustS偶（Bo Chen）创建，用 Go 语言编写，前端使用 React。整个应用编译后只有几十 MB，一个 SQLite 数据库文件就存下所有笔记。自 2022 年开源以来，Memos 在 GitHub 上获得了超过 3 万 Star，成为自托管笔记领域最受欢迎的项目之一。它特别适合开发者、程序员用来记录技术灵感、读书笔记和日常碎碎念。

✨ 核心特性

极简界面：时间线式布局，打开即写，无学习成本
Markdown 支持：完整 Markdown 渲染，支持代码块、表格、图片
标签系统：#标签自动识别，快速分类和筛选笔记
隐私可控：每条笔记可设为公开/私有/仅自己可见
轻量高效：Go 编写，单二进制文件，内存占用不到 50MB
多用户：支持多用户注册和使用
REST API：提供完整 API，可接入其他应用
数据导出：支持导出 Markdown 备份

💻 环境要求

Docker 部署：Docker 20.10+，内存 256MB 以上即可
二进制部署：Linux/macOS/Windows，无需任何依赖
磁盘空间：应用本身不到 100MB，数据按需增长
浏览器：现代浏览器均可

🚀 详细部署步骤

方式一：Docker 一键部署（推荐）

docker run -d \
  --name memos \
  --restart unless-stopped \
  -p 5230:5230 \
  -v ~/.memos:/var/opt/memos \
  neosmemo/memos:stable

参数说明：

-d：后台运行
--name memos：容器命名
--restart unless-stopped：开机自动启动
-p 5230:5230：映射端口，5230 是 Memos 默认端口
-v ~/.memos:/var/opt/memos：数据持久化到宿主机

方式二：Docker Compose 部署

创建 docker-compose.yml：

services:
  memos:
    image: neosmemo/memos:stable
    container_name: memos
    restart: unless-stopped
    ports:
      - "5230:5230"
    volumes:
      - ./data:/var/opt/memos
    environment:
      - MEMOS_PORT=5230
      - MEMOS_DRIVER=sqlite
      - MEMOS_INSTANCE_URL=https://memos.yourdomain.com

启动：

docker compose up -d

方式三：二进制部署

# 1. 下载最新版本（以 Linux amd64 为例）
wget https://github.com/usememos/memos/releases/latest/download/memos-linux-amd64

# 2. 赋予执行权限
chmod +x memos-linux-amd64

# 3. 启动
./memos-linux-amd64 --host 0.0.0.0 --port 5230

# 4. 可选：注册为系统服务
sudo cp memos-linux-amd64 /usr/local/bin/memos

🔧 常用命令行参数

memos --port 5230 \
  --host 0.0.0.0 \
  --data /path/to/data \
  --mode prod

--host：监听地址，默认 127.0.0.1，对外服务需设为 0.0.0.0
--port：监听端口，默认 5230
--data：数据存储目录
--mode：运行模式（dev/prod）

✅ 启动验证

访问 http://服务器IP:5230
首次访问需要注册管理员账号
在输入框写一条测试笔记，添加 #测试标签
确认笔记出现在时间线上

📖 使用方法

写笔记

在顶部输入框直接输入文字，支持 Markdown。输入 # 会自动弹出标签建议。写完按 Ctrl+Enter 发布。

图片上传

输入框工具栏有图片上传按钮，支持拖拽粘贴图片。图片存储在数据目录中。

笔记可见性

每条笔记右下角可以设置可见范围：公开（所有人可见）、保护登录用户可见、私有（仅自己可见）。

公开主页

在设置 → 我的主页中开启后，你的公开笔记会生成一个类似 Twitter 的个人时间线页面，可以分享给别人。

❓ 常见问题

Q1: 数据备份怎么做？
A: 备份 ~/.memos 目录（或 Docker 挂载的数据目录）即可。里面包含 SQLite 数据库和上传的图片。

Q2: 支持 PostgreSQL 吗？
A: 最新版本支持 PostgreSQL 和 MySQL，通过 MEMOS_DRIVER 环境变量切换。默认使用 SQLite，个人用户足够。

Q3: 如何配置 HTTPS 和域名？
A: 使用 Nginx 反向代理到 5230 端口，配合 Let's Encrypt 证书。设置 MEMOS_INSTANCE_URL 环境变量为你的域名。

Q4: 手机有客户端吗？
A: Memos 是 PWA 应用，可以在手机浏览器中"添加到主屏幕"当 App 用。也有第三方开发的 iOS/Android 客户端。

Q5: 支持多少用户？
A: 没有硬性限制。SQLite 适合中小规模（几十用户），大规模用户建议切换到 PostgreSQL。

🔗 跳转链接

GitHub 仓库：https://github.com/usememos/memos
官方网站：https://usememos.com
官方文档：https://usememos.com/docs
在线演示：https://demo.usememos.com