De eenvoudigste actuele manier om Twingate met CasaOS te gebruiken, is door een Twingate Connector als Docker-container te draaien op de CasaOS-host of een andere machine binnen hetzelfde LAN. De Connector maakt uitgaande verbindingen met Twingate, dus je hoeft de CasaOS-bedieningspagina niet via port forwarding toegankelijk te maken.
De forumhandleiding uit 2023 dateert van vóór de huidige Twingate Docker Compose-sjabloon. Gebruik de huidige Connector-tokens en officiële Compose-variabelen in plaats van blindelings een oud pakket uit de appstore te kopiëren.
Maak een extern netwerk en een Connector aan
Maak in de Twingate-beheerconsole een extern netwerk en een Connector aan. Twingate genereert voor die Connector een uniek toegangstoken en vernieuwingstoken.
Gebruik de actuele Docker Compose-sjabloon
De huidige Twingate Docker Compose-handleiding beschrijft deze verplichte variabelen:
services:
twingate-connector:
image: twingate/connector:latest
restart: always
environment:
- TWINGATE_NETWORK=YOUR_TENANT
- TWINGATE_ACCESS_TOKEN=YOUR_ACCESS_TOKEN
- TWINGATE_REFRESH_TOKEN=YOUR_REFRESH_TOKEN
Houd tokens buiten openbare schermafbeeldingen
Toegangs- en vernieuwingstokens identificeren de Connector op unieke wijze. Sla ze op in de CasaOS-appconfiguratie of in een omgevingsbestand dat niet wordt vastgelegd in Git of openbaar wordt gedeeld.
Voeg CasaOS toe als Twingate-resource
Definieer in de Twingate-beheerconsole het LAN-IP-adres of de hostnaam van CasaOS en de webpoort als een resource. Verleen alleen toegang aan de gebruikers/groepen die deze nodig hebben.
Brug- versus hostnetwerken
Volgens Twingate is de brugmodus de standaardinstelling, terwijl de hostmodus kan helpen bij lokale peer-to-peer-netwerken. Begin met de officiële standaardinstelling, tenzij je een specifieke reden hebt om de netwerkstack van de host te delen.
Port forwarding op de router is niet nodig
De Connector bevindt zich achter de firewall en maakt uitgaande verbindingen. Stel de CasaOS-beheerpoort niet bloot aan het openbare internet alleen omdat je op afstand toegang wilt.
Installeer de Twingate Client op je externe apparaat
De Connector draait binnen je thuisnetwerk; de Twingate Client draait op de laptop of telefoon die je op afstand gebruikt. Beide registreren zich bij het Twingate-netwerk voordat verkeer de privé-Resource bereikt.
Controleer de toegang voordat je meer Resources toevoegt
Test eerst het CasaOS-dashboard en voeg daarna andere NAS-apps afzonderlijk toe. Zo blijft het toegangsbeleid duidelijk en voorkom je dat je onnodig een heel subnet beschikbaar maakt.
De gids voor privétoegang op afstand biedt meer context over homeservers.
Controleer de status van de Connector voordat je CasaOS test
docker ps | grep twingate
docker logs --tail 100 twingate-connectorDe Connector moet zich succesvol registreren en actief blijven. Als deze herhaaldelijk opnieuw opstart, controleer dan de tenantnaam en tokens voordat je problemen met de CasaOS-Resource gaat oplossen.
Gebruik de meest beperkte Resource-definitie
Als je alleen het CasaOS-dashboard nodig hebt, definieer dan het exacte CasaOS-IP-adres en de webpoort in plaats van het hele LAN-subnet beschikbaar te maken. Voeg andere apps als afzonderlijke Resources toe wanneer je ze daadwerkelijk nodig hebt.
Plan Connector-updates
Twingate publiceert containerupdates onafhankelijk van CasaOS. Haal regelmatig de huidige Connector-image op en start deze opnieuw tijdens een onderhoudsvenster. Controleer daarna of externe toegang nog werkt.
Veelgestelde vragen
Moet ik CasaOS-poorten openen op mijn router?
Nee. Twingate Connectors zijn ontworpen om achter de firewall te draaien en uitgaande verbindingen tot stand te brengen.
Waar komen de Twingate-tokens vandaan?
De Admin Console genereert ze wanneer je een Connector implementeert.
Moet ik hostnetwerken gebruiken?
Alleen als dat nodig is voor je topologie of peer-to-peer-gedrag; bridge is de standaard.
Kan één Connector toegang bieden tot meer dan CasaOS?
Ja, maar definieer Resources en machtigingen bewust in plaats van standaard brede toegang tot het subnet te verlenen.
