Sunshine与樱花FRP内网穿透配置冲突如何解决？

Question

在使用Sunshine作为串流主机并搭配樱花FRP实现内网穿透时，常出现端口映射失败或串流连接中断的问题。其核心原因在于Sunshine默认使用的WebRTC通信依赖多个动态端口（如47984、47998等），而樱花FRP若仅配置了基础的HTTP/HTTPS或固定TCP端口转发，无法覆盖Sunshine所需的全部通信端口，导致穿透不完整。此外，FRP的stun_server配置缺失或信令服务器地址冲突，也可能引发NAT穿透失败。如何正确配置樱花FRP以支持Sunshine所需的多端口转发与STUN穿透，成为部署过程中的典型技术难题。

Answer 1

1. 问题背景与技术栈解析

在远程桌面串流场景中，Sunshine作为开源的GameStream主机替代方案，广泛应用于Windows或Linux平台的低延迟视频推流。其底层基于WebRTC协议栈实现P2P音视频传输，依赖ICE框架进行NAT穿透。而樱花FRP（Sakura FRP）作为国内用户常用的内网穿透工具，基于FRP项目二次开发，支持TCP、UDP、HTTP等多种转发模式。

然而，在实际部署过程中，用户频繁遭遇“连接超时”、“黑屏卡顿”或“信令握手失败”等问题。其根本原因在于：

• Sunshine默认启用多个动态UDP端口用于RTP/RTCP媒体流传输（如47984、47998、3478等）；
• 樱花FRP若仅配置了HTTP或单一TCP端口映射，无法覆盖WebRTC所需的完整端口集合；
• STUN服务器未正确配置或被防火墙拦截，导致ICE候选地址生成异常；
• UDP打洞失败后未能回退至Relay模式，造成连接中断。

2. 核心机制剖析：Sunshine + WebRTC 的通信模型

Sunshine在启动时会绑定以下关键端口：

端口号	协议	用途	是否可配置
47984	TCP/UDP	主控信令通道	是
47998	UDP	WebRTC媒体流（音频/视频）	是
3478	UDP	STUN/TURN服务端口	否（标准端口）
8080	TCP	Web管理界面	是
1935	TCP	RTMP推流端口（可选）	是
动态范围 49152-65535	UDP	ICE候选端口池	部分可调

由此可见，仅映射47984和8080并不能满足完整通信需求，尤其是UDP端口段的缺失将直接导致媒体流无法建立。

3. 樱花FRP配置误区与典型错误日志分析

常见用户配置如下：

[common]
server_addr = frp.sakurafrp.com
server_port = 7000
token = your_token

[http-sunshine]
type = http
local_ip = 127.0.0.1
local_port = 8080
custom_domains = sunshine.yourdomain.frx.sakurafrp.com

该配置仅暴露Web管理页面，未涉及任何UDP或STUN相关转发。查看Sunshine日志常出现：

ERROR: ICE failed, add all candidates timeout!
WARNING: No host or srflx candidates gathered.
INFO: STUN request timed out for server 'stun.l.google.com:19302'

表明STUN请求无响应，本地候选地址未生成，ICE协商失败。

4. 正确配置策略：多端口映射与STUN协同

为实现完整穿透，需在樱花FRP客户端中显式声明多个UDP/TCP代理：

[common]
server_addr = frp.sakurafrp.com
server_port = 7000
token = your_token
protocol = tcp
log_level = info

[sunshine-tcp]
type = tcp
local_ip = 127.0.0.1
local_port = 47984
remote_port = 30001

[sunshine-udp-video]
type = udp
local_ip = 127.0.0.1
local_port = 47998
remote_port = 30002

[sunshine-stun]
type = udp
local_ip = 127.0.0.1
local_port = 3478
remote_port = 3478

[sunshine-dynamic-ports]
type = udp
local_ip = 127.0.0.1
local_port = 49152
remote_port = 49152
# 可扩展多个端口或使用range（若FRP支持）

同时，在Sunshine配置文件sunshine.conf中指定STUN服务器：

"stun_server": "your-frp-domain:3478"

5. 网络拓扑与穿透流程图解

下图为完整的NAT穿透流程：

graph TD
            A[Sunshine主机] -->|信令| B(frp.sakurafrp.com:7000)
            B --> C[FRP服务端]
            C --> D[客户端设备]
            A -->|UDP媒体流| E[樱花FRP UDP映射 30002 → 47998]
            A -->|STUN探测| F[STUN Server @ your-domain:3478]
            F --> G{能否生成srflx candidate?}
            G -- 是 --> H[ICE协商成功]
            G -- 否 --> I[尝试TURN中继或连接失败]
            H --> J[开始串流]

6. 高级优化建议与生产环境考量

针对企业级部署或高并发场景，建议采取以下措施：

1. 使用独立VPS部署自建FRP服务，避免共享节点带宽拥塞；
2. 开启FRP的udp_mux选项以复用UDP连接，降低资源消耗；
3. 配置QoS策略优先保障47998等媒体端口的传输质量；
4. 结合DDNS与Let's Encrypt实现全链路HTTPS加密访问；
5. 监控FRP心跳状态与Sunshine日志，设置自动重启脚本；
6. 在路由器上启用UPnP或手动配置DMZ主机，辅助提升打洞成功率；
7. 测试不同STUN服务器（如Google、Twilio）以对比延迟与稳定性；
8. 限制动态端口范围（via min_port/max_port），便于FRP批量映射；
9. 启用FRP插件系统集成Prometheus进行性能指标采集；
10. 对敏感环境使用TLS+Token双重认证防止未授权接入。