如何通过TURN服务器暴露Android Cuttlefish设备

一、Cuttlefish的TURN参数配置方式 #

针对Android 15.0.0 r5版本的Cuttlefish，有两种直接配置TURN服务器的途径：

1. 启动时传入参数 #

在启动Cuttlefish的launch_cvd脚本中添加WebRTC相关的TURN参数，示例如下：

--webrtc_turn_server=<TURN_SERVER_EXTERNAL_IP>:<PORT>
--webrtc_turn_username=<TURN_AUTH_USERNAME>
--webrtc_turn_credential=<TURN_AUTH_CREDENTIAL>

• 若使用静态凭证认证，直接传入用户名和密码即可；
• 若使用临时凭证（TOTP），需生成对应临时字符串传入--webrtc_turn_credential。

2. 运行时修改系统属性 #

如果Cuttlefish已启动，可通过adb连接设备后设置持久化系统属性：

adb shell setprop persist.webrtc.turn.server <TURN_SERVER_EXTERNAL_IP>:<PORT>
adb shell setprop persist.webrtc.turn.username <TURN_AUTH_USERNAME>
adb shell setprop persist.webrtc.turn.credential <TURN_AUTH_CREDENTIAL>

设置完成后重启WebRTC服务或设备生效：

adb shell stop webrtc_service
adb shell start webrtc_service

二、Kubernetes侧配套配置 #

1. TURN服务器部署与暴露：在集群内部署TURN服务（如coturn），需将服务端口（默认UDP/TCP 3478，以及媒体端口范围如49152-65535）暴露到集群外部，可使用NodePort、LoadBalancer类型的Service，或通过Ingress转发TCP/UDP流量。
2. TURN服务器外部IP配置：确保TURN服务配置文件中设置external-ip为集群外可访问的公网IP，保证客户端和Cuttlefish都能通过该IP访问中继服务。
3. Pod网络策略放行：修改Cuttlefish Pod的网络策略，允许其出站访问TURN服务器的IP和端口，避免流量被拦截。

三、配置验证 #

1. 检查WebRTC日志：通过adb查看Cuttlefish的WebRTC日志，确认TURN服务器是否加载成功：

adb logcat | grep "TURN"

若出现Added TURN server: <server_address>类日志，说明配置已生效。
2. 客户端连接测试：在笔记本客户端使用WebRTC调试工具（如浏览器内置的WebRTC信息页面），尝试连接Cuttlefish的WebRTC流，查看ICE候选列表中是否包含TURN服务器的中继地址，若能成功建立连接则中继功能正常。

四、生产环境注意事项 #

• NAT类型兼容：确保TURN服务器支持客户端和Cuttlefish所在网络的NAT类型（如对称NAT），coturn等主流实现可适配多数场景；
• 媒体端口范围：需开放足够的媒体端口（建议49152-65535），避免因端口不足导致中继失败；
• 凭证安全：生产环境优先使用临时凭证（TOTP）替代静态密码，降低凭证泄露风险。

内容的提问来源于stack exchange，提问作者alexandgu