Railway

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

认证

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

# 使用 Token 登录（适用于 CI/CD）
railway login --token 

# 查看当前登录状态
railway whoami

# 注销
railway logout

项目管理

关联与初始化

# 将当前目录关联至已有项目
railway link

# 关联至指定项目
railway link --project 

# 创建新项目
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 

卷（Volumes）

# 列出所有卷
railway volume

# 创建卷（挂载路径为 /data）
railway volume create --mount /data

# 删除卷
railway volume delete 

常见工作流

部署一个新项目

# 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
name: Deploy to Railway
on:
  push:
    branches: [main]

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

资源

• Railway 文档
• Railway CLI 参考手册
• Railway 模板
• Railway GitHub 仓库