Railway

要求复制链接

拓扑复制链接

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

1. 创建项目复制链接

在 Railway Dashboard 点击 New Project → Empty project。

2. 添加 PostgreSQL复制链接

1. 项目画布右上角 Create → Database → Add PostgreSQL。
2. Postgres 服务 Settings → Source：镜像为 ghcr.io/railwayapp-templates/postgres-ssl:18。
3. 主版本低于 18 时：Database → Config → Major Version Upgrade → Upgrade to PostgreSQL 18。

3. 添加控制台服务复制链接

1. 项目画布 Create → Docker Image，Image name 填 ghcr.io/marvinli001/edgeweir:20260929-a1b2c3d（替换为目标 tag），回车。
2. 右键服务卡片 → Update Info，名称改为 edgeweir。

服务进入暂存区，在 第 7 步 部署。

4. 公开 3000 与 8443复制链接

edgeweir 服务 Settings → Networking，按顺序操作：

网络设置立即生效，不进入暂存区。服务已有 TCP 代理时不显示 Generate Domain：先删除 TCP 代理，生成域名后重新添加。每个服务只能有一个 TCP 代理；删除后重新创建得到新的域名与端口，在注册节点之前完成。

5. 生成主密钥复制链接

在本机执行：

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

输出原样使用。edgeweir-master-key 离线保存，与数据库备份分开，见 备份与恢复。

6. 设置变量复制链接

1. edgeweir 服务 Variables → Raw Editor，写入后保存：

   复制

   PORT=3000
   DATABASE_URL=${{Postgres.DATABASE_URL}}
   EDGEWEIR_PUBLIC_URL=https://${{RAILWAY_PUBLIC_DOMAIN}}
   EDGEWEIR_NODE_API_URL=https://${{RAILWAY_TCP_PROXY_DOMAIN}}:${{RAILWAY_TCP_PROXY_PORT}}
   EDGEWEIR_MASTER_KEY=<edgeweir-master-key 的内容>

2. EDGEWEIR_MASTER_KEY 行的 ⋮ 菜单 → Seal。

封存后其值不再出现在 Railway 界面、API 与 CLI 中，不可解封；Raw Editor 不再编辑该变量，修改经 ⋮ 菜单；复制环境或服务、PR 环境不带封存的变量。各变量见 变量。

7. 部署设置复制链接

1. edgeweir 服务中设置：

   设置	位置	值
   Healthcheck Path	Settings → Deploy	/healthz
   Serverless	Settings → Deploy → Enable Serverless	关闭
   Restart Policy	Settings → Deploy	Always；Free 计划与试用不提供，保持默认 On Failure
   Draining Time	Settings → Deploy，或变量 RAILWAY_DEPLOYMENT_DRAINING_SECONDS	10：旧部署收到 SIGTERM 后的退出时间，控制台最多需要 8 秒
   Regions	Settings → Scale	与 Postgres 服务相同

2. 画布顶部暂存横幅点击 Deploy，应用第 3、6、7 步的全部变更。

8. 初始化复制链接

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

1. edgeweir 服务 Deployments → 当前部署 → Deploy Logs，过滤框输入 "first-run setup"。
2. 该行 setupToken 字段为 setup token，url 字段为初始化向导地址（<EDGEWEIR_PUBLIC_URL>/setup）。
3. 打开向导，填入 setup token，见 快速上手。

命令行部署复制链接

与第 1–8 步等效。Seal 只能在网页控制台完成。

1. 创建项目、PostgreSQL 与控制台服务：

   复制

   railway init --name edgeweir
   railway add --database postgres
   railway add --service edgeweir --image ghcr.io/marvinli001/edgeweir:20260929-a1b2c3d

2. 公开 3000 与 8443：

   复制

   railway domain --service edgeweir --port 3000
   railway tcp-proxy create --service edgeweir --port 8443

3. 生成主密钥并设置变量；--skip-deploys 的命令不触发部署，最后一条触发部署：

   复制

   umask 077
   openssl rand -base64 32 > edgeweir-master-key
   railway variable set --service edgeweir --skip-deploys EDGEWEIR_MASTER_KEY --stdin < edgeweir-master-key
   railway variable set --service edgeweir PORT=3000 \
     'DATABASE_URL=${{Postgres.DATABASE_URL}}' \
     'EDGEWEIR_PUBLIC_URL=https://${{RAILWAY_PUBLIC_DOMAIN}}' \
     'EDGEWEIR_NODE_API_URL=https://${{RAILWAY_TCP_PROXY_DOMAIN}}:${{RAILWAY_TCP_PROXY_PORT}}' \
     RAILWAY_DEPLOYMENT_DRAINING_SECONDS=10

4. 第 7 步 的部署设置：

   复制

   railway environment edit \
     --service-config edgeweir deploy.healthcheckPath /healthz \
     --service-config edgeweir deploy.sleepApplication false \
     --service-config edgeweir deploy.restartPolicyType ALWAYS

   Free 计划与试用去掉 restartPolicyType 一行。区域用 railway scale 设置。在网页控制台完成 第 6 步 的 Seal。

5. 读取 setup token：

   复制

   railway logs --service edgeweir --lines 500 --json | grep setupToken

变量复制链接

ROLE、HOST、NODE_API_PORT 使用镜像默认值 all、0.0.0.0、8443。全部变量见 环境变量。

验证复制链接

openssl s_client -connect <名称>.proxy.rlwy.net:<端口> -servername <名称>.proxy.rlwy.net </dev/null 2>/dev/null \
  | openssl x509 -noout -text | grep -E 'Issuer:|Subject:|DNS:'

预期：

        Issuer: CN=Edgeweir Node Channel CA, O=Edgeweir
        Subject: CN=edgeweir-node-api, O=Edgeweir
                DNS:localhost, IP Address:127.0.0.1, IP Address:0:0:0:0:0:0:0:1, DNS:<容器主机名>, DNS:<名称>.proxy.rlwy.net

出现其他签发者表示 TLS 被中间设备终结。

自定义域名复制链接

在注册节点之前完成。

1. Web 控制台：edgeweir 服务 Settings → Networking → + Custom Domain，填 console.example.com，端口 3000；在 DNS 中添加界面给出的 CNAME 与 TXT 记录。TXT 记录缺失时该域名返回 404。

2. 节点通道：在 DNS 中将 nodes.example.com 以 CNAME 指向 <名称>.proxy.rlwy.net（不含端口）；端口仍为 Railway 分配的端口。DNS 在 Cloudflare 时关闭代理（仅 DNS）。

3. Variables 中修改：

   复制

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

4. 暂存横幅点击 Deploy。

5. 验证：以新域名执行 验证 中的 curl 与 openssl 命令。

命令行：

railway domain console.example.com --service edgeweir --port 3000
railway variable set --service edgeweir \
  EDGEWEIR_PUBLIC_URL=https://console.example.com \
  EDGEWEIR_NODE_API_URL=https://nodes.example.com:<端口>

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

升级复制链接

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

2. edgeweir 服务 Settings → Source，镜像改为新 tag。

3. 暂存横幅点击 Deploy。

4. 验证：

   复制

   curl -fsS https://<名称>.up.railway.app/healthz

   预期：version 为新 tag。

命令行（第 2–3 步）：

railway service source connect --service edgeweir --image ghcr.io/marvinli001/edgeweir:<新 tag>
railway redeploy --service edgeweir --from-source --yes

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

限制复制链接