Docker
Co to je: Platforma pro běh aplikací v kontejnerech: izolovaných procesech spuštěných z připravených images. V homelabu je to standardní způsob, jak provozovat služby jako Node-RED, Home Assistant nebo MQTT broker bez instalace do systému.1 Aktuální je Docker Engine 29.8.2 a Compose 5.6.0 (09–10/2026).1
Základní pojmy
Klient, daemon, registry, kontejnery, sítě a volumes. Vlastní schéma (Syntéza) podle dok. Docker1.
- Image: read-only šablona z vrstev. Stahuje se z registry, výchozí je Docker Hub.1
- Kontejner: běžící instance image. Co neleží ve volume nebo bind mountu, po odstranění kontejneru zmizí.1
- Volume: úložiště spravované Dockerem, preferované pro data. Bind mount: adresář hosta připojený do kontejneru, hodí se pro konfiguraci.1
- Síť: v user-defined síti se kontejnery najdou podle jména, na výchozím bridge jen přes IP.1
- Compose: celá sestava služeb v jednom
compose.yaml.1
Compose v praxi
Syntéza podle dok. Docker1 a2: Node-RED a MQTT broker v jedné user-defined síti, data ve volumes, port Node-RED jen na LAN.
services:
node-red:
image: nodered/node-red:5.0.7 # pevná verze místo latest
restart: unless-stopped
ports:
- "1880:1880" # 127.0.0.1:1880:1880 = jen z hosta
volumes:
- node_red_data:/data
mosquitto:
image: eclipse-mosquitto:2 # Mosquitto 2.x
restart: unless-stopped
volumes:
- mosquitto_data:/mosquitto/data
volumes:
node_red_data:
mosquitto_data:
docker compose up -dspustí sestavu na pozadí. Compose vytvoří vlastní síť projektu, takže Node-RED dosáhne na broker jakomosquitto:1883(Syntéza: síť projektu je user-defined, DNS podle jména viz dok. Docker1).- Výchozí název souboru je
compose.yaml,docker-compose.ymlfunguje kvůli zpětné kompatibilitě.1
Restart policy
| Hodnota | Chování |
|---|---|
no |
nerestartuje (výchozí) |
on-failure[:n] |
jen při chybě (nenulový exit code), volitelně max. n pokusů |
always |
vždy. Ručně zastavený naběhne až po restartu daemonu |
unless-stopped |
jako always, ale ručně zastavený zůstane vypnutý i po restartu daemonu |
Policy začne platit až po úspěšném startu (kontejner běží aspoň 10 s).1 Umbrel u svých aplikací používá on-failure.3
Data a zálohy
- Zálohuj volumes, ne kontejnery. Příklad z dokumentace1:
docker run --rm --volumes-from mynodered -v $(pwd):/backup ubuntu tar cvf /backup/backup.tar /data
- Bind mount připojený přes adresář, ve kterém už v kontejneru jsou soubory, je zakryje.1
- Databáze: kopie souborů za běhu nestačí. PostgreSQL zálohuj přes
pg_dump, viz PostgreSQL.4
Sítě a porty
- Port kontejneru je zvenku nedostupný, dokud ho nepublikuješ přes
-pneboports:.1 -p 1880:1880otevře port na všech rozhraních hosta, tedy i mimo něj.-p 127.0.0.1:1880:1880ho omezí jen na hosta. Dokumentace publikování portů výslovně označuje za „insecure by default“.1network_mode: host: kontejner sdílí síť hosta, takžeports:nemá smysl a port aplikace je rovnou na LAN. Používá to Umbrel pro HA, Homebridge i Node-RED.3 Syntéza: hodí se pro mDNS a HomeKit discovery, ale ochrana pak závisí na přihlášení v aplikaci.
Logy
Výchozí driver json-file logy nerotuje a může zaplnit disk. Doporučený je local1:
{ "log-driver": "local" }
Zapisuje se do /etc/docker/daemon.json. Po restartu Dockeru platí pro nově vytvořené kontejnery, existující nové nastavení automaticky nepřevezmou.1
Bezpečnost
dockerdběží jako root. Kdo ovládá Docker, ovládá prakticky celý host, protože kontejner může připojit/hosta. Přístup dej jen důvěryhodným uživatelům. Existuje rootless mode.1- Docker API (socket) nikdy nevystavuj do sítě. Syntéza: totéž platí pro připojení
/var/run/docker.sockdo kontejnerů. privileged: true(např. HA na Umbrelu kvůli USB adaptérům) dává kontejneru přístup k zařízením hosta.3
Gotchas
latestnení verze. Syntéza: připni tag (nebo digest jako Umbrel) a aktualizuj vědomě, např. kvůli Node-RED 5.- Na výchozím bridge se kontejnery nenajdou podle jména, použij vlastní síť nebo Compose.1
- Uid uvnitř kontejneru musí sedět s vlastníkem bind mountu. Node-RED běží jako uid 1000.2
Souvislosti
Zdroje
- Docker Docs (Engine, Compose) + releases ↗ — oficiální dokumentace Dockeru (Engine 29.8.2, Compose 5.6.0).
- Node-RED Documentation + release notes ↗ — Node-RED v Dockeru.
- umbrelOS / Umbrel Home (README, app store, produktová stránka) ↗ — jak Docker používá umbrelOS.
- PostgreSQL: oficiální Docker image + dokumentace 17 (zálohy, upgrade) ↗
- Mosquitto: mqtt(7) a mosquitto.conf(5) ↗
Intellihome