帮助文档

launchpad.json 配置、示例项目、域名与额度说明

Launchpad 是什么

Launchpad 是一个 AI 项目上线平台:连接 GitHub 仓库或选择模板,即可获得一个 可公网访问的容器实例(网站 / 后端 API / 数据库伴生服务等)。实例有到期时间, 到期前可以续期;也可以用 CLI / MCP 一条命令把本地项目打包部署。

仓库部署(launchpad.json)

连接 GitHub 选择仓库与分支(或用 CLI / MCP 上传本地项目)时,可在仓库根放一个 launchpad.json,告诉平台如何构建和运行你的项目。字段说明:

字段说明示例
runtime运行方式:static(纯静态)/ node / python / binary;留空由平台自动识别static
image构建 / 运行镜像(须在白名单内);未指定时按 runtime 选择node:22-alpine
install依赖安装命令(容器内执行,cwd = 代码根);默认 npm ci / pip installnpm ci
build构建命令(静态站点构建产物目录由 output 指定);默认无npm run build
output静态产物目录(build 后把该目录发布为 releases/current);默认 distdist
run启动命令(node / python / binary 运行时生效);默认 npm start 等node server.js
port应用监听端口(仅内网端口;对外统一经网关反代);默认按 runtime3000
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
}

静态站点(构建型):

launchpad.json
{
  "runtime": "static",
  "install": "npm ci",
  "build": "npm run build",
  "output": "dist"
}

域名与 HTTPS

每个项目默认以 <项目名>.fastlaunch.top 形式的独立域名对外提供 HTTPS 服务;平台使用泛域名证书承载全部实例。若项目名已被占用,会自动退化为 <租户名>-<项目名> 形式,保证地址全局唯一。用户自定义域名接入将在后续版本开放。通过前缀路由形态部署的模板 (如小程序 H5)会挂在 /t/<子域名> 路径下,应用可通过环境变量 LAUNCHPAD_ROUTE_PREFIX 获知前缀以生成正确的绝对链接。

API Key / CLI / MCP

网页登录之外,平台提供 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 小时临时令牌,不保存你的长期令牌。

  • 遇到违规内容?

    使用“举报”功能提交,运营会在复核队列处理。