从 GitHub 部署第一个项目到 Railway

这篇用官方的 Next.js 示例仓库演示：从 GitHub 仓库部署到拿到一个能访问的 HTTPS 地址。换成你自己的 Node.js、Python、Go 项目，步骤一样。

一、准备仓库

没有现成项目的话，先 Fork 官方示例 railwayapp-templates/nextjs-basic 到自己的 GitHub 账号。

自己的项目要注意两点：

• 应用要监听环境变量 PORT 指定的端口，不要写死端口号。
• 需要的环境变量写进 .env.example，Railway 会扫描仓库根目录的 .env* 文件并建议导入。

二、新建项目

1. Dashboard 点 New Project。
2. 选 GitHub Repository（第一次会要求授权 Railway 访问仓库，可以只授权部分仓库）。
3. 搜索并点击你的仓库。
4. 选 Deploy Now 立即部署；需要先填环境变量就选 Add Variables，填完再点画布顶部的 Deploy。

Railway 会用 Railpack 识别项目语言、安装依赖并构建。仓库里有 Dockerfile 时改用 Dockerfile 构建。

还没注册？打开 Railway 官网 →　新账户送 30 天试用和 $5 额度。

三、生成访问域名

Railway 不会自动给服务分配公网地址：

1. 点击画布上的服务，进入 Settings。
2. 找到 Networking → Public Networking，点 Generate Domain。
3. 得到一个 xxx.up.railway.app 地址，自带 HTTPS。

如果应用监听了多个端口，这一步会让你选择把域名指向哪个端口。

四、添加环境变量

服务的 Variables 标签页里：

• 点 New Variable 一个个加；
• 或点 RAW Editor，把 .env 内容整段粘进去。

改完变量后，画布上方会出现待部署的改动（staged changes），点 Deploy 才会生效。

五、之后怎么更新

默认每次 push 到关联分支都会自动重新部署。部署出问题时，在 Deployments 列表里找到上一个正常的版本，从菜单里选 Rollback 即可回滚。

六、构建失败怎么查

• Build Logs： 看依赖安装和构建命令哪一步报错。
• Deploy Logs： 构建成功但访问不了，多半是启动命令错了或端口不对。
• 用 CLI 看日志：railway logs --build 看构建日志，railway logs 看运行日志，见 CLI 入门。

项目要连数据库的话，下一篇看添加 PostgreSQL。