211API

Hapi 远程控制 ​

Hapi 是一个本地优先的开源应用：AI 编程会话跑在你自己的机器上，同时可以通过 Web / PWA / Telegram Mini App 远程监控和控制 —— 出门在外也能用手机管理 Claude Code、CodeX、Gemini 任务。

功能一览 ​

  • 本地原生环境与远程控制之间无缝切换
  • 从任意设备发起会话、审批或拒绝工具权限
  • 浏览文件、查看 git diff、跟踪任务进度
  • 同时支持 Claude Code、CodeX、Gemini 三种后端

安装与启动 ​

前置要求：Node.js 18+（见 Windows 安装 Node.js），并已完成对应工具的 211API 接入。

第一步：启动 Hapi 服务

bash
npx @twsxtd/hapi server

启动后会输出 Token 凭证和访问地址。

保存好 Token

Token 是连接和控制 Hapi 服务的唯一凭证，请勿泄露。

第二步：启动 AI 会话

在项目目录下执行对应命令：

bash
hapi claude    # Claude Code
hapi codex     # CodeX
hapi gemini    # Gemini CLI

启动后即可在局域网内通过 http://<服务器IP>:3006 访问控制界面。

公网访问（Cloudflare Tunnel） ​

想在外网访问，可用 Cloudflare Tunnel 做内网穿透，只需一个域名和免费 Cloudflare 账号：

  1. 登录 Cloudflare Zero Trust 控制台，创建新的 Tunnel。
  2. 按引导安装 cloudflared 客户端。
  3. 配置公共主机名，服务地址填 localhost:3006（Hapi 默认端口）。
  4. 完成后即可通过 https://你的域名 访问。

详细步骤见 Cloudflare Tunnel 官方文档。

使用 ​

  • 本地：http://localhost:3006
  • 局域网：http://<服务器IP>:3006
  • 公网：https://你的域名（配置 Tunnel 后）

浏览器打开地址 → 输入 Token 登录 → 选择 AI 后端 → 开始远程控制。手机浏览器可安装为 PWA，体验接近原生应用，支持多设备同时连接。

安全建议 ​

  • 公网访问时建议启用 Cloudflare Access 等安全策略。
  • 定期更换 Token，仅在可信网络环境下使用。

常见问题 ​

无法连接服务器 — 确认 Hapi 服务正在运行、防火墙放行 3006 端口、Token 输入正确。

Tunnel 配置失败 — 确认域名已接入 Cloudflare、cloudflared 正常运行，可查看其日志排查。

更多问题见 Hapi GitHub Issues。