用途:将仅限本机/局域网的 AionUi WebUI(默认 http://127.0.0.1:25808)发布为公网 URL,方便临时远程访问与分享。技能在运行 AionUi 的同一台机器上执行 shell 命令,用户只需完成架构上无法自动化的部分——在桌面界面打开 WebUI 开关。
主要能力:检测 WebUI 是否在运行(curl 探测,返回 200 为已启动,000/拒绝连接为未启动);跨平台自装 cloudflared(直接从 GitHub 下载预编译二进制,或用 brew install cloudflared);启动隧道并输出临时公网地址;从公网侧验证 URL 真的可访问;可通过 HTTP 接口修改 WebUI 用户名/密码。
必要用法:先探测状态;若未启动,引导用户到“设置 → WebUI → 打开开关”(如需局域网访问可同时开启 Allow remote access),确认返回 200 后再继续。安装并运行隧道时必须强制 http2:cloudflared tunnel --protocol http2 --url http://127.0.0.1:25808。随后在输出中查找 https://<随机词>.trycloudflare.com 及 Registered tunnel connection ... protocol=http2 两行。交付前用 curl 从公网验证返回 200(新建隧道前几秒可能返回 530/000,需重试)。改凭据接口示例:curl -s -X POST http://127.0.0.1:25808/api/webui/change-password -H "Content-Type: application/json" -d '{"new_password":"<new>"}',改用户名同理。
适用场景:临时远程访问本机 AionUi WebUI、快速分享与测试。
限制:无法用 HTTP/CLI 启动桌面 WebUI,必须由用户手动打开开关。隧道地址临时且随机,隧道或 WebUI 重启后会变化;关闭隧道进程、电脑休眠或关机都会导致公网地址失效。Cloudflare 快速隧道适合临时分享,可能被限流或中断,不适合生产或长期关键用途。公网暴露后密码是唯一防护,随机 URL 不等于安全,可能通过浏览器历史、聊天记录、链接预览或 Referer 泄露;流量经 Cloudflare 边缘终止 TLS,第三方位于路径中。凭据接口仅在 aioncore 以本地模式运行时有效,独立服务器部署会返回 403。固定地址需要 Cloudflare 账号、自有域名与命名隧道,资料仅提及,未展开步骤。