本工具将协助您对监控设备进行编码兼容性一键自测。无论您使用的是工程安防级监控，还是智能家居消费级产品，本测试都能帮您快速评估接入难度，并为您规划最节能、延迟最低的流传输方案。
⚡ 什么是 Go2RTC？
传统的摄像头接入 HomeKit（例如通过 Homebridge 插件），通常需要在后台运行一个笨重的 Node.js 环境，视频流经过多层第三方插件转发、重封装，极易造成画面卡顿、网关发热、以及高达 3-5 秒的延迟。
Go2RTC 是一款功能强大的通用摄像头流媒体服务器，专为解决安防监控领域的视频协议兼容性与低延迟传输难题而设计。它能够作为一个高效的中转网关，将各类传统的监控视频流汇聚并转换为现代化的 Web 友好协议。
多协议互通与极低功耗
原生支持 RTSP、RTMP、WebRTC、HLS 等主流协议，无缝对接不同设备。当使用 H.264 编码时可实现 zero-CPU 损耗直接透传，极适合在 NAS 或树莓派上长期运行。
0.2秒极致低延迟
利用 WebRTC 等技术，Go2rtc 能将 RTSP 视频底层打包为 Apple 专用的加密流（SRTP），将视频传输延迟降低至毫秒级，提供真正实时的监控体验。
轻量级架构与灵活扩展
采用 Go 语言开发，编译为独立的二进制文件，零外部依赖。既支持 Docker 容器化部署，也能完美集成到 Home Assistant 等智能家居系统中。
🎯 摄像头参数匹配测试
请根据您打算添加的设备编码，自检是否能直接免转码连接：
国产品牌的摄像头（如海康、大华、TP-Link）通常视频是 H.264，音频是 G.711。Go2rtc 的强大之处在于它可以做到：视频直接转发不耗 CPU，只对音频实施高效转码。
📹 国内主流摄像头品牌情况说明
全球安防监控巨头，几乎全系原生支持标准拉流协议。编码注意：新设备出厂可能默认为 H.265。您可以直接在第二步配置器中选择 H.265 让程序自动转码，或登录摄像头后台将其改为 H.264 以实现零损耗直连。避坑：萤石设备需先在 App 中关闭视频加密选项，否则拉流会显示花屏或无法播放。
知名监控安防品牌，拥有极佳的标准流兼容性。编码注意：较新的机型出厂默认多为 H.265 编码。建议您确认当前编码并在配置器中对应选择，或进入摄像头后台修改为 H.264。避坑：乐橙摄像头的拉流密码并非云账号密码，而是机身贴纸上印着的 8 位大写字母设备安全码。
高性价比的安防品牌，原厂支持RTSP和ONVIF协议。编码注意：为节省内存，新款设备往往默认开启 H.265。可在摄像头后台将视频编码切回 H.264 获得极速秒开体验。只需在 TP-LINK 安防 APP 中完成设备激活并牢记设置的管理密码，即可使用通用流地址轻松拉流。
高端极客玩家首选。UniFi 官方控制台提供了一键生成 RTSP 流的直观按钮，且音频轨道原生即为标准高动态 AAC 音轨，Go2rtc 能够以 100% 零解码、零重包的形式透传至 HomeKit，体验最为完美。
小米/米家摄像头原生不支持 RTSP 协议，它使用的是私有 P2P 协议和云端加密传输。可以利用第三方开源工具（如 Micam 或 Go2RTC 内置协议）建立桥接服务，将小米摄像头的视频流无感转换为标准 RTSP 协议接入。
绿米摄像头通常原生支持 HomeKit，无需此配置。若要使用支持 RTSP 的摄像头（如 G100、G5 Pro WiFi、G4 智能门铃），可以在设备设置中手动开启 RTSP 选项，随后即可获取到流 IP 地址、用户名及密码等信息，完美接入。
本配置生成器支持国内主流安防及智能家居品牌。只需选择您的设备品牌、输入设备相关凭证，系统就会采用该品牌的官方协议格式全自动拼接出标准 URL，并为您自动判断编码格式并写入自适应转码指令。
⚙️ 参数输入配置
✅ 推荐：字母、数字、下划线 _、横杠 -
❌ 禁止：中文、空格、井号 # 等特殊字符
⚠️ 苹果协议机制：PIN 码禁止设为 123-45-678 等简单密码，会导致服务启动失败报错。
📡 流输入凭据与地址
📋 保存配置指引
点击上方代码面板右上角绿色的"一键复制代码"按钮。
在浏览器新标签页访问您的 Go2rtc 管理控制台（如：http://IP:1984），并点击顶部菜单栏的 Config 标签。
在 Config 页面的文本编辑框中，将代码粘贴（或追加）到原有内容的空行里，随后点击页面上方的 Save & Restart 按钮。
等待重启完成。至此，新摄像头已被 Go2rtc 加载并已在后台广播。可直接点击上方选项卡前往 "第三步：设备配对向导" 开始连接！
👥 局域网多摄像头合并配置及语法规范指南
1. 空格缩进防报错法则 (YAML 核心机制)
Go2rtc 的核心配置文件遵循严格的 YAML 语法。YAML 文件内绝对禁止使用 Tab（制表符）键进行缩进！所有缩进必须使用纯空格。
- 每一层级统一使用 2 个空格进行右移缩进。
- 冒号后面必须紧跟一个英文空格（例如
streams:换行缩进后写living_room: rtsp://...）。
2. 与原有配置文件和平共存
如果您的 Go2rtc 在 Web UI 已经登录了小米账号，或者在群晖/软路由部署时原本配置了后台密码：
- 不要全选覆盖整个文件！ 这样会不小心抹除掉已登录小米账号自动生成存放在最底部的 Token。
- 正确做法是：找到文件中的
streams:和homekit:行，仅将本配置器生成的流子项复制并追加到对应的大分类下。
📌 多个摄像头合并标准范例：
# 统一写一个 streams 大节点，子设备不要重复写 streams 根标签
streams:
living_room: ffmpeg:rtsp://admin:pass@192.168.1.120:554/stream1#video=copy#audio=aac
balcony_cam: rtsp://admin:pass@192.168.1.121:554/h264/ch1/main/av_stream
# 统一写一个 homekit 大节点，子设备逐一平行向右缩进配置
homekit:
living_room:
name: "客厅监控"
pin: "482-59-136"
backchannel: true # 如果你的摄像头支持双向对讲，可加入此项
balcony_cam:
name: "阳台监控"
pin: "482-59-136"当您的 Go2rtc 程序服务已经完成加载后，请参考下方的小白专属配对引导流程。不需要专业编程知识，通过手机镜头和自带的家庭 App 即可简单建立安全的端到端连接。
环境准备：
你需要一台 24 小时运行的设备（Linux 服务器、NAS、HAOS或树莓派）安装运行Go2RTC服务，推荐使用 Docker安装。
打开Go2RTC管理后台
已在"第二步：配置生成器"中完成了配置文件的粘贴与重启。此时请在浏览器中再次刷新并打开 Go2rtc 的管理后台：
注：IP 指的是您安装 Go2rtc 服务的 NAS、软路由、服务器等宿主设备的内网 IP 地址。
一键获取配对码
1. 访问 Go2rtc 首页，会看到新加的设备列表（例如刚配置的摄像头）。
2. 点击设备行右侧的 "links" 按钮，即可进入该流的管理页面。
3. 找到 HomeKit server，即可看到该设备的：
Setup Code: 482-59-136
配对二维码
注：点击设备行右侧的 "stream" 按钮可以直接在网页端预览实时监控画面。
扫码连入 Apple 家庭
保持您的 iPhone / iPad 与 Go2rtc 处于相同的局域网 Wi-Fi 下：
- 打开手机自带的 "家庭" App
- 点击右上角 "+" 号 ➔ "添加或扫描配件"
- 扫描屏幕二维码或手动输入 PIN 码
💡 如果扫描设备无法添加，可以点击"更多选项"，里面会列出局域网内添加的设备。
💡 如果你是在 Docker 中运行的 go2rtc，默认的网桥模式（Bridge）会隔离 mDNS（Bonjour）广播，导致 iPhone 根本找不到这个虚拟配件。
解决方法：将 go2rtc 容器的运行网络模式修改为 Host（主机模式）。
配对完成后，即可直接通过 iOS 家庭 App 控制与查看。
🚨 小白高频疑难解答
在扫码时，iPhone 极有可能会弹出 "未认证的配件，是否仍然添加？" 警示信息。请不必担心。由于这是第三方的开源软件实现，并未向 Apple 官方缴纳授权费完成商业 MFi 认证。这不会影响您的家庭局域网数据安全性，请大方点击 "仍然添加" 完成配对。
本章为您归纳了在部署及日常使用过程中最容易遇到的几类疑难杂症（如：黑屏、延迟、对讲无声音等），并运用直观的可视化数据，对比阐释原生方案的核心运行效能。
📊 流畅度与延迟多维对比分析
原生网关直接省去了第三方冗余调用消耗，大大提高了系统容错能力：
🩺 自助症状排查与终极修复
根据您的异常状况，点击进行展开诊断：
❓ 扫码后一直提示"找不到配件"，局域网根本搜不到设备？▼
症状表现：手机扫码后长时间转圈，最后提示添加失败。如果您使用网络抓包或 mDNS 扫描工具（如 Discovery App），会发现在 _hap._tcp. 协议下根本找不到这个摄像头的踪影。
问题根源：这是一个极易踩雷的网络多播广播问题。Go2rtc 内置的 mDNS 广播机制在设备处于"未配对状态（sf=1）"时，在部分系统环境（特别是 Docker 部署下）极不稳定，导致苹果设备（iPhone/Mac）在局域网内根本"看不见"这个待添加的虚拟配件。
终极修复方案：
1. 基础网络排查：再次确认您的 Go2rtc Docker 容器网络模式已设置为 Host（主机模式），绝对不能是 Bridge（网桥模式）。
2. 底层 Avahi 接管（高阶必杀技）：如果确认了 Host 模式依然搜索不到，说明系统的 mDNS 广播通道被占用或阻塞。最终可用的完美架构是：让 Go2rtc 独立在 Docker 中运行，并依靠宿主机系统（如 Linux/NAS/软路由）自带的 avahi-daemon 服务来统一负责 mDNS 的网络广播。这样苹果设备就能瞬间发现并秒开配对。
❓ 日志报错"insecure PIN"导致服务启动失败？▼
这是因为您使用了过于简单或极易猜测的 PIN 码（如本应用之前默认的 123-45-678，或全相同数字的 111-11-111、000-00-000）。
苹果 HomeKit (HAP) 官方安全保护机制限制：Apple 强制要求所有接入 HomeKit 的第三方设备物理 PIN 码必须具备中等以上的复杂度检测。任何递增、递减或重复数字序列均会被 Go2rtc 底层直接判定为"不安全（insecure）"并拒绝加载，从而导致控制台页面不显示二维码，服务报错崩溃。
修复方案：请将 PIN 码修改为一个随机的、无规律的 8 位数字（例如我们当前生成的安全密码 482-59-136），保存配置后点击 Restart 即可完美解决该问题！
❓ 画面提示「正在加载」，一直转圈圈无画面▼
这是典型的 H.265 编码不兼容问题。因为 Apple 的 HAP 视频解码协议不支持部分流输出格式，请确保配置里在 RTSP 地址尾部加上了 #video=h264 实时转码标记，或者在摄像头后台管理系统里把输出强制改回 H.264。
❓ 画面非常顺畅，但是没有一丁点声音▼
绝大部分网络安防摄像头音频轨采用 G.711 / PCMA 格式。而苹果 HomeKit 必须使用 AAC 视频伴音或高动态 Opus 音频。您只需在 YAML 的流地址后增加 #audio=aac 转码参数，即可在几乎无 CPU 损耗的前提下自动实时转换格式。
❓ 出门断开 Wi-Fi 之后，摄像头卡死或显示无响应▼
这不是 Go2rtc 或摄像头网络问题。若想实现离开家里依然可以远程秒开查看，你的局域网里必须存在一个官方认证的「家庭中枢」设备（比如 Apple TV、HomePod Mini 或者是已经设置为控制中心的旧 iPad）。
❓ 刚配对完能看，隔了几天突然无法访问无响应？▼
这往往是由于摄像头断网重连后，路由器重新分配了不同的局域网 IP 地址（例如从 .120 漂移成了 .135）导致 Go2rtc 无法找到原流媒体源。
终极修复：建议进入您的家用路由器后台管理页面，将设备的 IP 地址设置为手动固定 IP 地址，或者通过 IP 分配设置进行客户端静态 IP 分配绑定 (DHCP 静态分配绑定)。以避免由于 IP 地址后续自动变动导致摄像机不定期出现无法访问或无响应等异常状况。