核心参考项目Wei-Shaw/sub2api GitHub 仓库部署说明参考Sub2API Docker 部署文档适用于Windows 11本地 AI 容器环境WSL2 UbuntuDocker DesktopCodex CLISub2API第一步开启 Windows WSL21.1 以管理员身份打开 PowerShell点击开始菜单搜索PowerShell右键以管理员身份运行1.2 安装 WSL2在管理员 PowerShell 输入wsl.exe --install如果已经安装过执行更新wsl.exe --update安装完成后系统会自动下载 Ubuntu重启电脑微软官方 WSL 文档Microsoft WSL 官方文档第二步初始化 Ubuntu电脑重启后Windows 会自动打开 Ubuntu 终端。第一次启动时会提示Enter new UNIX username:输入admin然后输入密码123456再次确认密码123456完成后进入 Ubuntu。第三步验证 WSL2 是否成功在 Ubuntu 或 PowerShell 输入wsl --list --verbose你应该看到NAME STATE VERSION Ubuntu Running 2如果 VERSION 显示为2说明 WSL2 安装成功。第四步安装 Docker Desktop打开 Docker 官网Docker Desktop 官网下载安装Docker Desktop for Windows4.1 Docker Desktop 设置安装完成后打开 Docker Desktop。进入Settings → Resources → WSL Integration开启Ubuntu然后点击Apply Restart第五步Ubuntu 安装基础环境进入 Ubuntuwsl更新系统sudo apt update sudo apt upgrade -y输入密码123456安装常用工具sudo apt install -y git curl wget unzip nano第六步安装 Node.js推荐安装 Node.js 20curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -然后sudo apt install -y nodejs验证node -v npm -v第七步安装 Codex CLI打开 OpenAI Codex 官方页面OpenAI Codex在 Ubuntu 安装npm install -g openai/codex验证codex --version登录codex login浏览器会自动授权。第八步安装 Git 并克隆 Sub2API进入 Ubuntucd ~克隆项目git clone https://github.com/Wei-Shaw/sub2api.git进入目录cd sub2api项目地址Sub2API GitHub 仓库第九步使用 Docker 部署 Sub2API推荐官方推荐 Docker Compose 部署。 (GitHub)进入部署目录cd deploy执行官方一键部署脚本curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/docker-deploy.sh | bash该脚本会自动下载 docker-compose 配置创建.env自动生成密钥创建数据库目录创建 Redis 目录官方文档说明(GitHub)第十步启动本地容器启动容器docker compose -f docker-compose.local.yml up -d查看运行状态docker ps查看日志docker compose -f docker-compose.local.yml logs -f sub2api第十一步查看管理员密码如果没有手动设置管理员密码执行docker compose -f docker-compose.local.yml logs sub2api | grep admin password系统会自动生成管理员密码。 (GitHub)第十二步打开 Web 管理后台浏览器打开这个地方建议端口号改成其他的例如8787防止和本地项目冲突http://localhost:8080默认管理员邮箱adminsub2api.local密码你设置的密码或日志里自动生成的密码第十三步常用 Docker 命令查看容器docker ps查看日志docker compose -f docker-compose.local.yml logs -f停止容器docker compose -f docker-compose.local.yml down重启容器docker compose -f docker-compose.local.yml restart第十四步Windows 中进入 Ubuntu以后每次进入 UbuntuWindows 搜索Ubuntu或者 PowerShell 输入wsl第十五步确认 Docker 与 WSL2 联动成功Ubuntu 输入docker version如果能看到Client: Server:说明Docker DesktopWSL2Ubuntu已经成功联动。第十六步推荐目录结构建议/home/admin/projects/例如mkdir -p ~/projects cd ~/projects以后Git 项目Docker 项目Codex 项目都放这里。第十七步推荐开发流程推荐顺序Windows 11 ↓ WSL2 ↓ Ubuntu ↓ Docker Desktop ↓ Codex CLI ↓ Sub2API这是目前 Windows 本地 AI 开发最稳定方案。第十八步常见问题1. Docker 无法连接重启Docker Desktop然后docker ps2. WSL 无法启动PowerShell 管理员执行wsl --shutdown然后wsl3. 端口占用修改nano .env修改SERVER_PORT8081然后重启docker compose down docker compose up -d第十九步推荐学习内容建议学习DockerLinuxWSL2GitDocker ComposeAI API GatewayCodex CLI官方参考资料Sub2API GitHub 仓库Sub2API Docker 部署文档Sub2API 中文说明Docker Desktop 官网Microsoft WSL 官方文档OpenAI Codex