prizz/opencode-cloud-sandbox

opencode-cloud-sandbox

用于AI辅助编码的定制化容器镜像，推荐通过opencode-cloud CLI进行镜像拉取、卷管理、端口配置和升级等操作：https://github.com/pRizz/opencode-cloud%EF%BC%88%E9%95%9C%E5%83%8F%E5%9C%B0%E5%9D%80%EF%BC%9Ahttps://gitea.com/pRizz/opencode-cloud%EF%BC%89

镜像内容

• Ubuntu 26.04 LTS (resolute) 操作系统
• 带无密码sudo权限的非root用户
• 由mise管理的运行时环境（Node.js 25、Python 3.14、Go 1.25）
• 通过rustup安装的Rust工具链
• 核心CLI工具（ripgrep、eza、jq、git等）
• 预安装opencode及GSD插件

标签说明

• latest：最新发布版本
• X.Y.Z：版本化发布（推荐用于版本固定）

使用方法

拉取镜像：

bash
docker pull prizz/opencode-cloud-sandbox:latest

运行容器：

bash
docker run --rm -it -p 3000:3000 prizz/opencode-cloud-sandbox:latest

opencode Web UI可通过 http://localhost:3000 访问。

应用平台配置

• 设置 http_port 为 3000，或提供 PORT/OPENCODE_PORT 环境变量，确保健康检查能访问正确端口
• 应用平台存储为临时存储，除非添加外部存储，否则工作区、配置和PAM用户在重新部署时会重置
• 日志无需额外配置即可在应用平台UI中查看
• 首次启动访问需提供 OPENCODE_BOOTSTRAP_USER，并配合 OPENCODE_BOOTSTRAP_PASSWORD 或 OPENCODE_BOOTSTRAP_PASSWORD_HASH
• 应用平台支持Linux/AMD64架构，优先选择较小镜像体积

安装opencode-cloud CLI

通过Cargo安装：

bash
cargo install opencode-cloud

通过NPM安装：

bash
npm install -g opencode-cloud

推荐启动服务：

bash
occ start

opencode构建与服务流程

Docker镜像直接从分支构建opencode，无需nginx直接运行Web服务器：

1. cd packages/opencode
2. bun run build 生成 packages/opencode/dist
3. 通过 ./bin/opencode web 启动服务器

源码信息

• 仓库：https://github.com/pRizz/opencode-cloud
• 镜像：[***]
• Dockerfile路径：packages/core/src/docker/Dockerfile

Dockerfile变更贡献

修改 packages/core/src/docker/Dockerfile 时，请遵循文件顶部的构建卫生规则和Dockerfile优化清单，具体参考：

• README.md
• packages/core/README.md