railway-deploy

Railway 部署

使用 railway up 将当前目录中的代码部署到 Railway。

何时使用

• 用户要求“部署”“发布”或“推送代码”
• 用户提到“railway up”或“部署到 Railway”
• 用户想要部署本地代码更改
• 用户说“部署并修复任何问题”（使用 --ci 模式）

模式

分离模式（默认）

启动部署后立即返回。适用于大多数部署。

railway up --detach

CI 模式

持续输出构建日志，直到构建完成。用户想要查看构建过程或需要排查问题时使用。

railway up --ci

何时使用 CI 模式：

• 用户说“部署并查看”或“部署并修复问题”
• 用户正在排查构建失败问题
• 用户想要查看构建输出

部署特定服务

默认使用已关联的服务。要部署到其他服务：

railway up --detach --service backend

部署到未关联的项目

无需先关联，即可部署到项目：

railway up --project <project-id> --environment production --detach

需要同时提供 --project 和 --environment 标志。

CLI 选项

标志	说明
-d, --detach	不附加到日志（默认）
-c, --ci	持续输出构建日志，完成后退出
-s, --service <NAME>	目标服务（默认为已关联的服务）
-e, --environment <NAME>	目标环境（默认为已关联的环境）
-p, --project <ID>	目标项目（需要 --environment）
[PATH]	部署路径（默认为当前目录）

目录关联

Railway CLI 会沿目录树向上查找已关联的项目。如果你位于已关联项目的子目录中，则无需重新关联。

对于子目录部署，建议通过 railway-environment 技能设置 rootDirectory，然后正常运行 railway up 进行部署。

部署后

分离模式

Deploying to <service>...

使用 railway-deployment 技能，通过 --lines 标志检查构建状态。

CI 模式

构建日志会直接持续输出。如果构建失败，错误信息会显示在输出中。

CI 模式后不要运行 railway logs --build——日志已经输出。如果需要 更多上下文，请使用 railway-deployment 技能并添加 --lines 标志（不要持续输出）。

组合使用

• 部署后检查状态：使用 railway-service 技能
• 查看日志：使用 railway-deployment 技能
• 修复配置问题：使用 railway-environment 技能
• 修复配置后重新部署：使用 railway-environment 技能

错误处理

未关联项目

No Railway project linked. Run `railway link` first.

未关联服务

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

构建失败（CI 模式）

构建日志已经输出——直接从 railway up --ci 的输出中进行分析。 CI 模式后不要运行 railway logs（不带 --lines 时，它会无限持续输出）。

常见问题：

• 缺少依赖项 → 检查 package.json/requirements.txt
• 构建命令错误 → 使用 railway-environment 技能修复
• Dockerfile 问题 → 检查 dockerfile 路径