Railway CLI 入门：安装、登录、部署与看日志

不想每次都 push 到 GitHub，或者要在本地用线上的环境变量调试，就用 Railway CLI。

一、安装

任选一种：

# macOS
brew install railway

# 已装 Node.js 的任意系统
npm i -g @railway/cli

# macOS / Linux 安装脚本
bash <(curl -fsSL railway.com/install.sh)

Windows 用户官方推荐在 WSL 里用 Bash 安装，也可以用 scoop install railway。装好后运行 railway --version 确认。

二、登录

railway login

会打开浏览器确认登录。服务器上没有浏览器时用：

railway login --browserless

CI 里不需要登录，设置环境变量 RAILWAY_TOKEN 即可。

三、部署本地代码

新项目：

cd my-app
railway init   # 新建一个空项目
railway up     # 打包上传当前目录并部署

已有项目：

railway link   # 选择要关联的项目和环境
railway up

railway up --detach 上传后立即返回，不在终端里跟踪日志。部署完用 railway open 打开项目画布。

还没有账户？先注册 Railway →　新账户送 30 天试用和 $5 额度。

四、在本地使用线上变量

railway run npm start

railway run 会把当前服务的环境变量注入到命令里，本地连测试数据库、调试第三方 API 很方便，不用把密钥写进 .env。

五、看日志和连数据库

railway logs            # 实时运行日志
railway logs --build    # 构建日志
railway logs -n 100     # 最近 100 行
railway connect         # 打开数据库命令行（psql、redis-cli 等）

六、常用命令速查

用量上限的设置方法见用量上限教程。