本文为 codex-console v1.1.2 架构增强版官方首发完整教程，全程零基础可上手，所有命令可直接复制粘贴，涵盖环境准备、部署实操、新功能落地、常见坑点排查，兼顾新手部署、批量挂机、二次开发需求，严格对标参考格式，确保每一步都可落地、无遗漏。

⚠️ 重要声明（必读）

1. 免费开源原则

本项目永久免费开源，任何付费版本均为倒卖行为！

• ❌ 禁止倒卖：严禁倒卖本项目及相关衍生版本
• ❌ 禁止付费：任何人向你收费提供本工具，请立即退款并举报
• ✅ 允许学习：允许学习、研究、二次开发
• ✅ 允许分享：允许分享给有需要的朋友

2. 合法使用提醒

• 请遵守 OpenAI 相关服务条款
• 严禁用于违规、滥用或非法用途
• 仅供学习、研究和技术交流使用
• 因使用本项目产生的风险和后果由使用者自行承担

3. 使用建议

• 新手建议：先用小号测试，熟悉流程后再批量操作
• 时段选择：避开北京时间 14:00 左右（美国午夜，封号高峰）
• 批量控制：建议每批 10-50 个，不要一次性注册太多
• 数据备份：定期导出账号数据，防止丢失

🎯 v1.1.2 版本更新内容（核心必看）

新增功能（6 项）

功能优化（5 项）

BUG 修复（4 项）

🖥️ 环境准备（按步骤操作）

第一步：确认操作系统

本教程支持以下操作系统：

查看系统版本命令：

# Windows（PowerShell）
systeminfo | findstr /B /C:"OS Name" /C:"OS Version"

# macOS
sw_vers

# Linux
cat /etc/os-release

第二步：安装 Python（3.10+）

Windows 安装 Python

下载 Python

• 访问官网：https://www.python.org/downloads/
• 下载 Python 3.10 或更高版本（推荐 3.11/3.12）
• 选择 “Windows installer (64-bit)”

安装 Python

• 双击安装包
• ⚠️ 重要：勾选 “Add Python to PATH”
• 点击 “Install Now”

验证安装

# 打开命令提示符（Win+R → cmd）
python --version
# 应显示：Python 3.10.x 或更高

macOS 安装 Python

# 使用 Homebrew（推荐）
brew install python@3.11

# 验证安装
python3 --version

Linux 安装 Python

# Ubuntu/Debian
sudo apt update
sudo apt install python3.11 python3.11-venv python3-pip

# CentOS/RHEL
sudo yum install python3.11 python3-pip

# 验证安装
python3 --version

第三步：安装 Git

Windows 安装 Git

• 下载：https://git-scm.com/download/win
• 双击安装，使用默认选项即可

验证：

git --version

macOS 安装 Git

# 使用 Homebrew
brew install git

# 或使用 Xcode 命令行工具
xcode-select --install

Linux 安装 Git

# Ubuntu/Debian
sudo apt install git

# CentOS/RHEL
sudo yum install git

# 验证
git --version

第四步：准备代理环境（重要）

由于 OpenAI 服务限制，你需要准备可用的代理：

代理要求：

• 支持 HTTPS
• 稳定性好（推荐付费代理）
• 延迟低于 300ms
• 支持并发连接

常见代理配置：

# 本地代理示例（Clash）
HTTP 代理：http://127.0.0.1:7890
HTTPS 代理：http://127.0.0.1:7890

# 环境变量设置（临时）
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

# Windows PowerShell
$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"

代理测试命令：

# 测试代理是否可用
curl -x http://127.0.0.1:7890 https://www.google.com -I
# 返回 HTTP/2 200 表示正常

📦 安装部署（5 种方式任选）

方式一：源码安装（推荐新手）

步骤 1：克隆项目

# 选择安装目录（Windows 示例：D:\tools\codex-console）
cd /tmp  # Linux/Mac

# 克隆项目
git clone https://github.com/dou-jiang/codex-console.git

# 进入项目目录
cd codex-console

# 查看项目结构
ls -la

预期输出：

drwxr-xr-x  9 root   4096 Mar 26 09:10 .
drwxrwxrwt 26 root   4096 Mar 26 09:10 ..
-rw-r--r--  1 root   1461 Mar 26 09:10 build.bat
-rw-r--r--  1 root   1185 Mar 26 09:10 build.sh
-rw-r--r--  1 root    647 Mar 26 09:10 docker-compose.yml
-rw-r--r--  1 root   8278 Mar 26 09:10 README.md
-rw-r--r--  1 root    303 Mar 26 09:10 requirements.txt
drwxr-xr-x  7 root   4096 Mar 26 09:10 src
drwxr-xr-x  4 root   4096 Mar 26 09:10 static
drwxr-xr-x  3 root   4096 Mar 26 09:10 templates
-rw-r--r--  1 root   5992 Mar 26 09:10 webui.py

步骤 2：创建虚拟环境（强烈推荐）

为什么使用虚拟环境：

• 避免污染系统 Python 环境
• 方便管理依赖包
• 便于迁移和部署

# Python 3.10+ 内置 venv 模块
python -m venv .venv

# 激活虚拟环境
# Windows (CMD):
.venv\Scripts\activate

# Windows (PowerShell):
.venv\Scripts\Activate.ps1

# Linux/Mac:
source .venv/bin/activate

激活成功后，命令行前会出现 (.venv) 标识：

(.venv) user@host:~/codex-console$

步骤 3：安装依赖

# 方式 1：使用 pip（通用）
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

# 方式 2：使用 uv（更快，推荐）
# 先安装 uv
pip install uv

# 使用 uv 安装依赖
uv pip install -r requirements.txt

依赖列表（requirements.txt）：

certifi>=2024.0.0
cffi>=1.16.0
curl_cffi>=0.14.0
pycparser>=1.21
pydantic>=2.0.0
pydantic-settings>=2.0.0
fastapi>=0.100.0
uvicorn[standard]>=0.23.0
jinja2>=3.1.0
python-multipart>=0.0.6
sqlalchemy>=2.0.0
aiosqlite>=0.19.0
psycopg[binary]>=3.1.18
playwright>=1.40.0  # 自动绑卡依赖

安装时间：约 2-5 分钟（取决于网络）

验证安装：

pip list | grep -E "(fastapi|uvicorn|playwright)"

步骤 4：安装 Playwright 浏览器（可选）

如需使用自动绑卡功能，需要安装 Playwright 浏览器：

# 安装浏览器
playwright install

# 安装系统依赖（Linux）
playwright install-deps

注意：这一步可能需要较长时间（10-20 分钟），如果暂时不需要绑卡功能可以跳过。

步骤 5：配置文件

# 复制环境变量模板
cp .env.example .env

# 编辑配置文件（选择你熟悉的编辑器）
# Windows: 用记事本打开 .env
# Linux/Mac: nano .env 或 vim .env

.env 配置示例：

# ── Web UI 监听地址 ──────────────────────────────────────────
# 监听主机（默认 0.0.0.0，允许外部访问）
APP_HOST=0.0.0.0

# 监听端口（默认 8000，可自定义）
APP_PORT=8000

# Web UI 访问密码（⚠️ 强烈建议修改！）
APP_ACCESS_PASSWORD=your_strong_password_here

# ── 数据库 ───────────────────────────────────────────────────
# 本地 SQLite（默认，新手推荐）
APP_DATABASE_URL=data/database.db

# 远程 PostgreSQL（高级用户）
# APP_DATABASE_URL=postgresql://user:password@host:5432/dbname

# ── 代理配置（重要）
# HTTP_PROXY=http://127.0.0.1:7890
# HTTPS_PROXY=http://127.0.0.1:7890

# ── 第三方自动绑卡（可选）
# BIND_CARD_API_URL=https://your-workers-domain.dev/
# BIND_CARD_API_KEY=your_api_key_here

⚠️ 安全提醒：

• 务必修改 APP\_ACCESS\_PASSWORD 默认值
• 不要将 .env 文件上传到公开仓库
• 生产环境建议使用强密码（16 位以上，包含大小写、数字、符号）

步骤 6：启动服务

# 方式 1：默认启动（127.0.0.1:8000）
python webui.py

# 方式 2：指定主机和端口（允许外部访问）
python webui.py --host 0.0.0.0 --port 8000

# 方式 3：设置访问密码
python webui.py --access-password your_password

# 方式 4：组合参数（推荐）
python webui.py --host 0.0.0.0 --port 8000 --access-password your_password

# 方式 5：调试模式（开发使用）
python webui.py --debug

启动成功标志：

INFO:     Started server process [12345]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)

访问 WebUI：

• 本地访问：http://127.0.0.1:8000
• 远程访问：http://你的服务器 IP:8000
• 默认密码：admin123（如未在 .env 中修改）

方式二：Docker 部署（推荐生产环境）

前置要求

• 已安装 Docker 和 Docker Compose
• Docker 版本：20.10+
• Docker Compose 版本：2.0+

安装 Docker：

# Ubuntu/Debian
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo systemctl enable docker
sudo systemctl start docker

# 验证安装
docker --version
docker compose version

使用 Docker Compose（推荐）

# 克隆项目
git clone https://github.com/dou-jiang/codex-console.git
cd codex-console

# 启动服务
docker compose up -d

# 查看日志
docker compose logs -f

# 停止服务
docker compose down

访问服务：

• WebUI: http://你的服务器 IP:1455
• noVNC（绑卡可视化）: http://你的服务器 IP:6080

🔧 常见问题解答

一、安装问题

Q1: pip install 报错 “Could not find a version that satisfies the requirement”

解决：

# 升级 pip
python -m pip install --upgrade pip

# 使用国内镜像
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

Q2: 虚拟环境激活失败

Windows PowerShell 执行策略问题：

# 临时允许执行脚本
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# 重新激活
.venv\Scripts\Activate.ps1

二、启动问题

Q1: 端口被占用

Error: [Errno 98] Address already in use

解决：

# 方式 1：更换端口
python webui.py --port 8080  # 示例更换为8080端口，可自定义其他未占用端口

💖 赞赏支持

❤️ 写教程不易，如果对您有帮助，可以赞赏一下吗？ ❤️

您的支持是我持续更新的最大动力！

微信

支付宝

🎉 感谢您的支持！