Skip to content

About

A beginner-friendly Mihomo console for Codex network testing, subscription management, and research workflows.

Topics

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Codex Network Console

Tests Python 3.10+ License: CC BY-NC 4.0

基于 Mihomo 的 Codex 网络管理控制台。 面向远程服务器和科研工作流,用一个简单页面完成订阅管理、Codex 节点测试、稳定性判断和节点切换。

Codex Network Console dashboard

能做什么

  • 新增、编辑和刷新 Mihomo 订阅。
  • 专门测试 Codex/ChatGPT 实际使用的网络通道。
  • 用最近 5 分钟的多次样本判断连接是否可靠,而不是只看一次测速。
  • 分开显示连接成功率、中位延迟和延迟波动。
  • 修改配置前自动备份,并使用 Mihomo 内核校验配置。
  • 默认只允许本机访问,适合通过 SSH 管理远程科研服务器。

它不是完整 Mihomo 面板,只保留非计算机专业用户最常用的功能。

最快安装

情况 A:服务器已经能通过 Mihomo 访问 ChatGPT

在服务器 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 环境、安装依赖、创建用户服务并启动控制台。

情况 B:服务器尚未安装或配置 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 -s -- --with-mihomo

安装器会:

  1. 从 MetaCubeX/mihomo 官方发布页下载适合当前 CPU 的 Linux 版本。
  2. 使用 GitHub 官方发布接口提供的 SHA-256 摘要校验下载文件。
  3. 提示输入 Mihomo/Clash 格式的订阅地址,输入内容不会回显。
  4. 生成只让 OpenAI、ChatGPT 和 Codex 域名经过代理的基础配置,其余请求直连。
  5. 创建并启动 mihomo.service 和 codex-network-console.service。
  6. 询问是否为以后登录的 shell 自动启用代理环境变量。

自动安装支持 Linux x86_64/amd64 和 arm64/aarch64。其他架构请先手动安装 Mihomo,再使用情况 A。

curl | bash 适合快速安装。如果希望先审查脚本,可以打开 install.sh 和 setup-mihomo.sh,或先克隆仓库再执行 bash install.sh --with-mihomo。

服务器目前打不开 GitHub

如果服务器还没有代理,安装器本身可能也无法从 GitHub 下载。这时可临时借用 Mac 上已经运行的 FlClash:

  1. 确认 FlClash 的本地 HTTP 代理端口。常见端口是 7890。
  2. 在 Mac 终端建立 SSH 反向隧道:
ssh -R 17890:127.0.0.1:7890 用户名@服务器地址
  1. 保持这个 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 → 本控制台

1. 准备订阅

从你信任的代理服务商获取 Mihomo、Clash Meta 或 Clash 格式的订阅地址。订阅地址通常包含账户令牌,应当像密码一样保护:

  • 不要发到公开 Issue、聊天截图或论文附件。
  • 不要写入 Git 仓库。
  • 泄露后应立即在服务商页面重新生成。
  • 请遵守所在地区法律、单位网络政策和服务条款。

2. 运行 Mihomo

Mihomo 是真正建立代理连接的网络内核。本项目只是管理界面,不能在没有 Mihomo 的情况下独立翻墙。

完整引导安装会把 Mihomo 放在 ~/.local/bin/mihomo,配置放在 ~/.config/mihomo/config.yaml。

检查运行状态:

systemctl --user status mihomo.service

3. 理解基础代理规则

引导安装生成的默认规则为:

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 节点,其他网络请求直接连接,不会消耗代理流量。

4. 让 Codex 使用 Mihomo

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 才表示代理链路有问题。

5. 打开控制台

控制台默认只监听远端服务器的 127.0.0.1:9180。在自己的 Mac 或电脑上另开一个终端:

ssh -N -L 19180:127.0.0.1:9180 用户名@服务器地址

保持该终端运行,然后在电脑浏览器打开 http://127.0.0.1:19180/。

6. 测试并选择节点

  1. 打开“节点测试”。
  2. 选择订阅。
  3. 点击“开始测试”。
  4. 优先选择成功率高、延迟低、波动低的节点。

连接稳定性只反映成功率;延迟和波动不会改变稳定性结论。

已有 Mihomo 的配置要求

如果不使用完整引导安装,现有配置至少需要:

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 --check

常见问题

安装器提示缺少 python3-venv

Debian/Ubuntu 执行:

sudo apt update
sudo apt install -y python3-venv curl

安装项目本身仍应使用普通用户,不要在 install.sh 前加 sudo。

SSH 退出后服务停止

让系统管理员执行一次:

sudo loginctl enable-linger 你的用户名

浏览器打不开 127.0.0.1:19180

确认 SSH 隧道终端仍在运行,并在服务器检查:

systemctl --user status codex-network-console.service
curl http://127.0.0.1:9180/api/status

Mihomo 正常,但 Codex 仍无法连接

确认启动 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 均无官方关联。

About

A beginner-friendly Mihomo console for Codex network testing, subscription management, and research workflows.

Topics

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages