太阳娘陪你排查找不到主机与配对失败
先确认问题停在哪一步：主机没出现、手动地址也连不上、PIN 不成功，还是配对后应用启动失败。最后一种情况应继续看黑屏与启动排查。
找不到主机
按顺序检查：
- 服务运行：主机桌面控制面板显示 Sunshine 正在运行，Windows 没有睡眠。
- 网络一致：手机没有切换到移动数据；两端不在隔离的访客网络。
- 权限：客户端所需的本地网络权限已允许；曾拒绝过时，到系统设置中检查。
- 手动添加：用主机当前活动网卡的 IPv4 地址测试。
在主机运行 ipconfig，找到正在使用的以太网或 WLAN 下的 IPv4。请选择当前实际连接家庭网络的网卡地址，跳过已断开的网卡和无关虚拟网卡。
客户端填主机 IP，例如 192.168.1.100，不是 https://localhost:47990，也不是客户端自己的地址。这里的示例地址需要换成实际值。
手动添加也失败
- 检查主机网络是否允许设备互访，尤其是 AP 隔离、企业策略或不同网段。
- 检查 Windows 防火墙中 Sunshine 的规则是否适用于当前网络配置文件；修正规则，而不是长期关闭整个防火墙。
- 暂停无关 VPN／代理路径做局域网对照，再逐个恢复。
- 如果家用路由器重启后地址改变，重新查 IP；需要固定地址时，可按路由器说明设置 DHCP 地址保留。
如果手动添加成功、自动发现失败，说明发现机制与实际连接路径不同，可以先继续手动连接，不必重装。
PIN 配对失败
- 在客户端重新发起配对，保持显示本次 PIN 的界面。
- 确认打开的是目标主机的 Sunshine PIN 码页面。
- 输入客户端当前显示的 PIN。WebUI 管理密码仅用于登录管理页面。
- 检查是否配到了主机上的另一份 Sunshine、其他用户实例或旧服务。
若主机重装、客户端清除数据或换设备后身份变化，可能需要重新配对。请在服务端找到并移除对应的失效设备，再重新添加，保留其他设备的配对。换设备后重新配对，再迁移需要的设置。
在家能连，在外面连不上
家中的局域网 IP 不会自动变成外网地址。先按远程组网确认两端已加入同一可互访网络，再手动添加主机的虚拟 IP。
节点“在线”但不能串流时，还要检查组网访问规则、防火墙和客户端是否实际走这条路径。没有跨网自动发现时，手动添加仍是正常操作。
如果用公网端口映射，则按当前版本和路由器方案核对，不把管理 WebUI 暴露出去。连接后卡顿属于另一类问题，继续看性能排查。
仍然失败
记录双方版本、连接方式、停在哪一步、原始错误与时间，按反馈指南附上脱敏日志。公开反馈中不要贴 PIN、配对证书、组网密钥或完整配置备份。