143 lines
4.3 KiB
Markdown
143 lines
4.3 KiB
Markdown
---
|
|
title: Pangolin
|
|
created: 2026-06-06
|
|
updated: 2026-06-06
|
|
type: app
|
|
tags: [catalogue, reverse-proxy, tunneling, typescript, vpn, security]
|
|
confidence: high
|
|
contested: false
|
|
sources: [https://selfh.st/apps/?tag=Reverse+Proxy, https://pangolin.net/]
|
|
---
|
|
# 🚦 Pangolin
|
|
|
|
> **Reverse proxy avec tunneling intégré** : alternative open-source à Cloudflare Tunnel + Cloudflare Access. Sécurise et expose vos services sans ouvrir de ports.
|
|
|
|
## 📋 Informations Générales
|
|
|
|
| Champ | Valeur |
|
|
| :--- | :--- |
|
|
| **Site web** | [pangolin.net](https://pangolin.net/) |
|
|
| **GitHub** | [fosrl/pangolin](https://github.com/fosrl/pangolin) |
|
|
| **License** | Custom (source-available, gratuit) |
|
|
| **Langage** | TypeScript |
|
|
| **Étoiles GitHub** | 21k ⭐ |
|
|
| **Dernière MAJ** | 2026-06-04 |
|
|
| **Catégorie** | [[cat-reverse-proxy|Reverse Proxy]], VPN, Tunneling |
|
|
|
|
## 📝 Description
|
|
|
|
**Pangolin** est un **reverse proxy + tunnel** combiné avec gestion d'accès :
|
|
|
|
- ✅ **Tunneling** (comme Cloudflare Tunnel, mais self-hosted)
|
|
- ✅ **Reverse proxy** classique
|
|
- ✅ **Authentification SSO** intégrée
|
|
- ✅ **Access control** par utilisateur/rôle/ressource
|
|
- ✅ **Multi-site** : agents déployables sur plusieurs serveurs
|
|
- ✅ **WireGuard** intégré pour la couche réseau
|
|
- ✅ **Dashboard moderne** (UI très propre)
|
|
- ✅ **API REST** complète
|
|
|
|
**Différence avec [[app-traefik]]** : Traefik = reverse proxy "pur", Pangolin = reverse proxy **+** tunneling **+** SSO **+** VPN le tout-en-un.
|
|
|
|
**Différence avec [[app-cloudflared]]** : Cloudflared = tunnel vers Cloudflare, Pangolin = **tout en local**, pas de dépendance cloud.
|
|
|
|
## 🚀 Installation
|
|
|
|
### Option 1 : Docker Compose (recommandé)
|
|
|
|
```yaml
|
|
# docker-compose.yml
|
|
version: '3.8'
|
|
services:
|
|
pangolin:
|
|
image: fosrl/pangolin:latest
|
|
container_name: pangolin
|
|
restart: unless-stopped
|
|
ports:
|
|
- "8080:8080" # Web UI
|
|
- "443:443" # HTTPS
|
|
volumes:
|
|
- ./config:/app/config
|
|
depends_on:
|
|
- postgres
|
|
|
|
postgres:
|
|
image: postgres:15
|
|
container_name: pangolin-db
|
|
restart: unless-stopped
|
|
environment:
|
|
- POSTGRES_USER=pangolin
|
|
- POSTGRES_PASSWORD=*** - POSTGRES_DB=pangolin
|
|
volumes:
|
|
- pg-data:/var/lib/postgresql/data
|
|
|
|
# Agent (à déployer sur chaque serveur distant)
|
|
pangolin-agent:
|
|
image: fosrl/pangolin-agent:latest
|
|
container_name: pangolin-agent
|
|
restart: unless-stopped
|
|
environment:
|
|
- PANGOLIN_SERVER_URL=https://pangolin.example.com
|
|
- PANGOLIN_AGENT_SECRET=*** volumes:
|
|
- /var/run/docker.sock:/var/run/docker.sock:ro
|
|
|
|
volumes:
|
|
pg-data:
|
|
```
|
|
|
|
## ⚙️ Configuration Initiale
|
|
|
|
1. **Démarrer Pangolin** (Docker Compose ci-dessus)
|
|
2. **Accéder à l'UI** : `http://IP:8080`
|
|
3. **Créer le premier admin** (via setup wizard)
|
|
4. **Ajouter des ressources** (services à exposer)
|
|
5. **Déployer l'agent** sur chaque serveur distant
|
|
6. **Configurer l'auth** (SSO, access lists)
|
|
|
|
## 🔄 Alternatives
|
|
|
|
### Open Source
|
|
- [[app-traefik]] + [[app-cloudflared]] (combo pour faire pareil)
|
|
- **Headscale** — VPN self-hosted
|
|
- **NetBird** — WireGuard + UI
|
|
- **Nebula** — Mesh VPN (overlap avec Pangolin)
|
|
|
|
### Comparaison Pangolin vs Cloudflare Tunnel
|
|
|
|
| Critère | Pangolin | Cloudflare Tunnel |
|
|
| :--- | :--- | :--- |
|
|
| Self-hosted | ✅ | ❌ |
|
|
| Dépendance cloud | Aucune | Cloudflare |
|
|
| Coût | Gratuit | Freemium |
|
|
| SSO intégré | ✅ | Via Cloudflare Access |
|
|
| Performance | Dépend du serveur | CDN global |
|
|
| Facilité setup | Moyenne | Très simple |
|
|
|
|
**Verdict** : Pangolin pour **contrôle total** et **souveraineté**. Cloudflare Tunnel pour **simplicité maximale** et **CDN global**.
|
|
|
|
### Propriétaires (ce que Pangolin remplace)
|
|
- **Cloudflare Tunnel** + **Cloudflare Access** (~5$/mois)
|
|
- **ngrok Business**
|
|
- **Tailscale Funnel**
|
|
- **Zrok** (open source mais moins complet)
|
|
|
|
## 🔐 Sécurité
|
|
|
|
- **SSO** (OIDC, OAuth2)
|
|
- **Access control** granulaire
|
|
- **WireGuard** pour le transport (chiffré)
|
|
- **HTTPS** automatique
|
|
- **Audit logs**
|
|
|
|
## 📚 Ressources
|
|
|
|
- [Documentation officielle](https://docs.pangolin.net/)
|
|
- [GitHub fosrl/pangolin](https://github.com/fosrl/pangolin)
|
|
- [Discord fosrl](https://discord.gg/fosrl)
|
|
|
|
## Pages Liées
|
|
- [[cat-reverse-proxy]] — Catégorie Reverse Proxy
|
|
- [[app-traefik]] — Concurrent classique
|
|
- [[vpn]] — Concepts VPN
|
|
- [[zero-trust]] — Modèle de sécurité
|