Étiquette : openvpn

22 juillet 2026 /

Comment faire passer un seul site (ici x.com) par un VPN, et uniquement lui, pendant que tout le reste de la machine garde sa connexion directe ? C’est ce qu’on appelle un split-tunnel par domaine. Sous Linux, ça se résout élégamment avec un network namespace isolé, un proxy SOCKS et un fichier PAC dans le navigateur. Sous Android, la logique est différente (le VPN y est par application). Voici le guide complet, avec les pièges rencontrés en vrai et une section honnête sur les limites.

Pourquoi ce n’est pas trivial

On pourrait croire qu’il suffit d’activer le VPN et de « router x.com ». En pratique, plusieurs mauvaises pistes se referment vite :

  • VPN sur toute la machine + filtrage par IP : les grands sites sont derrière des CDN aux IP tournantes et partagées. On capterait trop (d’autres sites du même CDN) et pas assez (IP qui changent), et ça toucherait toutes les applications.
  • Network namespace ou VPN par application : ça fait passer toute une application par le VPN, pas un seul domaine.

La bonne approche combine deux idées : sélection par domaine côté navigateur (fichier PAC) et proxy dont la sortie est le VPN, le tout cloisonné pour éviter toute fuite si le tunnel tombe.

Le principe

┌─ Système principal (connexion directe) ───────────────────────┐
│  Firefox ──PAC── si domaine = x.com / twitter / t.co / twimg   │
│                    → proxy SOCKS,  sinon → DIRECT              │
│                         │                                      │
│                         ▼  10.200.200.2:1080 (veth)            │
│  ┌─ netns « vpnx » ─────────────────────────────────────────┐ │
│  │  proxy SOCKS5 ──► tun0 (OpenVPN) ──► x.com (via le VPN)   │ │
│  │  défaut = tun0 ; pas de route de secours = fail-closed    │ │
│  └──────────────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────────────┘

Tout le VPN vit dans un namespace réseau dédié. Le système principal reste en direct ; seul ce qu’on envoie explicitement dans ce namespace (le trafic x.com relayé par le proxy) emprunte le VPN. La résolution DNS se fait dans le namespace, donc à travers le tunnel : pas de fuite DNS. Et si le VPN tombe, il n’y a plus de route de secours : le site échoue au lieu de fuiter (kill-switch par construction).

Prérequis

  • Une distribution type Ubuntu / Debian.
  • Un VPN fournissant une configuration OpenVPN (dans l’exemple : CyberGhost, profil « US », avec ca.crt / client.crt / client.key et un couple identifiant/mot de passe OpenVPN).
  • Les paquets openvpn et microsocks : sudo apt install openvpn microsocks

Partie 1 — Sur le PC (Linux)

Le script

Un seul script gère tout : up (monte le tunnel isolé + proxy + génère le PAC), down (démonte proprement) et status (compare l’IP directe et l’IP via le VPN). Adaptez les chemins OVPN_* et OVPN_HOST à votre fournisseur.

#!/bin/bash
set -uo pipefail
IFS=$'\n\t'

# --- Paramètres (à adapter) ---
NETNS="vpnx"
VETH_HOST="veth-x-h"; VETH_NS="veth-x-n"
HOST_IP="10.200.200.1"; NS_IP="10.200.200.2"; SUBNET="10.200.200.0/24"
SOCKS_PORT="1080"; DNS_NS="1.1.1.1"
OVPN_DIR="$HOME/cyberghost/us"            # dossier contenant openvpn.ovpn + certs
OVPN_CONF="$OVPN_DIR/openvpn.ovpn"
OVPN_HOST="us.exemple-vpn.net"            # nom du serveur (résolu en IP)
AUTH_FILE="$HOME/.config/vpn-x/cg-auth"   # 2 lignes : identifiant / mot de passe
RUN_DIR="/run/vpn-x"; OVPN_PID="$RUN_DIR/openvpn.pid"; SOCKS_PID="$RUN_DIR/microsocks.pid"
PAC_FILE="$HOME/vpn-x-proxy.pac"          # PAC hors dossier caché (cf. piège Firefox Snap)

priv() { sudo "$@"; }

generer_pac() {
  cat > "$PAC_FILE" </dev/null

  # 3. Forward + NAT (porte uniquement le trafic VPN chiffré)
  priv sysctl -q -w net.ipv4.ip_forward=1
  priv iptables -t nat -A POSTROUTING -s "$SUBNET" -o "$wan_if" -j MASQUERADE
  priv iptables -A FORWARD -s "$SUBNET" -o "$wan_if" -j ACCEPT
  priv iptables -A FORWARD -d "$SUBNET" -i "$wan_if" -m state --state RELATED,ESTABLISHED -j ACCEPT

  # 4. OpenVPN dans le namespace (remote épinglé en IP => reconnexion sans DNS)
  priv ip netns exec "$NETNS" openvpn --cd "$OVPN_DIR" --config "$OVPN_CONF" \
      --remote "$server_ip" 443 --auth-user-pass "$AUTH_FILE" --auth-nocache \
      --writepid "$OVPN_PID" --log "$RUN_DIR/openvpn.log" --daemon "openvpn-vpnx"

  # 5. Attente du tunnel
  local i
  for i in $(seq 1 30); do
    priv ip netns exec "$NETNS" ip -4 addr show tun0 2>/dev/null | grep -q "inet " && break
    sleep 1
  done

  # 6. Kill-switch : route serveur épinglée + suppression de la route de secours
  priv ip netns exec "$NETNS" ip route replace "${server_ip}/32" via "$HOST_IP"
  priv ip netns exec "$NETNS" ip route del default via "$HOST_IP" 2>/dev/null || true

  # 7. Proxy SOCKS5 dans le namespace
  priv ip netns exec "$NETNS" microsocks -i "$NS_IP" -p "$SOCKS_PORT" >"$RUN_DIR/microsocks.log" 2>&1 &
  sleep 1; pgrep -x microsocks | head -1 > "$SOCKS_PID"

  generer_pac
  echo "Prêt. PAC : file://$PAC_FILE"
}

action_down() {
  [[ -f "$SOCKS_PID" ]] && { priv kill "$(cat "$SOCKS_PID")" 2>/dev/null || true; priv rm -f "$SOCKS_PID"; }
  [[ -f "$OVPN_PID" ]]  && { priv kill "$(cat "$OVPN_PID")"  2>/dev/null || true; priv rm -f "$OVPN_PID"; }
  local wan_if; wan_if=$(ip route show default | awk '/default/ {print $5; exit}')
  priv iptables -t nat -D POSTROUTING -s "$SUBNET" -o "$wan_if" -j MASQUERADE 2>/dev/null || true
  priv iptables -D FORWARD -s "$SUBNET" -o "$wan_if" -j ACCEPT 2>/dev/null || true
  priv iptables -D FORWARD -d "$SUBNET" -i "$wan_if" -m state --state RELATED,ESTABLISHED -j ACCEPT 2>/dev/null || true
  priv ip netns del "$NETNS" 2>/dev/null || true
  priv ip link del "$VETH_HOST" 2>/dev/null || true
  priv rm -rf "/etc/netns/${NETNS}"
}

action_status() {
  echo -n "IP directe : "; curl -s --max-time 8 https://api.ipify.org; echo
  echo -n "IP via VPN : "; curl -s --max-time 12 --socks5-hostname "${NS_IP}:${SOCKS_PORT}" https://api.ipify.org; echo
}

case "${1:-}" in
  up) action_up ;; down) action_down ;; status) action_status ;;
  *) echo "Usage : $0 {up|down|status}" ;;
esac

Le fichier d’identifiants

Le script lit l’identifiant et le mot de passe OpenVPN depuis un fichier à deux lignes, en chmod 600 — jamais en dur dans le script :

mkdir -p ~/.config/vpn-x
printf '%s\n%s\n' "VOTRE_IDENTIFIANT_OPENVPN" "VOTRE_MOT_DE_PASSE" > ~/.config/vpn-x/cg-auth
chmod 600 ~/.config/vpn-x/cg-auth

Configurer Firefox (fichier PAC)

  1. Paramètres → Vie privée et sécurité → Sécurité logicielle et des connexions → Paramètres de Proxy → Configurer le proxy… (chemin des versions récentes de Firefox ; sur d’anciennes versions : Général → Paramètres réseau).
  2. Cocher « Adresse de configuration automatique du proxy (.pac) » et coller : file:///home/VOTRE_USER/vpn-x-proxy.pac
  3. Dans about:config, passer network.proxy.socks_remote_dns à true (résolution DNS côté proxy = anti-fuite).

⚠️ Piège Firefox Snap (Ubuntu récent). Le Firefox installé en Snap n’a pas accès aux dossiers cachés comme ~/.config/. Un PAC placé là est silencieusement ignoré, et le site part en direct sans erreur visible. Solution : mettre le PAC dans un chemin non caché du dossier personnel (ici ~/vpn-x-proxy.pac), accessible via l’interface Snap home.

Démarrage automatique au boot (systemd)

Pour ne jamais oublier de le lancer, un service systemd le monte après le réseau et le démonte à l’extinction. Il tourne sous votre compte (il élève via sudo) :

[Unit]
Description=Split-tunnel VPN pour x.com
After=network-online.target
Wants=network-online.target

[Service]
Type=oneshot
RemainAfterExit=yes
User=VOTRE_USER
Group=VOTRE_USER
Environment=HOME=/home/VOTRE_USER
ExecStart=/home/VOTRE_USER/scripts/vpn_x_split.sh up
ExecStop=/home/VOTRE_USER/scripts/vpn_x_split.sh down

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now vpn-x.service
systemctl status vpn-x

Le mode oneshot + RemainAfterExit=yes laisse openvpn et microsocks tourner dans le cgroup du service ; systemctl stop tue tout proprement.

Vérifier que ça marche

La commande status doit montrer deux IP différentes (directe vs VPN). Pour confirmer que le navigateur route bien le bon domaine, on observe les connexions dans le namespace pendant qu’on charge le site :

# IP de sortie comparée
./vpn_x_split.sh status

# Connexions actives dans le tunnel (charger x.com dans Firefox d'abord)
sudo ip netns exec vpnx ss -tn state established

# Preuve côté proxy
tail -f /run/vpn-x/microsocks.log   # doit lister x.com / video.twimg.com …

En parallèle, une page « quelle est mon IP » ouverte dans Firefox doit afficher votre IP normale (le reste passe en direct), tandis que le trafic du site ciblé sort par l’IP du VPN.

Partie 2 — Sur Android

Sur Android, impossible de filtrer par domaine : l’API VPN est par application et exclusive (un seul VPN actif à la fois). L’équivalent réaliste, c’est de router une seule application (l’app du service, ou un navigateur dédié) dans le VPN.

Attention : le split-tunneling intégré de nombreux clients VPN (dont CyberGhost) fonctionne uniquement en mode exclusion (choisir les apps qui contournent le VPN). Pour n’envoyer que l’app voulue, il faudrait exclure toutes les autres : impraticable.

La solution : l’application OpenVPN for Android (d’Arne Schwabe — pas « OpenVPN Connect »), qui propose une liste « Allowed Apps » en mode inclusif.

Préparer un profil .ovpn mono-fichier

OpenVPN for Android importe plus facilement un .ovpn avec les certificats intégrés en ligne. On le fabrique à partir des fichiers de la configuration manuelle :

SRC=~/cyberghost/us
OUT=~/vpn-us-android.ovpn
grep -vE '^\s*(ca|cert|key)\s' "$SRC/openvpn.ovpn" > "$OUT"
{ echo "";   cat "$SRC/ca.crt";     echo ""
  echo ""; cat "$SRC/client.crt"; echo ""
  echo "";  cat "$SRC/client.key"; echo ""; } >> "$OUT"
chmod 600 "$OUT"

On n’intègre pas le mot de passe : l’app le demandera et le mémorisera. Transférez le fichier sur le téléphone par un canal privé (câble USB, partage réseau local…) — il contient votre clé privée.

Sur le téléphone

  1. Installer OpenVPN for Android (Play Store / F-Droid).
  2. Importer le .ovpn.
  3. Saisir identifiant / mot de passe OpenVPN (cocher « enregistrer »).
  4. Éditer le profil → onglet « Allowed Apps »désactiver « VPN utilisé pour toutes les applications sauf celles sélectionnées » pour basculer en mode inclusif (« VPN utilisé uniquement pour les applications sélectionnées ») → cocher uniquement l’app voulue.
  5. Se connecter en tapant sur le nom du profil.

Toujours actif : Android → Paramètres → VPN → ⚙️ → « VPN permanent ». Laissez « Bloquer les connexions sans VPN » désactivé : en mode inclusif, seule l’app ciblée passe par le tunnel, donc le lockdown couperait Internet à toutes les autres. Pensez aussi à passer l’app en batterie « sans restriction » pour que le système ne la tue pas.

Les pièges rencontrés (en vrai)

  • AUTH_FAILED avec CyberGhost : les profils .ovpn manuels utilisent des identifiants OpenVPN dédiés, différents du token du client CLI. Récupérez les bons depuis vos connexions VPN existantes (par ex. nmcli -s -g vpn.secrets connection show NOM pour le mot de passe, nmcli -g vpn.data … pour l’identifiant).
  • Firefox Snap + PAC ignoré : dossier caché inaccessible → PAC hors ~/.config (voir plus haut).
  • Redirection de log en échec : sous sudo, la redirection > fichier s’exécute côté utilisateur ; si le dossier appartient à root, elle échoue. On rend le dossier de run inscriptible (chown) avant de lancer les démons.
  • PID du proxy : sous sudo ip netns exec …, capturez le vrai PID avec pgrep -x microsocks plutôt que $! (qui pointe le wrapper).

Limites — à lire avant de se croire invisible

Ce montage fait une chose précise : faire sortir un site par une IP différente. Ce n’est pas de l’anonymat, et il faut être honnête sur ce qu’un VPN ne fait pas :

  • Si vous êtes connecté à un compte, l’IP ne change rien à votre identification par ce compte.
  • Le fingerprinting du navigateur/appareil vous identifie indépendamment de l’IP.
  • Le fournisseur VPN voit votre trafic sortant : vous déplacez la confiance, vous ne la supprimez pas (les promesses « no-log » sont des affirmations, pas des garanties vérifiables).
  • Un VPN ne change ni votre juridiction, ni l’historique déjà enregistré côté service avant sa mise en place.
  • Sur Android, c’est par application : si vous ouvrez le même service dans une autre app hors tunnel, l’IP réelle fuit.

Autrement dit : excellent pour la confidentialité au quotidien et le choix de l’IP de sortie ; insuffisant, à lui seul, pour un vrai objectif d’anonymat (qui relève d’outils et d’une discipline d’usage bien plus larges : Tor, cloisonnement strict des identités, etc.).

Conclusion

Avec un network namespace, un proxy SOCKS et un PAC, on obtient sur Linux un split-tunnel par domaine propre, avec kill-switch et démarrage automatique. Sur Android, on retombe sur du par application via OpenVPN for Android en mode inclusif. Deux approches différentes pour un même besoin — et surtout, une bonne compréhension de ce que ça protège… et de ce que ça ne protège pas.

19 juillet 2026 /

Vous avez un NAS Synology, un client BitTorrent (Transmission) et un abonnement VPN. Vous voulez que vos torrents passent par le VPN, et uniquement eux. Le reste du NAS — DSM, DDNS, QuickConnect, Secure SignIn, vos autres services — doit continuer à sortir avec votre IP normale.

Ce tutoriel explique comment y parvenir avec trois conteneurs Docker : gluetun (le tunnel VPN + pare-feu), Transmission (le client torrent) et autoheal (la rustine qui rend l’ensemble fiable dans la durée).

Pourquoi pas le VPN intégré de DSM ?

DSM propose nativement un client VPN (Panneau de configuration → Réseau → Interface réseau). Le problème : une fois connecté, ce VPN devient la route par défaut de tout le NAS. Conséquences vécues :

  • le DDNS enregistre l’adresse IP du serveur VPN au lieu de votre IP publique → vos accès externes pointent dans le vide ;
  • Secure SignIn et QuickConnect deviennent erratiques ;
  • tous les services du NAS sortent par le VPN, même ceux qui n’en ont aucun besoin.

Le routage sélectif (« policy routing ») est possible en bidouillant les tables de routage à la main, mais c’est fragile et écrasé aux mises à jour de DSM. La bonne solution, c’est d’isoler le VPN dans un conteneur.

Le principe

┌─────────────────────────── NAS Synology ───────────────────────────┐
│                                                                    │
│  DSM, DDNS, autres services ──────────────► Internet (IP normale)  │
│                                                                    │
│  ┌────────── réseau du conteneur gluetun ──────────┐               │
│  │                                                 │               │
│  │  transmission ──► gluetun ──► tunnel VPN ───────┼─► Internet    │
│  │                   (kill switch)                 │   (IP du VPN) │
│  └─────────────────────────────────────────────────┘               │
└────────────────────────────────────────────────────────────────────┘
  • gluetun est le seul conteneur à monter le tunnel VPN. Il intègre un pare-feu strict : si le tunnel tombe, rien ne sort. C’est un kill switch natif, aucune fuite d’IP possible.
  • Transmission n’a pas de réseau à lui : grâce à network_mode: "service:gluetun", il partage la pile réseau de gluetun. Tout son trafic passe donc obligatoirement par le tunnel, sans rien configurer côté Transmission.
  • autoheal surveille la santé de Transmission et le redémarre automatiquement quand il perd le réseau (on verra plus bas pourquoi ça arrive forcément un jour).

Prérequis

  • Un Synology avec Container Manager installé (Centre de paquets) ;
  • Un abonnement VPN fournissant une configuration OpenVPN (fichier .ovpn + identifiants). Ici, l’exemple utilise un fournisseur en mode « custom », mais gluetun connaît nativement des dizaines de fournisseurs (NordVPN, ProtonVPN, Mullvad, Surfshark…) — dans ce cas, la configuration est encore plus simple ;
  • Un accès SSH au NAS (ou l’éditeur de fichiers de File Station).

1. L’arborescence

Créez un dossier de projet dans le partage docker :

/volume1/docker/transmission-vpn/
├── docker-compose.yml
├── gluetun/
│   ├── custom.ovpn          # config OpenVPN du fournisseur
│   ├── openvpn_user         # identifiant VPN (une ligne, rien d'autre)
│   └── openvpn_password     # mot de passe VPN (une ligne, rien d'autre)
└── config/                  # config de Transmission (à créer vide)
mkdir -p /volume1/docker/transmission-vpn/{gluetun,config}

⚠️ Créez bien le dossier config/ avant le premier lancement : contrairement au Docker standard qui crée silencieusement les dossiers manquants d’un bind mount, celui de Synology refuse de démarrer le conteneur avec l’erreur Bind mount failed: '…/config' does not exist.

Les identifiants sont dans des fichiers séparés plutôt qu’en variables d’environnement dans le compose. Deux raisons : on peut versionner ou partager le docker-compose.yml sans exposer de secret, et on évite les mauvaises surprises de l’interpolation docker-compose (un $ ou un caractère spécial dans un mot de passe passé en variable d’environnement peut être interprété silencieusement).

chmod 600 gluetun/openvpn_user gluetun/openvpn_password

2. Préparer le fichier .ovpn (fournisseur « custom »)

Deux pièges qui font perdre des heures :

Piège n° 1 — utilisez une IP, pas un nom de domaine. Dans le fichier .ovpn, la ligne remote contient généralement un nom d’hôte :

remote monfournisseur-vpn.example.net 443

Au démarrage, gluetun verrouille son pare-feu avant d’établir le tunnel — et à ce stade, la résolution DNS peut échouer ou être bloquée. Remplacez le nom par son adresse IP :

nslookup monfournisseur-vpn.example.net
# puis dans custom.ovpn :
remote 203.0.113.37 443

Si un jour le conteneur devient unhealthy sans raison apparente, re-résolvez le nom : le fournisseur a probablement changé l’IP du serveur.

Piège n° 2 — supprimez la ligne auth-user-pass du .ovpn. Gluetun injecte lui-même cette directive avec le chemin de ses fichiers d’identifiants. Si votre .ovpn contient déjà un auth-user-pass nu (sans chemin), OpenVPN tente de demander les identifiants de façon interactive dans un conteneur sans terminal → échec immédiat.

3. Le docker-compose.yml

Voici le fichier complet, commenté ensuite bloc par bloc :

services:
  gluetun:
    image: qmcgaw/gluetun
    container_name: gluetun
    cap_add:
      - NET_ADMIN
    devices:
      - /dev/net/tun:/dev/net/tun
    environment:
      - VPN_SERVICE_PROVIDER=custom
      - VPN_TYPE=openvpn
      - OPENVPN_CUSTOM_CONFIG=/gluetun/custom.ovpn
      - OPENVPN_USER_SECRETFILE=/gluetun/openvpn_user
      - OPENVPN_PASSWORD_SECRETFILE=/gluetun/openvpn_password
      - FIREWALL_INPUT_PORTS=9091
      - FIREWALL_OUTBOUND_SUBNETS=192.168.1.0/24,172.18.0.0/16
      - TZ=Europe/Paris
    volumes:
      - ./gluetun:/gluetun
    ports:
      - "9091:9091"
    restart: unless-stopped

  transmission:
    image: lscr.io/linuxserver/transmission:latest
    container_name: transmission
    network_mode: "service:gluetun"
    depends_on:
      - gluetun
    environment:
      - PUID=1026            # UID : le propriétaire des fichiers téléchargés (voir ci-dessous)
      - PGID=100             # GID : le groupe de ces fichiers
      - USER=admin           # identifiant de connexion à l'interface web (port 9091)
      - PASS=ChangezMoi      # mot de passe de l'interface web — se change ICI, pas dans settings.json
      - TZ=Europe/Paris
    volumes:
      - ./config:/config
      - /volume1/downloads:/volume1/downloads
    labels:
      - autoheal=true
    healthcheck:
      test: ["CMD-SHELL", "curl -sf -m 8 -o /dev/null https://api.ipify.org || exit 1"]
      interval: 30s
      timeout: 12s
      retries: 2
      start_period: 60s
    restart: unless-stopped

  autoheal:
    image: willfarrell/autoheal:latest
    container_name: autoheal
    environment:
      - AUTOHEAL_CONTAINER_LABEL=autoheal
      - AUTOHEAL_INTERVAL=15
      - AUTOHEAL_START_PERIOD=45
      - TZ=Europe/Paris
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    restart: unless-stopped

Bloc gluetun : le tunnel et le pare-feu

  • cap_add: NET_ADMIN et /dev/net/tun : indispensables pour créer une interface VPN dans un conteneur.
  • FIREWALL_INPUT_PORTS=9091 : le pare-feu de gluetun bloque tout par défaut, y compris en entrée. Cette ligne autorise l’accès à l’interface web de Transmission (port 9091). C’est sur gluetun que le port est publié (ports:), pas sur Transmission — logique, puisque Transmission vit dans le réseau de gluetun.
  • FIREWALL_OUTBOUND_SUBNETS=192.168.1.0/24,172.18.0.0/16 : autorise le trafic vers le réseau local en dehors du tunnel. Sans cette ligne, le NAS lui-même ne peut pas joindre le port publié — symptôme typique : un reverse proxy DSM devant Transmission qui renvoie une erreur 502. Adaptez 192.168.1.0/24 à votre réseau local (le 172.18.0.0/16 correspond au réseau Docker par défaut du projet).

Bloc transmission : tout passe par le tunnel

  • network_mode: "service:gluetun" : la ligne magique de tout le montage. Transmission n’a aucune interface réseau propre, il utilise celles de gluetun. Impossible de contourner le VPN, même par erreur de configuration.
  • PUID / PGID : un conteneur n’a pas ses propres utilisateurs — le processus Transmission écrit sur le disque du NAS avec un numéro d’utilisateur (UID) et de groupe (GID). Ces deux variables déterminent donc à qui appartiendront les fichiers téléchargés dans /volume1/downloads — et donc qui pourra les lire, les déplacer ou les supprimer ensuite (via File Station, SMB, etc.). Pour récupérer les vôtres, en SSH sur le NAS :
    $ id votreuser
    uid=1026(votreuser) gid=100(users) groups=100(users),101(administrators)

    Reportez le uid dans PUID et le gid dans PGID. Sur un Synology, le premier utilisateur créé porte généralement l’UID 1026 et appartient au groupe users (GID 100) — d’où les valeurs de l’exemple. Si vous migrez depuis une installation Transmission existante, utilisez plutôt l’UID/GID de l’ancien utilisateur (visible avec ls -lan /volume1/downloads) pour reprendre vos fichiers sans toucher aux permissions.

  • USER / PASS : les identifiants de connexion à l’interface web de Transmission. Attention, piège de l’image linuxserver — au démarrage, elle réécrit la configuration RPC de Transmission. Si ces deux variables sont absentes, elle désactive purement et simplement l’authentification de l’interface web, même si vous l’aviez activée dans settings.json. C’est donc ici, et uniquement ici, qu’on définit ou change ces identifiants.
  • Le healthcheck mérite une explication à part (section suivante).

Bloc autoheal : la fiabilité dans la durée

Le talon d’Achille de network_mode: "service:gluetun" : quand gluetun redémarre (mise à jour d’image, incident, reboot partiel), son espace réseau est détruit puis recréé. Transmission, lui, reste attaché à l’ancien espace réseau, désormais orphelin : le processus tourne, le conteneur est « Up », mais il n’a plus aucune connectivité. Docker ne le redémarre pas tout seul, puisque de son point de vue tout va bien.

La solution tient en deux morceaux :

  1. Un healthcheck qui teste la connectivité externe : curl https://api.ipify.org. Piège subtil : un healthcheck sur http://localhost:9091 ne détecte pas le problème, car le loopback continue de fonctionner dans un espace réseau orphelin. Il faut tester une sortie réelle vers Internet.
  2. autoheal, un micro-conteneur qui surveille le socket Docker et redémarre automatiquement tout conteneur portant le label autoheal=true dès qu’il passe unhealthy.

Résultat : après un redémarrage de gluetun, Transmission retrouve son réseau tout seul en ~90 secondes, sans intervention.

4. Lancement et vérification

cd /volume1/docker/transmission-vpn
docker compose up -d

(Sur Synology, le binaire complet est /var/packages/ContainerManager/target/usr/bin/docker si docker n’est pas dans votre PATH. Vous pouvez aussi importer le projet dans l’interface de Container Manager.)

Note sur les images : l’onglet « Registre » de Container Manager ne cherche que sur Docker Hub. Vous y trouverez qmcgaw/gluetun et willfarrell/autoheal, mais pas lscr.io/linuxserver/transmission, hébergée sur le registre de linuxserver (lscr.io) : inutile de la chercher dans l’interface, elle n’y apparaîtra jamais. Ce n’est pas un problème — docker compose up -d télécharge chaque image directement depuis le bon registre, celui indiqué dans son nom complet. C’est une des raisons de préférer la ligne de commande à l’interface pour ce projet.

La vérification qui compte — comparer l’IP de sortie du conteneur et celle du NAS :

# IP vue par Transmission (doit être celle du serveur VPN)
docker exec transmission curl -s https://api.ipify.org

# IP vue par le NAS (doit être votre IP publique normale)
curl -s https://api.ipify.org

Si les deux adresses diffèrent, mission accomplie. Testez aussi le kill switch :

docker stop gluetun
docker exec transmission curl -s -m 5 https://api.ipify.org   # doit échouer
docker start gluetun
# ~90 s plus tard, autoheal a redémarré transmission, tout refonctionne

L’interface web est accessible sur http://ip-du-nas:9091 avec les identifiants USER/PASS du compose.

Si l’interface ne répond pas du tout (connexion refusée, alors que le conteneur est healthy) : regardez config/settings.json. Sur une installation neuve, l’image linuxserver génère "rpc-bind-address": "[::]" — une adresse d’écoute IPv6. Or gluetun désactive l’IPv6 dans son espace réseau quand le tunnel n’en fournit pas : le bind échoue en silence et rien n’écoute sur 9091 (vérifiable avec docker exec transmission netstat -tln : le port pair 51413 est là, pas le 9091). Le correctif :

docker stop transmission
sed -i 's/"rpc-bind-address": "\[::\]"/"rpc-bind-address": "0.0.0.0"/' config/settings.json
docker start transmission

Ce réglage n’est pas réécrit par l’image au démarrage (contrairement à USER/PASS), la correction est donc définitive.

5. Mises à jour

Les tags :latest ne se mettent pas à jour tout seuls. Un petit script suffit :

#!/bin/bash
# Met à jour les images de la pile transmission-vpn
set -uo pipefail
cd /volume1/docker/transmission-vpn || exit 1
DOCKER=/var/packages/ContainerManager/target/usr/bin/docker
$DOCKER compose pull
$DOCKER compose up -d
$DOCKER image prune -f
$DOCKER compose ps

La configuration (docker-compose.yml, gluetun/, config/) n’est jamais touchée par une mise à jour d’images. Et si la mise à jour redémarre gluetun — c’est le cas — autoheal se charge de remettre Transmission sur pied.

Récapitulatif des pièges

Piège Symptôme Solution
VPN système DSM DDNS/QuickConnect/Secure SignIn cassés VPN conteneurisé (ce tutoriel)
remote avec un nom d’hôte gluetun ne démarre pas ou devient unhealthy Mettre l’IP en dur dans le .ovpn
auth-user-pass dans le .ovpn OpenVPN demande les identifiants et plante Supprimer la ligne, gluetun gère
Restart de gluetun Transmission « Up » mais sans réseau healthcheck externe + autoheal
Healthcheck sur localhost:9091 Passe au vert même sans réseau Tester une URL externe (api.ipify.org)
USER/PASS absents du compose Interface web sans authentification Toujours les définir dans le compose
Reverse proxy → 502 Le NAS ne joint pas le port publié FIREWALL_OUTBOUND_SUBNETS
Secrets en variables d’environnement Interpolation $ imprévisible OPENVPN_*_SECRETFILE
Dossier config/ absent Bind mount failed au premier lancement mkdir config avant le up -d (Docker Synology ne le crée pas)
rpc-bind-address "[::]" (install neuve) Conteneur healthy mais interface web injoignable Mettre 0.0.0.0 dans settings.json
Mêmes identifiants VPN sur deux machines Déconnexions en boucle (ping-restart) toutes les ~2 min Un jeu d’identifiants (ou au moins un serveur) par machine

Conclusion

Trois conteneurs, un seul fichier compose, et un cloisonnement propre : les torrents passent par le VPN avec un kill switch garanti, le NAS garde son IP publique pour tout le reste, et l’ensemble survit aux redémarrages et aux mises à jour sans intervention. Exactement ce que le client VPN intégré de DSM ne sait pas faire.

5 mars 2017 /

Un petit mémo pour mettre en place une connexion Openvpn, avec reconnexion auto.

On commence par stocker ses identifiants de connexion ici:

vi /etc/openvpn/starmate.pass

login
passwd

On sécurise le fichier:

chmod 700 /etc/openvpn/starmate.pass

On télécharge les fichiers de configuration de HMA:

mkdir /etc/openvpn/hma
wget -t 3 -T 20 -r -A.ovpn -nd --no-parent -e robots=off https://vpn.hidemyass.com/vpn-config/UDP/ -P /etc/openvpn/hma

On declare où se trouve le couple login/passwd dans les fichiers de configuration openvpn :

sed -i 's/auth-user-pass/auth-user-pass \/etc\/openvpn\/starmate.pass/g' /etc/openvpn/hma/*ovpn

On relance le service

service openvpn stop
service openvpn start

On peut tester la connexion avec cette commande

openvpn /etc/openvpn/hma/Netherlands.Amsterdam.UDP.ovpn

Pour automatiser cela, nous allons faire un petit script pour cron:

vi /etc/openvpn/vpn.sh

#!/bin/bash
VPN=`ifconfig | grep tun0 > /dev/null 2>&1 ; echo $?`
if [ "$VPN" -eq "1" ];
then
openvpn /etc/openvpn/hma/Netherlands.Amsterdam_LOC2S5.UDP.ovpn
fi

chmod +x /etc/openvpn/vpn.sh

Et la ligne crontab pour une exécution toutes les minutes:

vi /etc/crontab

* * * * * root /etc/openvpn/vpn.sh > /dev/null 2>&1

Ou alors, encore mieux, créer un service:

On commence par copier le fichier de connexion désiré dans /etc/openvpn :

cd /etc/openvpn/hma
cp -p /etc/openvpn/hma/Netherlands.Amsterdam.UDP.ovpn /etc/openvpn/Netherlands.conf

Puis on créer le service.

systemctl enable openvpn@Netherlands.service
systemctl start openvpn@Netherlands.service

La partie suivant directement le @, « Netherlands« , est le nom du fichier de connexion que l’on à copié précédemment.

On peut vérifier son adresse publique:

dig +short myip.opendns.com @resolver1.opendns.com