← 插件

Paseo Direct

前台自动发现并验证 PC 直连,管理本设备的连接偏好,保留 Relay 回退。

$ clisbot plugin add minleev5/direct
报告问题
minleev5daemon 管理0次安装db37dbee4394源代码
Paseo Direct 截图 1

手机在 Paseo 前台时自动寻找直连 PC 的地址,验证属于已配对的 PC 后保存,并保留已有 Relay 作为回退连接。

Paseo Direct 管理页面

开始使用

先通过 Relay 完成手机与此 PC 的配对,启用插件,再打开侧边栏或主机插件设置中的 Paseo Direct。如提示本地网络权限,请允许访问。手机前台默认自动探测;桌面与网页默认关闭。

PC 需要提供手机可访问的 TCP 端口。插件读取实际监听地址,不会修改监听、防火墙、端口映射或 Relay 配置。

连接偏好

优先直连会保存并激活验证成功的连接;由 Paseo 选择只保存新地址,交给 Paseo 的延迟策略选择。也可连接指定地址、使用 Relay 60 秒,或移除插件添加且未使用的地址。

设备设置按 PC 分别持久保存。PC 共享设置支持忽略网卡、补充 DNS / IPv4 / IPv6 / TLS WebSocket 地址;自动网卡发现仅使用 IPv4。

数据访问

PC 端读取网卡与守护进程实际监听信息。设备端在内存中复用已有认证,通过 App 管理直连,并将偏好保存在插件自己的本地存储命名空间。密码与配对凭据不会写入插件设置或诊断。

只有点击 发送诊断到 PC 才会发送地址、连接状态和近期事件。PC 内存最多保留 12 台设备的最新报告,也会写入插件日志。

兼容与限制

使用带能力检查的 App 私有连接接口,支持 Paseo 0.13.0 及以上版本,不设版本上限;运行时检查所需接口,接口缺失时停止操作。Android 0.13.2 已完成 Wi-Fi 直连 → Relay → 直连真机验证,iOS 仍待真机验收。

仅在前台探测,不提供后台服务、NAT 打洞或自动 IPv6 发现。已有连接故障后的 Relay 回退由 Paseo 核心处理。普通 WebSocket 直连沿用 Paseo 的信任模型,适用于可信 LAN / VPN;不可信网络应配置正确的 TLS。

停用插件会停止探测,已保存的连接继续由 Paseo 管理。