안전한 업데이트·백업·롤백 가이드

새 창이 열린다는 것만으로 업데이트 성공은 아닙니다.기존 프로필, 로컬 규칙과 필요한 네트워크 작업이 계속 작동해야 하며, 문제가 생기면 복구할 경로가 있어야 합니다. 기준 상태 기록, 읽을 수 있는 스냅샷 보관, 맞는 빌드 설치, 핵심 작업 검증 순서로 진행하세요.

Windows, macOS, Linux 데스크톱을 위한 유지 관리 절차이며 임의의 버전 간 직접 다운그레이드를 보장하지 않습니다. 공식 출시 안내의 마이그레이션 지침이 우선합니다. 관리 대상 컴퓨터나 원격 호스트는 유지 관리 시간을 정하고 유일한 원격 연결에 의존한 채 시험하지 마세요.

1. 복구할 대상을 세 가지로 구분하세요

  • 프로그램과 실행 환경:설치 파일, 클라이언트와 코어 버전, 관련 런타임입니다. 이전 설치 파일만 보관하면 설정은 보존되지 않습니다.
  • 사용자 데이터:구독 기록, 로컬 프로필, 덮어쓰기 설정이나 스크립트, 사용자 규칙, 앱 환경설정입니다. 구독을 다시 받아도 로컬 변경이 복구된다는 보장은 없습니다.
  • 시스템 상태:시스템 프록시, TUN 또는 서비스 모드, DNS, 자동 시작, 권한입니다. 앱 내보내기 파일에 포함되지 않을 수 있습니다.

YAML 하나가 전체 복구 계획은 아닙니다. 실제 의존하는 작업을 나열하고 그에 필요한 데이터와 상태를 확인하세요. 사용하지 않던 기능을 업데이트 시험을 위해 켤 필요는 없습니다.

2. 업데이트 전 다섯 가지를 확인하세요

  1. 정상 작동 중인 클라이언트, 코어, 운영체제 버전과 CPU 아키텍처를 기록합니다.
  2. 설정 로딩, 예상 규칙 일치, 해당 앱의 접근 등 핵심 작업을 한 번 실행합니다.
  3. 대상 버전의 요구 사항, 알려진 문제, 마이그레이션 안내와 보안 수정을 읽습니다.
  4. 현재 설치 채널을 확인합니다. 패키지 관리자라면 업데이트, 이전 버전 보관, 다운그레이드 절차를 이해하고 여러 채널을 무작정 혼용하지 않습니다.
  5. 사용 가능한 백업과 신뢰할 수 있는 복구 설치 파일을 준비하고 중요한 업무에 지장이 없는 시간을 선택합니다.

Windows x64와 ARM64, macOS Apple Silicon과 Intel, Linux 패키지 형식과 프로세서 아키텍처를 구분하세요. 이름에 “64”가 있다는 것만으로 판단하면 안 됩니다. 현재 지원 요구 사항은 프로젝트 설치 문서와 이 사이트 다운로드 페이지를 확인하세요.

3. 실제로 읽을 수 있는 오프라인 스냅샷을 만드세요

현재 버전 설정이나 문서에서 실제 데이터 폴더를 확인합니다. 설정 폴더 열기 기능이 있으면 이용하세요. 다른 설치 방식의 고정 경로를 추측해 적용하거나 프로그램 설치 위치를 사용자 데이터 위치로 착각하지 마세요.

  1. 복구에 필요한 위치와 설정을 기록합니다. 내보내기 기능을 쓴다면 포함 범위를 확인합니다.
  2. 앱을 정상 종료하고 관련 설정 쓰기가 멈춘 뒤 별도의 날짜별 위치에 복사합니다. 무관한 시스템 서비스를 강제 종료하지 마세요.
  3. 사본의 중요한 파일을 열어 구조, 파일 목록, 사용자 규칙을 확인합니다. 압축 파일이나 암호화 컨테이너도 해제해 읽을 수 있는지 검증합니다.
  4. 버전 정보와 복구 설명을 함께 보관하되 구독 URL이나 비밀번호는 공개 메모에 적지 않습니다.

백업에는 노드 인증 정보, 구독 토큰, 컨트롤러 비밀값, 동기화 자격 증명이 들어 있을 수 있습니다. 접근을 제한하고 신뢰할 수 있는 암호화 저장소를 사용하세요. 공개 저장소, 게시판, 보호 상태가 확인되지 않은 클라우드에 올리지 마세요. 파일 이름이 보인다고 복원 가능성이 검증된 것은 아닙니다.

4. 보안 경고를 우회하지 말고 출처를 확인하세요

공식 출시 기록이나 신뢰할 수 있는 관리 채널에서 받아 게시자, 버전, 아키텍처, 형식과 크기를 대조합니다. 공식 체크섬이나 검증 가능한 서명이 제공되면 지침에 따라 확인하세요. 직접 계산한 해시만으로 파일 출처의 신뢰성이 증명되지는 않습니다.

Windows 런타임 문제는 프로젝트 FAQ를, macOS 보안 경고는 출처와 플랫폼 안내를 확인하세요. 시스템 보안 검사를 끄는 것을 설치 절차로 삼지 마세요. Linux 의존성은 배포판에 맞는 패키지 관리로 처리하고 출처 불명 “원클릭 복구” 스크립트는 실행하지 않습니다.

5. 설치 후 같은 검증 목록을 사용하세요

원본 백업을 유지하고 모든 구독 갱신이나 규칙 재작성을 동시에 하지 마세요. 이전 바로가기가 다른 설치를 실행한 것은 아닌지 실제 동작 버전을 확인합니다.

  1. 시작과 데이터:앱이 열리고 필요한 프로필과 덮어쓰기 설정이 있으며 지속적인 로딩·해석 오류가 없습니다.
  2. 규칙:직접 연결할 대상과 설정상 프록시를 사용할 대상을 각각 시험하고 실제 일치 기록을 확인합니다.
  3. 원래 앱:내장 지연 테스트뿐 아니라 업데이트 전 일상 작업을 반복합니다.
  4. 필요한 모드:기존에 쓰던 시스템 프록시, TUN, 서비스 기능의 권한과 로그를 확인합니다.
  5. 재시작과 재연결:앱을 닫고 다시 열어 시험하고 유지 관리 시간에 네트워크 재연결이나 절전 복귀도 확인합니다.
  6. 종료 후 상태:정상 종료 후 프록시 설정을 확인해 멈춘 리스너를 계속 가리키지 않도록 합니다.

단순히 “성공”이라고 쓰지 말고 항목별 결과를 남기세요. 브라우저, 필요한 앱, 재연결 시험을 통과한 뒤 새 버전을 안정 기준으로 삼습니다.

6. 롤백할지 먼저 진단할지 판단하세요

한 외부 서비스만 실패하면 다른 목적지와 네트워크 상태를 비교합니다. 업데이트 직후라는 시간 관계만으로 회귀를 증명할 수 없습니다. 같은 설정과 환경에서 시작 실패, 지속적인 설정 해석 오류, 핵심 기능 문제가 반복된다면 롤백을 평가할 근거가 더 강해집니다.

민감 정보를 가린 로그와 현재 데이터 사본을 먼저 보관하세요. 이전 버전에 알려진 보안 문제가 있다면 편의를 위해 오래 머물지 말고 수정 버전이나 문제를 피하는 지원되는 임시 작업 방식을 찾으세요.

7. 새 데이터와 이전 데이터를 섞지 말고 복원하세요

  1. 추가 변경을 멈추고 문제와 롤백 이유를 기록합니다.
  2. 정상 종료하고 업데이트 후 데이터도 보관해 새 작업이 사라지지 않도록 합니다.
  3. 출시 안내와 설치 채널의 다운그레이드 제한을 확인합니다. 이전 프로그램이 변환된 데이터를 읽을 수 있다고 가정하지 마세요.
  4. 신뢰할 수 있는 이전 설치 파일이나 해당 패키지 관리자 절차를 사용하고, 지원되는 복구 방식으로 맞는 업데이트 전 스냅샷을 복원합니다.
  5. 같은 검증 목록을 반복해 단순 실행이 아닌 실제 복구를 확인합니다.

이전 폴더와 새 폴더를 무작정 겹치거나 시도 전에 전체 데이터를 삭제하지 마세요. 업데이트 전 사본이 없다면 무손실 롤백은 보장할 수 없습니다. 모든 데이터를 보관하고 프로젝트 지원을 요청하며 필요하면 지원되는 분리 환경에서 최소 설정을 검증하세요.

8. 비밀 정보 없는 유지 관리 기록을 남기세요

시각과 시간대:
이전 / 대상 / 코어 버전:
운영체제 / 아키텍처 / 설치 채널:
백업 위치와 읽기 검증:
업데이트 전후 테스트 결과:
롤백 결정 / 이유 / 복구 결과:

가상 사례:구독은 계속 갱신되지만 로컬 규칙이 사라졌습니다. 구독을 다시 받는다고 규칙이 돌아온다는 보장은 없습니다. 이전 프로필, 덮어쓰기 파일, 내보내기 범위를 먼저 확인하세요. 찾기 쉬운 파일 하나가 아니라 실제 작업 환경을 백업해야 하는 이유입니다.

새 기준 상태가 중요한 작업을 통과할 때까지 읽기가 검증된 이전 스냅샷을 적어도 하나 유지하세요. 이후 실제 보관 필요와 개인정보 보호 기준에 따라 정리하며 공개된 설정 보관소로 만들지 마세요.

관련 가이드

참고 자료

참고 자료 확인일: 2026-10-14. 아래 링크는 프로젝트 및 플랫폼 문서이며, 이 글은 본 사이트가 독립적으로 작성한 가이드입니다.