railway-domain

# Railway 域名管理 为 Railway 服务添加、查看或移除域名。 ## 何时使用 - 用户要求“添加域名”、“生成域名”、“获取 URL” - 用户想要添加自定义域名 - 用户询问“我的服务 URL 是什么” - 用户想要移除域名 ## 添加 Railway 域名 生成一个 Railway 提供的域名（每个服务最多 1 个）： bash railway domain --json 针对特定服务： bash railway domain --json --service backend ### 响应 返回生成的域名 URL。服务必须已部署。 ## 添加自定义域名 bash railway domain example.com --json ### 响应 返回所需的 DNS 记录： { "domain": "example.com", "dnsRecords": [ { "type": "CNAME", "host": "@", "value": "..." } ] } 告知用户将这些记录添加到其 DNS 提供商处。 ## 读取当前域名 使用 railway-environment 智能体查看已配置的域名，或直接查询： graphql query domains($envId: String!) { environment(id: $envId) { config(decryptVariables: false) } } 域名位于 `config.services..networking` 中： - `serviceDomains` - Railway 提供的域名 - `customDomains` - 用户提供的域名 ## 移除域名 使用 railway-environment 智能体移除域名： ### 移除自定义域名 { "services": { "": { "networking": { "customDomains": { "": null } } } } } ### 移除 Railway 域名 { "services": { "": { "networking": { "serviceDomains": { "": null } } } } } 然后使用 railway-environment 智能体应用并提交更改。 ## CLI 选项 | 标志 | 描述 | |------|-------------| | `[DOMAIN]` | 要添加的自定义域名（省略则为 Railway 域名） | | `-p, --port ` | 连接端口 | | `-s, --service ` | 目标服务（默认为已链接的服务） | | `--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