Runtime matrix

平台支持什么,在构建前说清楚

PocketBay 当前支持的项目类型、Node.js/Python 版本、包管理器、启动约定和静态托管限制。

Node.js 项目

支持 npm、pnpm 和 Yarn。平台优先读取 packageManager 字段,其次根据锁文件判断;安装时优先使用确定性锁文件模式,锁文件不同步时会记录警告并尝试兼容安装。

启动命令优先级为 scripts.start、main 字段和常见入口文件。无法确定启动方式时,会在 Docker build 前返回结构化错误。

Python 项目

支持 requirements.txt、pyproject.toml、uv.lock、Poetry 和 Pipenv 的常见依赖声明。FastAPI 会扫描常见 ASGI app,Flask 和 Django 会根据依赖与入口生成兼容启动计划。

静态站点

纯静态项目直接由 Caddy file_server 托管,不启动常驻容器。单次部署默认限制为 200MB、5,000 个文件,并保留最近 3 个不可变版本目录。

自定义 Dockerfile

PocketBay 尊重用户自带 Dockerfile,不覆盖其构建内容。该模式仍然只适合单容器 Web 服务;Docker Compose 中的其他服务不会自动启动。