用途:通过 Railway 的单一 GraphQL 端点,用项目作用域令牌在绑定的单个项目与环境内做自动化操作,包括读取服务、部署与变量,触发重新部署,以及写入环境变量。
主要能力:列出某服务在绑定环境中的部署(含 id、status、createdAt、staticUrl、meta);对指定部署执行 deploymentRedeploy;用 serviceInstanceDeployV2 从最新代码触发新部署;读取与 upsert 服务变量。
使用方式:所有请求都是向 https://backboard.railway.com/graphql/v2 发 POST,JSON 体为 {"query":"...","variables":{...}}。认证头为 Project-Access-Token: $RAILWAY_PROJECT_TOKEN,不要同时发送 Authorization: Bearer。建议把请求体写入 /tmp/railway_request.json,再用 -d @/tmp/railway_request.json 引用,避免 shell 转义。可用 __typename ping 或直接查询 project 验证认证;用 __type 内省查询字段名。连接类型使用 edges { node { ... } } 游标分页。
适用场景:单项目单环境内的部署状态查询、重新部署、变量管理等环境绑定自动化。
限制:项目令牌仅能访问其自身项目与环境,账户级查询(如 me、列出其他项目、工作区成员)会被拒绝或返回空。跨项目或账户级操作需改用更宽泛的 railway 技能。每次响应都要检查顶层 errors 数组,HTTP 200 但 errors 非空仍表示失败。切勿将 $RAILWAY_PROJECT_TOKEN 输出到日志、文件或 shell。故障排查可运行 zero doctor check-connector --env-name RAILWAY_PROJECT_TOKEN 或 zero doctor check-connector --url https://backboard.railway.com/graphql/v2 --method POST。官方文档:https://docs.railway.com/reference/public-api。