开源的AI编码代理OpenCode
和之前 在Instantbox中安装OpenCode 在别的容器中安装 OpenCode 不同，本次使用的是官方原生的 Docker 镜像
简介
什么是 OpenCode？
OpenCode是一个开源的 AI 编码代理（AI Coding Agent），通过大语言模型（LLM）自动化编程任务，从任务理解、代码生成到执行测试和自我修正，形成闭环。它支持终端、桌面应用和IDE集成，让开发者用自然语言描述需求，代理就能独立完成编码工作。
主要特点
- 完全开源：采用
MIT许可证，您可以自由使用、修改和分发。 - 模型无锁定：您可以灵活配置并使用任何您喜欢的
AI模型，无论是云端API还是本地模型。 - 多种代理模式：
build代理：拥有完全的系统访问权限，专为编码、调试和测试等开发工作设计。plan代理：只读模式，用于安全地分析和探索代码库，执行敏感操作前会请求许可。
- 多样的使用方式：支持交互式命令行（
CLI）、Web浏览器界面，甚至还有跨平台的桌面应用。 - 客户端/服务器架构：允许您将核心服务部署在远程服务器上，然后在本地通过客户端连接进行远程开发。
应用场景
- 日常软件开发：使用
build代理进行编码、调试、编写测试。 - 学习新项目：使用
plan代理安全地分析和理解一个陌生的代码库。 - 项目规划与重构：在进行大型重构前，进行分析和计划制定。
- 远程开发：将
OpenCode服务部署在云服务器上，随时随地在本地进行高效编程。
OpenCode 不受任何特定 AI 模型供应商的限制，允许您自由选择使用 Claude、OpenAI、Google 或是本地部署的 AI 模型。注重终端体验，但同样提供了 Web 界面和桌面应用，以满足不同开发者的使用偏好。
安装
OpenCode 提供了多种灵活的部署方式，以下我们重点介绍在群晖上通过 Docker 安装与运行的两种模式。
本文写作时，latest版本对应为1.2.15；
1. 命令行 (CLI) 交互模式
这种方式非常适合快速、一次性的交互任务。它会在您退出后自动清理容器，不留下任何残留。
打开您的终端，执行以下命令：
docker run -it--rm ghcr.io/anomalyco/opencode:latest 命令说明：
-it: 启动交互模式，允许您与容器内的OpenCode进程进行实时对话。--rm: 容器停止后自动删除，保持系统整洁。ghcr.io/anomalyco/opencode:OpenCode的官方 Docker 镜像。- 对于 CLI 模式，执行命令后直接在终端中即可开始与
OpenCode交互
2. 网页 (Web) 服务模式
这种方式会将 OpenCode 作为一个后台服务长期运行，并提供一个 Web 界面供您随时访问。非常适合部署在个人服务器或群晖 NAS 上。
第一步：准备目录
# 新建文件夹 opencode 和数据子目录mkdir-p /volume1/docker/opencode/{data,workspace}# 进入 opencode 目录cd /volume1/docker/opencode 注意：/volume1/docker/opencode/data 是示例路径，您可以根据自己的实际情况修改。第二步：运行容器
# 运行容器docker run -d\--restart unless-stopped \--name opencode \-p4096:4096 \-v$(pwd)/data:/home/opencode \-v$(pwd)/workspace:/home/opencode/workspace \-eHOME=/home/opencode \ ghcr.io/anomalyco/opencode:latest \ web --hostname0.0.0.0 --port4096# 带自定义账号密码docker run -d\--restart unless-stopped \--name opencode \-p4096:4096 \-v$(pwd)/data:/home/opencode \-v$(pwd)/workspace:/home/opencode/workspace \-eHOME=/home/opencode \-eOPENCODE_SERVER_USERNAME=laosu \-eOPENCODE_SERVER_PASSWORD=123456\ ghcr.io/anomalyco/opencode:latest \ web --hostname0.0.0.0 --port4096参数说明：
- 端口 (
-p)- 本地端口
4096映射到容器的4096端口。
- 本地端口
- 卷 (
-v)- 将当前目录下的
data文件夹（即您刚创建的/volume1/docker/opencode/data）挂载到容器的/home/opencode目录，用于持久化存储OpenCode的数据。 - 将当前目录下的
workspace文件夹，挂载到容器的/home/opencode/workspace目录，作为项目文件夹。
- 将当前目录下的
- 环境变量 (
-e)HOME=/home/opencode: 设置容器内的主目录。OPENCODE_SERVER_USERNAME=laosu：设置自定义用户名，默认用户为opencode。OPENCODE_SERVER_PASSWORD=123456：添加强密码的保护。
- 容器执行命令
web --hostname 0.0.0.0 --port 4096: 这部分是容器启动后执行的命令，意为以Web模式启动，并监听在所有网络接口的4096端口上。
运行
- 对于 Web 模式，执行命令后，在浏览器中输入
http://群晖IP:4096即可看到OpenCode的网页界面。
如果设置了自定义账号密码，则需要先登录
用来跑代码还是不错的
手机上也能看到对话
参考文档
anomalyco/opencode: The open source coding agent.
地址：https://github.com/anomalyco/opencode/
OpenCode | 开源 AI 编程代理
地址：https://opencode.ai/
Package opencode
地址：https://ghcr.io/anomalyco/opencode
