Zeabur

要求复制链接

拓扑复制链接

端口与节点通道证书的通用规则见 端口、反向代理与可信代理。

模板一键创建复制链接

仓库根目录的 zeabur.yaml 是 Zeabur 模板，已发布为 5MQJR2：

1. 生成主密钥：

   复制

   umask 077
   openssl rand -base64 32 > edgeweir-master-key

2. 点击本页顶部的 Deploy on Zeabur，在模板页点击 Deploy；按提示选择项目或在 Server 上新建项目，填写域名前缀（得到 <前缀>.zeabur.app）与主密钥（edgeweir-master-key 的内容）。

   命令行等效（首次执行 npx zeabur@latest auth login）；-f zeabur.yaml 部署本地的模板文件：

   复制

   npx zeabur@latest template deploy -c 5MQJR2

3. 固定版本，再 初始化。

模板变量会写入项目中的全部服务，EDGEWEIR_MASTER_KEY 也出现在 postgresql 服务的变量中；PostgreSQL 不读取它。

手动创建复制链接

与 模板一键创建 等效。

1. 生成主密钥（同上）。

2. Create Project，选择已有 Server、Buy New Server 或 Bind External Server，点击 Create Project。

3. 数据库：Deploy New Service → Databases → PostgreSQL。Zeabur 的 PostgreSQL 模板为 postgres:18，默认开启端口转发（5432 可从公网连接）；关闭：

   复制

   npx zeabur@latest context set project
   npx zeabur@latest context set service --name postgresql
   npx zeabur@latest service port-forward --disable

4. 控制台：Deploy New Service → Docker Image，镜像 ghcr.io/marvinli001/edgeweir:20260929-a1b2c3d（替换为目标 tag）。

   • Ports：web，3000，HTTP；node，8443，TCP。

   • Environment Variable：

     复制

     PORT=3000
     DATABASE_URL=${POSTGRES_CONNECTION_STRING}
     EDGEWEIR_MASTER_KEY=<edgeweir-master-key 的内容>
     EDGEWEIR_PUBLIC_URL=https://${ZEABUR_WEB_DOMAIN}
     EDGEWEIR_NODE_API_URL=https://${PORT_FORWARDED_HOSTNAME}:${NODE_PORT_FORWARDED_PORT}

   点击 Deploy。

5. edgeweir 服务 Domains → Generate Domain，得到 <前缀>.zeabur.app。

6. edgeweir 服务 Settings → Health Check，路径填 /healthz。

固定版本复制链接

模板部署的镜像为 latest。确认首次部署成功后固定为当时的 tag：

1. 读取运行版本：

   复制

   curl -fsS https://<前缀>.zeabur.app/healthz

   version 字段为 tag，如 20260929-a1b2c3d。

2. edgeweir 服务 Settings → Service Image，第二个输入框（tag）改为该 tag，点击 Save；服务以新镜像重启。CLI：

   复制

   npx zeabur@latest context set service --name edgeweir
   npx zeabur@latest service update tag -t <该 tag>

初始化复制链接

未初始化的控制台每次启动都在日志中输出同一个 setup token。

1. edgeweir 服务 Logs，过滤 first-run setup。服务重启或重新部署后看不到之前实例的日志，搜索最新实例即可。
2. 该行 setupToken 字段为 setup token，url 字段为初始化向导地址（<EDGEWEIR_PUBLIC_URL>/setup）。
3. 打开向导，填入 setup token，见 快速上手。

CLI：npx zeabur@latest deployment log -t=runtime --service-name edgeweir | grep setupToken。

变量复制链接

${KEY} 在服务启动时展开：先取本服务的变量，再取其他服务公开的变量，最后取 Zeabur 的特殊变量。ROLE、HOST、NODE_API_PORT 使用镜像默认值 all、0.0.0.0、8443。全部变量见 环境变量。

验证复制链接

openssl s_client -connect <主机>:<端口> </dev/null 2>/dev/null \
  | openssl x509 -noout -text | grep -E 'Issuer:|Subject:|DNS:'

预期：签发者为 CN=Edgeweir Node Channel CA, O=Edgeweir。出现其他签发者表示 TLS 被中间设备终结。

自定义域名复制链接

在注册节点之前完成。

1. Web 控制台：edgeweir 服务 Domains → Custom Domain，填 console.example.com，点击 Create Domain，按界面在 DNS 中添加记录。

2. 节点通道：在 DNS 中添加 nodes.example.com，A 记录指向端口转发的主机地址（Zeabur Server 的公网 IP），端口不变；DNS 在 Cloudflare 时关闭代理（仅 DNS）。端口转发的主机或端口变化时只需修改这条记录或节点通道地址。

3. 修改变量（服务重启）：

   复制

   EDGEWEIR_PUBLIC_URL=https://console.example.com
   EDGEWEIR_NODE_API_URL=https://nodes.example.com:<端口>

   节点通道地址也可以只在 系统设置 的「节点通道」改为 https://nodes.example.com:<端口>，不重启服务。

4. 验证：以新域名执行 验证 中的 curl 命令，以 nodes.example.com:<端口> 与 -servername nodes.example.com 执行 openssl 命令。

已注册节点更换节点通道地址见 节点通道地址与证书。

升级复制链接

1. 备份数据库，见 备份与恢复：

   • postgresql 服务 Overview → Command 执行 pg_dump -U edgeweir -d edgeweir -Fc -f /var/lib/postgresql/edgeweir.dump，在 Overview → Files 下载该文件后执行 rm /var/lib/postgresql/edgeweir.dump；
   • 或使用该服务的 Backup 页（Dev 计划及以上，备份保留 7 天）。

2. edgeweir 服务 Settings → Service Image，tag 改为新版本，点击 Save；或 npx zeabur@latest service update tag -t <新 tag>。

3. 验证：

   复制

   curl -fsS https://<前缀>.zeabur.app/healthz

   预期：version 为新 tag。

迁移、签名校验与回滚见 版本、升级与回滚。

节点通道改走 WebSocket复制链接

端口转发不可用或希望节点只连接 HTTPS 域名时，节点可以经 web 端口上的 WebSocket 入口连接：在 系统设置 的「节点通道」保存 wss://<前缀>.zeabur.app，或删除 EDGEWEIR_NODE_API_URL 并设置 EDGEWEIR_NODE_API_WEBSOCKET=true。节点需要 edgeweir-node 0.2.0 及以上，见 节点通道的 WebSocket 入口。

限制复制链接