Tailscale 앱을 설치하고 기기 인증 링크를 완료했다고 해서 ZimaOS 컨테이너가 계속 연결된 상태로 유지된다는 보장은 없습니다. 2025년 10월에 해결된 이 글에서는 기기를 Tailscale에 추가할 수는 있었지만, Tailscale 관리자 기기 목록에 예상한 연결 상태가 표시되지 않았습니다.
해결 방법은 IceWhale 직원 계정이 아니라 다른 커뮤니티 사용자가 제시했습니다. 한 사용자는 자신의 환경에서 작동했던 ZimaOS 앱 스토어의 Tailscale 항목을 확인하고, 웹 UI 구성을 변경한 뒤 새로운 Tailscale 인증 키를 제공했습니다. 이후 다른 답변에서는 문제가 지속될 때 필요한 중요한 복구 단계로, 앱을 다시 설치하기 전에 기존 Tailscale AppData 폴더를 삭제하라고 안내했습니다.
이 글에서는 특정 Tailscale 앱 스토어 항목을 사용했습니다
ZimaOS 앱 스토어에는 Tailscale 관련 항목이 두 개 표시되었습니다. 커뮤니티 도우미는 당시 자신의 ZimaOS 1.5 마이그레이션 환경에서 왼쪽에 강조 표시된 항목만 작동했다고 설명했습니다.
이는 2025년 당시의 관찰이며, 현재 앱 스토어 패키지의 영구적인 순위를 의미하지는 않습니다. 앱 정의는 변경될 수 있으므로, 같은 항목이 여전히 필요한지 판단하기 전에 현재 패키지 세부 정보를 비교하세요.
커뮤니티 구성에서 사용한 웹 UI 경로를 설정하세요
도우미는 Tailscale 앱의 웹 UI 대상을 Tailscale 로그인 관리 경로로 변경했습니다.
login.tailscale.com과 /admin 경로를 사용했습니다.이 설정은 ZimaOS에서 열리는 바로 가기를 제어합니다. Tailscale 데몬 자체의 네트워크 상태와 혼동하지 마세요.
현재 사용 중인 본인의 Tailscale 인증 키를 사용하세요
커뮤니티 안내에서는 Tailscale에서 인증 키를 발급받은 다음 앱의 TS_AUTHKEY 환경 변수에 입력했습니다. 스크린샷, 포럼 게시물, 백업 또는 다른 컴퓨터에서 인증 키를 복사하지 마세요. 인증 키는 자격 증명이므로 본인의 tailnet용으로 생성하고 관리해야 합니다.
현재 Tailscale 문서에서는 컨테이너 배포와 Docker용 인증 매개변수를 지원합니다.
다시 설치해도 해결되지 않으면 기존 AppData가 재사용되고 있을 수 있습니다
두 번째 커뮤니티 사용자는 이전에는 작동했지만 이후 중단된 Tailscale 설치를 사용하고 있었습니다. 업데이트, 재부팅, 앱 삭제 및 재설치를 시도했지만 처음에는 복구되지 않았습니다.
이 사용자에게 최종적으로 효과가 있었던 단계는 다음과 같습니다.
- ZimaOS에서 Tailscale 앱을 삭제합니다.
- ZimaOS AppData 위치로 이동합니다.
- 기존
tailscale애플리케이션 데이터 폴더를 삭제합니다. - 앱 스토어에서 Tailscale을 다시 설치합니다.
- 작동했던 구성 및 인증 단계를 다시 수행합니다.
경고: AppData 폴더를 삭제하면 애플리케이션의 영구 상태가 제거됩니다. 삭제하기 전에 필요한 데이터를 백업하고, 다른 애플리케이션의 데이터가 아닌 Tailscale 폴더를 삭제하는지 확인하세요.
앱만 삭제해도 Tailscale이 초기화되지 않을 수 있는 이유
컨테이너 애플리케이션은 일반적으로 일회성 컨테이너 파일 시스템 외부에 상태를 보관합니다. 이렇게 하면 업데이트나 컨테이너 재생성 후에도 설정이 유지되지만, 영구 AppData 디렉터리를 그대로 두면 잘못되었거나 오래된 상태가 일반적인 제거 및 재설치 과정 이후에도 남을 수 있습니다.
따라서 이 글의 후속 결과는 복구 단계를 두 수준으로 구분하는 데 유용합니다. 먼저 컨테이너를 다시 설치하고, 일반적인 재설치 후에도 동일한 문제가 있는 구성을 계속 재사용할 때만 영구 상태 삭제를 고려하세요.
이 글에서 해결한 문제는 노드 연결이며, 서브넷 라우팅 문제가 아닙니다
이 문제는 Tailscale 노드가 연결 상태가 되지 않는 것이었습니다. Tailscale은 성공적으로 연결되었지만 서브넷 경로를 광고하지 못했던 이후의 ZimaOS 논의와는 다른 문제입니다. 기기가 이미 Tailscale에서 온라인 상태이고 원격 LAN 서비스에만 접근할 수 없다면, 이 인증 중심 절차를 반복하기보다 서브넷 라우팅을 문제 해결하세요.
ZimaOS Tailscale 연결 FAQ
내 Tailscale 기기가 등록된 것으로 표시되지만 계속 연결되지 않는 이유는 무엇인가요?
2025년에 해결된 사례에서는 적절한 앱 스토어 항목, 해당 항목의 웹 UI 구성, 유효한 Tailscale 인증 키를 사용하는 커뮤니티 구성이 작동했습니다.
Tailscale AppData를 바로 삭제해야 하나요?
아니요. AppData 삭제는 일반적인 업데이트, 재부팅, 제거 및 재설치 시도가 실패한 후 사용한 후속 복구 단계였습니다. 영구 상태가 제거되므로 먼저 백업하세요.
오래된 스크린샷에 표시된 인증 키를 재사용해도 안전한가요?
아니요. 본인의 tailnet용 키를 직접 생성하고 관리하세요. 인증 키는 자격 증명으로 취급해야 합니다.
이것은 공식 IceWhale 해결 방법인가요?
아니요. 이 글은 커뮤니티 문제 해결을 통해 해결된 것으로 표시되었습니다. 실용적인 참고 자료이지만, 해당 단계가 공식 IceWhale 지원 절차로 게시된 것은 아닙니다.
