WebCode 一键部署指南
January 29, 2026 · View on GitHub
🚀 快速开始
只需一条命令即可完成部署：
docker-compose up -d
首次访问 http://localhost:5000 时，系统会自动引导您完成初始化配置。
📋 部署步骤
1. 克隆代码
git clone https://github.com/shuyu-labs/WebCode.git
cd WebCode
2. 启动服务
docker-compose up -d
3. 访问系统
打开浏览器访问：http://localhost:5000
4. 完成初始化向导
首次访问时，系统会自动跳转到初始化向导页面，您需要：
-
设置管理员账户
- 用户名和密码
- 是否启用登录认证
-
配置 Claude Code（可选）
- ANTHROPIC_API_KEY
- ANTHROPIC_BASE_URL（可选）
-
配置 Codex（可选）
- NEW_API_KEY
- CODEX_BASE_URL（可选）
🔧 高级配置
自定义端口
APP_PORT=8080 docker-compose up -d
使用 .env 文件
创建 .env 文件：
APP_PORT=5000
然后运行：
docker-compose up -d
📂 数据持久化
所有数据自动持久化到 Docker 卷：
| 卷名 | 用途 |
|---|---|
webcodecli-data | 数据库和配置 |
webcodecli-workspaces | 工作区文件 |
webcodecli-logs | 日志文件 |
🔄 常用命令
# 查看日志
docker-compose logs -f
# 重启服务
docker-compose restart
# 停止服务
docker-compose down
# 更新服务
git pull
docker-compose up -d --build
❓ 常见问题
Q: Docker 构建失败，提示 "failed to set up container networking" 或 "operation not supported"
这通常发生在某些 VPS 环境（如 OpenVZ 容器化环境）或嵌套 Docker 环境中。解决方案：
方案1：使用 host 网络模式构建（推荐）
# 直接使用 docker build 命令，指定 host 网络
docker build --network=host -t webcodecli:latest -f Dockerfile .
# 然后启动容器
docker-compose up -d
方案2：分步构建
# 先单独构建镜像
DOCKER_BUILDKIT=0 docker build --network=host -t webcodecli:latest .
# 再启动服务（跳过构建）
docker-compose up -d --no-build
方案3：如果仍然失败，尝试禁用 BuildKit
DOCKER_BUILDKIT=0 docker-compose build --no-cache
docker-compose up -d
Q: 如何修改 API 配置？
登录系统后，在主界面点击「设置」按钮，可以修改环境变量配置。
Q: 如何重置系统？
删除 Docker 卷后重新启动：
docker-compose down -v
docker-compose up -d
Q: 忘记管理员密码？
删除数据卷后重新初始化：
docker-compose down
docker volume rm webcode_webcodecli-data
docker-compose up -d