설치, 업데이트 및 이전
설치 파일은 클라이언트가 기기에서 실행되는지에 영향을 줍니다. 구독 업데이트나 개별 노드 연결은 설정과 네트워크에 따라 달라집니다. 두 문제는 증상이 다릅니다. 앱이 실행되는지 먼저 확인한 다음 설정을 가져오면 설치 문제를 노드 장애로 오인하지 않을 수 있습니다.
다운로드 후 파일 형식 확인
Windows 다운로드 파일은 설치 프로그램이 들어 있는 압축 파일입니다. 압축 파일 미리보기에서 내부 파일을 바로 실행하지 마세요. macOS는 디스크 이미지로 제공되며 앱을 복사한 뒤 이미지를 꺼낼 수 있습니다. Android APK는 시스템 설치 프로그램으로 여세요. Linux DEB와 RPM은 일반적으로 해당 배포판의 도구로 설치해야 하며, 한 형식을 다른 형식으로 임의 변환해 설치하는 것은 권장하지 않습니다.
브라우저에 다운로드가 완료되지 않았다고 표시되면 저장 공간, 네트워크, 다운로드 기록을 먼저 확인하세요. 다운로드가 끝나지 않은 임시 파일의 확장자를 설치 파일 형식으로 바꾸지 마세요. 시스템 설치 화면이 열렸지만 진행할 수 없다면 오류 메시지에 아키텍처, 운영체제 버전, 종속성 또는 권한이 언급되어 있는지 확인하세요. 안내 문구를 전부 기록해 두면 ‘설치가 안 됨’만 적어 두는 것보다 문제를 찾기 쉽습니다.
복구할 수 있도록 업데이트 전 설정 백업
먼저 기존 설치를 덮어써 업데이트할지, 다른 버전으로 바꿀지 구분하세요. 덮어쓰기 업데이트는 가능한 한 기존 설치 경로와 앱 식별자를 유지해야 합니다. 다른 배포 패키지나 클라이언트, 기기로 바꿀 때는 데이터 디렉터리를 그대로 공유할 수 있다고 가정하지 마세요. 클라이언트에서 내보내기를 지원하면 다시 가져올 수 있는 설정을 우선 보관하고, 사용자 지정 규칙, 프록시 모드, 복원해야 할 앱 예외도 별도로 기록하세요.
백업을 저장한 뒤 기기에서 파일이 정상적으로 열리는지 확인하고, 어떤 클라이언트와 기기에서 만든 백업인지 기록하세요. 구독 주소에는 접속 정보가 포함될 수 있고, 설정 백업에도 노드 정보가 들어 있을 수 있습니다. 백업 파일 전체를 온라인 변환기에 올리거나 원문 그대로 공개 게시판에 붙여 넣지 마세요. 도움을 요청할 때는 운영체제 버전, 클라이언트 이름, 민감 정보를 지운 오류 메시지를 우선 제공하세요.
처음 실행할 때 연결 경로 하나부터 확인
앱이 정상적으로 실행되면 구독 가져오기 안내를 따라 사용 권한이 있는 설정을 추가하세요. 노드 하나를 선택하고 프록시 설정을 따르는 것이 확실한 앱으로 연결을 확인하세요. 라우팅, 이름 해석 방식, 프록시 모드를 한꺼번에 바꾸면 문제가 해결되더라도 어떤 설정이 효과가 있었는지 파악하기 어렵습니다.
데스크톱 클라이언트를 종료하기 전에 클라이언트가 설정한 로컬 프록시 주소가 남아 있는지 확인하세요. 백그라운드 프로세스는 종료됐는데 시스템이 여전히 로컬 포트를 가리키면 브라우저에서 웹페이지가 열리지 않을 수 있습니다. Android에서는 현재 활성화된 VPN 서비스를 먼저 확인하세요. 휴대폰에 클라이언트 두 개를 설치했더라도 두 개를 동시에 켤 필요는 없습니다.
관리되는 기기라면 먼저 권한 확인
회사 컴퓨터, 학교 기기, 업무 프로필이 있는 휴대폰은 소프트웨어 출처, 설치 권한, 시스템 프록시 변경이 제한될 수 있습니다. 이런 제한이 있으면 기기 관리자에게 설치가 허용되는지와 사용해야 할 배포 경로를 먼저 문의하세요. 정책 제한을 패키지 손상으로 오인하지 마세요. 업무 프로필의 앱만 연결되지 않는다면 개인 프로필에서 같은 앱을 비교해 기기 정책 문제인지 노드 설정 문제인지 구분할 수 있습니다.