deploy

部署

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

适用场景

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

提交消息

始终使用 -m 标志，并提供一条描述性提交消息，概括要部署的内容：

railway up --detach -m "Add user authentication endpoint"

优秀的提交消息：

• 描述更改内容：“修复工作进程中的内存泄漏”
• 引用工单／问题：“实现功能 #123”
• 简洁但有意义：“更新依赖项并修复构建警告”

模式

分离模式（默认）

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

railway up --detach -m "Deploy description here"

CI 模式

持续输出构建日志，直到构建完成。适用于用户想要查看构建过程或需要调试问题的情况。

railway up --ci -m "Deploy description here"

适用 CI 模式的场景：

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

部署到指定服务

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

railway up --detach --service backend -m "Deploy description here"

部署到未关联的项目

无需先关联项目即可进行部署：

railway up --project <project-id> --environment production --detach -m "Deploy description here"

需要同时使用 --project 和 --environment 标志。

CLI 选项

标志	说明
-m, --message <MSG>	描述此次部署的提交消息（始终使用此选项）
-d, --detach	不附加到日志（默认）
-c, --ci	持续输出构建日志，完成后退出
-s, --service <NAME>	目标服务（默认为已关联的服务）
-e, --environment <NAME>	目标环境（默认为已关联的环境）
-p, --project <ID>	目标项目（需要同时指定 --environment）
[PATH]	部署路径（默认为当前目录）

目录关联

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

部署子目录时，建议通过环境技能设置 rootDirectory，然后正常运行 railway up 进行部署。

部署后

分离模式

Deploying to <service>...

使用 deployment 技能检查构建状态（带上 --lines 标志）。

CI 模式

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

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

组合使用

• 部署后检查状态：使用 service 技能
• 查看日志：使用 deployment 技能
• 修复配置问题：使用 environment 技能
• 修复配置后重新部署：使用 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
• 构建命令错误 → 使用环境技能修复
• Dockerfile 问题 → 检查 dockerfile 路径