Najprościej obecnie korzystać z Twingate w CasaOS, uruchamiając Connector Twingate jako kontener Docker na hoście CasaOS lub innym urządzeniu w tej samej sieci LAN. Connector nawiązuje połączenia wychodzące z Twingate, więc nie trzeba przekierowywać portów do panelu CasaOS.
Poradnik z forum z 2023 roku powstał przed opracowaniem aktualnego szablonu Twingate Docker Compose. Użyj aktualnych tokenów Connectora i oficjalnych zmiennych Compose, zamiast bezrefleksyjnie kopiować stary pakiet ze sklepu oferujący instalację jednym kliknięciem.
Utwórz Remote Network i Connector
W konsoli administracyjnej Twingate utwórz Remote Network i Connector. Twingate wygeneruje unikalny token dostępu i token odświeżania dla tego Connectora.
Użyj aktualnego szablonu Docker Compose
Aktualna instrukcja Twingate Docker Compose opisuje wymagane zmienne:
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
Nie umieszczaj tokenów na publicznych zrzutach ekranu
Tokeny dostępu i odświeżania służą do jednoznacznego uwierzytelniania Connectora. Zapisz je w konfiguracji aplikacji CasaOS lub w pliku środowiskowym, który nie jest zatwierdzany w Git ani publikowany publicznie.
Dodaj CasaOS jako zasób Twingate
W konsoli administracyjnej Twingate zdefiniuj adres IP lub nazwę hosta CasaOS w sieci LAN oraz port internetowy jako zasób. Przyznaj dostęp tylko użytkownikom/grupom, które go potrzebują.
Sieć w trybie bridge a w trybie hosta
Według Twingate tryb bridge jest domyślny, a tryb hosta może ułatwić lokalną komunikację peer-to-peer. Zacznij od oficjalnego ustawienia domyślnego, chyba że masz konkretny powód, by udostępniać stos sieciowy hosta.
Nie trzeba przekierowywać portów na routerze
Connector znajduje się za zaporą sieciową i nawiązuje połączenia wychodzące. Nie udostępniaj portu administracyjnego CasaOS w publicznym internecie tylko dlatego, że chcesz uzyskać zdalny dostęp.
Zainstaluj Klienta Twingate na urządzeniu używanym do zdalnego dostępu
Connector działa w Twojej sieci domowej; Klient Twingate działa na laptopie lub telefonie, z którego łączysz się zdalnie. Oba urządzenia rejestrują się w sieci Twingate, zanim ruch dotrze do prywatnego zasobu.
Sprawdź dostęp, zanim dodasz więcej zasobów
Najpierw przetestuj panel CasaOS, a potem dodawaj osobno inne aplikacje NAS. Dzięki temu zasady dostępu będą jasne i nie udostępnisz niepotrzebnie całej podsieci.
Przewodnik po prywatnym dostępie zdalnym zawiera szerszy kontekst dotyczący domowych serwerów.
Sprawdź stan Connectora przed testowaniem CasaOS
docker ps | grep twingate
docker logs --tail 100 twingate-connectorConnector powinien zarejestrować się poprawnie i działać bez przerwy. Jeśli wielokrotnie się uruchamia ponownie, przed diagnozowaniem zasobu CasaOS sprawdź nazwę dzierżawcy i tokeny.
Użyj możliwie najwęższej definicji zasobu
Jeśli potrzebujesz tylko panelu CasaOS, określ dokładny adres IP CasaOS i port WWW zamiast udostępniać całą podsieć LAN. Dodawaj inne aplikacje jako osobne zasoby dopiero wtedy, gdy będą potrzebne.
Zaplanuj aktualizacje Connectora
Twingate publikuje aktualizacje kontenerów niezależnie od CasaOS. Co jakiś czas pobieraj aktualny obraz Connectora i uruchamiaj go ponownie w oknie serwisowym, a następnie potwierdź, że dostęp zdalny nadal działa.
FAQ
Czy muszę otworzyć porty CasaOS na routerze?
Nie. Connectory Twingate są zaprojektowane do działania za zaporą sieciową i nawiązywania połączeń wychodzących.
Skąd pochodzą tokeny Twingate?
Konsola administratora generuje je podczas wdrażania Connectora.
Czy używać sieci hosta?
Tylko wtedy, gdy wymaga tego topologia sieci lub komunikacja peer-to-peer; domyślnie używaj trybu bridge.
Czy jeden Connector może udostępniać więcej niż CasaOS?
Tak, ale zdefiniuj zasoby i uprawnienia w przemyślany sposób, zamiast domyślnie przyznawać szeroki dostęp do podsieci.
