OpenClash 설정은 어떻게 백업하나요? 다운로드와 내용 확인

사용 중인 YAML만 저장하면 충분할까요?

플러그인을 업데이트하거나 규칙을 수정하기 전, 또는 원래 설정을 잃어버릴까 걱정될 때 가장 먼저 현재 YAML을 내려받으려 할 수 있습니다. 하지만 YAML은 설정의 일부일 뿐입니다. 구독 갱신 설정, 플러그인 옵션, 사용자 지정 파일이 모두 그 파일 하나에 들어 있는 것은 아닙니다. 현재 OpenClash 설정 자료를 보관하려면 다운로드하는 대상이 단일 설정 파일인지, 플러그인에서 제공하는 전체 백업인지 먼저 구분해야 합니다.

이 글은 OpenClash v0.47.156의 공식 소스 코드와 릴리스 설명을 확인해 작성했습니다. 절차는 중국어 간체 LuCI 화면을 기준으로 하며 영어 라벨을 함께 표기합니다. 한국어 화면의 실제 번역을 검증한 절차는 아닙니다. OpenClash는 현재도 유지보수되는 OpenWrt 플러그인으로, Windows용 Clash Verge Rev나 Clash for Windows와는 다른 제품입니다. 공유기 관리 화면에 정상적으로 로그인할 수 있고 해당 버전의 플러그인을 열 수 있다는 전제에서 시작합니다. 펌웨어나 코어를 설치하지 않으며, 모든 OpenWrt 파생 펌웨어의 화면 구성이 같다고 보장하지 않습니다.

다운로드할 때 CPU 아키텍처를 선택할 필요는 없지만, 백업에 원래 장치의 아키텍처에 종속된 코어가 포함될 수 있습니다. 공유기 모델, 펌웨어 버전, CPU 아키텍처, OpenClash 버전을 기록하고 다른 장치에도 쓸 수 있는 범용 설치 패키지처럼 취급하지 마세요. 아래 절차는 다운로드와 컴퓨터에서의 확인까지만 진행하며, 업로드 복원은 실행하지 않습니다.

「配置管理」에서 「备份」 누르기

편집 중인 설정을 저장하고 구독 갱신이나 다른 변경 작업이 끝난 다음 백업을 시작하세요. 백업은 당시 디스크에 저장된 파일을 읽습니다. 편집창의 미저장 내용은 대상이 아니며, 모든 파일을 정확히 같은 시점의 상태로 저장하는 시스템 스냅샷도 아닙니다. 다운로드 중에는 플러그인을 업데이트하거나 설정을 덮어쓰지 마세요.

1. 자신의 공유기 LuCI에 로그인한 뒤 중국어 화면의 「服务 → OpenClash」에서 「配置管理」(Config Manage)를 엽니다.
2. 파일 작업 영역에서 「备份」(Backup) 버튼을 찾습니다. 로컬 파일을 선택하거나 「上传文件类型」(업로드 파일 유형)을 바꿀 필요는 없습니다.
3. 「备份」를 한 번 누르고 브라우저의 다운로드가 완료될 때까지 기다립니다. 저장 위치는 브라우저 설정에 따라 결정됩니다. 버튼을 다시 누를 수 있게 되었다는 이유만으로 파일 다운로드가 끝났다고 판단하지 마세요.
4. 컴퓨터에 내려받은 파일의 확장자가 .tar.gz인지 확인하고 원본을 보관합니다. 저장 위치를 묻는다면 외부에 공개 공유하지 않는 폴더를 선택하세요.

정상 응답의 파일명은 Backup-OpenClash-로 시작하며, 뒤에 장치 이름, 시스템이 보고한 아키텍처, 시간이 붙고 .tar.gz로 끝납니다. 이 시간은 공유기 시계를 기준으로 합니다. 프런트엔드가 응답에서 파일명을 가져오지 못하면 Backup-OpenClash.tar.gz가 사용될 수도 있습니다. 파일명은 정리에 도움이 되지만, 그것만으로 생성 시간이 정확하거나 내용이 완전하다고 판단할 수는 없습니다.

전체 백업에는 무엇이 들어 있나요?

이 버전의 전체 백업은 /etc/config/openclash를 /etc/openclash/openclash로 복사한 다음, 당시 /etc/openclash/의 내용을 아카이브로 만드는 방식입니다. 출력을 마치면 이 임시 복사본을 삭제합니다. 압축 파일 안의 경로는 보통 전체 /etc/openclash/가 아니라 ./로 시작합니다.

표는 확인할 범위를 안내하며, 모든 장치에 똑같이 있어야 하는 필수 폴더 구조를 뜻하지 않습니다. 사용 방식에 따라 남아 있는 내용이 다릅니다. 또한 이 작업으로 공유기 펌웨어 전체나 다른 플러그인의 설정, OpenWrt의 /etc/config/network, /etc/config/firewall 같은 시스템 설정까지 백업되는 것은 아닙니다. OpenWrt 시스템 백업을 대체할 수 없습니다.

컴퓨터에서 확인하고, 시험 삼아 복원하지 않기

신뢰할 수 있는 로컬 아카이브 열람 도구로 방금 내려받은 파일을 엽니다. 먼저 내용 목록만 확인하고, 안에 있는 프로그램은 실행하지 마세요. 도구에 따라 바깥쪽 gzip을 먼저 표시한 뒤 내부 tar를 여는 경우도 있으며, 그 자체로 오류는 아닙니다. ./openclash와 보관하려던 ./config/의 파일을 확인하고, 읽기 실패나 예상치 못한 파일 끝, 손상 경고가 있는지 살펴봅니다.

• YAML 하나만 있는 경우: 보통 이 글에서 말하는 전체 플러그인 백업이 아닙니다. 「配置管理」로 돌아가 「备份」 버튼을 사용했는지 확인하세요. 확장자만 .tar.gz로 바꿔서는 안 됩니다.
• 웹페이지나 로그인 내용이 다운로드된 경우: LuCI 로그인 상태와 관리 주소를 다시 확인한 뒤 내려받으세요. 로그인 만료로 반환된 페이지는 백업으로 사용할 수 없습니다.
• 아카이브가 손상되었거나 필요한 파일이 없는 경우: 이전에 읽을 수 있었던 사본을 보관하고 유일한 백업을 덮어쓰지 마세요. 진행 중인 설정 변경이 끝난 다음 다시 내려받고, 여전히 이상하다면 후속 업데이트나 복원을 중단하세요.
• 다른 사람의 파일과 크기가 다른 경우: 코어, 규칙 집합, 장치의 저장 방식에 따라 크기가 달라집니다. 공통으로 적용할 수 있는 '정상 MB 크기'는 없으며, 크기가 그럴듯해도 복원 가능성을 증명하지는 못합니다.

내용 목록이 열린다는 것은 첫 번째 확인 단계에 불과합니다. YAML 문법이 맞다거나 구독이 유효하고 노드에 연결할 수 있다거나 복원이 성공했다는 의미는 아닙니다. v0.47.156은 백업 데이터를 파이프로 출력하며, 먼저 /tmp에 압축 파일 전체를 만드는 방식은 아닙니다. 다만 플러그인 설정을 임시로 복사합니다. 따라서 디스크에 전혀 쓰지 않는다거나, 메모리를 사용하지 않는다거나, 공간이 부족해도 문제가 없다는 뜻은 아닙니다.

변경 전 상태를 참고할 수 있도록 안전하게 보관하기

백업과 함께 장치 모델, 펌웨어 및 플러그인 버전, 아키텍처, 저장 날짜, 당시 저용량 플래시 모드 사용 여부를 간단히 기록하세요. 수정하지 않은 원본을 자신이 관리하는 비공개 저장소에 보관하고, 재설치할 공유기에만 남겨 두지 마세요. 새 파일의 확인이 끝나기 전에는 이전의 사용 가능한 사본을 덮어쓰지 않는 것이 좋습니다.

나중에 복원해야 한다면 그 시점의 현재 설정도 따로 저장하고, 장치·아키텍처·버전 차이를 확인하세요. 해당 플러그인을 다시 설치하거나 정상 작동이 확인된 설정을 가져올 방법도 준비해야 합니다. 공식 업로드 복원은 플러그인 파일과 설정을 다시 쓰는 작업입니다. 읽기 전용 미리보기가 아니며, 모든 예전 파일을 바이트 단위로 되돌리는 시스템 롤백을 보장하지도 않습니다. 이 글은 다른 장치나 버전에 바로 덮어쓰는 절차를 제공하지 않습니다.

여기까지의 목표는 출처가 분명하고, 내용을 읽을 수 있으며, 포함 범위를 파악한 백업을 손에 남기는 것입니다. 다운로드와 확인만 하려면 프록시 모드를 바꾸거나 코어를 업데이트하거나 파일을 업로드할 필요가 없습니다. 백업이 존재한다는 것을 증명하려고 사용 중인 공유기에 즉시 덮어쓰기 복원을 할 필요도 없습니다.

공식 자료와 버전 범위

• OpenClash v0.47.156 공식 릴리스 안내
• 고정 소스: 백업 버튼과 브라우저 다운로드
• 고정 소스: 백업 범위와 파일 이름
• 고정 소스: 중국어 간체 화면 문구
• 고정 소스: 소용량 플래시 모드의 경로와 심볼릭 링크
• 고정 소스: 복원 시 파일과 설정 기록