Deployment guide

用 AI 把本地项目部署成线上应用

从项目准备、框架判断、浏览器授权到构建上线和失败修复,完整了解 PocketBay 的 AI 原生部署流程。

部署口令
请将当前项目部署到 PocketBay,部署手册:https://pocketbay.com/deploy

部署前检查

  • 这是一个提供 HTTP 服务或静态文件的单体 Web 项目。
  • Node.js 项目有可解析的 package.json;Python 项目有依赖清单和 Web 入口。
  • 动态应用必须监听环境变量 PORT 并绑定 0.0.0.0。
  • 如果使用 Dockerfile,容器内必须启动一个可健康检查的 Web 服务。
  • 需要数据库时,可开通/迁移平台托管 PostgreSQL,或使用外部数据库连接串;暂不托管 Redis 等其他引擎。

完整流程

STEP 1

准备一个可运行的 Web 项目

项目应属于 static、nextjs、node、python 或 dockerfile,并有明确入口文件或构建产物。

STEP 2

把部署口令发给 AI

AI 在本地读取项目文件,判断 framework_hint,并获取 PocketBay 的 Agent Markdown 手册。

STEP 3

打开配对链接确认

AI 创建一次性会话后必须把完整授权链接展示给你;登录 PocketBay 后确认项目名与部署类型。

STEP 4

AI 打包并上传

上传包会排除 node_modules、.git、.next、虚拟环境和缓存目录,减少体积与泄露风险。

STEP 5

平台生成构建计划

PocketBay 分析版本、锁文件、包管理器、启动命令和环境变量,再进行受限构建与健康检查。

STEP 6

成功上线或按错误修复

成功后得到 pocketbay.app 子域名;失败时 AI 可读取 error_category、repair_hint 和日志,修复源码后重新上传。

如何判断部署类型

类型典型项目关键要求
staticHTML、CSS、JS 或已生成的静态产物包含 index.html;直接由网关托管
nextjs依赖中包含 next 的 Next.js 项目有 build/start 脚本;公开变量使用 NEXT_PUBLIC_
nodeExpress、Hono、Koa 等 Node Web 服务有启动命令并监听 PORT
pythonFastAPI、Flask、Django 等 Web 服务有依赖清单和可识别入口
dockerfile自定义单容器 Web 应用Dockerfile 位于项目根目录

部署失败时会发生什么

PocketBay 不承诺每个项目都能一次构建成功。平台会返回结构化错误分类、日志尾部和修复建议;AI 可在告知用户后修改源码并重新部署。常见问题包括运行时版本过高、缺少启动命令、依赖安装失败、未监听正确端口和构建超时。

完整机器执行步骤始终以 Agent Markdown 手册为准。

Start shipping

把最后一步交给 PocketBay

把部署口令发给你的 AI 编程助手,授权一次,它会自动打包、上传、构建并返回线上地址。