极速 · 纯净 · 强悍
跨平台远程协助新标杆

1. 为什么在国内手机热点下很多远程软件会连不上？

在国内使用 iPhone 或安卓手机开热点且没有打开代理/VPN 时，国内三大移动蜂窝运营商的移动网防火墙经常会对海外或公共 Anycast 节点（如 104.21.x.x）发起 TCP RST 阻断，导致苹果 CFNetwork 报错 -1005 (The network connection was lost)。

2. QsyRemote 的独家破解方案：LanDiscovery 智能广播嗅探

QsyRemote 自研了底层局域网与热点嗅探引擎（lan_discovery.cpp）。受控端在后台持续监听 UDP 8922 端口：

控制端输入 9 位设备代码点击连接
  ↓
自动向 255.255.255.255、当前子网网段、以及手机热点网段发送 150ms 极速嗅探:
  • 苹果 iOS 热点默认网段: 172.20.10.255
  • 安卓 Android 热点默认网段: 192.168.43.255 / 192.168.137.255
  ↓
受控端收到 UDP 8922 探测包立即返回握手
  ↓
【0ms 外网依赖】以 1ms 纯本地 TCP 极速直连，不消耗任何外网流量，100% 自动秒连！

3. 终极备用方案：直接输入局域网 IP 直连

如果两台电脑处于特殊隔离网段，主界面还支持「直接输入 IP」：

1. 查看受控端主界面显示的「本机局域网 IP」（例如：172.20.10.3 或 192.168.1.88）。
2. 控制端直接在「伙伴设备代码」中填入该 IP（例如直接填 172.20.10.3）。
3. 填入对应的 6 位连接密码，点击连接。软件直接绕过所有外网信令，1毫秒内完成握手！

1. 什么是 Cloudflare Tunnel 官方隧道？

传统远程软件往往依赖昂贵的商业中继服务器或需要用户自备公网 IP、做路由器端口映射（Port Forwarding）。QsyRemote 深度集成了 Cloudflare 官方隧道技术（基于 cloudflared / qsyshare 内核）：

• 完全免公网 IP：两端都在家用光猫内网或公司内网亦可完美穿透。
• 不限流量、不限速：依托 Cloudflare 全球骨干 Anycast 网络直连。
• 极简一键开关：在软件内只需点击一个按钮，无需用户编写配置文件。

2. 如何在软件中启用穿透？

3. 常见 Windows 防火墙与拦截提示处理

一、macOS 必开系统权限（受控端必备）

由于 macOS 具有严格的安全隐私沙盒机制，受控端 Mac 电脑必须授予两项核心权限：

二、解决 Mac 提示“无法打开，因为 Apple 无法检查其是否包含恶意软件”

由于个人开源项目未购买苹果昂贵的商业开发者年费证书，macOS Gatekeeper 会默认拦截：

xattr -cr /Applications/QsyRemote.app

三、Windows 绿色版免安装即用说明

Windows 版为完全纯净的绿色单文件版本（QsyRemote.exe），无需繁琐安装流程。推荐解压到一个固定目录（如 D:\QsyRemote\），将 qsyshare.exe 穿透组件放在同一目录下，右键选择【以管理员身份运行】即可。

方式 A：免费部署 Cloudflare Worker 信令（推荐，0成本且全球加速）

本项目包含已写好的 cf_worker/worker.js，您可以直接部署到自己的 Cloudflare 账号中：

1. 登录 Cloudflare 仪表盘，进入 Workers & Pages → 创建 Worker。
2. 将项目仓库 cf_worker/worker.js 中的代码完整复制粘贴进去，点击部署。
3. 绑定 KV 数据库（建议）：在 Worker 设置页面的「KV 命名空间绑定」中添加变量名称 DEVICE_SESSIONS，绑定到新建的 KV 命名空间中。
4. 部署后获得的域名（如 https://my-signaling.workers.dev）即可填入软件的「穿透与中继设置」中。

方式 B：在 VPS 或私有服务器上运行 Go 语言信令服务端

# 进入 server 目录
cd server

# 运行 Go 信令中继核心
go run main.go

# 或编译为独立二进制执行
go build -o qsy_server main.go
./qsy_server

在客户端主界面的「🌐 穿透与中继设置 (高级)」中填入您服务器的公网 IP 和端口，即可完全走自己的私有专属链路！