
如何填写 OctoPrint 基础 URL、端口和子路径
大多数 OctoPrint 连接错误都是从几乎正确的地址开始的。方案、主机、端口及可选的反向代理子路径必须描述服务根目录。
Printer Tools 通过本地协议与受支持的打印机和摄像头通信。保持设备私密,保护凭证,并使用当前的兼容性矩阵作为特定型号功能的权威参考。
从方案和主机开始
根据实际端点使用 http 或 https,并输入当前私有 IP 或受信任的本地主机名。只在一台计算机上解析的主机名在手机上无法使用。
仅在需要时添加端口
直接 OctoPrint 通常使用配置的非默认端口,而反向代理可能使用标准的 80 或 443。不要复制摄像头端口。
添加一个基础子路径
如果代理在 /octoprint/ 下发布 OctoPrint,只需包含该基础路径一次。除非应用程序明确要求,否则不要附加 /api 或特定浏览器页面。
检查规范化和重定向
尾部斜杠不应产生循环或重复路径。在相同的网络环境中测试基础路径,并确认重定向仍在可访问的主机名上。
本地故障排除检查清单
- 确认协议和可访问的主机。
- 使用服务端口。
- 只包括一次代理子路径。
- 保持摄像头和API URL分开。
常见问题
URL 应该以 /api 结尾吗?
通常不需要。除非应用程序另有说明,否则请输入配置好的 OctoPrint 基础路径。
我可以使用 localhost 吗?
仅在运行 OctoPrint 的机器上使用;在手机上,它指的是手机自身。
为什么摄像头 URL 不同?
OctoPrint 可以引用具有自己主机、端口和路径的独立网络摄像头服务。




