Cloudish 是一个以智能体为先、基于 API 密钥与预付额度的容器部署平台。它支持从 Dockerfile、源码目录或已有镜像运行容器,并在服务端完成镜像构建,因此无需本地 Docker 守护进程,也无需管理镜像仓库。平台托管私有镜像仓库,并以附加存储的方式运行生成的容器。该产品没有面向用户的图形界面,所有操作均通过 API 完成。
用途
当用户要求将应用、API、机器人或网站部署、托管或上线到 Cloudish 时使用。当用户希望在不本地安装 Docker 的情况下运行容器时使用。当数据库类服务需要持久卷(容器内运行 SQLite 或 Postgres)时使用。当用户索要 Cloudish API 密钥或充值链接时使用。不适用于 Cloudish 以外的平台,也不适用于用户希望托管在其他主机的静态站点。
主要能力
- 服务端构建:上传包含 Dockerfile 的 tar.gz 构建上下文,构建在 Cloudish 服务器执行,无需本地 docker build。
- 已有镜像注册:可直接注册已有镜像(如 ghcr.io 上的镜像)并立即部署。
- 自动分配访问地址:镜像注册后自动分配永久 URL,形如 https://<name>.cloudish.app/。
- 环境变量与密钥:非敏感配置通过 env 传入;敏感信息通过加密的 secrets 端点单独设置,静态加密并自动合并进容器环境。
- 持久存储:可申请卷,容量为 1、5 或 20 GB,默认挂载路径为 /data;一个卷只能挂载到一个容器,因此带卷的应用不能运行副本。
- 自定义子域名与自有域名:可设置易记的子域名标签,也可添加自有域名并通过 TXT 记录验证,支持重定向与证书签发。
- 容器规格与伸缩:可设置容器 CPU 与内存、请求体大小上限;容器在首次请求时启动,闲置后缩容,闲置超时可按密钥覆盖。
- 副本:可为同一应用运行多个隔离副本,适合按用户、任务或智能体划分沙箱。
- 内置 OIDC:应用可对接 Cloudish 自带的 OpenID Connect 提供方,使用标准发现文档与 Authorization Code + PKCE,无需管理客户端密钥。
使用方式
首先通过 POST https://cloudish.ai/api/v1/keys 创建 API 密钥,该调用无需凭证,返回的密钥用于后续所有调用的 Authorization: Bearer 认证。新密钥包含 0.1 额度(视可用性而定)。随后通过 POST /api/v1/projects 创建或更新项目并部署:可附带已有镜像,或上传 tar.gz 构建上下文(根目录必须包含 Dockerfile)。构建状态通过 GET /api/v1/images/builds/{id} 轮询,直到 succeeded 或 failed。port 默认为 8080,必须与服务器实际监听端口一致。构建默认使用 3 核 CPU 与 5 GB 内存,若因资源耗尽失败,可通过 buildCpuCores 与 buildMemoryGb 调整。
适用场景
适合需要快速上线容器化应用、API、机器人或网站的场景;适合无法在本地运行 Docker 的环境;适合需要在容器内运行 SQLite 或 Postgres 并挂载持久卷的服务;适合需要为每个用户或任务运行隔离副本的场景;适合希望应用接入标准 OIDC 登录的场景。
限制
Cloudish 没有托管数据库服务,数据库需在自有容器内运行。平台不代为处理容器身份,不注入可信请求头,也不添加自有 CORS 头,需要由应用自行配置。子域名标签仅限小写字母、数字和连字符,长度 1 至 63 字符,且全局唯一。每个活跃自有域名每天消耗 0.01 额度,每小时最多添加 10 个,最多 20 个待验证。额度不足时请求返回 402,浏览器访问则显示 503 状态页。密钥与机密不得打印到聊天、源码或日志中;在构建成功且日志显示应用已启动并监听之前,不得报告部署成功。