Ubuntu 20.04 – Newsgroups – (Partie 2) Accès de l’extérieur avec Traefik

Ubuntu 20.04https://howto.wared.fr/ubuntu-newsgroups-nzbget-nzbhydra-sonarr-radarr-plex-docker/

Un reverse proxy est le récepteur frontal de toutes les requêtes HTTP venant de l’extérieur. Celui-ci les redirigera vers les bonnes instances des conteneurs Docker. Dans notre cas, nous disposons d’une multitude de containers Docker et nous ne pouvons pas toutes les faire écouter sur le port 80 ou 443, d’où l’utilisation d’un reverse proxy. Ajoutez à cela un joli nom de domaine à chacun de nos services en sécurisant le tout avec le protocole SSL/TLS et un certificat Let’s Encrypt.

5 – Traefik

Traefik est un reverse-proxy et un load-balancer moderne conçu (par un Français) pour faciliter le déploiement des microservices (Docker, Kubernetes, AWS, etc.). Traefik est extrêmement simple à configurer et gère automatiquement vos certificats délivrés par Let’s Encrypt. De plus, il est capable de charger vos containers dynamiquement sans interruption de service et dispose d’un dashboard affichant l’ensemble de vos routes configurées.

5.1 – Création de l’utilisateur traefik

Si vous avez plusieurs docker-compose.yml ou si vous avez pour projet d’en créer par la suite, il est préférable d’isoler et de dédier un docker-compose.yml à Traefik. Il est recommandé de ne pas le lancer sous votre super-utilisateur et de créer un utilisateur dédié.

Créez un utilisateur traefik :
```
sudo adduser traefik
```
Ajoutez-le au groupe docker :
```
sudo adduser traefik docker
```

5.2 – Le réseau Traefik

Ajoutons un peu plus de sécurité en isolant nos containers dans un réseau uniquement accessible par Traefik et les containers.

Connectez-vous sous l’utilisateur traefik :
```
su traefik
```
Déplacez-vous dans le répertoire personnel de cet utilisateur :
```
cd
```
Créez le réseau dédié à Traefik et à l’ensemble de vos containers :
```
docker network create traefik_network
```

5.3 – L’image Traefik

Créez le fichier /home/traefik/docker-compose.yml en ajoutant le contenu suivant :

version: '3.7'
services:
  traefik:
    image: "traefik:v2.2"
    container_name: "traefik"
    restart: unless-stopped
    networks:
      - traefik_network
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - /home/traefik/traefik.toml:/traefik.toml:ro
      - /home/traefik/acme.json:/acme.json

networks:
  traefik_network:
    external: true

/var/run/docker.sock:/var/run/docker.sock:ro : précise le socket Unix de votre docker. Laissez cette valeur par défaut.
/home/traefik/traefik.toml:/traefik.toml:ro : précise le chemin du fichier de configuration de Traefik. Nous le créerons à l’étape suivante.
/home/traefik/acme.json:/acme.json : précise le chemin du fichier contenant les informations relatives à vos certificats.
traefik_network : ici nous spécifions le réseau créé précédemment et dédié à Traefik. Nous ajouterons les différents containers dans ce réseau par la suite.

5.4 – Configuration Traefik

Traefik peut être configuré de différentes manières, nous allons détailler ici, la configuration recommandée par Traefik, à savoir par un fichier statique au format TOML.

Traefik stocke les informations liées au certificat dans un fichier acme.json. Vous devez au préalable créer le fichier et lui attribuer un minimum de permissions :
```
touch /home/traefik/acme.json && chmod 600 /home/traefik/acme.json
```
Créez le fichier de configuration Traefik /home/traefik/traefik.toml en ajoutant les lignes suivantes. L’unique propriété à modifier est l’email :
```
[providers.docker]
  endpoint = "unix:///var/run/docker.sock"
  watch = true
  exposedByDefault = false

[entryPoints.web]
  address = ":80"
  [entryPoints.web.http.redirections.entryPoint]
    to = "websecure"
    scheme = "https"

[entryPoints.websecure]
  address = ":443"

[certificatesResolvers.leresolver.acme]
  email = "votre-adresse@email.com"
  storage = "acme.json"
  [certificatesResolvers.leresolver.acme.httpChallenge]
    entryPoint = "web"
```
- [providers.docker] : cette directive permet tout simplement d’activer le support Docker.
- endpoint = « unix:///var/run/docker.sock » : précise le socket Unix de votre Docker à Traefik. Laissez la valeur par défaut.
- watch = true : permet de déployer à chaud les containers dès qu’un changement dans la configuration est détectée.
- exposedByDefault = false : n’expose pas par défaut les containers au monde extérieur. Il est préférable d’activer cette option dans le docker-compose.yml pour chacun des containers dans le cas où, si pour une raison ou une autre, vous ne souhaiteriez plus rendre accessible un container de l’extérieur.
- [entryPoints.web] et [entryPoints.websecure] : ces directives définissent les points d’entrée de votre Traefik. web et websecure sont purement indicatifs, vous pouvez les nommer autrement mais ils doivent correspondre aux labels que nous définirons plus tard dans le docker-compose.yml. Les propriétés adress précisent les ports sur lesquels Traefik « écoute » en fonction du point d’entrée.
- [entryPoints.web.http.redirections.entryPoint] : force la redirection du port 80 vers le port 443 donc force le HTTP en HTTPS.
- [certificatesResolvers.[NOM_RESOLVEUR].acme] : nous indiquons ici que nous souhaitons utiliser le protocole ACME (donc le service Let’s Encrypt) pour obtenir un certificat. Le nom du résolveur est purement indicatif, il doit simplement correspondre aux labels que nous définirons plus tard dans le docker-compose.yml.
- storage = « acme.json » : la propriété storage précise à Traefik le fichier (que nous avons créé précédemment) où seront stockées les informations relatives aux certificats. L’erreur commune est d’indiquer le chemin absolu (dans notre cas /home/traefik/acme.json), ici le chemin à renseigner est celui au sein du container Traefik, il faut donc laisser cette valeur par défaut.
- [certificatesResolvers.[NOM_RESOLVEUR].acme.httpChallenge] : cette directive précise tout simplement par quel point d’entrée (dans notre cas le port 80) Traefik peut obtenir un certificat.
Déplacez-vous dans le répertoire personnel de l’utilisateur traefik et démarrez le container :
```
cd
docker-compose up -d
```

5.5 – Labels et réseau Traefik

N’oubliez pas d’ajouter des règles DNS pour chacun des sous-domaines dans l’interface administrateur du fournisseur de votre nom de domaine pour pointer vers l’IP de votre serveur. Les règles à ajouter dont de type « A ».

Si votre serveur est hébergé chez vous, il sera aussi nécessaire de créer une redirection du port 80 et 443 vers votre serveur dans l’interface de configuration de votre box internet (ou routeur).

Connectez-vous sous l’utilisateur media :
```
su media
```
Déplacez-vous dans son répertoire personnel :
```
cd
```
Modifiez votre /home/media/.env en ajoutant les lignes suivantes en fin de fichier. Remplacez mondomaine.com par le vôtre. Attention ici à renseigner uniquement la base de votre domaine (aucun sous-domaine ni même les www) :
```
[...]
NETWORK=traefik_network
BASE_HOST=mondomaine.com
```

Les expositions de ports deviennent inutiles avec Traefik, vous pouvez supprimer toutes les directives ports: avec les ports associés.

Ensuite, ajoutez les labels permettant de communiquer avec Traefik et terminez par ajouter le réseau traefik_network en fin de fichier :

version: '3.7'
services:
  nzbget:
    image: linuxserver/nzbget:latest
    container_name: nzbget
    restart: unless-stopped
    networks:
      - ${NETWORK}
    environment:
      - PUID=${PUID}
      - PGID=${PGID}
      - TZ=Europe/Paris
    volumes:
      - /home/media/nzbget/config:/config
      - ${PATH_MEDIA}:/downloads
    labels:
      - "traefik.enable=true"
      - "traefik.docker.network=${NETWORK}"
      - "traefik.http.routers.deluge.entrypoints=web,websecure"
      - "traefik.http.routers.deluge.rule=Host(`deluge.${BASE_HOST}`)"
      - "traefik.http.services.deluge.loadbalancer.server.port=6789"
      - "traefik.http.routers.deluge.tls=true"
      - "traefik.http.routers.deluge.tls.certresolver=leresolver"

  nzbhydra:
    image: linuxserver/hydra2:latest
    container_name: nzbhydra
    restart: unless-stopped
    networks:
      - ${NETWORK}
    environment:
      - PUID=${PUID}
      - PGID=${PGID}
      - TZ=Europe/Paris
    volumes:
      - /home/media/nzbhydra/config:/config
      - ${PATH_MEDIA}:/downloads
    labels:
      - "traefik.enable=true"
      - "traefik.docker.network=${NETWORK}"
      - "traefik.http.routers.nzbhydra.entrypoints=web,websecure"
      - "traefik.http.routers.nzbhydra.rule=Host(`nzbhydra.${BASE_HOST}`)"
      - "traefik.http.services.nzbhydra.loadbalancer.server.port=5076"
      - "traefik.http.routers.nzbhydra.tls=true"
      - "traefik.http.routers.nzbhydra.tls.certresolver=leresolver"

  sonarr:
    image: linuxserver/sonarr:latest
    container_name: sonarr
    restart: unless-stopped
    networks:
      - ${NETWORK}
    environment:
      - PUID=${PUID}
      - PGID=${PGID}
      - TZ=Europe/Paris
    volumes:
      - /home/media/sonarr/config:/config
      - ${PATH_MEDIA}:/data
    labels:
      - "traefik.enable=true"
      - "traefik.docker.network=${NETWORK}"
      - "traefik.http.routers.sonarr.entrypoints=web,websecure"
      - "traefik.http.routers.sonarr.rule=Host(`sonarr.${BASE_HOST}`)"
      - "traefik.http.services.sonarr.loadbalancer.server.port=8989"
      - "traefik.http.routers.sonarr.tls=true"
      - "traefik.http.routers.sonarr.tls.certresolver=leresolver"

  radarr:
    image: linuxserver/radarr:latest
    container_name: radarr
    restart: unless-stopped
    networks:
      - ${NETWORK}
    environment:
      - PUID=${PUID}
      - PGID=${PGID}
      - TZ=Europe/Paris
    volumes:
      - /home/media/radarr/config:/config
      - ${PATH_MEDIA}:/data
    labels:
      - "traefik.enable=true"
      - "traefik.docker.network=${NETWORK}"
      - "traefik.http.routers.radarr.entrypoints=web,websecure"
      - "traefik.http.routers.radarr.rule=Host(`radarr.${BASE_HOST}`)"
      - "traefik.http.services.radarr.loadbalancer.server.port=7878"
      - "traefik.http.routers.radarr.tls=true"
      - "traefik.http.routers.radarr.tls.certresolver=leresolver"

  lidarr:
    image: linuxserver/lidarr:latest
    container_name: lidarr
    restart: unless-stopped
    networks:
      - ${NETWORK}
    environment:
      - PUID=${PUID}
      - PGID=${PGID}
      - TZ=Europe/Paris
    volumes:
      - /home/media/lidarr/config:/config
      - ${PATH_MEDIA}:/data
    labels:
      - "traefik.enable=true"
      - "traefik.docker.network=${NETWORK}"
      - "traefik.http.routers.lidarr.entrypoints=web,websecure"
      - "traefik.http.routers.lidarr.rule=Host(`lidarr.${BASE_HOST}`)"
      - "traefik.http.services.lidarr.loadbalancer.server.port=8686"
      - "traefik.http.routers.lidarr.tls=true"
      - "traefik.http.routers.lidarr.tls.certresolver=leresolver"

  plex:
    image: linuxserver/plex:latest
    container_name: plex
    restart: unless-stopped
    networks:
      - ${NETWORK}
    environment:
      - VERSION=latest
      - PUID=${PUID}
      - PGID=${PGID}
      - TZ=Europe/Paris
    volumes:
      - /home/media/plex/config:/config
      - ${PATH_MEDIA}:/data
    labels:
      - "traefik.enable=true"
      - "traefik.docker.network=${NETWORK}"
      - "traefik.http.routers.plex.entrypoints=web,websecure"
      - "traefik.http.routers.plex.rule=Host(`plex.${BASE_HOST}`)"
      - "traefik.http.services.plex.loadbalancer.server.port=32400"
      - "traefik.http.routers.plex.tls=true"
      - "traefik.http.routers.plex.tls.certresolver=leresolver"

networks:
  traefik_network:
    external: true

traefik.enable=true : ce label expose le container au monde extérieur. Il surchage la propriété exposedByDefault de votre fichier /home/traefik/traefik.toml.
traefik.docker.network=traefik_network : ce label précise à Traefik quel réseau utilise le container.
traefik.http.routers.[NOM_DU_CONTAINER].entrypoints : chaque règle de routage spécifique à un container doit être spécifiée par un nom, ici nous utilisons tout simplement le nom du container. Le label entrypoints précise que les requêtes entrantes sur les points d’entrée web (port 80) et websecure (port 443) seront transmises au container.
traefik.http.routers.[NOM_DU_CONTAINER].rule=Host(`[SERVICE].${BASE_HOST}`) : ici nous précisons une règle, toute requête arrivant sur http://SERVICE.mondomaine.com sera transmise au container Docker associé.
traefik.http.services.[NOM_DU_CONTAINER].loadbalancer.server.port=[PORT] : ici nous précisons le port du container sur lequel les requêtes doivent être transmises.
traefik.http.routers.[NOM_DU_CONTAINER].tls : active le support SSL/TLS.
traefik.http.routers.[NOM_DU_CONTAINER].tls.certresolver : précise le résolveur et donc les certificats à utiliser.

Déplacez-vous dans le répertoire personnel de l’utilisateur media et redémarrez l’ensemble des containers :
```
cd
docker-compose up -d
```

5.6 – Configuration des services

Plex

Pour un accès à distance, il est nécessaire d’associer l’interface web Plex à votre serveur. Pour cela, vous devez préciser l’URL et un code d’association dont la validité est de 4 minutes.

Demandez le code d’association à l’adresse suivante : https://www.plex.tv/claim/

Modifiez votre fichier /home/media/docker-compose.yml et ajoutez les lignes suivantes en spécifiant le code obtenu précédemment :

version: '3.7'
services:
  [...]

  plex:
    image: linuxserver/plex:latest
    container_name: plex
    restart: unless-stopped
    networks:
      - ${NETWORK}
    environment:
      - VERSION=latest
      - PUID=${PUID}
      - PGID=${PGID}
      - TZ=Europe/Paris
      - PLEX_CLAIM=claim-424242424242
      - ADVERTISE_IP=plex.${BASE_HOST}:443
    volumes:
      - /home/media/plex/config:/config
      - ${PATH_MEDIA}:/data
    labels:
      - "traefik.enable=true"
      - "traefik.docker.network=${NETWORK}"
      - "traefik.http.routers.plex.entrypoints=web,websecure"
      - "traefik.http.routers.plex.rule=Host(`plex.${BASE_HOST}`)"
      - "traefik.http.services.plex.loadbalancer.server.port=32400"
      - "traefik.http.routers.plex.tls=true"
      - "traefik.http.routers.plex.tls.certresolver=leresolver"

[...]

Redémarrez le container Plex avec la commande :
```
docker-compose up -d
```

Les services sont désormais disponibles aux adresses suivantes :

NZBGet : http://nzbget.mondomaine.com
NZBHydra : http://nzbhydra.mondomaine.com
Sonarr : http://sonarr.mondomaine.com
Radarr : http://radarr.mondomaine.com
Lidarr : http://lidarr.mondomaine.com
Plex : http://plex.mondomaine.com

6 – Configuration

Nous allons maintenant configurer les applications pour qu’elles puissent communiquer entre elles et que chacune d’elles dispose d’un minimum de sécurité.

Suite du tutoriel (configuration et problèmes rencontrés)

Ubuntu 20.04Docker 19.03.8
Docker Compose 1.26.2
Traefik 2.2
NZBGet 21.1-r2311
NZBHydra 2.25.0
Jackett 0.16.105.0
Sonarr 2.0.0.5344
Radarr 0.2.0.1480
Lidarr 0.7.1.1381
Plex 1.19.4.2935-79e214ead

AuteurEdouard WATTECAMPS

Evaluez ce tutoriel !