macOS에서 ZimaClient가 “연결 중” 상태로 멈춰 있다면, 앱을 재설치하거나 ZimaOS 서버를 변경하기 전에 클라이언트에서 로그아웃한 뒤 다시 로그인하세요. 이 조치만으로 몇 시간 동안 멈춰 있던 검증된 2.1.0 소스 사례가 해결되었습니다.
다만 로그아웃/로그인을 모든 문제의 근본 원인을 해결하는 방법으로 간주해서는 안 됩니다. 같은 스레드에는 ZimaOS 업그레이드 후 Mac과 Android에서 발생한 연결 증상이 모두 포함되어 있었으며, IceWhale은 방화벽, VPN, 프록시, ISP 변경 및 네트워크 구성에 대해 구체적으로 문의했습니다. 따라서 문제 해결 과정에서는 계정/세션 상태와 네트워크 연결 가능성을 분리해 확인하는 것이 좋습니다.
1단계: 서버가 로컬에서 작동하는지 확인
브라우저에서 LAN IP를 직접 입력해 ZimaOS 대시보드를 엽니다. 서버가 로컬에서는 작동하지만 ZimaClient가 연결되지 않는다면 클라이언트, 세션 또는 원격 액세스 계층에 집중하세요.
2단계: 로그아웃한 후 다시 로그인
원래 사용자는 이미 ZimaClient를 재설치하고 ZimaOS를 재부팅했지만 문제가 해결되지 않았습니다. ZimaClient에서 로그아웃한 뒤 다시 인증하자 연결이 복구되었습니다.
이는 오래된 클라이언트/세션 상태가 관련되었을 가능성을 보여주지만, 해당 스레드만으로 어떤 토큰이나 네트워크 상태가 변경되었는지는 정확히 입증되지 않았습니다.
3단계: ZimaOS에서 원격 액세스 확인
현재 ZimaOS 원격 액세스 가이드에 따르면 원격 액세스는 설정 → 네트워크에서 켜거나 끌 수 있습니다.
집 밖에서 ZimaClient를 사용할 예정이라면 원격 액세스가 활성화되어 있는지 확인하세요.
4단계: 동일한 LAN에서 테스트
현재 ZimaOS 온보딩 안내에서는 최초 연결을 동일한 네트워크에서 진행할 것을 권장합니다. ZimaClient가 로컬에서도 연결되지 않는다면 원격 NAT 통과가 첫 번째 문제는 아닙니다.
5단계: VPN, 프록시, 방화벽 및 네트워크 변경 확인
IceWhale 지원팀은 문제가 발생하기 전에 사용자가 방화벽, VPN/프록시, ISP 또는 네트워크 관리 설정을 변경했는지 구체적으로 문의했습니다.
진단하는 동안 충돌을 일으킬 수 있는 VPN/프록시 클라이언트를 일시적으로 비활성화하고, macOS의 로컬 네트워크 권한이 ZimaClient의 기기 검색을 허용하는지 확인하세요.
6단계: 멈춘 ZimaClient 프로세스 재시작
현재 ZimaClient 설치 가이드에서는 앱이 실행 중으로 보이지만 제대로 작동하지 않을 때 활성 상태 보기에서 Zima 관련 프로세스를 종료할 것을 권장합니다.
7단계: 다시 재설치하기 전에 로그 수집
현재 문서에는 macOS의 ZimaClient 로그 위치가 다음과 같이 나와 있습니다.
~/Library/Application Support/Zima/logs문제를 재현한 직후 로그를 수집하면 지원팀에서 검색, 인증 및 원격 네트워크 문제를 구분하는 데 도움이 됩니다.
대안으로 표준 VPN 도구 사용
현재 ZimaOS는 대체 원격 네트워크 옵션으로 Tailscale, WireGuard Easy, Firefly 및 NetBird도 지원합니다. 이러한 도구는 ZimaClient의 백업 또는 Finder 통합 기능을 대체하지는 않지만, 별도의 사설 네트워크 경로를 제공할 수 있습니다.
원격 연결 가이드에서 이러한 계층을 비교하는 방법을 확인할 수 있습니다.
인증 문제와 연결 문제 구분
Mac에서 서버를 검색할 수 있지만 인증에 실패한다면 동일한 ZimaOS 계정으로 로컬 웹 UI에 로그인해 보세요. 브라우저에서는 계정이 작동하지만 ZimaClient에서는 작동하지 않는다면 문제는 비밀번호 자체보다는 클라이언트/세션 상태일 가능성이 높습니다.
브라우저와 클라이언트 모두 IP 주소를 통해 서버에 연결할 수 없다면 먼저 서버 또는 LAN 문제를 해결하세요.
macOS 로컬 네트워크 권한 확인
macOS에서는 앱이 로컬 네트워크의 기기를 검색하지 못하도록 제한할 수 있습니다. ZimaClient에 근처의 ZimaOS 기기가 표시되지 않는다면 macOS 개인정보 보호 및 보안 설정에서 앱의 로컬 네트워크 권한을 확인하고, 권한을 변경한 후 클라이언트를 재시작하세요.
문제가 있는 계층만 재설정
ZimaOS 서버, Remote ID, 비밀번호 및 클라이언트 설치를 한꺼번에 재설정하지 마세요. 한 번에 하나의 계층만 변경해야 실제로 무엇이 문제를 해결했는지 알 수 있습니다.
소스 사례가 좋은 예입니다. 서버 재부팅과 클라이언트 재설치는 도움이 되지 않았지만 로그아웃 후 다시 로그인하자 문제가 해결되었습니다. 이는 손상된 서버 설치보다는 세션 상태에 문제가 있었음을 시사합니다.
대체 원격 경로를 사용해야 하는 경우
ZimaClient를 계속 사용할 수 없지만 서버 자체는 정상이라면, 로그를 수집하는 동안 별도로 구성한 Tailscale 또는 WireGuard 경로를 사용해 관리 기능을 유지할 수 있습니다. 다만 이는 독립적인 네트워크 경로로 사용해야 하며, ZimaClient 문제가 해결되었다는 증거로 보아서는 안 됩니다.
FAQ
ZimaClient를 재설치해도 왜 해결되지 않았나요?
재설치만으로는 계정/세션 또는 네트워크 조건이 변경되지 않을 수 있습니다. 검증된 소스 사례에서는 로그아웃한 뒤 다시 로그인하는 조치로 서비스가 복구되었습니다.
SMB는 작동하는데 ZimaClient는 왜 실패하나요?
LAN에서의 SMB와 ZimaClient의 원격/세션 연결은 서로 다른 계층입니다. 한쪽은 작동하면서 다른 쪽은 고장 날 수 있습니다.
ZimaClient Mac 로그는 어디에 있나요?
현재 공식 문서에는 ~/Library/Application Support/Zima/logs로 안내되어 있습니다.
ZimaOS 비밀번호를 재설정해야 하나요?
ZimaClient에 ‘연결 중’이라고 표시된다는 이유만으로 비밀번호를 재설정할 필요는 없습니다. 먼저 직접 로그인, 로그아웃/로그인, 네트워크 상태 및 로그를 확인하세요.
