Render

要求复制链接

拓扑复制链接

Render 的每个 Web 服务只转发一个 HTTP 端口，并在负载均衡上终结 TLS。节点通道的 8443 不对外：节点用 wss://<名称>.onrender.com 注册，节点通道的 TLS 在 WebSocket 内运行，由控制台终结并要求 mTLS，见 节点通道的 WebSocket 入口。

一键创建复制链接

仓库根目录的 render.yaml 是 Blueprint：

两个资源都在 Render 默认区域 oregon，创建后不能更改区域；需要其他区域时用 手动创建。

1. 点击本页顶部的 Deploy to Render（地址 https://render.com/deploy?repo=https://github.com/marvinli001/edgeweir），登录 Render。
2. 填写 Blueprint 名称，确认将创建 edgeweir 与 edgeweir-db，点击 Deploy Blueprint。
3. 关闭自动同步：Blueprint 页 Settings，Auto Sync 设为 No。否则本仓库的 render.yaml 每次修改都会同步到这个部署，并覆盖在 Dashboard 中改过的同名设置（镜像、变量）。
4. 保存主密钥：edgeweir 服务 Environment，复制 EDGEWEIR_MASTER_KEY 的值，离线保存，与数据库备份分开，见 备份与恢复。
5. 固定版本，再 初始化。

手动创建复制链接

与 一键创建 等效，可选择区域。

1. 生成主密钥：

   复制

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

2. 数据库：Dashboard + New → Postgres。名称 edgeweir-db，PostgreSQL Version 18，选择区域与计划，点击 Create Database。

   • 数据库页右上角 Connect 菜单复制内部连接串（Internal）。
   • 新数据库默认允许任意来源地址（0.0.0.0/0）凭密码连接：数据库 Info 页 Networking 部分删除该条目，只保留私有网络，与一键创建的 ipAllowList: [] 相同。

3. 控制台：+ New → Web Service，Source Code 选 Existing Image，Image URL 填 ghcr.io/marvinli001/edgeweir:20260929-a1b2c3d（替换为目标 tag），点击 Connect。

4. Name 填 edgeweir，Region 与数据库相同，计划选 0.5c-512mb 或更高。

5. Advanced：

   • 环境变量见下方；
   • Health Check Path 填 /healthz。

   复制

   PORT=3000
   DATABASE_URL=<内部连接串>
   EDGEWEIR_MASTER_KEY=<edgeweir-master-key 的内容>
   EDGEWEIR_PUBLIC_URL=https://edgeweir.onrender.com
   EDGEWEIR_NODE_API_WEBSOCKET=true

   EDGEWEIR_PUBLIC_URL 先按服务名填写；名称已被占用时 Render 分配的子域名不同，创建后在服务页查看实际地址，在 Environment 中改正并选 Save and deploy。

6. 点击 Create Web Service。

固定版本复制链接

一键创建的镜像为 latest。确认首次部署成功后固定为当时的 tag：

1. 读取运行版本：

   复制

   curl -fsS https://<名称>.onrender.com/healthz

   version 字段为 tag，如 20260929-a1b2c3d。

2. edgeweir 服务 Settings 页 Deploy 部分，镜像地址改为 ghcr.io/marvinli001/edgeweir:<该 tag> 并保存。

初始化复制链接

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

1. edgeweir 服务 Logs，搜索 first-run setup。
2. 该行 setupToken 字段为 setup token，url 字段为初始化向导地址（<EDGEWEIR_PUBLIC_URL>/setup）。
3. 打开向导，填入 setup token，见 快速上手。

变量复制链接

ROLE、HOST、NODE_API_PORT 使用镜像默认值 all、0.0.0.0、8443；8443 只在容器内由 WebSocket 入口连接。全部变量见 环境变量。

验证复制链接

自定义域名复制链接

在注册节点之前完成；已注册的节点按注册时的地址连接，见 节点通道地址与证书。

1. edgeweir 服务 Settings → Custom Domains → + Add Custom Domain，填 console.example.com；在 DNS 中按界面添加 CNAME，点击 Verify。

2. Environment 中修改，选 Save and deploy：

   复制

   EDGEWEIR_PUBLIC_URL=https://console.example.com

   节点通道默认地址随之变为 wss://console.example.com。Blueprint 的 Auto Sync 须为 No，否则下次同步把 EDGEWEIR_PUBLIC_URL 改回 RENDER_EXTERNAL_URL。

3. 验证：以新域名执行 验证 中的命令。

已有经 wss://<名称>.onrender.com 注册的节点时，在 系统设置 的「节点通道」保存 wss://console.example.com，不改环境变量：旧名称留在节点通道证书中，onrender.com 子域名保持开启（Render Subdomain 不设为 Disabled）。

升级复制链接

1. 备份数据库：数据库页 Recovery → Create export，下载导出文件；付费计划另有时间点恢复（Point-in-Time Recovery）。见 备份与恢复。

2. edgeweir 服务 Settings 页 Deploy 部分，镜像地址改为新 tag 并保存；Deploys 页 Manual Deploy → Deploy latest reference。

3. 验证：

   复制

   curl -fsS https://<名称>.onrender.com/healthz

   预期：version 为新 tag。

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

Render CLI复制链接

限制复制链接