launchpad.json 配置、示例项目、域名与额度说明
Launchpad 是一个 AI 项目上线平台:连接 GitHub 仓库或选择模板,即可获得一个 可公网访问的容器实例(网站 / 后端 API / 数据库伴生服务等)。实例有到期时间, 到期前可以续期;也可以用 CLI / MCP 一条命令把本地项目打包部署。
连接 GitHub 选择仓库与分支(或用 CLI / MCP 上传本地项目)时,可在仓库根放一个 launchpad.json,告诉平台如何构建和运行你的项目。字段说明:
| 字段 | 说明 | 示例 |
|---|---|---|
| runtime | 运行方式:static(纯静态)/ node / python / binary;留空由平台自动识别 | static |
| image | 构建 / 运行镜像(须在白名单内);未指定时按 runtime 选择 | node:22-alpine |
| install | 依赖安装命令(容器内执行,cwd = 代码根);默认 npm ci / pip install | npm ci |
| build | 构建命令(静态站点构建产物目录由 output 指定);默认无 | npm run build |
| output | 静态产物目录(build 后把该目录发布为 releases/current);默认 dist | dist |
| run | 启动命令(node / python / binary 运行时生效);默认 npm start 等 | node server.js |
| port | 应用监听端口(仅内网端口;对外统一经网关反代);默认按 runtime | 3000 |
| healthcheck | 启动探针路径,必须以 / 开头;默认 / | /healthz |
| env | 环境变量数组;默认 [] | ["S3_BUCKET=demo"] |
Node.js 项目(无 launchpad.json 也可,平台会自动识别常见项目):
my-site/
├── package.json # "start": "node server.js",监听 3000 端口
├── server.js
└── launchpad.json # 可选
{
"runtime": "node",
"image": "node:22-alpine",
"run": "node server.js",
"port": 3000
}静态站点(构建型):
{
"runtime": "static",
"install": "npm ci",
"build": "npm run build",
"output": "dist"
}每个项目默认以 <项目名>.fastlaunch.top 形式的独立域名对外提供 HTTPS 服务;平台使用泛域名证书承载全部实例。若项目名已被占用,会自动退化为 <租户名>-<项目名> 形式,保证地址全局唯一。用户自定义域名接入将在后续版本开放。通过前缀路由形态部署的模板 (如小程序 H5)会挂在 /t/<子域名> 路径下,应用可通过环境变量 LAUNCHPAD_ROUTE_PREFIX 获知前缀以生成正确的绝对链接。
网页登录之外,平台提供 API Key 供 CLI、MCP 与 CI 使用。请在 账户设置 → API Key 创建:可选只读(read)或部署(deploy)权限,可设置有效期,明文只显示一次。 API Key 不能修改密码、换绑邮箱、注销账号或管理其他密钥。
export LAUNCHPAD_API_KEY=lp_xxx
python3 launchpad.py whoami
python3 launchpad.py deploy ./myapp需要 OpenCode Skill 或 MCP Server 时,见控制台「AI 部署」页;安装包/公开仓库 由平台提供。只把 API Key 保存在本机(0600),不要提交进仓库;泄露后立即在 账户设置中注销。
免费额度默认 1 个项目、每个项目最多 2 个实例、10GB 云盘、单实例最长 10080 分钟(7 天),到期实例在数据保留窗口内可通过“恢复运行”重新启用,窗口之外数据将被清理,敬请留意到期提醒。
实例到期了还能恢复吗?
过期实例在数据保留窗口内可一键“恢复运行”,窗口之外数据将被清理,敬请留意到期提醒。
忘密码了?
登录页“忘记密码”可通过注册邮箱验证码重置。
不支持什么?
不支持修改宿主机网络 / 挂载宿主路径 / 特权容器;数据库类模板仅为实例内伴生服务,不对公网暴露。
代码怎么更新?
在实例详情页的「GitHub 仓库」里重新选择仓库(或分支)并点「拉取并部署」,会前滚发布并保留上一版本用于回滚。
如何自动部署?
GitHub 推送自动部署暂未开放,目前每次部署需在实例页手动触发;后续会接入 GitHub App Webhook 实现推送即部署。
套餐有什么限制?
普通用户(免费):每账号 1 个项目,每个项目最多 2 个实例;资源上限见“资源用量”。会员用户:最多 5 个项目、10 个实例(联系管理员开通)。管理员账号不受额度限制。
私有仓库怎么拉取?
连接 GitHub 时授权对应的私有仓库即可。平台只保存安装 ID,部署时现签 1 小时临时令牌,不保存你的长期令牌。
遇到违规内容?
使用“举报”功能提交,运营会在复核队列处理。