Table of Contents
Containers
- Wat: wat er bij het aanmaken van elke nieuwe container of stack in Portainer geregeld moet zijn.
- Doel: elke container is bij de eerste start goed ingericht (DNS, subnet, updatebeleid, limieten), zonder dat je het later moet nalopen.
Regel
Bij elke nieuwe container of stack, in deze volgorde:
- DNS: elke service met uitgaand verkeer krijgt
dns: 192.168.1.10(Pi-hole), zodat hij per container zichtbaar is. Bij meerdere services staat het adres één keer bovenaan als variabele, bij één service direct bij de service. Waarom: 26.014. - Subnet: geef de stack een vast subnet
172.16.<stack-id>.0/24(stack 37 krijgt172.16.37.0/24), zodat de adressen in Pi-hole niet verspringen en Docker niet terugvalt op een 192.168.x-blok dat kan botsen met het LAN of een VLAN. Bestaande stacks krijgen het bij de eerstvolgende wijziging; het gaat in na een redeploy van de stack. Een netwerk zonder vast subnet krijgt automatisch een adres uit het vangnet172.26.0.0/15; de indeling en de reden staan in het IP-plan. - Bijwerken in Portainer met Re-pull image uit, zodat er geen image-update buiten WUD om binnenkomt.
- Na opnieuw aanmaken: open in DSM Container Manager → Container, zodat Synology weer naar de nieuwe container wijst. Anders kan de container na een DSM-update wegblijven. Zie de les containerlijst verversen.
- Mounts: koppel geen volume-root (zoals
/volume1) maar een bestaande gedeelde map (zoals/volume1/Media). Synology kan bij een volume-root geen gedeelde map bepalen en start zo'n container na een DSM-update niet (fout 117). Zie dezelfde les. - Documentatie: een servicepagina volgens de template, en de container in de indeling op de WUD-pagina.
Uitzonderingen op de DNS-regel
Geen dns: bij:
| Container | Reden |
|---|---|
| Pi-hole, Plex, Beszel-Agent | network_mode: host: gebruiken het netwerk van de NAS zelf, dns: is dan niet toegestaan |
| joplin-indexer | network_mode: container:Joplin-DB: deelt het netwerk van een andere container |
| Databases en caches (Joplin-DB, ghostfolio-db, ghostfolio-redis) | geen uitgaand verkeer |
Containers in het servers-VLAN
Alleen voor containers die van buiten bereikbaar zijn (26.015). In plaats van dns: 192.168.1.10 gebruikt zo'n container dns: 192.168.5.10 (Pi-hole via de NAS, binnen het VLAN). De container krijgt het externe netwerk servers met een vast adres uit 192.168.5.32 tot en met 192.168.5.99 (bij voorkeur het stacknummer in Portainer, bijvoorbeeld 192.168.5.53 voor stack 53). Bij een stack met meerdere services (bijvoorbeeld Joplin en zijn database) komt alleen de service die van buiten bereikbaar moet zijn in servers; de rest blijft in het eigen stacknetwerk, en de service staat in beide netwerken. In de reverse proxy van DSM wijst de backend dan naar het adres in 192.168.5.x.
services: omnitools: image: ... dns: - 192.168.5.10 networks: servers: ipv4_address: 192.168.5.32 networks: servers: external: true
Een dienst op de NAS die zo'n container nodig heeft (bijvoorbeeld Plex of Sonarr) is bereikbaar op 192.168.5.10:poort, en daarvoor is een poortregel in de DSM-firewall nodig voor 192.168.5.0/24.
Toepassingsgebied
Alle containers die op de NAS via Portainer als stack zijn aangemaakt. Een stack die alleen host-modus gebruikt heeft geen eigen netwerk en dus geen subnet nodig.
Voorbeeld
Een stack met meerdere services:
x-my-dns: &my-dns - 192.168.1.10 services: prowlarr: image: ... networks: - arr dns: *my-dns networks: arr: ipam: config: - subnet: 172.16.37.0/24
Een stack met één service:
services: omnitools: image: ... dns: - 192.168.1.10 networks: default: ipam: config: - subnet: 172.16.23.0/24
Beheer
Compose per stack in Portainer. Het DNS-adres staat nu in alle stacks; wijzigt het, zoek dan in de compose-bestanden op 192.168.1.10. De vergeven subnetten vind je door te zoeken op 172.16.. Het vangnet staat in dockerd.json op de NAS, zie het IP-plan.
