[Bambu Lab] Home Assistant를 Docker Compose에 설치해보자

2015년에 처음 3D 프린터를 접하고 거의 4~5 종류의 프린터를 사용해본 것 같다.

처음 구매한 3D 프린터는 Sunhokey Prusa i3 제품이었다.
Original Prusa i3랑은 완전히 연관이 없는 제품이다. 프레임은 전부 아크릴이고 연마봉으로 된 레일, RAPMS 1.4 보드,
아두이노 메가, 2004 LCD 조합으로 된 제품이었다.

모터가 나름 소음이 적은 제품이어서 쓸만했던 것으로 기억한다.
테스트용 필라멘트로 ABS를 출력하다가 수축이 너무 심해서 바로 PLA를 따로 구매했다.
(알리 판매자는 왜 ABS를 보내줬을까....)

자작도 몇번 해보고 마지막으로 Original Prusa i3 MK3를 Prusa Bear로 모딩을 하고 한동안 잘 사용하다가
주변에서 계속 뱀부랩 뱀부랩 하는 이야기를 들었다. 좋아봐야 얼마나 좋겠어...? 싶었는데 다 죽어버린 3D프린터 시장에서
계속 이야기가 들리는게 믿기지가 않았다. 지인이 마침 한 대를 팔아도 된다고 해서 출력 테스트를 보고 바로 구매했다.
600mm/s라는 말도 안되는 속도로 출력이 가능하다고 해서 테스트 해봤는데 이미 기본 출력 속도가 너무 빨라서 충격을 먹었다.

여튼 Bambu Lab P1S를 사용하다보니 내수용이라 불편한 점이 꽤 많았다.
핸디앱이 지원이 되지 않는다는 점이 가장 컸고 이를 해결하기 위해서 HA (Home Assistant)나 Octoeverywhere 같은
서드파티 앱을 사용한다고 들어서 이 참에 HA를 구성해보기로 했다.
참고로 Octoeverywhere도 인터페이스가 깔끔해서 좋았지만 제어가 안된다는 점이 가장 컸다.

서버 환경 구성
Intel N100 CPU + 16GB RAM + 512GB NVMe (https://09labs.tistory.com/57)
Openmediavault에 Docker engine 설치

Compose 파일 작성

services:
  homeassistant:
    container_name: homeassistant
    image: "ghcr.io/home-assistant/home-assistant:stable"
    volumes:
      - /root/ha/config:/config
      - /etc/localtime:/etc/localtime:ro
      - /run/dbus:/run/dbus:ro
    restart: unless-stopped
    privileged: true
    network_mode: host

volumes의 /config 디렉토리를 호스트쪽 /root/ha/config로 변경하였다 (OMV에서 Shared 폴더 사용)

HACS (Home Assistant Community Store) 설치
HACS는 컨테이너에 접속해서 직접 설치해줘야 한다. 이 부분은 나중에 compose 파일에 녹여내거나 Dockerfile을 따로 작성하는게 좋을듯 싶다.

$ wget -O - https://get.hacs.xyz | bash -
Connecting to get.hacs.xyz (172.67.68.101:443)
Connecting to raw.githubusercontent.com (185.199.109.133:443)
writing to stdout
-                    100% |***********************************************************|  4990  0:00:00 ETA
written to stdout
INFO: Trying to find the correct directory...
INFO: Found Home Assistant configuration directory at '/config'
INFO: Creating custom_components directory...
INFO: Changing to the custom_components directory...
INFO: Downloading HACS
Connecting to github.com (20.200.245.247:443)
Connecting to github.com (20.200.245.247:443)
Connecting to objects.githubusercontent.com (185.199.110.133:443)
saving to 'hacs.zip'
hacs.zip             100% |***********************************************************| 18.1M  0:00:00 ETA
'hacs.zip' saved
INFO: Creating HACS directory...
INFO: Unpacking HACS...

INFO: Verifying versions
INFO: Current version is 2025.6.1, minimum version is 2024.4.1

INFO: Removing HACS zip file...
INFO: Installation complete.

INFO: Remember to restart Home Assistant before you configure it

설치 완료 후 HA를 설정하려면 8123 포트로 접속한다.
compose.yaml에서 network를 host로 해놨기 때문에 Docker engine이 돌아가는 서버의 IP로 접속하면 된다.
설치 완료 후 HACS를 설정하기 위해선 재부팅 1회 필요.

---

HACS 및 HA-Bambulab 설치

HACS 설치 후 재부팅이 완료되면 설정 -> 기기 및 서비스로 들어간다.

우측 하단 통합구성요소 추가하기를 눌러서 HACS를 검색한다.

HA-Bambulab 공식 문서에서 Automatic Install에 존재하는 Open HACS REPOSITORY ON MY를 누르면 HACS를 통해 자동으로 BambuLab 컴포넌트를 추가할 수 있다.

---

Bambu Lab 프린터 연동

Bambu Lab 프린터는 내수 / 글로벌 버전으로 나뉜다. 내수 버전은 중국 내수용으로 Bambu Handy 어플이 지원이 안된다.
즉, 지금과 같이 Home Assistant나 Octoeverywhere과 같은 서드파티로 연결해야한다.

설정 순서
- Bambu Lab 컴포넌트 설치
- 설정 - 기기 및 서비스 - 통합구성요소 추가 - Bambu Lab 컴포넌트 추가
- 프린터 설정

설정 > 우측 하단 통합구성요소 추가하기 > Bambu Lab 검색 후 클릭

Bambu Lab 프린터의 버전에 따라 아래와 같이 설정한다.
- 글로벌 : 뱀부랩 클라우드
- 내수용 : 랜모드

그 다음 프린터의 IP주소, 시리얼번호, Access Code를 입력하면 된다.

내수용 프린터에서 위 정보들을 찾기 어렵다면 아래 내용과 링크를 참고한다.
Access Code : https://wiki.bambulab.com/en/knowledge-sharing/enable-lan-mode#p1pp1s-series-printers
Serial 번호 : https://wiki.bambulab.com/en/general/find-sn#p1-series

중국 내수용 프린터는 꼭! LAN Only Mode를 활성화 해야 서드파티 앱에 연결할 수 있다.

Access Code 위치

좌측 세 번째 메뉴 > WLAN 에서 IP와 Access Code를 확인할 수 있다.

Serial 번호 위치

좌측 세 번째 메뉴 > Device > Printer 에서 확인할 수 있다.

---

Home Assistant 첫 화면

Flow rate Calibration 중이라서 위와 같이 출력중인 스트리밍 카메라 화면과 출력물 섬네일이 표시되었다.

일단 위 과정까지 마무리하고 대시보드 꾸미는 것은 차츰 진행해야겠다. 찾아보니 lovelace 플러그인을 활용하고
대시보드를 꾸미기 위해서는 YAML을 수정해서 구성하는 것으로 예상된다.