Bambu Lab Local Control

核心用法

Bambu Local 是一款针对 Bambu Lab 系列 3D 打印机的本地控制工具，通过 MQTT 协议实现与打印机的直接通信，完全绕过官方云服务。用户需配置打印机 IP、访问码和序列号后即可通过命令行执行操作。

主要功能覆盖：

• 状态监控：实时获取打印机运行状态
• 灯光控制：开关打印机照明灯
• 打印控制：暂停、恢复、停止当前打印任务
• 速度调节：四档速度模式（静音/标准/运动/极速）
• 温度管理：独立调节热床与喷嘴温度
• G-code 指令：直接发送自定义 G-code 命令

显著优点

1. 隐私与独立性：纯本地通信，无需绑定 Bambu 账号，避免云端数据上传
2. 低延迟控制：局域网直接通信，响应速度快于云端中转
3. 功能完整：覆盖日常打印管理的核心需求，从监控到干预一应俱全
4. 多型号兼容：支持 A1/A1 Mini/P1P/P1S/X1C 等主流机型

潜在局限

• 配置门槛：需手动从打印机获取 IP、访问码、序列号三项参数
• 功能边界：不支持云端的模型库、切片服务、远程监控等高级功能
• 安全风险：明文存储访问凭证于本地配置文件，多用户环境需注意权限管理
• 维护状态：依赖社区驱动，官方 API 变更可能导致功能失效

适合人群

• 注重隐私、希望脱离云服务的 3D 打印爱好者
• 需要集成打印机控制到本地自动化工作流的高级用户
• 局域网环境下追求低延迟响应的生产场景

常规风险

• 配置文件若权限设置不当，可能导致打印机访问凭证泄露
• 直接发送 G-code 存在误操作风险，可能损坏打印机或引发安全事故
• 非官方逆向工程实现，存在因固件更新导致兼容性问题的不确定性

核心用法

Bambu Local 是一款面向 Bambu Lab 系列 3D 打印机的本地控制工具，通过 MQTT 协议实现与打印机的直接通信，完全绕过云端服务。用户需先配置打印机的 IP 地址、访问码和设备序列号，即可通过命令行工具执行状态查询、灯光控制、打印管理（暂停/恢复/停止）、速度调节（四档模式）、温度设置及自定义 G-code 发送等操作。

显著优点

1. 零云依赖隐私保护：所有通信限于本地网络，打印数据不上传任何外部服务器，符合 GDPR 数据最小化原则。
2. 轻量化设计：核心代码仅 151 行 Python，依赖单一成熟库 paho-mqtt，无冗余功能。
3. 多型号兼容：完整支持 A1/A1 Mini、P1P/P1S、X1/X1C 等主流机型。
4. 实时双向通信：基于 MQTT 的消息机制确保状态同步及时，响应延迟低。

潜在局限

• 自签名证书妥协：因打印机使用自签名证书，代码被迫禁用 TLS 证书验证，虽为必要设计，但理论上存在局域网中间人攻击风险（需先侵入内网）。
• 个人维护项目：上游 OpenBambuAPI 为个人开发者维护（T3 级别），长期更新和漏洞修复依赖社区贡献。
• 配置门槛：需手动从打印机获取三项参数并编辑 JSON 文件，对非技术用户不够友好。
• 功能范围限定：仅支持基础控制指令，无法替代 Bambu Studio 的切片与模型管理功能。

适合人群

• 注重隐私、希望完全掌控打印数据的进阶用户
• 具备基础 Linux/命令行操作能力的技术爱好者
• 已将打印机部署于隔离网络环境的企业/工作室场景
• 需集成打印机控制至自动化工作流（如 Home Assistant）的开发者

常规风险

• 网络隔离重要性：建议将打印机置于独立子网或 VLAN，避免 IoT 设备与关键资产混网。
• 配置凭证保护：config.json 包含访问码等敏感信息，需确保文件权限正确（建议 600）。
• 上游依赖监控：定期检查 paho-mqtt 及 OpenBambuAPI 的安全公告，及时更新。