rule-providers로 규칙을 분리해야 하는 이유
Clash 설정에서 rules를 계속 길게 늘리다 보면 서비스별 규칙이 한 파일에 뒤섞이고, 구독 프로필을 다시 가져올 때 직접 추가한 줄이 사라지는 일이 생깁니다. rule-providers는 규칙 목록을 별도 파일로 분리해 Clash가 불러오도록 하는 기능입니다. 메인 프로필에는 어떤 규칙 묶음을 어느 프록시 그룹으로 보낼지만 남기고, 실제 도메인 목록은 GitHub 저장소에서 관리할 수 있습니다.
이 방식은 개인 규칙을 다른 기기에서 재사용하거나, 목록 변경 이력을 살펴보거나, 실수로 추가한 항목을 이전 상태로 되돌릴 때 특히 유용합니다. 예를 들어 업무 사이트, 개발 도구, 개인적으로 직접 연결할 도메인을 각각 파일로 관리하면 한 파일의 변경이 다른 규칙 묶음에 영향을 주는 일을 줄일 수 있습니다. 여러 사람이 함께 관리할 때도 GitHub의 변경 기록과 검토 절차를 활용하면 누가 무엇을 바꾸었는지 확인하기 쉽습니다.
다만 rule-provider는 규칙을 담는 파일을 자동으로 안전하게 검증해 주는 기능은 아닙니다. 파일 안의 규칙 내용뿐 아니라 behavior 값, 파일 형식, URL, 메인 프로필의 참조 이름이 서로 맞아야 합니다. 또한 규칙 엔진은 일반적으로 위에서부터 검사해 처음 일치한 규칙을 적용하므로, provider에 규칙을 분리했다고 해서 기존 규칙과의 우선순위 문제가 자동으로 해결되지는 않습니다.
GitHub에 규칙 파일을 두고 프로필에 연결하기
먼저 공개 GitHub 저장소에 규칙 파일을 만들고, Clash 프로필에서 접근할 수 있는 원본 파일 URL을 사용합니다. 브라우저에서 파일을 열었을 때 GitHub의 코드 보기 페이지가 아니라 파일 내용만 반환하는 주소인지 확인하세요. 아래 예시는 구조를 설명하기 위한 것으로, 저장소 소유자와 저장소 이름은 본인의 값으로 바꿔야 합니다. 프로필의 프록시 그룹 이름도 실제 설정과 정확히 일치해야 합니다.
rule-providers:
work-sites:
type: http
behavior: domain
format: yaml
path: ./rules/work-sites.yaml
url: https://raw.githubusercontent.com/OWNER/REPO/main/rules/work-sites.yaml
interval: 86400
rules:
- RULE-SET,work-sites,PROXY
- MATCH,DIRECT
rule-providers 아래의 work-sites는 provider의 식별자입니다. 메인 규칙에서 같은 이름을 RULE-SET으로 참조해야 하며, PROXY 자리에는 실제 프로필에 선언된 프록시 그룹 이름을 적습니다. path는 내려받은 파일을 로컬에서 보관할 위치이고, interval은 업데이트를 확인하는 간격을 초 단위로 지정합니다. 하루에 한 번 확인하려면 예시처럼 86400을 사용할 수 있습니다.
위 설정의 behavior: domain과 format: yaml에 맞춰 provider 파일은 다음처럼 작성합니다. 이 형식에서는 payload 아래에 도메인 규칙을 나열합니다.
payload:
- DOMAIN-SUFFIX,example.com
- DOMAIN,api.example.net
- DOMAIN-SUFFIX,developer.example.org
behavior는 규칙 목록의 성격에 맞게 선택해야 합니다. 도메인 패턴 중심이면 domain, 도메인·IP·키워드 등 서로 다른 규칙 유형을 함께 담으려면 classical, IP 대역 중심이면 ipcidr가 알맞습니다. classical provider는 대체로 payload 안에 DOMAIN-SUFFIX,example.com처럼 일반 규칙 줄을 넣습니다. 형식과 내용이 어긋나면 URL 접속은 성공해도 규칙 파일을 읽지 못할 수 있으므로, 처음에는 한 가지 유형으로 작게 시작하는 편이 좋습니다.
규칙 우선순위와 GitHub 변경 관리
RULE-SET은 메인 프로필의 rules 목록에서 하나의 규칙 줄처럼 동작합니다. 같은 도메인을 처리하는 개별 규칙이나 다른 provider가 앞에 있으면, 뒤쪽에 추가한 사용자 provider까지 도달하지 않을 수 있습니다. 예를 들어 더 넓은 범위의 규칙 세트가 먼저 일치한다면, 예외 도메인이나 더 구체적인 사용자 규칙을 그보다 위에 놓아야 합니다. 반대로 마지막의 MATCH는 나머지 트래픽을 모두 처리하므로 보통 규칙 목록의 끝에 둡니다.
- 서비스별로 파일을 나누기: 업무, 개발, 직접 연결 예외처럼 목적이 다른 규칙을 분리하면 변경 범위를 파악하기 쉽습니다. 너무 잘게 쪼개면 메인 프로필에 provider 참조가 과도하게 늘 수 있으므로, 함께 검토하고 배포할 항목끼리 묶는 것이 실용적입니다.
- 작은 변경을 커밋하기: 한 번에 많은 도메인을 추가하기보다 변경 이유와 함께 몇 줄씩 올리면 잘못된 패턴을 찾고 되돌리기 쉽습니다. GitHub의 커밋 기록은 규칙이 바뀐 시점과 변경 내용을 비교하는 데 도움이 됩니다.
- 기본 브랜치와 파일 경로 확인하기: URL의 브랜치 이름과 저장소 안의 디렉터리, 파일 이름은 실제 GitHub 경로와 일치해야 합니다. 대소문자나 확장자가 다르면 파일을 찾지 못할 수 있습니다.
- 민감한 정보는 올리지 않기: 규칙 파일에는 도메인 패턴만 관리하고 토큰, 계정 정보, 사내 전용 주소처럼 공개해서는 안 되는 자료를 넣지 않습니다. 공개 저장소의 raw URL은 누구나 읽을 수 있다고 가정해야 합니다.
main 브랜치의 raw 파일 주소를 사용하면 그 브랜치에 새 커밋이 올라왔을 때 이후 업데이트 확인에서 변경된 규칙을 가져올 수 있습니다. 반면 재현성을 우선한다면 검토가 끝난 커밋을 기준으로 URL을 고정하는 방법도 있습니다. 이 경우 변경 내용이 자동으로 따라오지 않으므로, 새 규칙을 배포할 때 프로필의 주소도 갱신해야 합니다. 자동 업데이트의 편리함과 특정 시점의 내용 고정 중 어떤 쪽이 필요한지에 따라 선택하세요.
규칙을 바꾼 뒤에는 저장소의 파일 내용만 확인하고 끝내지 말고, 사용 중인 클라이언트의 활성 프로필과 코어 로그도 확인해야 합니다. Clash Verge나 Clash Verge Rev처럼 화면을 제공하는 클라이언트에서는 편집한 프로필이 실제로 활성 상태인지, 설정 변경이 코어에 반영됐는지 점검합니다. 설정을 다시 불러온 뒤 해당 도메인에 접속해 로그에서 매칭된 규칙과 최종 프록시 그룹을 확인하면, 파일 로드 문제와 우선순위 문제를 구분하기 쉽습니다.
로드 오류와 업데이트 문제 점검하기
provider가 동작하지 않을 때는 오류 문구를 보기 전에 원인을 층별로 나누면 시간을 절약할 수 있습니다. 우선 원본 URL을 브라우저에서 열어 실제 규칙 파일 내용이 반환되는지 확인합니다. GitHub 저장소의 파일 보기 페이지, 오타가 있는 경로, 이름이 바뀐 브랜치를 URL에 넣으면 기대한 형식으로 파일을 가져오지 못합니다. 다음으로 URL의 프로토콜이 HTTPS인지, 저장소가 공개되어 있는지, 현재 네트워크에서 GitHub에 연결할 수 있는지 확인합니다.
- 규칙 파일을 읽지 못함: provider의
behavior와format이 파일 구조와 맞는지 살펴봅니다. YAML 형식에서는 들여쓰기를 일정하게 유지하고,payload키가 올바른 위치에 있는지 확인합니다. - provider를 찾지 못함: 메인 프로필의 provider 이름과
RULE-SET에 적은 이름이 철자와 대소문자까지 일치하는지 확인합니다. provider 정의를 활성 설정의 최상위rule-providers아래에 두었는지도 점검합니다. - 업데이트가 반영되지 않음: 클라이언트가 실제로 사용하는 프로필, 업데이트 간격, 코어 로그의 다운로드 결과를 확인합니다. 업데이트가 실패해도 로컬에 남은 이전 파일로 계속 동작할 수 있으므로, 연결이 된다는 사실만으로 최신 규칙을 쓰고 있다고 단정하지 마세요.
- 규칙은 로드되지만 원하는 그룹을 타지 않음:
rules목록에서 더 앞선 규칙이 먼저 일치하는지 확인합니다. 테스트할 도메인이 provider 안의 패턴과 실제 요청 호스트에 맞는지도 로그와 함께 비교합니다.
GitHub에 새 커밋을 올린 직후에도 업데이트 확인 간격이나 클라이언트의 새로고침 동작에 따라 반영 시점이 달라질 수 있습니다. 장애가 급하다면 먼저 변경 파일의 URL과 원문을 확인하고, 클라이언트에서 provider 또는 프로필을 새로 고친 뒤 로그를 다시 살펴보세요. 다만 제공자 업데이트 버튼의 위치와 동작은 클라이언트 버전에 따라 다를 수 있으므로, 버튼을 찾기 어렵다면 코어 로그와 활성 설정을 기준으로 확인하는 편이 정확합니다. 변경 전후 파일을 비교할 수 있도록 GitHub 커밋 기록을 남겨 두면, 문제가 생겼을 때 마지막 정상 버전으로 되돌리기도 수월합니다.
유지보수하기 쉬운 분기 구성 만들기
처음부터 대형 규칙 저장소를 만들기보다는 자주 바뀌는 개인 규칙 한 묶음으로 시작하세요. 파일 이름과 provider 이름을 알아보기 쉽게 정하고, 각 규칙이 어떤 트래픽을 위한 것인지 커밋 메시지나 저장소 설명에 남깁니다. 규칙을 추가할 때는 도메인 전체를 넓게 잡기보다 실제 요청에서 확인한 호스트를 기준으로 범위를 정하는 것이 안전합니다. 특히 광범위한 키워드 규칙은 관련 없는 사이트까지 같은 그룹으로 보내 체감 속도와 접속 경로를 바꿀 수 있습니다.
또한 provider 파일의 변경과 메인 프로필의 참조 변경을 한 번에 적용할 수 있는지 생각해 두세요. 파일 이름만 바꾸고 URL을 갱신하지 않으면 이전 파일을 계속 읽거나 새 파일을 찾지 못할 수 있습니다. 변경을 반영한 뒤에는 실제로 자주 쓰는 도메인과 예외 도메인을 각각 시험하고, 로그에 표시된 매칭 규칙이 예상한 이름인지 확인합니다. 규칙이 잘 작동하면 그 상태를 커밋이나 백업으로 남겨 두어 다음 업데이트와 비교할 기준으로 삼을 수 있습니다.
단순한 로컬 목록 편집기는 빠르게 한두 줄을 추가하기에는 편하지만, 기기 간 동기화나 변경 이력 검토가 약할 수 있습니다. 반대로 복잡한 관리 플랫폼은 검토·배포 기능이 풍부해도 개인 설정에는 운영 부담이 커질 수 있습니다. GitHub의 파일 이력과 Mihomo 호환 Clash 규칙 엔진을 조합하면 별도 시스템을 크게 늘리지 않고도 규칙을 분리하고 변경을 추적할 수 있습니다. 사용자 규칙을 재사용 가능한 형태로 정리하려면 다운로드 페이지에서 클라이언트를 확인하세요 →