让自建 memos 服务完美融合在 Astro 博客里面

1. 编写 Docker Compose 配置文件#

在服务器的某个目录下（例如 /opt/memos），创建一个 docker-compose.yml 文件：

1
services:
2
  memos:
3
    image: neosmemo/memos:latest
4
    container_name: memos
5
    restart: unless-stopped
6
    ports:
7
      - "5230:5230"
8
    volumes:
9
      - ./data:/var/opt/memos
10
    environment:
11
      - MEMOS_INSTANCE_URL=https://memos.example.com  # 替换为你实际绑定的域名

💡 注意事项（关于版本与环境变量）： 从 Memos 0.30.0 版本开始引入了较为严格的公开与私有模式破坏性变更。如果你的 Memos 版本号 ≥ 0.30.0，请务必在环境变量中配置 MEMOS_INSTANCE_URL，并且该地址需要与你后续在博客里配置的 apiUrl严格保持一致，否则前端跨域或 API 请求可能会遇到阻碍。

2. 启动容器#

在 docker-compose.yml 所在目录下执行：

1
docker compose up -d

1. 在 Cloudflare Zero Trust 中创建 Tunnel#

1. 登录 Cloudflare Dashboard，进入 Zero Trust 面板。
2. 导航至 Networks -> Tunnels，点击 Create a tunnel。
3. 给隧道起个名字（例如 memos-tunnel），保存后选择你的操作系统或 Docker 部署方式获取运行命令。

2. 配置 Public Hostname（公网域名）#

在 Tunnel 创建完成后，为其绑定一个专属的子域名：

• Subdomain & Domain: 填入你想要的域名，例如 memos.example.com。
• Service:
  • Type: HTTP
  • URL: localhost:5230（如果 cloudflared 与 memos 容器在同一台机器上）或容器名 memos:5230（如果在同一个 Docker 网络下）。

保存后，Cloudflare 会自动为你处理 DNS 解析和免费的 SSL/TLS 证书。此时直接访问 [https://memos.example.com](https://memos.example.com) 即可打开 Memos 初始化页面，完成管理员账号注册。

1. 开启动态页总开关#

首先，在站点配置文件（如 src/config/siteConfig.ts）中，确保开启了动态页面模块：

1
export const siteConfig = {
2
  // ... 其他配置
3
  pages: {
4
    dynamic: true, // 开启动态页
5
  },
6
};

2. 修改动态配置文件启用 Memos#

打开动态专属的配置文件 src/config/dynamicConfig.ts，将 memos 的 enable 改为 true，并正确填写你的 Memos 实例地址以及用户标识 (parent)：

1
export const dynamicConfig = {
2
  title: "",
3
  description: "",
4
  profileUrl: "/about/",
5
  showComment: true,
6
  itemsPerPage: 20,
7
  apiUrl: "/api/dynamic.json", // 当 memos.enable 为 true 时此项会被忽略
8
  memos: {
9
    enable: true,                            // 启用 Memos 数据源
10
    apiUrl: "https://memos.example.com",     // 你的 Memos 实例地址（需与 Docker 环境变量及 Tunnel 域名一致）
11
    parent: "users/your-username",           // 你的 Memos 用户标识（可在 Memos 后台或 API 路径中确认）
12
  },
13
};

配置项说明：#

• enable: 设置为 true 后，博客客户端将绕过本地静态 JSON，直接从配置的 Memos API 实时拉取数据。
• apiUrl: 你的 Memos 站点根地址。
• parent: 目标用户的 Resource Name 格式（例如 users/xiaye 或你的实际用户名）。