Det enklaste aktuella sättet att använda Twingate med CasaOS är att köra en Twingate Connector som en Docker-container på CasaOS-värden eller en annan dator i samma LAN. Connectorn upprättar utgående anslutningar till Twingate, så du behöver inte vidarebefordra portar till CasaOS-instrumentpanelen.
Foruminstruktionen från 2023 publicerades innan Twingates aktuella Docker Compose-mall. Använd aktuella Connector-token och officiella Compose-variabler i stället för att blint kopiera ett gammalt paket från appbutiken med ett klick.
Skapa ett fjärrnätverk och en Connector
Skapa ett fjärrnätverk och en Connector i Twingates administratörskonsol. Twingate genererar en unik åtkomsttoken och uppdateringstoken för Connectorn.
Använd den aktuella Docker Compose-mallen
I den aktuella Twingate-guiden för Docker Compose dokumenteras dessa obligatoriska variabler:
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
Håll token borta från offentliga skärmbilder
Åtkomst- och uppdateringstoken autentiserar Connectorn unikt. Lagra dem i CasaOS appkonfiguration eller i en miljöfil som inte checkas in i Git eller publiceras offentligt.
Lägg till CasaOS som en Twingate-resurs
Ange CasaOS LAN-IP-adress eller värdnamn och webbport som en resurs i Twingates administratörskonsol. Ge endast de användare och grupper som behöver det åtkomst.
Nätverk i bryggläge kontra värdläge
Twingate anger att bryggläge är standard, medan värdläge kan underlätta lokala peer-to-peer-nätverk. Börja med det officiella standardläget om du inte har ett särskilt skäl att dela värddatorns nätverksstack.
Ingen portvidarebefordran i routern krävs
Connectorn körs bakom brandväggen och upprättar utgående anslutningar. Öppna inte CasaOS administrationsport mot det offentliga internet bara för att du vill ha fjärråtkomst.
Installera Twingate Client på din fjärrenhet
Connector körs i ditt hemnätverk, medan Twingate Client körs på den bärbara dator eller telefon du använder på distans. Båda registreras i Twingate-nätverket innan trafiken når den privata resursen.
Verifiera åtkomsten innan du lägger till fler resurser
Testa CasaOS-instrumentpanelen först och lägg sedan till andra NAS-appar var för sig. Då förblir åtkomstpolicyn tydlig i stället för att hela undernätet exponeras i onödan.
Guiden för privat fjärråtkomst ger mer sammanhang om hemmaservrar.
Kontrollera Connector-status innan du testar CasaOS
docker ps | grep twingate
docker logs --tail 100 twingate-connectorConnector bör registreras utan problem och fortsätta köras. Om den startar om upprepade gånger kontrollerar du klientnamnet och tokenen innan du felsöker CasaOS-resursen.
Använd den snävaste resursdefinitionen
Om du bara behöver CasaOS-instrumentpanelen definierar du den exakta CasaOS-IP-adressen och webbporten i stället för att exponera hela LAN-undernätet. Lägg till andra appar som separata resurser när du faktiskt behöver dem.
Planera för uppdateringar av Connector
Twingate publicerar containeruppdateringar oberoende av CasaOS. Hämta regelbundet den aktuella Connector-avbildningen och starta om den under ett underhållsfönster. Bekräfta sedan att fjärråtkomsten fortfarande fungerar.
Vanliga frågor
Behöver jag öppna CasaOS-portar på min router?
Nej. Twingate Connectors är utformade för att köras bakom brandväggen och upprätta utgående anslutningar.
Varifrån kommer Twingate-tokenen?
Administratörskonsolen genererar dem när du driftsätter en Connector.
Bör jag använda värdnätverk?
Endast vid behov för din topologi eller peer-to-peer-beteende; bridge är standard.
Kan en Connector exponera mer än CasaOS?
Ja, men definiera resurser och behörigheter medvetet i stället för att som standard bevilja bred åtkomst till undernätet.
