kangarap/opencode

opencode 镜像文档

概述

opencode镜像（kangarap/opencode:1.2.27）是一个轻量级代码开发协作环境，通过Web界面提供服务。支持端口映射、环境变量自定义配置及数据持久化，可快速部署独立或团队共享的开发环境，确保开发过程的一致性和数据可靠性。

核心功能与特性

• Web服务访问：默认通过4096端口提供Web界面，支持本地或网络访问
• 灵活配置：通过环境变量自定义主机名、端口、CORS策略、日志级别等参数
• 数据持久化：使用命名卷保存配置、数据、状态及缓存，确保服务重启后数据不丢失
• 工作区挂载：支持本地目录挂载到容器工作区，方便代码文件管理与同步

使用场景

• 本地开发环境：快速搭建隔离的开发环境，避免项目依赖冲突
• 团队协作：提供统一配置的开发环境，确保团队成员开发环境一致性
• 临时测试环境：快速部署临时开发空间，用于代码测试或演示

使用方法

Docker Run 命令示例

bash
docker run -d \
  --name opencode \
  --restart unless-stopped \
  -p 4096:4096 \
  -e OPENCODE_HOSTNAME=0.0.0.0 \
  -e OPENCODE_PORT=4096 \
  -v ./workspace/xxxx:/workspace/xxxx \
  -v opencode-config:/root/.config/opencode \
  -v opencode-data:/root/.local/share/opencode \
  -v opencode-state:/root/.local/state/opencode \
  -v opencode-cache:/root/.cache/opencode \
  kangarap/opencode:1.2.27

Docker Compose 配置示例

yaml
services:
  opencode:
    image: kangarap/opencode:1.2.27
    container_name: opencode
    restart: unless-stopped
    ports:
      - '4096:4096'
    environment:
      OPENCODE_HOSTNAME: '0.0.0.0'
      OPENCODE_PORT: '4096'
      # OPENCODE_MDNS: 'true'           # 启用mDNS服务（默认未启用）
      # OPENCODE_MDNS_DOMAIN: 'myproject.local'  # mDNS域名（启用mDNS时生效）
      # OPENCODE_CORS: 'https://example.com,https://foo.example'  # 允许的CORS源（多个用逗号分隔）
      # OPENCODE_LOG_LEVEL: 'INFO'      # 日志级别（可选：DEBUG, INFO, WARN, ERROR，默认INFO）
      # OPENCODE_PRINT_LOGS: 'true'     # 是否打印日志到控制台（默认true）
    volumes:
      - ./workspace/xxxx:/workspace/xxxx  # 本地工作区目录挂载
      - opencode-config:/root/.config/opencode  # 配置文件持久化
      - opencode-data:/root/.local/share/opencode  # 应用数据持久化
      - opencode-state:/root/.local/state/opencode  # 状态数据持久化
      - opencode-cache:/root/.cache/opencode  # 缓存数据持久化

volumes:
  opencode-config:
  opencode-data:
  opencode-state:
  opencode-cache:

环境变量说明

卷挂载说明

• 工作区挂载：./workspace/xxxx:/workspace/xxxx - 本地代码目录与容器工作区同步，支持代码读写
• 配置卷：opencode-config - 存储应用配置文件，确保配置持久化
• 数据卷：opencode-data - 存储应用核心数据，如项目信息、用户数据等
• 状态卷：opencode-state - 存储应用运行状态信息
• 缓存卷：opencode-cache - 存储临时缓存数据，提升应用性能