FastRTC项目部署指南：TURN服务器配置详解

时泓岑Ethanael

于 2025-06-10 09:07:58 发布

阅读量390

点赞数 5

本文链接：https://blog.youkuaiyun.com/gitblog_00390/article/details/148550218

版权

FastRTC项目部署指南：TURN服务器配置详解

fastrtc The python library for real-time communication 项目地址: https://gitcode.com/gh_mirrors/fa/fastrtc

前言

在实时音视频通信应用中，WebRTC技术因其低延迟、高质量的特性而广受欢迎。然而，当我们将FastRTC项目部署到云环境（如Hugging Face Spaces、RunPod等）时，往往会遇到网络限制直接连接的问题。本文将深入探讨如何通过配置TURN服务器来解决这一问题，确保您的FastRTC应用在各种网络环境下都能稳定运行。

什么是TURN服务器？

TURN（Traversal Using Relays around NAT）服务器是一种中继服务器，当WebRTC的P2P连接因网络限制无法直接建立时，它会作为中间节点转发音视频数据。虽然这会增加一些延迟，但在复杂网络环境下是确保连接成功的必要手段。

部署方案选择

1. 托管型TURN服务（推荐方案）

某云服务商提供了托管型TURN服务器服务，与Hugging Face合作提供每月10GB的免费流量配额。

使用Hugging Face Token

from fastrtc import Stream, get_turn_credentials_async

# 设置HF_TOKEN环境变量或直接传入
TOKEN = "hf_..."  # 注意不要提交到代码仓库

async def get_credentials():
    return await get_turn_credentials_async(hf_token=TOKEN)

stream = Stream(
    handler=...,
    rtc_configuration=get_credentials,
    server_rtc_configuration=get_turn_credentials(ttl=360_000),
    modality="audio",
    mode="send-receive",
)

最佳实践建议：

客户端使用短期凭证（默认10分钟有效期）
服务端可配置较长有效期的凭证（如示例中的360,000毫秒）
虽然服务端配置非必须，但建议同时配置以提高可靠性

使用云服务API Token

当免费配额用尽后，可创建账户继续使用：

创建云服务账户
在控制台创建TURN应用
获取Turn Token ID和API Token

from fastrtc import Stream, get_turn_credentials_async

# 设置TURN_KEY_ID和TURN_KEY_API_TOKEN环境变量
stream = Stream(
    handler=...,
    rtc_configuration=get_turn_credentials_async,
    modality="audio",
    mode="send-receive",
)

2. 第三方API方案

某第三方服务是另一种流行的TURN服务提供商，提供免费试用额度。

基础配置方式

from fastrtc import Stream
from thirdparty.rest import Client
import os

# 配置第三方服务凭证
account_sid = os.environ.get("THIRD_PARTY_ACCOUNT_SID")
auth_token = os.environ.get("THIRD_PARTY_AUTH_TOKEN")

client = Client(account_sid, auth_token)
token = client.tokens.create()

rtc_configuration = {
    "iceServers": token.ice_servers,
    "iceTransportPolicy": "relay",  # 强制使用中继
}

Stream(
    handler=...,
    rtc_configuration=rtc_configuration,
    modality="audio",
    mode="send-receive"
)

简化配置方式

FastRTC提供了便捷的封装方法：

from fastrtc import get_thirdparty_turn_credentials

# 自动读取THIRD_PARTY_ACCOUNT_SID和THIRD_PARTY_AUTH_TOKEN环境变量
rtc_configuration = get_thirdparty_turn_credentials()

3. 自建TURN服务器

对于需要完全控制的场景，可以自行部署TURN服务器。FastRTC提供了云服务部署脚本简化这一过程。

部署准备

安装云服务CLI工具
创建具有必要权限的IAM用户
创建密钥对

部署步骤

修改parameters.json配置文件：
- KeyName: 创建的密钥对名称
- TurnUserName/TurnPassword: TURN服务器认证信息
- InstanceType: 实例规格（t3.micro等）
执行部署命令：

cloudformation create-stack \
  --stack-name turn-server \
  --template-body file://deployment.yml \
  --parameters file://parameters.json \
  --capabilities CAPABILITY_IAM

等待部署完成并获取服务器信息：

cloudformation describe-stacks \
  --stack-name turn-server \
  --query 'Stacks[0].Outputs' > server-info.json

客户端配置

from fastrtc import Stream

rtc_configuration = {
    "iceServers": [
        {
            "urls": "turn:服务器IP:80",
            "username": "配置的用户名",
            "credential": "配置的密码"
        },
    ]
}

Stream(
    handler=...,
    rtc_configuration=rtc_configuration,
    modality="audio",
    mode="send-receive"
)

方案对比与选型建议

| 方案 | 优点 | 缺点 | 适用场景 | |------|------|------|---------| | 托管服务+Hugging Face | 免费10GB/月，简单易用 | 流量有限 | 小型项目、原型开发 | | 托管服务付费 | 稳定可靠，全球节点 | 需要付费 | 生产环境、商业应用 | | 第三方服务 | 免费试用额度 | 后续需要付费 | 短期项目、测试环境 | | 自建服务器 | 完全控制，无流量限制 | 维护成本高 | 企业级应用、高安全性需求 |