railway-domain（Railway域名管理Skill）Skill 怎么用？

Railway域名管理Skill：用一句话完成Railway服务域名的添加、查看与移除

一句话定位：把「给 Railway 服务加域名、查 URL、删域名」这些原本需要在控制台点选或手敲 CLI 命令的操作，变成和 AI 助手的一次对话。
核心能力：生成 Railway 免费域名（每个服务最多 1 个）、绑定自定义域名并返回所需 DNS 记录、读取当前已配置的 serviceDomains 与 customDomains、移除不需要的域名。
依赖清晰：底层依赖 railway-cli，技能仅被允许调用 railway 相关命令（Bash(railway:*)），权限边界明确，不会越权改动其它基础设施。
可组合：读取与移除域名时与 railway-environment 技能配合，检查服务时与 railway-service 技能配合，形成一套对话式的 Railway 运维工作流。
适合谁：用 Railway 部署服务的独立开发者、需要给客户演示绑定自定义域名的小团队、以及在多服务项目中经常忘记具体命令和 DNS 配置细节的后端/全栈工程师。

该技能叫什么？如何一键安装 AI 技能提升开发效率？

这个技能的中文名是 Railway域名管理Skill，英文名 railway-domain，技能 ID 为 12006，由 Railway 官方维护，版本 1.0.0，采用 MIT 许可证，标签包括 Railway、域名、DNS、URL、自定义域名、基础设施。

它要解决的问题非常具体：在 Railway 上部署完服务之后，「我的服务 URL 是什么」「怎么给服务绑一个自己的域名」「这条 CNAME 记录该指向哪里」「这个不用的域名怎么删掉」——这些操作分散在控制台页面、CLI 参数和 DNS 服务商后台之间，新手容易卡在「域名填了但不生效」这类问题上。这个技能把上述操作收敛成自然语言请求，由助手翻译成正确的 railway 命令并解释结果。

「一键安装」的思路与步骤：

确认安装前提：本机已安装并登录 railway-cli（技能声明了 dependencies: [railway-cli]），项目已完成链接、目标服务已有部署。没有部署时，技能会明确提示「服务无部署。首先使用 railway up 部署。」
通过技能入口安装：在你的 AI 助手/技能市场中使用技能 ID 12006 或英文名 railway-domain 进行检索并添加（具体安装入口与命令以官方说明为准）。安装后建议确认技能声明的工具权限为 Bash(railway:*)，避免权限过大。
验证是否生效：回到对话中直接问「我的服务 URL 是什么」或「帮我生成一个 Railway 域名」。如果技能正常工作，助手会调用 railway domain --json 并返回域名结果；也可以自己在终端执行一次 railway domain --json 确认 CLI 侧通畅。

该技能的主要功能和特点

生成 Railway 官方域名：执行 railway domain --json 即可为当前链接的服务生成一个 Railway 提供的域名。需要强调的限制是：每个服务最多只能有 1 个 Railway 域名，重复申请会提示「服务已有一个railway提供的域名」。
按服务定向操作：通过 --service backend 之类的参数，可以对指定服务操作域名，而不必先切换链接目标，这在多服务项目里非常实用。
绑定自定义域名并返回 DNS 记录：执行 railway domain example.com --json 时，返回结果中会给出该域名所需的 DNS 记录，例如 {"domain":"example.com","dnsRecords":[{"type":"CNAME","host":"@","value":"..."}]}，助手会提示你把这些记录添加到自己的 DNS 服务商处。这一步替用户省掉了「到底该配 A 记录还是 CNAME」的反复试错。
读取当前域名配置：域名信息位于 config.services.<serviceId>.networking 之下，分为 serviceDomains（Railway 提供的域名）和 customDomains（用户自己的域名）两类，可以清晰区分来源。
移除域名：通过把 customDomains 或 serviceDomains 下对应的域名 ID 置为 null，再交由 railway-environment 技能应用并提交更改，实现「删干净」而不是「看着删了其实还在」。
JSON 输出便于自动化：所有添加操作都支持 --json，返回结构化结果，方便被助手解析、被脚本二次消费。
错误提示面向人话：未链接服务、域名已存在、无部署、域名格式无效等场景都有明确文案，降低排错成本。

和「直接看文档 + 手动敲命令」相比，它的优势不在于发明了新功能，而在于把正确的命令、正确的参数、正确的 DNS 记录一次性给对，并顺带解释限制条件。

如何使用该技能？

第 1 步：准备环境。 安装并登录 railway-cli，在项目目录下完成链接，确认目标服务已有部署。

第 2 步：生成 Railway 域名。 对当前链接的服务执行：

railway domain --json

对特定服务执行：

railway domain --json --service backend

响应会返回生成的域名 URL。若提示无部署，先 railway up。

第 3 步：添加自定义域名。 在命令后直接跟域名：

railway domain example.com --json

响应形如：

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

此时按返回的记录到你的 DNS 服务商处添加即可，助手会明确告诉你「将这些记录添加到他们的DNS提供商」。

第 4 步：读取当前域名。 可以使用 railway-environment 技能查看配置的域名，或直接查询：

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

结果中关注 config.services.<serviceId>.networking 下的 serviceDomains 与 customDomains。

第 5 步：移除域名。 移除自定义域名时，将对应域名 ID 置空：

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

移除 Railway 域名时，改为操作 serviceDomains：

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

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

第 6 步：了解 CLI 选项。 常用标志如下：

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

第 7 步：对照错误提示排错。 「未链接服务」→ 使用 --service 或运行 railway service 选择；「域名已存在」→ 每个服务最多 1 个 Railway 域名；「无部署」→ 先 railway up；「无效域名格式」→ 使用 example.com 或 api.example.com 这类合法域名。

同类型竞品对比分析

方案名称	定位	核心功能	安装/使用门槛	适用场景	优势与不足
Railway域名管理Skill（railway-domain）	对话式 Railway 域名运维	生成 Railway 域名、绑定自定义域名并返回 DNS 记录、读取与移除域名	需安装 `railway-cli` 并完成登录与链接；技能侧一次安装	部署后快速拿 URL、给服务绑自有域名、清理域名	优势：命令与 DNS 记录一次给对，支持自然语言与 JSON 输出；不足：强依赖 CLI 与已部署服务，仅覆盖 Railway 平台
Railway 控制台手动配置	图形界面手工操作	在网页上查看服务、添加/删除域名	门槛低，但需要在控制台与 DNS 服务商之间来回切换	偶尔操作、需要人工核对配置	优势：直观可见；不足：批量或多服务场景效率低，容易漏配 DNS 记录
直接使用 railway CLI	命令行原生操作	与技能底层命令一致	需记忆 `railway domain` 的参数与限制	熟悉 CLI 的工程师、脚本化场景	优势：无中间层；不足：无自然语言理解，需要自己解读返回结果与 DNS 要求
通用 DNS 服务商 + 云平台域名管理	基础设施层配置	解析记录管理、自定义域名接入	需要理解 CNAME/A 记录、验证流程	跨平台统一域名管理	优势：平台无关；不足：不掌握 Railway 侧的服务状态与限制，仍需回到 Railway 完成绑定

该技能的典型应用场景与实际体验情况

场景一：独立开发者上线后立刻要一个可访问地址。 痛点是不确定域名是否已经生成、URL 在哪看。使用方式：直接问「我的服务 URL 是什么」或「生成一个 Railway 域名」，技能调用 railway domain --json 返回地址。体验上属于「一句话解决」，几乎零学习成本；唯一需要注意的是必须先完成部署，否则会收到无部署提示。

场景二：给客户演示时绑定自有品牌域名。 痛点是要在 Railway 与 DNS 服务商之间反复确认记录类型和主机名。使用方式：让助手执行 railway domain example.com --json，拿到 dnsRecords 后照抄到 DNS 后台。体验上的最大价值是「不用猜」，返回的 JSON 直接给出了类型、主机与目标值；注意 DNS 生效通常有延迟，验证时不要立刻断定失败。

场景三：多服务项目的定向域名管理。 例如前端、后端、管理后台在同一个项目里，需要只给 backend 加域名。使用方式：railway domain --json --service backend。体验上避免了误操作到错误服务，但前提是服务名准确，拼错时会命中「未链接服务」之类的提示。

场景四：环境迁移与域名清理。 服务下线或域名更换后，遗留域名需要移除。使用方式：通过把 customDomains 或 serviceDomains 下对应 ID 置为 null，再由 railway-environment 应用提交。体验上比在控制台逐个点击更可控，但建议在变更前先读取一次当前配置，避免删错 ID。

整体来看，这个技能的上手难度低、边界清晰：它不负责 DNS 服务商侧的实际写入，也不承诺自动完成验证，而是把「该执行什么命令、该配什么记录、为什么失败」讲清楚。

该技能能为用户带来的价值

效率提升：把「查文档 → 想命令 → 执行 → 解读返回 → 配 DNS」的多步流程压缩为一到两轮对话，尤其在只需要一个可访问 URL 的场景下，几乎瞬间完成。
门槛降低：不需要记住 -s、-p、--json 这些参数，也不需要理解 serviceDomains 与 customDomains 的区别，助手会按语义选择正确路径。
减少低级错误：内置的限制提示（每个服务最多 1 个 Railway 域名、必须先部署、域名格式校验）能在出错当下给出可执行的修复建议，减少无效尝试。
可自动化：--json 输出让结果可以被脚本或后续技能消费，便于把域名管理纳入更完整的发布流程。
长期价值：与 railway-environment、railway-service 等技能组合后，形成一套「对话式基础设施运维」的习惯，团队新人不必先啃完整个 CLI 文档就能完成常见操作。

常见问题 FAQ

Q1：这个技能怎么安装？需要额外付费吗？ A：通过你的 AI 助手/技能市场按技能 ID 12006 或英文名 railway-domain 添加（具体安装入口以官方说明为准）。使用前需要本机具备 railway-cli 并完成登录。技能本身为 MIT 许可证，至于 Railway 平台侧的套餐与计费，以其官方说明为准。

Q2：为什么我生成 Railway 域名时提示「域名已存在」？ A：因为每个服务最多只能有 1 个 Railway 提供的域名。如果你需要多个访问入口，应该使用自定义域名（railway domain example.com --json），而不是重复申请 Railway 域名。

Q3：添加自定义域名后，为什么访问还不通？ A：技能返回的是你需要在 DNS 服务商处添加的记录（例如 type: CNAME, host: @, value: ...），Railway 侧不会替你修改 DNS。请先按返回结果配置记录，并预留 DNS 生效时间。

Q4：这个技能适合谁用？和直接用 CLI 相比怎么选？ A：适合经常在 Railway 上部署、但不希望记忆命令细节的开发者，以及需要向他人解释「DNS 该怎么配」的协作场景。如果你已经非常熟悉 railway domain 的参数并习惯脚本化操作，直接用 CLI 完全等价；技能的价值在于自然语言理解与结果解读。

Q5：删除域名时会不会误删别的配置？ A：移除操作只针对 networking 下指定的 customDomains 或 serviceDomains 条目，把对应域名 ID 置为 null，再交由 railway-environment 技能应用提交。稳妥做法是先读取当前配置确认域名 ID，再执行变更。