CasaOS에서 Twingate를 사용하는 가장 깔끔하고 최신 방법은 CasaOS 호스트나 동일한 LAN에 있는 다른 머신에서 Twingate Connector를 Docker 컨테이너로 실행하는 것입니다. Connector가 Twingate에 아웃바운드 연결을 설정하므로 CasaOS 대시보드의 포트를 포워딩할 필요가 없습니다.
2023년 포럼 튜토리얼은 현재 Twingate Docker Compose 템플릿이 나오기 전에 작성되었습니다. 오래된 원클릭 스토어 패키지를 무작정 복사하지 말고, 최신 Connector 토큰과 공식 Compose 변수를 사용하세요.
Remote Network 및 Connector 생성
Twingate Admin Console에서 Remote Network와 Connector를 생성하세요. Twingate가 해당 Connector의 고유한 액세스 토큰과 새로고침 토큰을 생성합니다.
최신 Docker Compose 템플릿 사용
현재 Twingate Docker Compose 가이드에는 필수 변수가 안내되어 있습니다.
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
공개 스크린샷에 토큰이 노출되지 않도록 하세요
액세스 토큰과 새로고침 토큰은 Connector를 고유하게 인증합니다. CasaOS 앱 설정이나 Git에 커밋하거나 공개 게시하지 않는 환경 파일에 저장하세요.
Twingate 리소스로 CasaOS 추가
Twingate Admin Console에서 CasaOS LAN IP 또는 호스트 이름과 웹 포트를 리소스로 정의하세요. 필요한 사용자/그룹에만 액세스 권한을 부여하세요.
브리지 네트워킹과 호스트 네트워킹 비교
Twingate에 따르면 기본 모드는 브리지 모드이며, 호스트 모드는 로컬 피어 투 피어 네트워킹에 도움이 될 수 있습니다. 호스트의 네트워크 스택을 공유해야 하는 특별한 이유가 없다면 공식 기본 설정으로 시작하세요.
라우터 포트 포워딩 불필요
Connector는 방화벽 뒤에서 아웃바운드 연결을 설정합니다. 원격 액세스를 원한다는 이유만으로 CasaOS 관리자 포트를 공용 인터넷에 개방하지 마세요.
원격 기기에 Twingate Client 설치하기
Connector는 홈 네트워크 안에서 실행되고, Twingate Client는 원격 접속에 사용하는 노트북이나 휴대폰에서 실행됩니다. 트래픽이 비공개 리소스에 도달하기 전에 둘 다 Twingate 네트워크에 등록됩니다.
리소스를 더 추가하기 전에 액세스 확인하기
먼저 CasaOS 대시보드를 테스트한 다음 다른 NAS 앱을 하나씩 추가하세요. 이렇게 하면 서브넷 전체를 불필요하게 노출하지 않고 액세스 정책을 명확하게 설정할 수 있습니다.
비공개 원격 액세스 가이드에서 홈 서버에 관한 더 폭넓은 정보를 확인할 수 있습니다.
CasaOS를 테스트하기 전에 Connector 상태 확인하기
docker ps | grep twingate
docker logs --tail 100 twingate-connectorConnector가 정상적으로 등록되고 계속 실행되어야 합니다. 반복해서 재시작된다면 CasaOS 리소스를 점검하기 전에 테넌트 이름과 토큰을 확인하세요.
리소스 정의 범위를 최대한 좁게 설정하기
CasaOS 대시보드만 필요하다면 LAN 서브넷 전체를 노출하는 대신 정확한 CasaOS IP와 웹 포트를 지정하세요. 다른 앱은 실제로 필요할 때 별도의 리소스로 추가하세요.
Connector 업데이트 계획하기
Twingate는 CasaOS와 별도로 컨테이너 업데이트를 배포합니다. 주기적으로 최신 Connector 이미지를 가져와 유지 관리 시간에 재시작한 다음, 원격 액세스가 여전히 작동하는지 확인하세요.
자주 묻는 질문
라우터에서 CasaOS 포트를 열어야 하나요?
아니요. Twingate Connector는 방화벽 뒤에서 실행되며 아웃바운드 연결을 설정하도록 설계되었습니다.
Twingate 토큰은 어디서 가져오나요?
Connector를 배포하면 Admin Console에서 토큰이 생성됩니다.
호스트 네트워킹을 사용해야 하나요?
네트워크 토폴로지나 피어 투 피어 동작에 필요한 경우에만 사용하세요. 기본값은 브리지입니다.
Connector 하나로 CasaOS 외의 서비스도 노출할 수 있나요?
예. 다만 기본적으로 서브넷 전체에 대한 광범위한 액세스 권한을 부여하는 대신, 리소스와 권한을 신중하게 설정하세요.
