Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

Repository files navigation

codex-mobile-web

手机网页控制本机 Codex 的本地 bridge。适合电脑在学校/公司内网、无法被 RustDesk 这类远控软件直连,但可以主动连出公网的场景。

功能

  • 手机浏览器查看 Codex 任务进度
  • 手机端 approve / deny 命令、文件修改和权限请求
  • 手机端发送下一轮任务输入,运行中会走 steer
  • 多个网页客户端共享同一条 Codex app-server 后端连接,手机和电脑网页同步
  • 聊天列表可折叠,可按工作文件夹分组
  • 可在手机端切换是否显示 command 输出
  • 通过 Cloudflare Tunnel 暴露 HTTPS 临时地址,手机无需 VPN
  • 支持多种认证模式:本地 token、Cloudflare Access、Access/token 过渡模式

架构

手机浏览器 / 电脑浏览器
  -> Cloudflare Tunnel HTTPS
  -> 127.0.0.1:8787 codex-mobile-web
  -> 127.0.0.1:8791 codex app-server
  -> 本机 Codex / Git / 文件系统

codex-mobile-web 不直接调用 OpenAI API。Codex 运行在本机,网页只是本机 Codex app-server 的受控前端。

快速开始

前置条件:

  • Windows
  • Node.js 24+
  • Codex CLI / Codex Desktop 已安装并登录
  • 可选:本机 HTTP 代理,例如 http://127.0.0.1:7897,用于 Cloudflare 域名被 fake-ip 代理接管的网络

启动 Codex app-server:

.\scripts\start-codex-app-server.ps1

如果从 Codex 自己的工具环境里启动,需要让进程在命令结束后继续运行:

.\scripts\start-codex-app-server.ps1 -UseScheduledTask
.\scripts\start-bridge.ps1 -AuthMode access-edge -UseScheduledTask -Restart

启动本地 bridge:

.\scripts\start-bridge.ps1

下载并启动 Cloudflare Tunnel:

.\scripts\start-cloudflare-tunnel.ps1 -Download -Proxy http://127.0.0.1:7897

如果网络不需要代理:

.\scripts\start-cloudflare-tunnel.ps1 -Download

脚本会输出手机访问地址:

https://<random>.trycloudflare.com/?token=<bridge-token>

手机不需要连接 VPN;直接用浏览器打开该 HTTPS 地址即可。

固定域名与认证模式

如果已经在 Cloudflare 中配置 named tunnel 和固定域名,例如:

https://codex.wuyou0123.com

先把本地固定访问地址保存下来:

Set-Content .bridge-public-url "https://codex.wuyou0123.com" -NoNewline

如果 Cloudflare Access 已经保护该域名,并且策略只允许你的邮箱访问,可以使用边缘认证模式:

.\scripts\start-bridge.ps1 -AuthMode access-edge -Restart

如果你还想保留旧 token 链接作为备用,使用过渡模式:

.\scripts\start-bridge.ps1 -AuthMode access-or-token -Restart

更严格的 Cloudflare Access JWT 本地校验需要配置 CF_ACCESS_TEAM_DOMAIN 和 CF_ACCESS_AUD。完整说明见:

docs/auth-modes.md

Cloudflare named tunnel 有两种常见运行方式:

  • Dashboard-managed tunnel:在 Cloudflare 后台复制 connector token 启动,本地不需要 config.yml。
  • Locally-managed tunnel:本机有 ~/.cloudflared/config.yml、tunnel credentials 和 DNS route。

如果你的 Cloudflare 后台已经把 codex.wuyou0123.com 指向 tunnel,但手机仍无法访问,优先检查本机是否真的运行了该 named tunnel connector。旧的 quick tunnel 日志只会显示 trycloudflare.com,不会服务固定域名。

安全

  • .bridge-token 是本地随机 token,已加入 .gitignore
  • .bridge-public-url 是本地域名配置,已加入 .gitignore
  • 不要提交 .bridge-token、.bridge-public-url、日志、tools/cloudflared.exe
  • 不要把 127.0.0.1:8791 的 Codex app-server 直接暴露公网
  • 临时 trycloudflare.com 隧道没有 uptime 保证,长期使用建议换成 Cloudflare named tunnel + Access

常见问题

手机能打开页面,但电脑网页不同步

刷新手机和电脑网页。当前版本的 bridge 使用单一共享 Codex 后端连接,并广播 thread/start、turn/status/approval/output 和用户输入事件;旧页面还连着旧 JS 时需要刷新。

手机发起新聊天后电脑端没有切换

确认 bridge 已重启到最新代码。新版本会广播 bridge/threadStarted,其他网页客户端收到后会把新聊天加入列表并自动切换到该聊天。

Cloudflare Tunnel 请求失败,解析到 198.18.x.x

这是常见 fake-ip 代理表现。传入本机代理:

.\scripts\start-cloudflare-tunnel.ps1 -Proxy http://127.0.0.1:7897

Codex Desktop App 不实时刷新

本项目保证手机网页和电脑网页同步。Codex Desktop App 可能需要重新打开 thread 或手动刷新才能看到持久化后的会话。

Skill

仓库内包含可复现 Skill:

skills/codex-mobile-web/SKILL.md

把该目录复制到 $CODEX_HOME/skills 或 ~/.codex/skills 后,Codex 可按同样流程重建和运维此方案。

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages