从 Railway 迁移到 Square Cloud

开发者为什么迁移

Railway 按计量用量计费（每秒消耗的 CPU、RAM 和网络流量），因此每月账单会随流量波动，难以预估。Square Cloud 采用了不同的方式：

Railway	Square Cloud
`railway.json` / Nixpacks	`squarecloud.app` 配置文件 + 自动 Runtimes
按用量计费	固定月度套餐定价
Postgres/Redis 插件	Square Cloud 托管数据库（PostgreSQL、MySQL、MongoDB、Redis）
环境变量	环境变量，可在控制面板中设置，或通过 `.env` 文件上传
`railway up`	`squarecloud upload`
自定义域名	Standard 套餐或更高级别上的自定义域名

创建你的配置文件

将 railway.json/Nixpacks 检测替换为项目根目录下的 squarecloud.app 文件：

squarecloud.app

MAIN=index.js
MEMORY=512
VERSION=recommended
DISPLAY_NAME=My migrated app
SUBDOMAIN=my-app

Square Cloud 的 Runtimes 会根据 package.json 或 requirements.txt 等文件自动检测你的语言，这与 Nixpacks 依赖的信号相同。查看配置文件参考了解每个字段的详情。

设置你的环境变量

从 Railway 项目的 Variables 标签页重新创建这些变量，可以从控制面板的环境变量面板设置，也可以上传 .env 文件：

squarecloud app env set --from-file .env --app <appID>

部署

通过 CLI 或控制面板上传你的项目，以替代 railway up：

squarecloud upload

参见如何托管你的网站/API，了解这两种方式的完整演示。

将插件迁移到托管数据库

如果你的项目使用了 Railway 的 Postgres、MySQL 或 Redis 插件，请配置等价的 Square Cloud 托管数据库，并将应用的连接字符串指向它。

配置你的 DNS

应用在 <subdomain>.squareweb.app 上线后，将你域名的 DNS 指向 Square Cloud，并通过 CLI 绑定：

squarecloud app network domain example.com --app <appID>

自定义域名需要有效的 Standard 套餐或更高级别。

计费模式。 没有按秒计量的用量表需要留意 —— 无论流量如何，成本都按套餐固定。请根据 RAM/vCPU 需求而非预计用量来选择套餐规模。参见套餐与价格。
地区与延迟。 Square Cloud 的数据中心位于纽约 —— 参见平台概览了解基础设施详情。如果你之前运行在不同的 Railway 地区，请在切换前先根据用户所在地测量延迟。
数据库需单独迁移。 迁移 Railway 的 Postgres/Redis 插件数据意味着需要先导出它，再恢复到一个新的 Square Cloud 托管数据库中 —— 请为切换规划一个维护窗口。

如果你仍然遇到技术问题，我们的专业支持团队可以为你提供帮助。联系我们，我们很乐意协助你解决任何问题 —— 支持质量正是开发者给予 Square Cloud 4.9/5 评分（共 402 条评价）（Google 与 Trustpilot）的重要原因之一。