
如何为 Klipper 和 Printer Tools 配置 Crowsnest 摄像头
Klipper 的 crowsnest 摄像头
简短答案
Printer Tools 会在你的 Moonraker 主机上标准的摄像头路径查找 MJPEG 视频流,这正是使用 KIAUH、Mainsail 或 Fluidd 搭建的安装默认由 crowsnest 发布的路径。如果 crowsnest 使用默认摄像头名称,只要打印机连接成功,视频流就会自动出现。自定义路径需要单独作为外部摄像头添加。
你需要准备
- 一台已经通过 Moonraker 连接到 Printer Tools 的 Klipper 打印机
- 在同一主机上安装并运行 crowsnest,通常通过 KIAUH 完成
- 一个受 crowsnest 支持、并已在 crowsnest.conf 中配置好的 USB 或 CSI 摄像头
- 默认的摄像头名称和路径,除非你打算手动添加自定义视频流
设置 crowsnest 摄像头
- 1
确认 crowsnest 正在运行
如果你是用 KIAUH 安装的 Klipper,请从同一个菜单安装或确认 crowsnest。在检查 Printer Tools 之前,先确认该服务在打印机主机上处于活动状态。
- 2
保持默认的摄像头配置
除非有特定原因需要更改,否则让 crowsnest.conf 保持使用默认的摄像头名称和路径。默认值正是 Printer Tools 会自动请求的路径。
- 3
先在浏览器中测试视频流
在同一网络下的浏览器中直接打开标准摄像头路径。如果 MJPEG 视频流能在那里加载,那么打印机连接后 Printer Tools 也应该能以同样的方式检测到它。
- 4
在 Printer Tools 中打开摄像头视图
在 Klipper 打印机已经连接的情况下,打开它的摄像头视图。如果 crowsnest 能在默认路径上访问到,视频流应该会自动出现。
- 5
如有需要,将自定义路径作为外部摄像头添加
如果你更改了 crowsnest 的摄像头名称,或者让它运行在不同的路径或端口上,请改为通过 Printer Tools 的外部摄像头功能添加它,直接指向真实的视频流网址。
Printer Tools 中的 Klipper 摄像头


一旦 Klipper 打印机连接生效,摄像头视图就会自动加载默认的 crowsnest MJPEG 路径。
crowsnest 支持的功能
- 打印机连接后,在默认摄像头路径上自动检测 MJPEG
- 在同一个仪表盘上,与状态、温度和控制项一起实时查看画面
- 支持将重命名过的或自定义的 crowsnest 视频流作为外部摄像头添加
不会自动完成的事
- Printer Tools 对原生 Klipper 摄像头只支持 MJPEG,不支持 RTSP、RTSPS 或 WebRTC
- crowsnest.conf 中自定义的摄像头名称或非默认路径不会被自动检测到
- 分辨率、帧率和摄像头来源完全在 crowsnest.conf 中配置,而不是在 Printer Tools 中
- Printer Tools 本身不会安装或配置 crowsnest
常见摄像头问题
状态正常,但摄像头没有出现
确认 crowsnest 正在运行,并且在同一网络下可以通过默认摄像头路径访问。如果视频流在浏览器中也无法加载,问题出在 crowsnest,而不是 Printer Tools。
摄像头之前正常,配置更改后失效
检查 crowsnest.conf 中的摄像头名称或路径是否发生了变化。如果它不再匹配默认值,请将新的网址作为外部摄像头添加,而不是期望自动检测。
视频流非常卡顿或画质很差
直接在 crowsnest.conf 中调整分辨率和帧率。Printer Tools 只是显示 crowsnest 发布的内容,不会对这个摄像头应用自己的画质设置。
配置了多个摄像头,但只显示一个
Printer Tools 只会自动检测默认的摄像头路径。请通过外部摄像头功能,逐一添加其余的 crowsnest 摄像头。
在家外查看这个摄像头
通过连回你网络的 VPN,或通过经由 OctoEverywhere 或 Obico 添加的 Klipper 打印机,摄像头都会以同样的方式加载。请不要在路由器上直接转发 crowsnest 的端口。
常见问题
我需要手动输入摄像头网址吗?
不需要,只要 crowsnest 使用默认的摄像头名称和路径即可。打印机连接后,Printer Tools 会自动请求同一个默认路径。
Klipper 可以用 RTSP 或 WebRTC 代替 MJPEG 吗?
Printer Tools 中原生的 Klipper 摄像头仅支持 MJPEG。如果你的搭建能够独立提供其他协议的视频流,可以通过单独的外部摄像头功能使用。
这能配合 Raspberry Pi 摄像头模块使用吗?
可以,只要 crowsnest 配置为使用该摄像头,并在 Printer Tools 期望的默认路径上发布视频流。
为什么 Mainsail 能显示摄像头,Printer Tools 却不能?
Mainsail 可以读取 webcam.json 中的自定义摄像头配置。Printer Tools 只会自动请求默认路径,因此自定义搭建需要作为外部摄像头添加。
同一台 Klipper 打印机可以添加多个摄像头吗?
可以。通过 Printer Tools 的外部摄像头功能,添加默认摄像头以外的任意摄像头,指向每个视频流实际的网址即可。
查看完整的 Klipper 和 Moonraker 兼容性
查看受支持的 Moonraker 功能、可选的摄像头和 Spoolman 要求、远程访问方式以及当前的限制。


