名称： railway
描述： 在 Railway.app 上部署和管理应用程序。用于部署项目、管理服务、查看日志、设置环境变量以及管理数据库。Railway 是一个现代化的云平台，支持零配置部署应用。
元数据：
{
"openclaw":
{
"emoji": "🚂",
"requires": { "bins": ["railway"] },
"install":
[
{
"id": "brew",
"kind": "brew",
"formula": "railway",
"bins": ["railway"],
"label": "安装 Railway CLI (brew)",
},
{
"id": "npm",
"kind": "npm",
"package": "@railway/cli",
"bins": ["railway"],
"label": "安装 Railway CLI (npm)",
},
],
},
}

Railway

在 Railway.app 上部署和管理应用程序——一个支持零配置部署的现代化云平台。

身份验证

# 登录（会打开浏览器）
railway login

# 使用令牌登录（适用于 CI/CD）
railway login --token <TOKEN>

# 检查登录状态
railway whoami

# 登出
railway logout

项目管理

关联与初始化

# 将当前目录关联到现有项目
railway link

# 关联到指定项目
railway link --project <项目ID>

# 创建新项目
railway init

# 取消项目关联
railway unlink

查看项目

# 列出所有项目
railway list

# 在浏览器中打开项目
railway open

# 显示项目状态
railway status

部署

部署操作

# 部署当前目录
railway up

# 部署但不实时查看日志
railway up --detach

# 部署指定服务
railway up --service <服务名称>

# 部署到指定环境
railway up --environment production

# 重新部署最新版本
railway redeploy

# 重新部署指定服务
railway redeploy --service <服务名称>

从模板部署

# 部署模板
railway deploy --template <模板名称>

# 带变量部署
railway deploy --template postgres --variable POSTGRES_USER=myuser

服务管理

# 列出项目中的服务
railway service

# 创建新服务
railway service create

# 删除服务
railway service delete <服务名称>

环境变量

# 列出所有变量
railway variables

# 设置变量
railway variables set KEY=value

# 设置多个变量
railway variables set KEY1=value1 KEY2=value2

# 删除变量
railway variables delete KEY

# 查看指定变量
railway variables get KEY

日志

# 查看日志（实时）
railway logs

# 查看指定服务的日志
railway logs --service <服务名称>

# 查看最近的日志（非实时）
railway logs --no-follow

# 查看带时间戳的日志
railway logs --timestamps

运行命令

# 在 Railway 环境变量下运行命令
railway run <命令>

# 示例
railway run npm start
railway run python manage.py migrate
railway run prisma db push

# SSH 连接到运行中的服务
railway ssh

# SSH 连接到指定服务
railway ssh --service <服务名称>

域名管理

# 列出域名
railway domain

# 添加自定义域名
railway domain add <域名>

# 移除域名
railway domain delete <域名>

数据库

Railway 支持一键式数据库配置：

# 添加 PostgreSQL
railway add --plugin postgresql

# 添加 MySQL
railway add --plugin mysql

# 添加 Redis
railway add --plugin redis

# 添加 MongoDB
railway add --plugin mongodb

数据库连接字符串会自动添加到环境变量中。

环境管理

# 列出环境
railway environment

# 切换环境
railway environment <环境名称>

# 创建环境
railway environment create <环境名称>

# 删除环境
railway environment delete <环境名称>

存储卷

# 列出存储卷
railway volume

# 创建存储卷
railway volume create --mount /data

# 删除存储卷
railway volume delete <存储卷ID>

常用工作流

部署新项目

# 1. 在项目目录中初始化
cd my-app
railway init

# 2. 按需添加数据库
railway add --plugin postgresql

# 3. 设置环境变量
railway variables set NODE_ENV=production

# 4. 部署
railway up

连接生产数据库

# 使用生产环境变量运行本地命令
railway run psql $DATABASE_URL

# 或使用 SSH
railway ssh
# 然后在容器内执行：
psql $DATABASE_URL

查看部署状态

# 检查状态
railway status

# 查看日志
railway logs

# 打开控制面板
railway open

回滚部署

# 在控制面板中查看部署记录
railway open

# 重新部署上一个版本（通过控制面板）
# 或重新部署当前代码
railway redeploy

CI/CD 集成

适用于 GitHub Actions 或其他 CI 工具：

# .github/workflows/deploy.yml
名称： 部署到 Railway
on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: 安装 Railway CLI
        run: npm i -g @railway/cli
      - name: 部署
        run: railway up --detach
        env:
          RAILWAY_TOKEN: ${{ secrets.RAILWAY_TOKEN }}

资源

• Railway 文档
• Railway CLI 参考
• Railway 模板
• Railway GitHub