如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
SFU(选择性转发单元)是一种将单个流分发给大量对等端的机制。当对等端直接连接到流发送端时,需要为每个对等端分配资源进行流编码,这会导致仅少数几个对等端就迅速耗尽资源。SFU通过simulcast接收多个流,并根据远程对等端的可用资源选择性地转发流,无需实际重新编码流,从而有效解决资源消耗问题。
配置通过单个config.js文件进行管理。
| 名称 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| signallingURL | String | 'http://localhost:8889' | 指向要连接的信令服务器的URL |
| SFUId | String | 'SFU' | 此对等端的名称,将显示在流发送端列表中。希望从此SFU接收流的对等端应订阅此ID |
| subscribeStreamerId | String | 'DefaultStreamer' | SFU应订阅并重新流式传输的流发送端名称 |
| retrySubscribeDelaySecs | Number | 10 | 如果订阅指定流发送端失败,等待多少秒后重试 |
| mediasoup | Object | Mediasoup相关配置选项,详见下文 |
| 名称 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| worker | Object | Worker相关配置选项,详见下文 | |
| router | Object | Router相关配置选项,详见下文 | |
| webRtcTransport | Object | WebRTC传输相关配置选项,详见下文 |
Worker相关配置选项
| 名称 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| rtcMinPort | Number | 40000 | ICE、DTLS、RTP等使用的最小RTC端口 |
| rtcMaxPort | Number | 49999 | ICE、DTLS、RTP等使用的最大RTC端口 |
| logLevel | String | 'debug' | Worker的日志级别,参见Mediasoup 文档 |
| logTags | Array<WorkerLogTag> | 日志中包含的日志标签,参见Mediasoup 文档 |
Router相关配置选项
| 名称 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| mediaCodecs | Array<RtpCodecCapability> | 支持的编解码器,参见Mediasoup 文档 |
WebRTC传输相关配置选项
| 名称 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| listenIps | Array<TransportListenIp | String> | |
| initialAvailableOutgoingBitrate | Number | 初始可用出站比特率(单位:bps/比特每秒) |
platform_scripts/文件夹中提供了适用于Windows和Linux的多个脚本,这是在常见情况下启动服务器的最简单方法,也可作为新场景的参考。
充分利用SFU的最佳方式是让单个流发送端使用simulcast向SFU流式传输,然后让对等端订阅SFU流。
使用以下参数启动流媒体应用:
-SimulcastParameters="1.0,5000000,20000000,2.0,1000000,5000000,4.0,50000,1000000"
此参数告诉Pixel Streaming插件使用simulcast传输3个流,每个流的视频分辨率减半。参数值序列格式为:缩放因子,最小比特率,最大比特率,...(为每个流重复)
当流传输到SFU时,SFU将检测这3个流,然后根据连接的对等端的连接质量选择性地将这些流转发出去。
Docker镜像需要知道要连接的信令服务器位置。需设置SIGNALLING_URL环境变量指向信令服务器的URL,该URL需要指向已配置的SFU端口(默认8889)。
由于SFU收集和报告可用端口的方式,必须在Docker中使用host网络驱动。
运行示例:
docker
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。



来自真实用户的反馈,见证轩辕镜像的优质服务