可本地部署的开源笔记应用 Memos 部署和使用指南

Memos 是一个开源轻量化的笔记应用，能在本地部署，支持超 Markdown 格式，有强大的自定义功能。

• 数据完全自主可控：所有应用数据都存储在你选择数据库中，可以是本地，也可以是你购买的云服务器上

• 自托管架构：你自己选择的基础设施和设置的访问策略

• 无第三方依赖：运行不需要外部服务和云连接

• 纯文本输入：简化文本输入，支持实时保存

• Markdown：支持完整的 Markdown 渲染和语法高亮

• 富媒体格式：支持图片、链接和嵌入式的内容

• 后端性能：基于 Go 语言开发

• 前端技术：React.js 构建响应式用户界面

• 轻量部署：系统资源需求低，支持 Linux、macOS、Windows 和容器部署

• 界面可配置：支持自定义服务器、主题和页面

• API 优先：提供 RESTful API 和完整文档，方便第三方集成

• 数据库支持：支持 SQLite、PostgreSQL、MySQL 等数据库

• 零授权费用：没有订阅费，没有使用限制

Memos安装使用

前置条件

• 已安装 Docker 或 Docker Compose

• 最低 512MB 内存和 1GB 可用磁盘空间

Docker 部署

# 创建数据目录
mkdir -p ~/.memos

# 运行 Memos 容器
docker run -d \
  --name memos \
  --restart unless-stopped \
  -p 5230:5230 \
  -v ~/.memos:/var/opt/memos \
  neosmemo/memos:stable

访问 http://localhost:5230 完成初始化设置。

Docker Compose 部署

# docker-compose.yml
version: "3.8"

services:
  memos:
    image: neosmemo/memos:stable
    container_name: memos
    restart: unless-stopped
    ports:
      - "5230:5230"
    volumes:
      - ./data:/var/opt/memos
    environment:
      - MEMOS_MODE=prod
      - MEMOS_PORT=5230

执行 docker-compose up -d 启动服务。

注意：数据目录（~/.memos 或 ./data）存储所有应用数据，需要设置备份策略，Windows 用户请参考相关文档。

安装方式

容器部署

• Docker Hub：官方镜像 neosmemo/memos

• GitHub 容器仓库：同版本镜像

• Kubernetes：提供 Helm 图表与 YAML 清单

二进制安装

• 预编译二进制文件：支持 Linux、macOS、Windows，可在 Releases 页面获取

源码安装

• Go 构建：使用 Go 1.24 或更高版本编译源码

• 开发模式：支持本地开发和热重载

开发环境搭建

前置工具

• Go 1.24 或更高版本

• Node.js 22+ 与 pnpm

• Git 版本控制工具

后端开发

# 克隆仓库
git clone https://github.com/usememos/memos.git
cd memos

# 安装依赖
go mod download

# 运行开发服务器
go run ./bin/memos/main.go --mode dev --port 8081

前端开发

# 进入前端目录
cd web

# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev

开发服务地址：

• 后端 API：http://localhost:8081

• 前端界面：http://localhost:3001