sprisa/opencode

sprisa/opencode

https://img.shields.io/docker/pulls/sprisa/opencode](https://hub.docker.com/r/sprisa/opencode) https://img.shields.io/docker/image-size/sprisa/opencode](https://hub.docker.com/r/sprisa/opencode) https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/opencode-server](https://artifacthub.io/packages/search?repo=opencode-server)

这是一个基于Ubuntu的通用Docker镜像，用于运行https://github.com/anomalyco/opencode%E3%80%82%E9%95%9C%E5%83%8F%E5%8F%91%E5%B8%83%E5%88%B0Docker Hub的标签格式为sprisa/opencode:<version>，其中<version>与version.txt中固定的版本一致。

镜像内容

懒加载工具

以下工具在首次使用时会自动安装（通过mise → github/zerobrew）：

镜像在/etc/mise/config.toml中提供系统级配置，包含预批准的工具。用户可通过创建~/.config/mise/config.toml添加或覆盖工具，mise会合并两者的配置。

使用方法

快速启动

bash
docker run -it -p 4096:4096 -v $(pwd):/home/opencode docker.xuanyuan.run/sprisa/opencode:latest

服务器将在4096端口启动。将项目挂载到/home/opencode可持久化整个主目录（包括 dotfiles、配置和~/workspace）。

环境变量

示例

带认证的启动：

bash
docker run -it -p 4096:4096 \
  -e OPENCODE_SERVER_PASSWORD=secret \
  -v myproject:/home/opencode \
  docker.xuanyuan.run/sprisa/opencode:latest

启用特定源的CORS：

bash
docker run -it -p 4096:4096 \
  -e OPENCODE_CORS_ORIGIN=https://myapp.example.com \
  docker.xuanyuan.run/sprisa/opencode:latest

自定义端口：

bash
docker run -it -p 8080:8080 \
  -e OPENCODE_PORT=8080 \
  docker.xuanyuan.run/sprisa/opencode:latest

构建与推送

所有Docker命令通过task执行，它会读取version.txt中固定的版本：

bash
task docker:build                          # 本地构建为sprisa/opencode:<version>
task docker:login                          # Docker Hub登录（需设置$DOCKER_USER / $DOCKER_PASS）
task docker:push                           # 推送+latest和+<version>标签（支持amd64/arm64架构）
task publish                               # 推送镜像并创建带自动生成说明的GitHub Release

更新opencode版本

bash
task update

从GitHub上的https://github.com/anomalyco/opencode%E8%8E%B7%E5%8F%96%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC%E5%B9%B6%E5%86%99%E5%85%A5%60version.txt%60%E3%80%82

运行时注意事项

• opencode用户拥有无需密码的sudo权限，可在容器内执行su - opencode -c 'apt install <pkg>'安装软件包。
• 根文件系统是临时的；挂载/home/opencode作为持久化卷以保存所有用户数据（dotfiles、配置、项目）。~/workspace是默认工作目录。
• ~/.local/bin已加入PATH且可由用户写入，适合在运行时放置自定义工具。
• 可通过n <version>（如n lts）在运行时切换Node版本。
• Homebrew安装在/home/linuxbrew/.linuxbrew（位于持久化卷之外），使用自带的便携Ruby，无需系统Ruby。
• Zerobrew（zb）安装在/usr/local/bin/zb，其前缀路径~/.local/share/zerobrew/prefix已加入PATH，用于访问公式二进制文件。
• 懒加载工具（见上文表格）：运行任何列出的工具时，mise会通过zerobrew或github后端自动安装。镜像在/etc/mise/config.toml中提供默认配置；创建~/.config/mise/config.toml可添加自定义工具，mise会合并两者。

---

生产环境使用地址：[***]