# opencode_web

**Repository Path**: wiseai/opencode_web

## Basic Information

- **Project Name**: opencode_web
- **Description**: 使用docker创建web的opencode
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-11
- **Last Updated**: 2026-03-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenCode AI Docker

在 Docker 容器中运行 OpenCode AI 服务的配置。

## 环境变量

| 变量 | 默认值 | 说明 |
|------|--------|------|
| OC_USER_NAME | code | 用户名 |
| OC_UID | 1000 | 用户 ID |
| OC_GID | 1000 | 用户组 ID |
| OC_PORT | 6666 | 端口 |
| OC_DATA_DIR | ./data | 数据目录（挂载到容器内） |
| NODE_FILE | - | Node.js 安装包路径（自动查找） |
| GO_FILE | - | Go 安装包路径（自动查找） |
| OC_OPENCODE_SERVER_USERNAME | - | Web 服务用户名（可选） |
| OC_OPENCODE_SERVER_PASSWORD | - | Web 服务密码（可选） |

## 快速开始

### 方式一：使用 run.sh 脚本（推荐）

脚本会自动查找安装包并完成构建、启动：

```bash
# 确保目录下有 node-*.tar.xz 和 go*.tar.gz 文件
# 可选：创建 .env 文件配置环境变量
./run.sh
```

### 方式二：手动运行

```bash
# 默认构建运行
docker compose up -d

# 指定端口
OC_PORT=8080 docker compose up -d

# 指定用户
OC_USER_NAME=myuser OC_UID=1001 OC_GID=1001 docker compose up -d

# 设置 Web 服务认证
OC_OPENCODE_SERVER_USERNAME=user OC_OPENCODE_SERVER_PASSWORD=pass docker compose up -d

# 重新构建（不使用缓存）
docker compose build --no-cache && docker compose up -d
```

## 常用命令

```bash
# 构建镜像
docker compose build

# 启动容器
docker compose up -d

# 停止容器
docker compose down

# 查看日志
docker compose logs -f

# 查看运行中的容器
docker ps

# 检查容器详情
docker inspect opencode-ai

# 清理未使用的镜像
docker image prune -f
```

## 调试

```bash
# 进入容器 Shell
docker exec -it opencode-ai /bin/bash

# 查看容器资源使用
docker stats opencode-ai

# 查看容器进程
docker top opencode-ai

# 检查容器网络配置
docker inspect opencode-ai --format='{{json .NetworkSettings}}'
```

## 访问服务

启动后访问：`http://localhost:6666`

### .env 配置文件

复制 `.env.example` 为 `.env` 并修改配置：

```bash
cp .env.example .env
# 编辑 .env 文件
```

或手动创建 `.env`：

```bash
OC_USER_NAME=code
OC_UID=1000
OC_GID=1000
OC_PORT=6666
OC_DATA_DIR=./data
OC_OPENCODE_SERVER_USERNAME=
OC_OPENCODE_SERVER_PASSWORD=
```

## 故障排除

- 容器启动失败：使用 `docker compose logs` 查看日志
- 端口被占用：修改 OC_PORT 环境变量
- 权限问题：检查 UID/GID 是否与主机用户匹配
- 卷挂载问题：检查主机目录权限