codex-console数据管理完全指南：5种账号导出格式与数据库备份、导入、清理全解

codex-console数据管理完全指南：5种账号导出格式与数据库备份、导入、清理全解

【免费下载链接】codex-consolecodex-console 是一个集成化控制台项目，支持任务管理、批量处理、数据导出、自动上传、日志查看与打包支持。项目地址: https://gitcode.com/gh_mirrors/co/codex-console

codex-console是一款集任务管理、批量处理、数据导出、自动上传与日志查看于一体的集成化控制台。本文用最少的篇幅讲清楚它最重要的数据管理能力：5 种账号导出格式（JSON / CSV / Codex / CPA / Sub2Api）、账号一键导入，以及数据库备份、导入、清理三大操作，帮助新手快速掌握账号数据的完整生命周期。

📤 一、账号导出：5种格式怎么选

在账号页面的工具栏中点击📥 导出，会弹出 5 个格式选项，入口位于 templates/accounts.html，前端统一调用/api/accounts/export/{格式}接口，后端实现在 src/web/routes/accounts.py。

所有导出都支持四种圈定范围（见 BatchExportRequest）：

• ✅ 勾选的指定账号
• ✅ 全选
• ✅ 按状态筛选（如仅导出 active）
• ✅ 按邮箱服务 / 关键词搜索筛选

1️⃣ JSON：全量备份格式

导出 15 个字段：邮箱、密码、client_id、各类 Token（access / refresh / id / session）、邮箱服务、注册时间等，是字段最全的格式（见 export_accounts_json）。

💡建议：定期用 JSON 格式做账号快照备份，出问题时可随时导回。

2️⃣ CSV：表格友好格式

带表头导出，15 列与 JSON 一一对应，可直接打开做统计和筛选（见 export_accounts_csv）。

3️⃣ Codex：逐行 JSONL 格式

每行一个账号的独立 JSON 对象（type: codex），包含 cookies 与 source 字段，方便逐行追加、批量处理和跨工具流转（见 export_accounts_codex）。

4️⃣ CPA：单账号 JSON / 多账号 ZIP

• 导出1 个账号：直接返回{邮箱}.json
• 导出多个账号：每个账号一个 JSON 文件，自动压缩为 ZIP 包下载

实现见 export_accounts_cpa。

5️⃣ Sub2Api：网关直连格式

把所有选中账号合并进一个 JSON 的accounts数组，自动填充platform: openai、type: oauth、模型映射、并发与限流参数，下载后导入 Sub2Api 即可使用（见 export_accounts_sub2api）。

📥 二、账号一键导入

导出不是终点。codex-console 提供 POST /import 接口，在账号总览页可把任意 JSON 账号列表一次性导入，特性包括：

• 🔢 单次最多1000 条，超限直接拒绝
• 🧠智能识别：能从 access / id token 中自动解析account_id、workspace_id、client_id和订阅类型
• 🔄同邮箱冲突处理：可选择跳过（skip）或覆盖（overwrite）已有账号
• 📋 返回created / updated / skipped / failed明细及逐条错误原因，导入结果一目了然

💡 导入前建议先用「JSON 导出」做一份快照，形成"备份 → 导入"的安全闭环。

💾 三、数据库备份：一键快照

在设置 → 💾 数据库标签页（templates/settings.html）点击💾 备份数据库按钮即可。

工作原理（src/web/routes/settings.py）：

1. 定位当前 SQLite 数据库文件
2. 在同级backups/目录生成database_backup_时间戳.db副本
3. 返回备份文件路径

整个过程就是"复制一份带时间戳的完整快照"，不影响正在运行的服务，可高频执行。

⚠️ 备份文件包含全部账号 Token 与密码，请妥善保管，切勿外传。

🗂️ 四、数据库导入：自动备份 + 覆盖恢复

当需要把某台机器的数据恢复到本机（或回滚到某个快照）时，使用数据库导入：

1. 上传.db / .sqlite / .sqlite3文件
2. 系统先落盘临时文件并校验 SQLite 文件头，防止脏文件写入
3. 自动备份当前库为database_backup_before_import_时间戳.db
4. 释放数据库连接、清理 WAL/SHM 附属文件，再原子替换（import_database）

由于"导入前自动备份"，即使选错文件也能通过备份目录里的快照找回，这是它比手动替换文件安全得多的原因。

🧹 五、数据清理：定期瘦身

数据库用久了会积累大量历史记录，codex-console 提供两类清理：

1. 任务记录清理— POST /database/cleanup

• 删除 N 天前（默认 30 天）的过期注册任务记录
• 默认保留failed失败记录便于排查；取消勾选可连失败记录一起删除
• 返回实际删除条数

2. 日志清理— POST /logs/cleanup，调用 cleanup_database_logs 清理历史日志表，保持后台日志页轻量。

💡 建议节奏：每周一键备份 → 每月清理一次 30 天前任务与日志。

🛡️ 六、数据安全清单

小结：codex-console 的数据管理链路非常完整——5 种格式导出覆盖备份、表格、网关、CPA 等全部场景，一键导入带冲突处理与错误明细，数据库备份 / 导入自带自动备份兜底，清理功能让库容长期健康。掌握本文的"备份 → 导出 → 导入 → 清理"四步闭环，你的账号数据就能随时迁移、随时恢复、随时瘦身。

【免费下载链接】codex-consolecodex-console 是一个集成化控制台项目，支持任务管理、批量处理、数据导出、自动上传、日志查看与打包支持。项目地址: https://gitcode.com/gh_mirrors/co/codex-console