2026-08-12 核对 Railway 官方价格页:Free 计划在 30 天 $5 额度试用后为 $1/月,提供 0.5 GB Volume;Hobby 为 $5/月 最低用量,包含等额月度用量额度并提供最高 5 GB 存储。首批验证使用 Free 和 Railway 赠送域名,不购买自定义域名;出现真实付款后再评估 Hobby。
价格和套餐可能变化,开通前以 Railway Pricing 为准。
- 在 Railway 登录并选择
Deploy from GitHub repo,授权fly1d/quicklearn-agent。 - 确认部署来源为
main,构建配置读取仓库根目录的railway.json。 - 给 Web Service 添加 Volume,挂载路径必须为
/data。 - 设置变量
HOST=0.0.0.0和QUICKLEARN_DATA_DIR=/data。 - 生成 Railway Domain,等待
/health返回{"status":"ok"}。 - 在 Railway 设置用量告警和硬限制,避免超出验证预算。
PORT 由 Railway 自动注入,不要写死。.env.example 只表示本地默认值,不应上传任何部署令牌或联系方式。
Volume 和环境变量完成前,不提交真实联系方式。Railway 的 redeploy 会保留 Volume,但移除 Volume 或删除项目会删除运行数据。
应用在非本机地址监听时会强制要求 QUICKLEARN_DATA_DIR:缺少该变量时 /health 返回 503,购买意向和漏斗事件也拒绝写入,Railway 不会把可能丢数据的版本标记为健康。这个检查不能证明 Volume 已正确挂载,因此上线 Smoke 仍必须执行重启后持久化验证。
把公网地址代入下面命令:
QUICKLEARN_URL=https://your-service.up.railway.app npm run deploy:smoke该检查只执行免费分析、健康检查和敏感路径拦截,不写入购买意向。随后手工登记一条明确标记为测试的意向,重启服务,确认记录仍存在后立即删除测试记录。
使用 Railway Shell 运行:
npm run commercial:report每天有新意向时导出 /data 三个 JSONL 文件到只有运营者能访问的加密存储。备份包含联系方式,不要上传 GitHub、聊天群或公开网盘。按月测试一次恢复:在临时私有目录解压备份并运行报表,确认记录可解析。
不要依赖 Railway Deploy Logs 作为线索备份,应用不会把联系方式写入日志。若使用 Railway Volume Backup 功能,也要按套餐页面确认当前是否可用以及保留期。
代码故障优先在 Railway Deployment 历史中回滚到上一成功版本,Volume 不做回滚。若停止服务,先导出履约仍需要的数据,再关闭公网域名;履约完成或用户要求删除后,清理对应记录。需要迁移平台时,先复制 Volume 数据并校验,再切换域名。