基于 Mihomo 的 Codex 网络管理控制台。 面向远程服务器和科研工作流,用一个简单页面完成订阅管理、Codex 节点测试、稳定性判断和节点切换。
- 新增、编辑和刷新 Mihomo 订阅。
- 专门测试 Codex/ChatGPT 实际使用的网络通道。
- 用最近 5 分钟的多次样本判断连接是否可靠,而不是只看一次测速。
- 分开显示连接成功率、中位延迟和延迟波动。
- 修改配置前自动备份,并使用 Mihomo 内核校验配置。
- 默认只允许本机访问,适合通过 SSH 管理远程科研服务器。
它不是完整 Mihomo 面板,只保留非计算机专业用户最常用的功能。
在服务器 SSH 终端中,以运行 Codex 的普通用户执行:
curl -fsSL --retry 5 --retry-all-errors --retry-delay 2 \
-H 'Accept: application/vnd.github.raw+json' \
https://api.github.com/repos/zhang17173/codex-network-console/contents/install.sh \
| bash安装器会自动检查 Mihomo、创建 Python 环境、安装依赖、创建用户服务并启动控制台。
执行完整引导安装:
curl -fsSL --retry 5 --retry-all-errors --retry-delay 2 \
-H 'Accept: application/vnd.github.raw+json' \
https://api.github.com/repos/zhang17173/codex-network-console/contents/install.sh \
| bash -s -- --with-mihomo安装器会:
- 从 MetaCubeX/mihomo 官方发布页下载适合当前 CPU 的 Linux 版本。
- 使用 GitHub 官方发布接口提供的 SHA-256 摘要校验下载文件。
- 提示输入 Mihomo/Clash 格式的订阅地址,输入内容不会回显。
- 生成只让 OpenAI、ChatGPT 和 Codex 域名经过代理的基础配置,其余请求直连。
- 创建并启动
mihomo.service和codex-network-console.service。 - 询问是否为以后登录的 shell 自动启用代理环境变量。
自动安装支持 Linux x86_64/amd64 和 arm64/aarch64。其他架构请先手动安装 Mihomo,再使用情况 A。
curl | bash适合快速安装。如果希望先审查脚本,可以打开 install.sh 和 setup-mihomo.sh,或先克隆仓库再执行bash install.sh --with-mihomo。
如果服务器还没有代理,安装器本身可能也无法从 GitHub 下载。这时可临时借用 Mac 上已经运行的 FlClash:
- 确认 FlClash 的本地 HTTP 代理端口。常见端口是
7890。 - 在 Mac 终端建立 SSH 反向隧道:
ssh -R 17890:127.0.0.1:7890 用户名@服务器地址- 保持这个 SSH 会话,在登录后的服务器终端执行:
export HTTP_PROXY=http://127.0.0.1:17890
export HTTPS_PROXY=http://127.0.0.1:17890
curl -fsSL --retry 5 --retry-all-errors --retry-delay 2 \
-H 'Accept: application/vnd.github.raw+json' \
https://api.github.com/repos/zhang17173/codex-network-console/contents/install.sh \
| bash -s -- --with-mihomo这里使用 GitHub API 是为了避开部分代理节点对 raw.githubusercontent.com 的连接问题。17890 只是服务器上的临时入口,会把安装下载请求转交给 Mac 的 FlClash。安装完成并确认远端 Mihomo 可用后即可退出该 SSH 会话。若 FlClash 不是 7890 端口,只需替换第一条命令最后的端口号。
对非计算机专业用户,可以把整个链路理解为六步:
代理订阅 → Mihomo 内核 → CODEX 节点分组 → shell 代理环境 → Codex → 本控制台
从你信任的代理服务商获取 Mihomo、Clash Meta 或 Clash 格式的订阅地址。订阅地址通常包含账户令牌,应当像密码一样保护:
- 不要发到公开 Issue、聊天截图或论文附件。
- 不要写入 Git 仓库。
- 泄露后应立即在服务商页面重新生成。
- 请遵守所在地区法律、单位网络政策和服务条款。
Mihomo 是真正建立代理连接的网络内核。本项目只是管理界面,不能在没有 Mihomo 的情况下独立翻墙。
完整引导安装会把 Mihomo 放在 ~/.local/bin/mihomo,配置放在 ~/.config/mihomo/config.yaml。
检查运行状态:
systemctl --user status mihomo.service引导安装生成的默认规则为:
rules:
- DOMAIN-SUFFIX,openai.com,CODEX
- DOMAIN-SUFFIX,chatgpt.com,CODEX
- DOMAIN-SUFFIX,oaistatic.com,CODEX
- DOMAIN-SUFFIX,oaiusercontent.com,CODEX
- MATCH,DIRECT这表示 OpenAI/Codex 相关域名使用 CODEX 节点,其他网络请求直接连接,不会消耗代理流量。
Mihomo 启动后,还需要让当前 shell 把 HTTP(S) 请求交给它:
source ~/.local/share/codex-network-console/scripts/proxy-env.sh然后从同一个 SSH 终端启动 Codex。完整引导安装可以自动把这条设置加入 ~/.profile,使以后登录自动生效。
检查 Codex 通道:
curl -sS -o /dev/null \
-w 'HTTP %{http_code}, total %{time_total}s\n' \
-x http://127.0.0.1:7890 \
https://chatgpt.com/backend-api/codex/responses未登录请求通常返回 HTTP 405,这表示网络通道已经连通;超时、DNS 错误或 HTTP 000 才表示代理链路有问题。
控制台默认只监听远端服务器的 127.0.0.1:9180。在自己的 Mac 或电脑上另开一个终端:
ssh -N -L 19180:127.0.0.1:9180 用户名@服务器地址保持该终端运行,然后在电脑浏览器打开 http://127.0.0.1:19180/。
- 打开“节点测试”。
- 选择订阅。
- 点击“开始测试”。
- 优先选择成功率高、延迟低、波动低的节点。
连接稳定性只反映成功率;延迟和波动不会改变稳定性结论。
如果不使用完整引导安装,现有配置至少需要:
mixed-port: 7890
external-controller: 127.0.0.1:9097
secret: change-this-secret
proxy-providers:
primary:
type: http
url: "你的订阅地址"
interval: 10800
path: ./providers/primary.yaml
proxy-groups:
- name: CODEX
type: select
use:
- primary仅检查环境:
bash ~/.local/share/codex-network-console/install.sh --checkDebian/Ubuntu 执行:
sudo apt update
sudo apt install -y python3-venv curl安装项目本身仍应使用普通用户,不要在 install.sh 前加 sudo。
让系统管理员执行一次:
sudo loginctl enable-linger 你的用户名确认 SSH 隧道终端仍在运行,并在服务器检查:
systemctl --user status codex-network-console.service
curl http://127.0.0.1:9180/api/status确认启动 Codex 的同一个终端已经执行:
source ~/.local/share/codex-network-console/scripts/proxy-env.sh
env | grep -i proxy然后在控制台重新测速并切换节点。
重新执行安装命令即可更新,订阅和 Mihomo 配置不会被覆盖:
curl -fsSL --retry 5 --retry-all-errors --retry-delay 2 \
-H 'Accept: application/vnd.github.raw+json' \
https://api.github.com/repos/zhang17173/codex-network-console/contents/install.sh \
| bash卸载控制台:
bash ~/.local/share/codex-network-console/uninstall.sh卸载脚本不会删除 Mihomo、订阅、代理规则或历史备份。
| 变量 | 默认值 | 用途 |
|---|---|---|
MIHOMO_CONFIG_PATH |
~/.config/mihomo/config.yaml |
Mihomo 配置文件 |
MIHOMO_BIN |
~/.local/bin/mihomo |
Mihomo 可执行文件 |
MIHOMO_API |
http://127.0.0.1:9097 |
Mihomo external controller |
MIHOMO_PROXY_URL |
http://127.0.0.1:7890 |
连通性复测代理 |
MIHOMO_GROUP_NAME |
CODEX |
节点选择分组 |
MIHOMO_SERVICE |
mihomo.service |
Mihomo 用户服务 |
MIHOMO_SELECTOR_TIMER |
mihomo-codex-auto-select.timer |
可选自动选择定时器 |
MIHOMO_MANAGER_HOST |
127.0.0.1 |
控制台监听地址 |
MIHOMO_MANAGER_PORT |
9180 |
控制台端口 |
修改 ~/.config/systemd/user/codex-network-console.service 后执行:
systemctl --user daemon-reload
systemctl --user restart codex-network-console.service每个节点默认对 Codex 通道采集 3 次样本,并加入最近 5 分钟窗口。较新的样本权重更高:
- 连接稳定性由窗口成功率和当前轮成功次数决定。
- 显示延迟为加权中位数。
- 波动为加权 P90 与中位延迟之差。
- OpenAI API 诊断默认关闭;设置
MIHOMO_MANAGER_TEST_OPENAI_API=1可在后端启用。
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/python -m unittest discover -s tests -v
bash -n install.sh uninstall.sh scripts/*.sh该服务能够读取订阅地址、修改 Mihomo 配置并重启服务。请保持回环监听,不要把 9180 或 Mihomo 控制端口直接暴露到公网,并阅读 SECURITY.md。
界面风格基于 guokaigdg/animal-island-ui 修改。本项目依照 CC BY-NC 4.0 发布,仅限非商业用途,与 MetaCubeX、OpenAI 均无官方关联。
