Railway 一键部署平台¶

一句话概述：Railway 是最简单的全栈应用部署平台，连接 GitHub 自动部署，内置数据库（PostgreSQL/MySQL/Redis/MongoDB），不用写 Dockerfile，适合个人项目和小团队。

核心知识点¶

概念	白话解释
自动检测	Railway 自动识别你的项目语言和框架，零配置部署
一键数据库	点一下就能创建 PostgreSQL/MySQL/Redis
服务（Service）	一个应用或数据库就是一个服务
环境	支持 Production/Staging 多环境
模板	社区共享的项目模板，一键部署各种应用

安装配置¶

# 安装 Railway CLI
npm install -g @railway/cli  # npm 安装

# 登录
railway login  # 打开浏览器授权

# 在项目目录部署
railway init  # 创建项目
railway up  # 部署

# 或者直接在网页操作
# https://railway.app → New Project → Deploy from GitHub

环境变量¶

railway variables set DATABASE_URL="postgresql://..."  # 设置环境变量
railway variables  # 查看所有环境变量

# 数据库变量自动注入
# 添加 PostgreSQL 后，DATABASE_URL 自动可用

基本使用¶

支持的项目类型¶

自动检测并部署：
- Node.js (package.json)
- Python (requirements.txt / Pipfile)
- Go (go.mod)
- Rust (Cargo.toml)
- Java (pom.xml / build.gradle)
- Docker (Dockerfile)
- 静态网站 (index.html)

添加数据库¶

# CLI 方式
railway add  # 交互式添加服务
# 选择 PostgreSQL / MySQL / Redis / MongoDB

# 网页方式
# 项目面板 → + New → Database → PostgreSQL
# 连接字符串自动注入为环境变量

自定义域名¶

railway domain  # 生成 xxx.railway.app 子域名
# 自定义域名在 Settings → Domains 配置

常见报错¶

报错信息	原因	解决方案
`Build failed`	构建出错	检查构建日志，确认依赖安装正确
`Port not detected`	应用没监听端口	用 `PORT` 环境变量或在配置中指定
`Out of resources`	超出免费额度	升级计划或优化资源使用
部署后 502	应用启动失败	检查日志 `railway logs`

速查表¶

railway login           # 登录
railway init            # 初始化项目
railway up              # 部署
railway logs            # 查看日志
railway shell           # 远程 Shell
railway variables set   # 设环境变量
railway add             # 添加服务
railway domain          # 配置域名
railway down            # 停止服务
railway open            # 浏览器打开

# Hobby Plan: $5/月
# 500 小时执行 + 100GB 出口流量
# Trial: $5 免费额度

参考：Railway 官网 | Railway 文档 | 定价