railway-domain

Railway 域名管理

为 Railway 服务添加、查看或移除域名。

适用场景

• 用户要求“添加域名”“生成域名”或“获取 URL”
• 用户想添加自定义域名
• 用户询问“我的服务 URL 是什么”
• 用户想移除域名

添加 Railway 域名

生成 Railway 提供的域名（每个服务最多 1 个）：

railway domain --json

为指定服务生成：

railway domain --json --service backend

响应

返回生成的域名 URL。服务必须已有部署。

添加自定义域名

railway domain example.com --json

响应

返回所需的 DNS 记录：

{
  "domain": "example.com",
  "dnsRecords": [
    { "type": "CNAME", "host": "@", "value": "..." }
  ]
}

告知用户将这些记录添加到其 DNS 提供商。

查看当前域名

使用 railway-environment 技能查看已配置的域名，或直接查询：

query domains($envId: String!) {
  environment(id: $envId) {
    config(decryptVariables: false)
  }
}

域名位于 config.services.<serviceId>.networking 中：

• serviceDomains - Railway 提供的域名
• customDomains - 用户提供的域名

移除域名

使用 railway-environment 技能移除域名：

移除自定义域名

{
  "services": {
    "<serviceId>": {
      "networking": {
        "customDomains": { "<domainId>": null }
      }
    }
  }
}

移除 Railway 域名

{
  "services": {
    "<serviceId>": {
      "networking": {
        "serviceDomains": { "<domainId>": null }
      }
    }
  }
}

然后使用 railway-environment 技能应用并提交更改。

CLI 选项

标志	描述
[DOMAIN]	要添加的自定义域名（省略则添加 Railway 域名）
-p, --port <PORT>	要连接的端口
-s, --service <NAME>	目标服务（默认为已关联的服务）
--json	JSON 输出

组合使用

• 读取域名：使用 railway-environment 技能
• 移除域名：使用 railway-environment 技能
• 应用移除操作：使用 railway-environment 技能
• 检查服务：使用 railway-service 技能

错误处理

未关联服务

No service linked. Use --service flag or run `railway service` to select one.

域名已存在

Service already has a railway-provided domain. Maximum 1 per service.

无部署

Service has no deployment. Deploy first with `railway up`.

域名无效

Invalid domain format. Use a valid domain like "example.com" or "api.example.com".