왜 Clash·Mihomo 프로필에 Git인가
검색창에 Clash 프로필 백업이나 YAML 롤백을 치는 사람은 보통 두 가지 상황 가운데 하나입니다. 첫째는 스트리밍·업무·개발용으로 쓰던 규칙 순서를 바꿨다가 갑자기 특정 도메인만 빗나가 전체가 느려지거나 끊기기 시작한 경우이고, 둘째는 노트북 교체·OS 재설치 뒤에 구독·Proxy Group·rule-providers가 얽힌 구조를 하루 안에 그대로 복제하고 싶은 경우입니다. 클라이언트가 제공하는 「가져오기」만으로도 최소한은 살아나지만, 수개월에 걸쳐 손보던 분기 설계는 기억 속에만 남고 파일 한 장으로는 복원이 어렵습니다.
Git은 단순히 원격 백업 도구가 아니라 의미 있는 순간마다 스냅샷을 남기고, 나중에 「이 커밋으로 돌아가자」고 말할 수 있게 해 줍니다. Mihomo·Clash Meta처럼 기능이 빠르게 늘어나는 코어를 쓸수록 YAML에 필드가 늘고, 조용히 깨지는 호환 이슈도 있어 버전 관리가 곧 안전망이 됩니다.
저장소에 넣을 것, 쓰면 안 되는 것
실수 한 번으로 계정 전체가 털리는 가장 흔한 이유는 구독 URL에 포함된 토큰을 공개 GitHub 저장소에 그대로 올리는 경우입니다. URL 자체가 비밀키 역할을 하므로, 스크린샷·이슈 본문·친구에게 보낸 링크까지 같은 취급을 해야 합니다. 팀과 공유해야 한다면 비공개 저장소와 최소 권한이라는 전제 위에서도, 포크·권한 변경 실수를 상정하고 secrets.local.yaml처럼 절대 push하지 않는 파일 패턴을 먼저 잡는 편이 낫습니다.
반대로, 규칙 이름·Proxy Group 논리·GeoIP/rule-provider 이름·DNS 모드 선택처럼 공개돼도 위험이 적은 내용은 Git에 두는 이득이 큽니다. 즉 저장소에는 「구조와 정책」을, 기기마다 다른 「출구 자격증명」은 저장소 밖에 둔다고 생각하면 정리하기 쉽습니다.
디렉터리 레이아웃과 쪼개기
한 파일에 proxies·proxy-groups·rules·rule-providers·dns가 전부 들어 있는 모놀리식 구성도 작동에는 문제없지만, Git diff가 길어지고 충돌이 잦아집니다. 실무에서는 다음처럼 역할을 나눕니다.
- base.yaml:
port·mixed-port·dns·tun등 런타임 골격 - groups.yaml:
proxy-groups와 선택 정책 - rules.yaml 또는 provider 참조만 모은 파일:
rules상단의 좁은 예외와 RULE-SET 순서 - secrets.local.yaml(gitignore): 실제 구독 URL·API 키
코어가 ! include 문법을 지원하는지·GUI가 합쳐서 쓰는지에 따라 파일 개수는 조절하면 됩니다. 중요한 것은 「사람이 읽기 좋은 단위」와 「자동 생성 블록」을 분리해 커밋 메시지에 의미를 남길 수 있느냐입니다. 입문자는 커스텀 규칙 입문 글에서 쓰는 작은 규칙부터 같은 방식으로 커밋을 쌓아 보는 연습이 도움이 됩니다.
Git 초기화와 .gitignore
작업 폴더에서 git init 후, 클라이언트가 내려받은 캐시·대용량 rule-set 바이너리·런타임 로그는 저장소에서 제외하는 것이 좋습니다. 예시는 아래와 같습니다(필드 이름은 환경에 맞게 조정).
# .gitignore — tune paths for your client OS
*.log
.cache/
**/cache/
# Downloaded provider payloads (large / machine-specific)
rules/*.mrs
provider-cache/
# Local secrets — NEVER commit
secrets.local.yaml
.env
*.pem
# OS noise
.DS_Store
Thumbs.db
커밋 주기는 하루 단위보다 「동작이 확인된 작은 변경」마다가 롤백에 유리합니다. 메시지에 「DNS를 fake-ip로 전환」「PROXY-CDN 그룹에 노드 추가」처럼 검색 가능한 문장을 남기면 한 달 뒤의 나도 고마워합니다.
롤백: checkout, restore, tag
가장 단순한 시나리오는 「방금 저장한 버전이 문제다」일 때입니다. 아직 푸시하지 않았다면 git restore로 작업 트리를 마지막 커밋으로 되돌리거나, 특정 파일만 이전 커밋에서 꺼내면 됩니다. 이미 푸시한 히스토리를 깨끗이 유지하고 싶다면 revert 커밋을 만들어 되돌린 기록을 남기는 방식이 협업에 안전합니다.
「이번 주 초까지는 괜찮았다」처럼 시간 기준이 분명할 때는 annotated tag를 습관화하세요. 예를 들어 코어 메이저 업그레이드 직전에 before-mihomo-1.18 태그를 박아 두면, 문제가 생겼을 때 브랜치를 태그에서 분기해 비교 실험을 하기 쉽습니다. 대규모 규칙 재작성 전에는 별도 브랜치를 파서 메인은 항상 출근용으로 두는 전략도 흔합니다.
YAML을 되돌린 뒤에는 실제로 클라이언트가 읽는 경로에 반영했는지 확인하세요. GUI는 메모리에 올린 프로필과 디스크 파일이 어긋날 수 있으니, 저장·리로드·필요 시 재시작까지 한 세트로 검증하는 것이 좋습니다.
새 PC·재설치: 복제 체크리스트
멀티 기기를 맞출 때 목표는 파일 복사 한 번이 아니라 재현 가능한 절차서를 만드는 것입니다. 순서는 대략 다음과 같습니다.
-
저장소 복제
새 OS에 Git과 에디터를 설치한 뒤git clone으로 동일한 폴더 구조를 가져옵니다. -
시크릿 이전
구독 URL·로컬 인증서·기업 프록시 자격 증명은 암호화된 채널(예: 비밀번호 관리자·자체 NAS)로만 옮기고, 텍스트 메신저에 붙여 넣지 않습니다. -
클라이언트 경로 정렬
Clash Verge·OpenClash·데스크톱 앱마다 프로필 디렉터리가 다릅니다. 심볼릭 링크로 Git 작업 트리를 가리키거나, 배포 스크립트로 복사하는 방식 중 하나를 정해 두면 이후 drift가 줄어듭니다. -
규칙 갱신·캐시 워밍
첫 실행 후 rule-provider와 GeoIP가 다시 받아지는 시간을 감안하고, DNS 모드가 이전과 같게 적용됐는지 로그에서 확인합니다.
클라우드 드라이브로 설정 폴더 통째로 동기화하는 방법도 있지만, 두 기기가 동시에 켜져 쓰기 충돌이 나면 조용히 YAML이 섞이기 쉽습니다. Git이 출처(SoT)이고 드라이브는 부수 백업이라는 역할 분담이 덜 아픕니다.
Mihomo·Clash Meta 전용 주의점
같은 키워드라도 코어 버전에 따라 동작이 달라지는 영역이 있습니다. 예를 들어 rule-set 계열·일부 DNS 옵션·스니핑 관련 필드는 문서를 버전에 묶어 읽어야 합니다. 저장소 루트에 ENGINE.md처럼 짧은 메모를 두고 「현재 목표 버전, 업그레이드 시 확인한 릴리스 노트 링크」를 적어 두면 팀·미래의 나 모두에게 도움이 됩니다.
TUN 모드를 켠 상태에서 방화벽·라우팅 테이블이 OS마다 다르니, Git에는 의도한 분기 논리만 넣고 로컬 튜닝 값은 필요 시 host-specific.yaml로 분리하는 패턴도 현실적입니다.
자주 묻는 질문
구독 URL은 어디까지가 비밀인가요?
대부분의 상용 패널은 URL 경로에 긴 토큰을 넣습니다. 이 링크만 알면 다른 사람이 같은 출구를 쓸 수 있으므로 비밀번호와 동일한 관리가 맞습니다.
GUI가 내 편집을 되돌리는 것 같습니다.
동기화 순서를 정하세요. 「GUI가 마스터」냐 「Git 트리가 마스터」냐에 따라 워크플로가 갈립니다. 한쪽만 고치면 반대쪽이 덮어쓰는 루프에 빠지기 쉽습니다.
실험 규칙은 브랜치로 관리해야 하나요?
필수는 아니지만, 메인 브랜치를 출근용으로 고정하고 실험은 짧은 브랜치에서 하면 심리적 부담이 줄어듭니다. 머지 전에 clash 로그로 rule hit를 확인하는 습관과 맞물립니다.
정리: 일회성 백업을 넘어서
많은 원클릭 VPN·단순 프록시 앱은 「연결만 되면 된다」는 경험에 맞추어 있어, 도메인 단위 분기와 규칙 세트·프로바이더를 장기간 추적하기 어렵게 만듭니다. 반대로 설정을 아예 파일로 주지 않는 모델은 어디선가 바뀐 뒤 예전 상태로 되돌리기가 힘듭니다.
Clash·Mihomo 계열은 YAML 한 언어로 데스크톱 GUI·라우터·CLI를 가로지르는 장점이 있고, Git과 결합하면 그 유연성이 재현 가능한 운영으로 이어집니다. 규칙이 길어질수록 백업 한 장보다 커밋 히스토리가 진짜 보험에 가깝습니다.
클라이언트 바이너리 출처를 한곳으로 모은 뒤 오늘 정리한 폴더 구조에 맞춰 프로필을 붙이고 싶다면 클라이언트 다운로드 페이지에서 현재 플랫폼 빌드를 확인하시길 권합니다.