Налаштування першого принтера¶
Цей посібник проведе вас через додавання першого принтера до BamDude.
Передумови¶
Перед додаванням принтера переконайтеся:
- BamDude запущений (Встановлення або Docker)
- Принтер увімкнений та підключений до мережі
- SD-карта вставлена в принтер
- Developer Mode увімкнений (інструкція)
- У вас є IP-адреса, серійний номер та код доступу
Додавання принтера¶
Принтер можна додати двома шляхами: дозволити BamDude автоматично знайти його в LAN (найшвидше) або вписати IP / access-code / serial вручну.
Варіант A — Автодискаверинг у LAN¶
- Відкрийте BamDude → Printers → Add Printer → Discover on LAN.
-
Виберіть метод дискаверингу під ваш інстал:
BamDude слухає SSDP broadcast-и. Принтери Bambu Lab анонсують себе в LAN кожні кілька секунд і автоматично з'являються у списку дискаверингу. Натисніть Start, почекайте ~10 секунд, виберіть свій принтер зі списку.
SSDP працює, поки контейнер на
network_mode: host(див. Docker → Host-mode compose). Той самий потік, що й нативний інстал.SSDP-multicast не перетинає bridge, тож автоматичний список може лишитися порожнім. Скористайся subnet picker (нижче) з опцією Custom subnet… під твою LAN — BamDude активно перевіряє кожен хост на цьому subnet замість того, щоб покладатися на multicast. На
/24це завершується менш ніж за хвилину. -
Шукаєш через router чи VLAN? Діалог завжди показує subnet picker. За замовчуванням він сканує subnet самого сервера через SSDP, але SSDP-multicast не перетинає router чи межі VLAN — тож принтер на іншому сегменті мережі, ніж сервер, ніколи не з'явиться. Вибери Custom subnet…, щоб відкрити поле CIDR, введи subnet принтера (наприклад,
10.1.1.0/24) — і BamDude запустить активний unicast scan цього діапазону замість SSDP. Останній введений custom subnet запам'ятовується на наступний раз.Порти мають бути доступні через межу мережі
Cross-subnet сканування знайде принтер, лише якщо порти FTP (990) та MQTT (8883) маршрутизуються від сервера до сегмента принтера. Спершу відкрий їх на будь-якому firewall / router ACL між двома мережами — інакше принтер лишиться невидимим навіть із правильним CIDR.
-
Натисніть на принтер у списку результатів. BamDude підставить IP та Serial автоматично — лишиться лише ввести Access Code.
- Перейдіть до Кроку 3 — Збережіть та підключіть.
Право для дискаверингу
Маршрути дискаверингу потребують права discovery:scan. Дефолтні групи
Administrators та Operators його мають; Viewers — ні.
Варіант B — Ручне введення¶
Використовуйте, коли дискаверинг недоступний (інший VLAN, mDNS заблоковано, обмежене середовище) або ви вже знаєте дані підключення принтера.
- Відкрийте BamDude у браузері
- Перейдіть на сторінку Printers
- Натисніть кнопку Add Printer
- Виберіть Enter manually
Крок 2: Введіть дані принтера¶
| Поле | Опис | Приклад |
|---|---|---|
| Name | Зрозуміла назва принтера | Workshop X1C |
| Model | Виберіть модель зі списку (X1C, P1S, A1 Mini, H2D, …). BamDude використовує її, щоб увімкнути model-specific фічі (двері-сенсор, dual nozzle, AMS-HT) ще до того, як MQTT це підтвердить. | X1 Carbon |
| IP Address | Локальна IP-адреса принтера (автодискаверинг заповнює сам) | 192.168.1.100 |
| Access Code | 8-символьний код з Developer Mode | 12345678 |
| Serial Number | Серійний номер принтера (автодискаверинг заповнює сам) | 01P00A000000001 |
З'єднання перевіряється перед збереженням принтера
Коли тиснеш Add, BamDude спершу пробує під'єднатися до принтера по MQTT. Якщо не вдається — невірний access code, невірний IP, або принтер вимкнено / не в LAN-Only Mode — додавання відхиляється з поясненням, і нічого не зберігається, тож ти ніколи не отримаєш мертву порожню картку принтера. Переконайся, що принтер увімкнено й доступний, перед додаванням.
Вибір моделі важливий
BamDude виводить кілька можливостей з моделі — детекцію стану дверей, UI dual nozzle, рендер AMS-HT слотів, фільтрацію завдань обслуговування (carbon/steel rod проти linear rail). Помилковий вибір моделі сховає або покаже не ті фічі. Якщо не впевнені, до якого класу належить ваш принтер, перевірте матрицю можливостей.
Крок 3: Збережіть та підключіть¶
- Натисніть Save
- BamDude спробує підключитися до принтера
- Дочекайтеся, поки індикатор з'єднання стане зеленим
Bambu Cloud (опціонально, per-user)¶
Прив'язка вашого Bambu-аккаунта вмикає cloud-only фічі: перевірку оновлень прошивки, cloud-каталог філаментів, slicer-setting профілі. Кожен користувач BamDude зберігає власні cloud-credentials — адміни не діляться своїм Bambu-аккаунтом з операторами чи viewers.
- Відкрийте Settings → Cloud під логіном того користувача, якого хочете прив'язати.
- Виберіть регіон —
global(дефолт, EU/US/AS) абоchina. Регіон мапиться на інший endpoint Bambu Cloud; помилковий вибір видастьLogin failed. - Введіть email + password. Якщо у вашому Bambu-аккаунті увімкнено 2FA, далі система запитає код підтвердження.
- Токен зберігається зашифрованим на рядку користувача. Інші користувачі на тому ж BamDude-інсталі його не бачать і не використовують.
Auth вимкнено?
На інсталях, де auth вимкнено (рідкість — auth увімкнено за замовчуванням
з 0.4.0), cloud-токен фолбекає на глобальну таблицю Settings замість
per-user сховища.
Перевірка з'єднання¶
Успішно підключений принтер відображає:
| Елемент | Опис |
|---|---|
| Зелений індикатор | З'єднання активне |
| Температури в реальному часі | Показники сопла, столу та камери |
| Статус HMS | Health Management System показує "OK" |
Проблеми з підключенням?¶
- Developer Mode увімкнений? Перевірте LAN Only Mode та Developer Mode
- Правильна IP-адреса? Перевірте в мережевих налаштуваннях принтера
- Актуальний код доступу? Коди змінюються при перемиканні Developer Mode
- Та сама мережа? Сервер BamDude та принтер мають бути в одній локальній мережі
- Правила файрволу? Переконайтеся, що порти 8883 (MQTT) та 990 (FTPS) відкриті
Дивіться повний Посібник з вирішення проблем.
Додавання інших принтерів¶
Повторіть процес для додавання інших принтерів. BamDude підтримує необмежену кількість принтерів -- керуйте всією фермою друку з одного інтерфейсу.
Наступні кроки¶
Базується на документації Bambuddy.