server-up/docs/pangolin.md
Ramon 58d9be1f48
All checks were successful
Deploy server-up (dev) / deploy (push) Successful in 2m1s
v0.7.90-beta - ARR-stack opgesplitst, /data-mount, netwerkopties per container
- Elk *arr-onderdeel is nu ook een losse app in de store (46 nieuwe sjablonen);
  los en gebundeld komen uit één bron (tools/arr_sjablonen.py) met een test die
  bewaakt dat ze niet uiteen lopen
- Alles deelt één /data-map, zodat hardlinks werken; losse /tv-, /movies- en
  /downloads-mounts zijn eruit, UMASK=002 erbij
- Nieuwe eerste stap "Onderdelen" in het invulmenu, met kopjes per soort; de
  dubbele groepsschakelaar en de lege kaarten in Instellingen zijn weg
- Eigen IP-adres per container in plaats van per stack; containers zonder adres
  houden hun poortmapping. Ook Pangolin publiceert nu per container
- Huntarr vervangen door NeutArr (project offline na lekken, image bestaat niet
  meer), Maintainerr naar zijn nieuwe organisatie
- 31 apps toegevoegd uit het *arr-ecosysteem, alle images tegen hun registry
  gecontroleerd
- data_dir hernoemd naar appdata_dir in de hele catalogus, naast de nieuwe
  data_root; qBittorrent van poort 8080 naar 8097

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q9eqpADJSRs49SoGGr4NAy
2026-07-31 22:21:04 +02:00

3.5 KiB

Pangolin — een publiek adres voor je apps

Pangolin is een reverse proxy met tunnel: je apps blijven thuis draaien en krijgen toch een adres op internet, zónder dat je poorten hoeft open te zetten in je router. Server Up kan die adressen voor je aanmaken, zodat je dat niet per app in de Pangolin-interface hoeft te doen.

Server Up installeert Pangolin niet. Je hebt een draaiende Pangolin-server nodig (in de cloud of op een VPS) en een Newt-site die vanaf je thuisnetwerk naar buiten verbindt. Server Up praat alleen met de API.


Instellen

Onder Instellingen → Pangolin:

Veld Waar vind je dat
Adres De URL van je Pangolin-server, bijvoorbeeld https://pangolin.voorbeeld.nl
API-sleutel In Pangolin onder Settings → API Keys. Geef hem rechten om resources en targets te maken.
Organisatie-id Staat in de URL als je in Pangolin bent ingelogd
Site Wordt opgehaald zodra de sleutel werkt; dit is je Newt-verbinding
Domein Wordt opgehaald zodra de sleutel werkt

Klik daarna op Verbinding testen. Lukt het, dan staat er hoeveel sites er gevonden zijn. De API-sleutel is write-only: je kunt hem instellen, maar de API geeft hem nooit terug.


Een URL aanmaken

Open Inloggegevens op de stackkaart en klik op Publieke URL aanmaken. Server Up doet dan twee dingen:

  1. een resource aanmaken — het publieke adres, standaard <stacknaam>.<domein>;
  2. een target aanmaken — waar dat adres naartoe wijst.

Het doel wordt afgeleid: heeft de container een eigen IP-adres (macvlan), dan dat; anders het adres van de host met de gepubliceerde poort. De URL wordt bij de stack bewaard en daarna in het paneel getoond.

Bij een stack met meerdere webinterfaces publiceer je per container. De ARR-stack heeft er twintig; die krijgen elk hun eigen adres (sonarr.<domein>, radarr.<domein>, …) in plaats van dat de eerste poort in het bestand de URL opslokt. Server Up haalt de juiste poort uit de gegevens die bij het installeren zijn bewaard.


Als het misgaat

"De API-sleutel wordt geweigerd (401)" — de sleutel is verlopen of heeft te weinig rechten.

"Organisatie niet gevonden (404)" — het organisatie-id klopt niet. Het is de korte naam uit de URL, niet de weergavenaam.

"Geen site gevonden; installeer eerst Newt" — Pangolin heeft een tunnel naar je netwerk nodig. Zet Newt op je thuisserver en koppel die als site.

"Aanmaken mislukt" met twee HTTP-codes — de API van Pangolin is in versie 1.9 veranderd: een resource hing eerst onder een site (PUT /org/<org>/site/<site>/resource) en staat sindsdien los (PUT /org/<org>/resource). Server Up probeert allebei en toont beide foutmeldingen, zodat je ziet welke route jouw versie verwacht. Zie fosrl/pangolin#1344.


Wat er níét gebeurt

  • Server Up beheert de URL niet verder: verwijder je de stack, dan blijft de resource in Pangolin staan. Ruim die daar zelf op.
  • Er wordt geen authenticatie voor de resource ingesteld. Wil je dat het adres niet voor de hele wereld open staat, zet dan in Pangolin zelf een toegangsregel of SSO op die resource.
  • Meerdere targets per resource (load balancing) valt hierbuiten.

Deze integratie is getest tegen een nagebouwde API, niet tegen een echte Pangolin-server. Dat de juiste verzoeken verstuurd worden ligt vast in de tests; of jouw versie ze accepteert, blijkt bij de eerste poging. De foutmeldingen zijn daarom zo volledig mogelijk gehouden.