Docker

Przewodnik instalacji CUBE OS za pomocą Dockera w systemach Linux.

Zainstaluj CUBE OS jako kontener Docker na hoście Linux. Ta metoda dobrze sprawdza się na serwerach domowych, urządzeniach NAS oraz zawsze włączonych maszynach z Linuxem.

Wdrażanie Docker jest obsługiwane na Tylko Linux.

Jeśli nie masz hosta z Linuxem, użyj Raspberry Pi lub maszyny wirtualnej.

1. Przygotowanie

1

Sprawdź architekturę hosta

CUBE Docker obsługuje następujące architektury Linuxa:

• amd64 (x86_64) — komputery PC, serwery, Synology NAS i podobne urządzenia

• arm64 (aarch64) — Raspberry Pi 4/5, Orange Pi i inne hosty ARM

2

Sprawdź wersję jądra Linux

Jądro 4.15 lub nowsze jest wymagane.

uname -r

Niektóre urządzenia NAS są dostarczane ze starszymi jądrami, takimi jak 4.4.x. Te hosty nie są zgodne z CUBE Docker. W takim przypadku uruchom CUBE OS zamiast tego w maszynie wirtualnej Linux.

3

Zainstaluj Docker Engine

Zainstaluj Docker Engine na hoście, zanim kontynuujesz.

Użyj oficjalnego przewodnika instalacji Dockera.

4

Sprawdź wymagane porty

Upewnij się, że porty 80 i 1883 są wolne na hoście.

sudo lsof -i :80
sudo lsof -i :1883

• 80 — interfejs webowy CUBE OS

• 1883 — broker MQTT

Jeśli inna usługa używa tych portów, najpierw ją zatrzymaj.

5

Przygotuj dongle Zigbee, jeśli jest potrzebny

Jeśli planujesz dodać urządzenia Zigbee, podłącz do hosta zgodny dongle Zigbee.

Testowane dongle Zigbee obejmują:

SONOFF ZBDongle-MAX SONOFF ZBDongle-PMG24 SONOFF ZBDongle-LMG21 SONOFF ZBDongle-E SONOFF ZBDongle-P Inne wymienione przez dewelopera @darkxst

Aby uzyskać więcej informacji na temat konfiguracji i zgodności Zigbee, zapoznaj się z tym przewodnikiem.

Więcej informacji o obsłudze Zigbee znajdziesz w tym przewodniku.

2. Pobierz obraz

1

Pobierz najnowszy obraz

docker pull ghcr.io/ewelinkcube/cube-os:latest

Możesz zastąpić latest konkretnym tagiem wersji, na przykład 2.10.3. Dostępne wersje są wymienione na GitHub Releases.

3. Uruchom CUBE OS

1

Utwórz katalog danych

mkdir -p ~/cubeos-data

Ten katalog przechowuje Twoje urządzenia, sceny i ustawienia.

2

Sprawdź ścieżkę urządzenia Zigbee, jeśli używasz jednego (opcjonalnie)

Typowe ścieżki urządzeń to:

ls /dev/ttyUSB* /dev/ttyACM*

Użyj prawidłowej ścieżki w następnym poleceniu.

3

Uruchom kontener

Użyj tego polecenia jako punktu wyjścia:

docker run -d \\
  --name cubeos \\
  --privileged \\
  --net=host \\
  -v ~/cubeos-data:/data \\
  --device /dev/ttyUSB0:/dev/ttyUSB0 \\
  -v /run/dbus/system_bus_socket:/host_dbus/system_bus_socket:ro \\
  ghcr.io/ewelinkcube/cube-os:latest

Jeśli nie używasz Zigbee, usuń --device /dev/ttyUSB0:/dev/ttyUSB0.

Jeśli nie używasz Matter Hub ani eWeLink Remote, możesz również usunąć montowanie D-Bus.

4

Zrozum główne parametry

• --privileged — wymagane do dostępu do sprzętu

• --net=host — wymagane do wykrywania w sieci LAN i MQTT

• -v ~/cubeos-data:/data — zachowuje Twoje dane po ponownym uruchomieniu kontenera

• --device /dev/ttyUSB0:/dev/ttyUSB0 — przekazuje dongle Zigbee

• -v /run/dbus/system_bus_socket:/host_dbus/system_bus_socket:ro — umożliwia dostęp do D-Bus dla obsługiwanych funkcji

4. Uzyskaj dostęp do CUBE OS

1

Potwierdź, że kontener działa

docker ps

Stan kontenera powinien pokazywać Uruchomiony.

2

Otwórz interfejs webowy

Otwórz przeglądarkę w tej samej sieci i odwiedź jeden z tych adresów:

• http://<HOST_IP>/

• http://cube.local

Zastąp <HOST_IP> adresem IP hosta Linux.

3

Później użyj krótkiego lokalnego adresu

Po konfiguracji znajdziesz krótki identyfikator na stronie ustawień.

Następnie możesz użyć cube-{short-id}.local aby zidentyfikować tę instancję CUBE OS w Twojej sieci LAN.

5. Zaktualizuj CUBE OS

Wdrożenie Docker nie obsługuje aktualizacji OTA z poziomu interfejsu webowego.

Aby zaktualizować ręcznie:

docker stop cubeos
docker rm cubeos
docker pull ghcr.io/ewelinkcube/cube-os:latest

docker run -d \\
  --name cubeos \\
  --privileged \\
  --net=host \\
  -v ~/cubeos-data:/data \\
  --device /dev/ttyUSB0:/dev/ttyUSB0 \\
  -v /run/dbus/system_bus_socket:/host_dbus/system_bus_socket:ro \\
  ghcr.io/ewelinkcube/cube-os:latest

Twoje dane pozostają w ~/cubeos-data, więc urządzenia, sceny i ustawienia pozostaną po aktualizacji.

6. Ograniczenia

Z powodu izolacji kontenera te funkcje nie są dostępne we wdrożeniach Docker:

• Dodatki — nie można instalować ani zarządzać dodatkami

• Głośnik Bluetooth — przekazywanie Bluetooth nie jest obsługiwane

• Aktualizacja systemu — aktualizacje OTA w interfejsie webowym są wyłączone

• Uruchom ponownie / Wyłącz — sterowanie zasilaniem na poziomie systemu jest niedostępne

7. Uwaga dotycząca Raspberry Pi

Jeśli uruchamiasz Docker na Raspberry Pi, upewnij się, że rozmiar strony wynosi 4096:

getconf PAGE_SIZE

# Jeśli wynik nie wynosi 4096, dodaj tę linię i uruchom ponownie
echo "kernel=kernel8.img" | sudo tee -a /boot/firmware/config.txt
sudo reboot