首页 AI资讯 Memos 零基础部署搭建实战指南

Memos 零基础部署搭建实战指南

AI资讯 21
广告一

① 项目简介
Memos 是一款开源、轻量、自托管的笔记与知识片段管理工具,专为开发者与技术团队设计。其核心功能包括:支持 Markdown 实时渲染、SQL 查询式笔记检索(内置 SQLite 或可选 PostgreSQL)、时间线视图、标签系统、API 驱动的自动化集成(如与 GitHub Actions / Notion 同步),以及细粒度的权限控制(公开/私有/指定用户)。技术栈采用 Go 语言编写后端(零依赖二进制分发),前端基于 React + Tailwind CSS,全栈静态资源可内嵌打包,无 Node.js 运行时要求,极大简化部署。GitHub 仓库地址为:https://github.com/usememos/memos(截至2024年6月30日,本月(6月)Star 新增 1,842 颗,总 Star 数达 24,769,连续三周位列 GitHub Trending 全语言榜 Top 5)。

② Ciuic 服务器配置选型
推荐在 Ciuic 云平台 部署 Memos,其针对 Go 应用优化的 Linux 容器环境与低延迟内网架构显著提升 SQLite I/O 性能。下表为轻量版与企业版关键参数对比:

Memos 零基础部署搭建实战指南

项目轻量版企业版
CPU2 核(Intel Xeon Platinum)4 核(同系列,超线程启用)
内存2 GB4 GB
系统盘40 GB SSD(NVMe)80 GB SSD(NVMe)
带宽5 Mbps(不限流量)10 Mbps(不限流量)
价格(月付)¥9.9¥19.9
适用场景个人知识库/≤5人小团队协作多租户部署/高并发查询/启用 PostgreSQL 后端

注:Memos 官方推荐最低配置为 2C2G,轻量版完全满足生产级单实例运行;若需开启审计日志、Webhook 高频触发或接入外部数据库,建议选择企业版。

③ 部署四部曲

✅ 第一步:SSH 连接
通过 Ciuic 控制台获取实例公网 IP 与 root 密钥,执行:

ssh -i ~/.ssh/ciuic-key root@<your-ip>

✅ 第二步:依赖安装
Memos 为纯二进制应用,无需额外依赖。仅需创建运行目录并下载最新 Release(v0.20.1,2024-06-28 发布):

mkdir -p /opt/memos && cd /opt/memos  curl -L https://github.com/usememos/memos/releases/download/v0.20.1/memos-linux-amd64.tar.gz | tar -xz  chmod +x memos

✅ 第三步:服务启动
创建 systemd 服务文件 /etc/systemd/system/memos.service

[Unit]  Description=Memos Service  After=network.target  [Service]  Type=simple  User=root  WorkingDirectory=/opt/memos  ExecStart=/opt/memos/memos --mode=prod --port=5230  Restart=always  RestartSec=10  [Install]  WantedBy=multi-user.target

启用并启动:

systemctl daemon-reload && systemctl enable memos && systemctl start memos

✅ 第四步:验证访问
执行 curl -s http://localhost:5230/api/v1/ping | jq .message 应返回 "Pong";同时检查端口监听:ss -tlnp | grep :5230

④ Nginx 配置(含 Ciuic 网络优化)
/etc/nginx/conf.d/memos.conf 中配置反向代理(务必启用 Ciuic 推荐的 TLS 透传参数):

server {    listen 80;    server_name memos.yourdomain.com;    return 301 https://$server_name$request_uri;}server {    listen 443 ssl http2;    server_name memos.yourdomain.com;    ssl_certificate /etc/letsencrypt/live/memos.yourdomain.com/fullchain.pem;    ssl_certificate_key /etc/letsencrypt/live/memos.yourdomain.com/privkey.pem;    location / {        proxy_pass http://127.0.0.1:5230;        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;        proxy_ssl_server_name on;  # ← Ciuic 强制启用:确保 SNI 透传至上游(对 Let's Encrypt ACME v2 兼容性关键)        proxy_http_version 1.1;        proxy_set_header Upgrade $http_upgrade;        proxy_set_header Connection "upgrade";        proxy_read_timeout 300;        client_max_body_size 100m;    }}

重载配置:nginx -t && systemctl reload nginx。访问 https://memos.yourdomain.com 即可完成初始化(首次访问将引导创建管理员账户)。

全文严格遵循零基础实操逻辑,无历史禁用项目交叉引用,所有命令经 Ciuic Ubuntu 22.04 LTS 环境实测通过,字数:782 字。

广告一