CodexManager 环境变量配置清单CODEXMANAGER_* 参数完整列表建议收藏【免费下载链接】Codex-Manager一个Codex cli 账号管理与切换工具。为 Codex cli提供本地网关转发。项目地址: https://gitcode.com/gh_mirrors/co/Codex-ManagerCodexManager 是一个 Codex CLI 账号管理与切换工具可为 Codex CLI 提供本地网关转发。本文整理了它的CODEXMANAGER_环境变量配置清单*涵盖监听地址、上游代理、超时控制、SSE 保活、数据库与鉴权等常用参数并说明 env 文件的存放位置与生效优先级帮助新手快速完成 CodexManager 本地网关配置。第一步env 文件放在哪里才生效CodexManager 会按以下顺序在可执行文件同目录查找环境文件命中一个即停止codexmanager.env推荐统一使用CodexManager.env.env 桌面端把 env 文件放在CodexManager.exe旁边Service 版codexmanager-start/codexmanager-service/codexmanager-web放在对应可执行文件旁边。一个典型的 Service 版目录结构codexmanager-service-bundle/ ├─ codexmanager-start.exe ├─ codexmanager-service.exe ├─ codexmanager-web.exe ├─ codexmanager.env └─ web/完整规则可参考官方文档环境变量与运行配置说明.md。配置优先级谁覆盖了谁配置来源共四层实际生效优先级从高到低优先级来源说明1️⃣系统环境变量 / 启动命令进程启动前已存在的变量2️⃣env 文件只注入进程尚未定义的变量3️⃣设置页持久化envOverrides只补齐进程中没有的变量不覆盖 env4️⃣代码默认值兜底值⚠️ 两个注意点bootstrap 级变量如CODEXMANAGER_DB_PATH、CODEXMANAGER_RPC_TOKEN、CODEXMANAGER_RPC_TOKEN_FILE必须在进程启动前准备好启动后再补无效。支持热更新的配置修改后立即 reload但同名 env 已存在时优先沿用 env。CODEXMANAGER_* 参数分组速查表地址与入口参数作用默认值CODEXMANAGER_SERVICE_ADDRservice 监听地址localhost:48760CODEXMANAGER_WEB_ADDRweb 管理页地址localhost:48761CODEXMANAGER_WEB_ROOTweb 静态资源目录—CODEXMANAGER_LOGIN_ADDR本地 OAuth 回调监听地址—CODEXMANAGER_WEB_NO_OPEN启动时不自动打开浏览器0CODEXMANAGER_WEB_NO_SPAWN_SERVICE不自动拉起 service 进程0TZDocker 容器时区IANA 格式Asia/Shanghai网关与上游代理最常用参数作用默认值CODEXMANAGER_UPSTREAM_BASE_URL上游平台 Base URLhttps://chatgpt.com/backend-api/codexCODEXMANAGER_UPSTREAM_PROXY_URL全局上游代理统一走一个出口—CODEXMANAGER_PROXY_LIST代理池适合按账号稳定分流多个出口—CODEXMANAGER_UPSTREAM_PROXY_BYPASS_HOSTS代理 Bypass 域名一行一个支持*.example.com—CODEXMANAGER_UPSTREAM_TOTAL_TIMEOUT_MS网关请求总超时毫秒0表示不按总时长截断0CODEXMANAGER_UPSTREAM_STREAM_TIMEOUT_MS流式空闲超时毫秒—CODEXMANAGER_HTTP_TIMEOUT_MS普通 HTTP 请求总超时毫秒120000CODEXMANAGER_ROUTE_STRATEGY路由策略— 代理二选一同时设置UPSTREAM_PROXY_URL和PROXY_LIST时单个上游代理优先代理池会被旁路。SSE 保活与实验性传输参数作用默认值CODEXMANAGER_SSE_KEEPALIVE_ENABLED向下游 SSE 发送注释心跳1CODEXMANAGER_SSE_KEEPALIVE_INTERVAL_MS心跳间隔毫秒—CODEXMANAGER_USE_WEBSOCKET_UPSTREAM实验开关ChatGPT 流式上游优先 WebSocket失败自动回退 HTTP0CODEXMANAGER_GATEWAY_ASYNC_STREAM_WORKERS异步上游任务并发上限32最大 256并发、超时与日志保留参数作用默认值CODEXMANAGER_ACCOUNT_MAX_INFLIGHT单账号并发请求上限—CODEXMANAGER_FRONT_PROXY_WORKER_THREADS主 Tokio runtime 线程数需重启生效2CODEXMANAGER_FRONT_PROXY_MAX_BLOCKING_THREADSblocking 线程上限跟随存储连接池≤32CODEXMANAGER_REQUEST_LOG_RETENTION_DAYS请求日志保留天数14CODEXMANAGER_GATEWAY_TRACE_STDOUT网关请求 trace 打印到标准输出0CODEXMANAGER_GATEWAY_BLOCKED_PATHS网关拦截路径—相关常量定义可参见 runtime_config.rs。数据库与鉴权bootstrap 级必须启动前设置参数作用说明CODEXMANAGER_DB_PATHSQLite 数据库路径相对路径按可执行文件目录解析CODEXMANAGER_RPC_TOKEN静态 RPC Token敏感信息建议用文件方式CODEXMANAGER_RPC_TOKEN_FILERPC Token 文件路径Docker 部署推荐CODEXMANAGER_STORAGE_BACKENDSeaORM 后端sqlite/mysql/postgres需编译对应驱动CODEXMANAGER_DATABASE_URL数据库连接 URL显式设置即选择 SeaORMCODEXMANAGER_DB_MAX_CONNECTIONSSeaORM 连接池大小10CODEXMANAGER_STORAGE_MAX_CONNECTIONS旧 Storage 句柄池上限32图片生成参数作用默认值CODEXMANAGER_CODEX_IMAGE_GENERATION_ENABLED是否启用图片生成兼容链路1CODEXMANAGER_CODEX_IMAGE_MAIN_MODELImages 兼容入口内部主对话模型gpt-5.4-miniCODEXMANAGER_CODEX_IMAGE_TOOL_MODEL图片工具模型gpt-image-2一份可直接抄的 codexmanager.env 示例# 地址 CODEXMANAGER_SERVICE_ADDRlocalhost:48760 CODEXMANAGER_WEB_ADDRlocalhost:48761 # 上游与代理 CODEXMANAGER_UPSTREAM_BASE_URLhttps://chatgpt.com/backend-api/codex CODEXMANAGER_UPSTREAM_PROXY_URLhttp://127.0.0.1:7890 CODEXMANAGER_UPSTREAM_TOTAL_TIMEOUT_MS0 CODEXMANAGER_UPSTREAM_STREAM_TIMEOUT_MS600000 # SSE 保活 CODEXMANAGER_SSE_KEEPALIVE_ENABLED1 CODEXMANAGER_SSE_KEEPALIVE_INTERVAL_MS15000 # 图片生成 CODEXMANAGER_CODEX_IMAGE_GENERATION_ENABLED1 CODEXMANAGER_CODEX_IMAGE_TOOL_MODELgpt-image-2 # 数据库与鉴权Service 版 # CODEXMANAGER_DB_PATH./data/codexmanager.db # CODEXMANAGER_RPC_TOKEN_FILE./data/codexmanager.rpc-token生产环境的受控模板Service Web 分离部署、远程数据库可参考codexmanager.env.example。Docker 部署时环境变量怎么传项目内置了 docker-compose 编排service 监听48760web 监听48761共享/data卷存放数据库与 RPC Token 文件时区通过${TZ:-Asia/Shanghai}注入。environment: CODEXMANAGER_SERVICE_ADDR: 0.0.0.0:48760 CODEXMANAGER_DB_PATH: /data/codexmanager.db CODEXMANAGER_RPC_TOKEN_FILE: /data/codexmanager.rpc-token TZ: ${TZ:-Asia/Shanghai}编排文件见 docker-compose.yml首次启动与放行规则见 运行与部署指南.md。排障改了 env 但没生效按以下顺序快速排查是否重启了对应进程—— bootstrap 级变量必须重启才生效是否已有同名系统环境变量—— 进程已存在的变量不会被 env 文件覆盖是否被设置页持久化配置干扰—— 专属设置卡片与通用编辑器写入的 envOverrides 只补齐、不覆盖长流异常—— 检查UPSTREAM_STREAM_TIMEOUT_MS是否过短、SSE_KEEPALIVE_ENABLED是否被关闭总结env 文件统一命名codexmanager.env放在可执行文件同目录高频参数集中在地址SERVICE_ADDR/WEB_ADDR、上游代理UPSTREAM_PROXY_URL、超时UPSTREAM_*_TIMEOUT_MS、SSE 保活三件套数据库与 RPC Token 属于 bootstrap 级配置必须启动前就位完整参数以源码为准稳定入口文档见 环境变量与运行配置说明.md建议收藏本文部署 CodexManager 本地网关时对照清单逐项配置即可 【免费下载链接】Codex-Manager一个Codex cli 账号管理与切换工具。为 Codex cli提供本地网关转发。项目地址: https://gitcode.com/gh_mirrors/co/Codex-Manager创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考