Ce site est optimisé pour être consulté depuis un navigateur moderne dans lequel JavaScript est activé.

Pangolin - Installation sur un VPS

waazaa

La particularité de Pangolin dans le monde des "reverse proxy" est qu'il peut jouer son rôle en masquant l'ip final du service tout comme le "proxied" de Cloudflare.

Pour cela il faut faire pointer nos domaines et sous-domaines vers une autre machine que chez nous typiquement un VPS.
Dés lors les visiteurs arriveront sur ce VPS et Pangolin s'occupera de rediriger vers les bons services qui tournent chez vous par le biais d'un tunnel wireguard créé facilement entre un service de Pangolin qui se nomme Gerbil et un client sur votre machine locale: Newt.

Pangolin fonctionne avec 3 containers imbriqués:

Pangolin qui fait l'orchestration de tout cela et la webui
Gerbil qui fait la communication à travers les tunnels wireguard
Traefik qui gère les requêtes HTTP/HTTPS, les certificats et via des plugins ajoutent des fonctionnalités de sécurité (par exemple Crowdsec)

Si vous envisagez d'utiliser Pangolin sans la partie tunnel wireguard c'est à dire comme simple reverse proxy alors dans ce cas là vous n'avez pas besoin de Gerbil.

waazaa

1 - Commandez votre VPS

Pour installer Pangolin sur un VPS il vous faut un VPS.
Libre à vous de le prendre où bon vous semble, personnellement je suis parti sur la première offre chez Ionos qui est actuellement à 1.20€/mois.

Je vous encourage à prendre Ubuntu 24.04 comme Système d'Exploitation.

Vous obtiendrez l'ip de votre VPS ainsi que probablement le mot de passe de root.

2 - Connectez vous par ssh à votre VPS

Dans un terminal ou powershell rentrez dans votre VPS via SSH:

ssh root@IP_VPS

Mises à jour:

apt-get update && apt-get -y upgrade

Les premières étapes que je fais d'office c'est de régler la timezone et les locales:

dpkg-reconfigure locales

Vous naviguez avec les flèches du clavier, sélectionnez avec la barre d'espace et validez avec Entrée.
Il vous choisir fr_FR UTF8

dpkg-reconfigure tzdata

Vous naviguez avec les flèches du clavier et validez avec Entrée.
Vous devez choisir probablement Europe puis Paris et validez.

waazaa

3 - Ajoutez du swap

Si vous avez vous aussi pris un VPS avec peu de RAM y ajouter du SWAP va lui permettre d'en avoir davantage.

# pour mettre 512Mo de disk en swap mémoire
sudo fallocate -l 512M /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
sudo cp /etc/fstab /etc/fstab.bak
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
sudo sysctl vm.swappiness=20
sudo sysctl vm.vfs_cache_pressure=50

Puis éditer:

sudo nano /etc/sysctl.conf

Pour ajouter ceci en fin de fichier pour les prochains reboot:

vm.swappiness=20
vm.vfs_cache_pressure=50

A partir de ce moment là si vous lancez un htop vous verrez en dessous de la RAM une ligne SWAP
Vous pouvez aussi lancer free -h pour voir la RAM/SWAP utilisée/disponible

waazaa

4 - Installation assistée de Pangolin

La première fois que vous installez Pangolin il est trés pratique d'utiliser un script d'installation qu'ils fournissent.
Pour mettre à jour ensuite n'utilisez plus ce script.

Création du dossier pour Pangolin

Créez un dossier spécifique à pangolin où bon vous semble et ensuite rentrez à l'intérieur pour faire les étapes suivantes.
Pangolin résidera dans ce dossier qu'il vous suffira de backup pour revenir en cas de pépins.
Pour le reste on va dire que ce dossier est: ~/pangolin

Téléchargement et exécution du script

La première chose à faire est de récupérer le lien du script d'installation pour la dernière version.
Pour cela allez visiter la page des "releases" du projet sur leur Github:
https://github.com/fosrl/pangolin/releases

A la date de la rédaction de ce topic la dernière version est: 1.0.1

Vous trouverez une liste de fichiers juste aprés les annonces de changements:

1 - la version si vous avez un CPU x64
2 - si votre CPU est un ARM

Copiez le lien du fichier qui convient au CPU de votre VPS et ensuite dans la console SSH avec votre VPS:

cd ~/pangolin
wget LE_LIEN -O installer && chmod a+x installer

Evidemment remplacez LE_LIEN par le lien du fichier que vous avez copié.

waazaa

Exécution du script

sudo ./installer

Le script est une série de questions auxquelles il vous faudra répondre pour mettre en place votre Pangolin.
Ce script s'occupe même de vous installer l'environnement docker pour vous, pensez donc à répondre "yes" pour dire que vous le voulez.

Les premières questions posées sont essentielles:

1 - Vous devez indiquer le "domaine" principal. Exemple: example.com
2 - Vous devez indiquer un sous-domaine qui servira à joindre la webui de Pangolin. Exemple: proxy.example.com ou pangolin.example.com

Il vous faut donc modifier votre zone DNS pour avoir:

une entrée de type A avec comme nom: proxy ou pangolin qui pointe vers l'ip de votre VPS
si vous voulez tout faire diriger vers Pangolin vous pouvez aussi créer une entrée de type CNAME avec comme nom * et cible proxy ou pangolin

Allez jusqu'à la fin du pas à pas en répondant aux questions.
Ces questions sont assez simples à comprendre.

Comme je disais en intro Gerbil n'est utile que si vous voulez l'aspect "tunnel wireguard" alors comme on est dans une installation VPS il nous faut Gerbil pour ensuite pouvoir faire discuter avec nos machines en local.
Donc à la question "voulez vous Gerbil ?" il faut donc répondre yes.

A la fin on vous demande si vous voulez Crowdsec.
C'est une solution de sécurité qui peut vous bloquer l'accés si vous ne faites pas des manipulations/paramétrages par la suite. Trés utile toutefois mais pensez à paramétrer votre liste blanche pour vous autoriser sans limites.

waazaa

Les ports utilisés

Si votre VPS bénéficie d'un parefeu intégré pensez à ouvrir les ports:
51820 - connexion wireguard
80 - http
443 - https

Visitez la webui de votre Pangolin

Normalement si tout s'est bien passé vous devriez pouvoir visiter la webui de votre Pangolin.
Sur proxy.example.com ou pangolin.example.com selon ce que vous avez choisis.
Remplacez example.com par votre domaine évidemment.

Les certificats SSL sont automatiquement créés au besoin mais il faut lui laisser le temps de le faire donc si vous arrivez sur une page indiquant que le SSL est pas bon patientez une minute ou deux et rafraîchissez la page.