GUIDE · hubcreate / hubdeploy

使用指南

所有站点发布到 https://<namespace>--<slug>.deploy.hubopenai.com/。AI 与人类都只使用本站命令。

当前支持什么

与首页说明一致，请先选对路径：

• 支持：静态 HTML/CSS/JS（hubdeploy）；Node.js Express + SQLite 全栈（hubcreate，默认跑在平台固定 Docker 镜像中，带 CPU/内存上限）。
• 不支持：PHP（含 WordPress 等）、Python / Java / Go、用户自定义 Dockerfile / 任意镜像。发布包中的 .php 会被拒绝或清理，不会执行。
• 机器可读：GET /api/portal/settings/public → runtimes；协议见 llms.txt。

控制台与命名空间（P3）

打开 /app/：登录用户发布到 用户名--项目（静态站不会因闲置自动回收；全栈见 fullstack_idle_days）；游客为 g-xxxxxx--项目（静态站闲置约 guest_idle_days 天后可能自动回收）。配额与回收天数由平台配置，见 GET /api/portal/settings/public。

export HUB_TOKEN='（控制台：会话 Token 或专用 CLI Token）'
hubdeploy dist my-site
# → https://<namespace>--my-site.deploy.hubopenai.com/
hubcreate my-app
hubcreate restart <host_slug>
hubdeploy list   # 有 Token 时仅列出你的项目
hubdeploy rm <host_slug>   # 同步删除门户登记

发给 AI

打开 /ai/ 复制提示词，粘贴到任意 AI 编辑器 / 编程助手（不限某一款产品）。协议与 Skill 如下：

https://deploy.hubopenai.com/llms.txt
https://deploy.hubopenai.com/skills/hubopenai-deploy/SKILL.md
https://deploy.hubopenai.com/ai/

一键全栈（服务端 + 数据库 + 前端）

hubcreate my-app
# 有 HUB_TOKEN → https://<ns>--my-app.deploy.hubopenai.com/
# 无 Token / --legacy → https://my-app.deploy.hubopenai.com/
# API: …/api/health

会自动完成：脚手架、依赖安装、SQLite、PM2 进程、子域反代。

应用目录：

apps/<host_slug>/
  server.js
  public/
  db/data.sqlite
  .hub.json

hubcreate restart <host_slug>
hubcreate list
hubcreate rm <host_slug>

静态站发布

npm run build
hubdeploy dist my-site
hubdeploy list
hubdeploy rm <host_slug>

子域名冲突

有 Token 时按命名空间隔离（你的 username--slug 不会与他人冲突）。无 Token 的遗留模式仍共用全局 slug：同名时默认自动分配 slug-2；同一所有者可原地更新；全栈重复创建会拒绝（请 restart 或 --force）。

hubdeploy check my-site
hubcreate check my-app
# 可选：--exact 严格失败 | --force 强制覆盖 | --legacy 跳过门户命名空间
# 有 HUB_TOKEN 时 --force/--exact 会传给门户 reserve，并预检磁盘配额

务必使用命令打印出的最终 URL，不要假设等于请求的 slug。

示例

先打开这些线上样例，再对照命令发布你自己的项目。