企业官网建设流程全解析

CPA-Codex-Manager 是一款专为 OpenAI 账号池设计的高性能管理面板，集成全自动批量注册与 CLIProxyAPI 账号池实时监控。本文带你用 Docker 完成 CPA-Codex-Manager Docker 部署，只需一条docker compose up -d命令，就能把账号池管理面板跑起来，全程无需手动配置 Python 环境。

为什么推荐用 Docker 部署？

用原生 Python 方式部署 CPA-Codex-Manager，你需要自己安装 Python 3.10+、安装一堆依赖包、再处理.env配置，新手很容易在环境这一步就卡住。

而 Docker 部署的优势非常直接：

• ✅环境零配置：镜像maoleio/cpa-codex-manager:latest已内置 Python 3.11 与全部依赖（见 Dockerfile）
• ✅一条命令启动：docker compose up -d后服务自动在 8000 端口运行
• ✅自动重启：restart: unless-stopped保证容器异常退出后自动拉起
• ✅数据本地持久化：data/和logs/目录挂载到宿主机，升级不丢数据

部署前准备工作

1. 安装 Docker

确保服务器已安装 Docker 与 Docker Compose 插件，执行以下命令验证：

docker --version docker compose version

两个命令都能输出版本号即表示环境就绪。

2. 准备项目目录

mkdir -p ~/CPA-Codex-Manager cd ~/CPA-Codex-Manager mkdir -p data logs

其中data/用于存放数据库文件，logs/用于存放运行日志，稍后会在 compose 文件中挂载到容器内。

3. 获取项目与 compose 文件

从 gitcode 克隆仓库：

git clone https://gitcode.com/gh_mirrors/cp/CPA-Codex-Manager

仓库根目录自带 docker-compose.yml，直接拿来用即可；也可以复制一份后按自己的需求修改。

docker-compose.yml 配置详解

一份最小可用的配置如下，字段全部有注释说明：

services: cpa-codex-manager: image: maoleio/cpa-codex-manager:latest container_name: cpa-codex-manager restart: unless-stopped ports: - "8000:8000" environment: WEBUI_HOST: 0.0.0.0 WEBUI_PORT: 8000 WEBUI_ACCESS_PASSWORD: your_secret_password APP_DATABASE_URL: data/database.db volumes: - ./data:/app/data - ./logs:/app/logs

各关键字段含义：

💡 默认密码为admin123，部署后第一件事就是改掉它。所有可通过环境变量注入的项也可以在 .env.example 中查到。

一条命令启动并验证面板

配置完成后，在项目目录执行：

docker compose up -d

看到容器状态为Up即启动成功。接下来打开浏览器访问：

http://localhost:8000

如果部署在远程服务器上，把localhost换成服务器局域网 IP 即可，例如http://192.168.1.100:8000，输入你设置的WEBUI_ACCESS_PASSWORD就能登录管理面板。

想看运行日志，执行：

docker compose logs -f

日志里会打印出本地访问与局域网访问地址，方便你确认服务是否正常监听。

进阶配置：切换到 PostgreSQL

默认使用容器内的 SQLite（data/database.db），小账号池完全够用。若你的 OpenAI 账号规模较大，建议切换为 PostgreSQL，只要修改一个环境变量：

environment: APP_DATABASE_URL: postgresql://user:password@host:5432/dbname

连接地址支持远程 PostgreSQL，连接池相关参数（如DB_POOL_SIZE、DB_MAX_OVERFLOW）参考 .env.example 即可按需设置，无需改动任何代码。

日常维护：升级镜像与数据备份

升级版本

镜像更新后执行两步，数据挂载在宿主机，不会丢失：

docker compose pull docker compose up -d

备份账号池数据

账号数据、注册任务与配置都保存在data/目录中，定期打包备份即可：

tar czf cpa-backup-$(date +%Y%m%d).tar.gz data/

常见问题排查

1. 端口被占用？把 compose 中的端口映射改为"8080:8000"，同时把WEBUI_PORT保持为8000，之后访问http://localhost:8080。

2. 浏览器打不开页面？先执行docker compose logs -f查看是否有报错；再确认云服务器安全组 / 防火墙已放行 8000 端口。

3. 忘记修改访问密码？修改 compose 中WEBUI_ACCESS_PASSWORD后执行docker compose up -d重建容器生效。

写在最后

至此，CPA-Codex-Manager 的 Docker 部署就完成了：准备目录 → 写好 docker-compose.yml → 执行docker compose up -d，三步即可拉起整个账号池管理面板。接下来登录面板，在系统设置页添加 CPA 服务，就可以体验全自动批量注册、账号巡检与智能补货这些核心功能了。