远程访问指南
在 AtomCode 运行 /webui,手机浏览器扫描中继二维码即可访问,无需蒲公英组网,也无需让电脑监听公网端口。
使用方式
- 电脑保持 AtomCode 运行,执行
/webui。本机浏览器会打开,终端同时显示手机链接和二维码。 - 用手机浏览器扫码,或在电脑 WebUI 的“远程访问”面板复制中继链接。手机和电脑可使用不同网络。
- TUI 与手机同步查看和回答同一会话。执行
/webui stop、退出 AtomCode 或在终端登出会停止中继共享。
独立启动可用 atomcode webui;仅本机访问用 /webui --local 或 atomcode webui --local。显式指定 /webui lan 或 --host <地址> 时使用局域网地址,不自动连接中继。
连接失败
中继连接失败时本机 WebUI 仍可使用,终端和远程访问面板会说明原因。若提示中继未启用 WebUI,需升级中继服务端并部署当前版本的 WebUI 资源,再执行 /webui 重试。可通过 ATOMCODE_APP_RELAY 指定自建中继,ATOMCODE_ENABLE_RELAY=0 禁用中继。
中继地址
默认使用线上 HTTPS 中继 https://relay-atomcode.atomgit.com,无需额外配置。手机请打开 AtomCode 生成的配对链接或扫描二维码。
安全与生命周期
链接等同于访问密码,请勿外传。请求经 HTTPS 中继到本机,继续校验 WebUI 令牌;中继可以处理传输内容,不提供端到端加密。浏览器把配对凭据保存在当前标签页的 sessionStorage,用于刷新重连,关闭标签页后清除。网络中断时客户端自动重连;电脑休眠、离线或 AtomCode 退出后不可访问。
局域网备选
仍可使用 /webui lan 在同一 Wi-Fi 内访问,或 /webui --host <虚拟 IP> 配合已有 VPN。此时需自行确保网络可信,本地 HTTP 不提供传输加密。