ClashX 구독 링크 추가부터 Mac 프록시 노드 갱신까지 설정하기
구독 링크와 ClashX 설정 파일의 관계부터 확인하기
ClashX에서 구독 링크를 등록하기 전에 제공업체가 어떤 형식의 데이터를 반환하는지 확인하세요. 구독 링크는 단순히 노드 주소 하나를 가리키는 것이 아니라, 서버가 Clash 호환 설정이나 프록시 노드 목록을 내려주는 주소입니다. 링크에 접속했을 때 전체 설정이 반환되는지, 노드 정보만 제공되는지에 따라 가져온 뒤 필요한 작업이 달라집니다.
전체 설정에는 보통 프록시 노드뿐 아니라 정책 그룹과 라우팅 규칙이 함께 포함됩니다. 반면 노드 목록만 있는 구독은 사용할 노드는 가져오더라도 규칙이나 그룹이 충분하지 않을 수 있습니다. 제공업체가 ClashX용 구독 주소와 다른 클라이언트용 주소를 따로 제공한다면, 변환 옵션이나 출력 형식을 확인해 Clash 호환 형식을 선택하세요. 일반 브라우저에서 링크를 열었을 때 로그인 페이지나 오류 문구가 표시된다면 링크가 만료되었거나 인증이 필요한 상태일 수 있습니다.
또한 ClashX라는 이름이 붙은 앱이라도 배포판과 버전에 따라 메뉴 구성, 코어와 구독 관리 기능이 다를 수 있습니다. 아래 단계의 메뉴 이름은 버전에 따라 약간 다를 수 있으므로, 화면에 “Remote Config”, “원격 설정”, “구성 관리”처럼 표시되는 항목을 기준으로 찾으세요. 메뉴 자체가 없다면 앱이 원격 설정 가져오기를 지원하지 않는 버전일 수 있습니다.
Mac용 ClashX에 구독 링크 등록하기
등록 전에 제공업체 계정 페이지에서 최신 구독 주소를 복사하세요. 주소를 직접 입력하는 것보다 복사·붙여넣기를 사용하는 편이 안전합니다. URL에는 계정 식별 토큰이 포함되는 경우가 있어 문자 하나가 빠지거나 공백이 추가되어도 서버가 설정을 반환하지 않을 수 있습니다.
- ClashX를 실행합니다. 메뉴 막대의 ClashX 아이콘을 눌러 앱이 실행 중인지 확인합니다. 아이콘이 보이지 않으면 응용 프로그램 폴더에서 앱을 실행하고, macOS가 네트워크 설정 변경을 요청하면 앱과 출처를 확인한 뒤 필요한 권한만 허용합니다.
- 원격 설정 관리 화면을 엽니다. 메뉴에서 Config 또는 구성 항목을 열고 Remote Config, 원격 설정, 구성 관리와 비슷한 이름의 메뉴를 찾습니다. 메뉴 이름은 배포판과 버전에 따라 달라질 수 있습니다.
- 새 구성을 추가합니다. 추가 또는 플러스 버튼을 선택하고 제공업체에서 복사한 구독 URL을 입력합니다. 화면에서 이름을 지정할 수 있다면 “개인 구독”처럼 알아보기 쉬운 이름을 사용하세요. 이름은 로컬에서 표시하는 라벨이며 서버의 구독 주소를 바꾸지는 않습니다.
- 설정을 가져오고 활성화합니다. 저장 또는 업데이트를 눌러 서버에서 데이터를 받아온 다음, 목록에 나타난 구성을 선택해 현재 설정으로 적용합니다. 일부 버전은 등록과 적용을 별도 단계로 처리합니다. 목록에 추가된 것만 확인하고 끝내지 말고 활성 설정 표시도 확인하세요.
- 노드와 정책 그룹을 확인합니다. 프록시 또는 노드 목록에 서버 이름이 표시되는지 보고, 정책 그룹에서 실제 노드를 선택할 수 있는지 확인합니다. 연결이 필요하다면 ClashX의 시스템 프록시 메뉴를 켠 뒤 브라우저에서 접속을 테스트합니다.
처음 업데이트할 때 오류가 나면 URL을 다시 입력하기 전에 네트워크 연결, 계정 상태와 제공업체의 사용량 제한을 확인하세요. 업데이트가 성공했는데 노드가 보이지 않는 경우에는 해당 구성이 활성화되었는지, 가져온 형식이 현재 ClashX 코어에서 읽을 수 있는 형식인지 살펴보세요. 구성을 여러 개 등록했다면 다른 프로필을 보고 있는지도 확인해야 합니다.
구독 URL
↓
서버에서 설정 또는 노드 목록 가져오기
↓
ClashX에서 구성 활성화
↓
정책 그룹에서 노드 선택
↓
시스템 프록시로 Mac 앱의 트래픽 전달
구독 설정과 프록시 노드를 갱신하는 순서
서버 목록이 오래되었거나 새 노드가 추가되었다면 먼저 구독 설정을 업데이트하세요. 메뉴 막대의 ClashX 아이콘에서 현재 원격 구성의 Update, 업데이트 또는 새로고침 명령을 선택합니다. 업데이트가 끝나면 성공 여부를 알리는 표시나 오류 메시지를 확인하고, 노드 목록에 새 항목이 나타났는지 살펴봅니다. 앱 버전에 따라 구독 업데이트 명령이 구성 메뉴 안에 있거나 현재 선택한 구성의 하위 메뉴에 있을 수 있습니다.
그다음 프록시 그룹을 열어 사용할 노드를 선택하세요. 구독이 갱신되어도 현재 선택된 정책 그룹이 자동으로 새 노드로 바뀌지 않을 수 있습니다. 노드 목록을 갱신한 뒤에도 이전에 선택했던 노드가 유지되는 것은 일반적인 동작입니다. 연결 테스트가 필요한 경우 노드의 지연 시간 측정 기능을 사용하고, 측정 결과와 실제 웹 접속 여부를 각각 확인하세요. 지연 시간 숫자가 표시된다는 사실만으로 모든 목적지에 연결할 수 있다는 뜻은 아닙니다.
| 작업 | 갱신되는 항목 | 확인할 화면 |
|---|---|---|
| 구독 업데이트 | 서버에서 내려받는 설정, 노드 목록, 규칙 정보 | 원격 구성의 업데이트 결과와 활성 설정 |
| 노드 지연 시간 측정 | 선택한 노드에 대한 연결 시험 결과 | 프록시 목록의 지연 시간 또는 시험 상태 |
| 정책 그룹에서 노드 선택 | 트래픽을 보낼 출구 노드 | 정책 그룹의 현재 선택 항목 |
| 시스템 프록시 전환 | macOS 시스템 프록시를 이용하는 앱의 전달 경로 | ClashX 메뉴의 시스템 프록시 상태 |
구독 업데이트는 기존 설정을 새 내용으로 바꿀 수 있으므로, 직접 만든 규칙이나 설정 변경이 있다면 어디에 저장되는지 먼저 확인하세요. 원격 설정 파일을 직접 편집하면 다음 업데이트에서 변경 사항이 사라질 수 있습니다. 사용자 지정 규칙을 계속 유지해야 한다면 해당 ClashX 버전에서 지원하는 별도 오버라이드나 로컬 설정 기능을 사용하거나, 변경 내용을 안전한 위치에 따로 기록해 두세요.
구독이 만료되거나 노드가 나타나지 않을 때 점검하기
주소가 만료되었거나 서버에서 오류를 반환하는 경우
“업데이트 실패”가 표시되면 우선 Mac의 날짜와 시간이 자동으로 설정되어 있는지, 일반 웹사이트에 접속할 수 있는지 확인하세요. 그런 다음 계정 페이지에서 구독 상태와 갱신일, 트래픽 제한을 확인하고 URL을 새로 복사합니다. 구독 링크는 개인 인증 정보에 해당하므로 대화 앱이나 공개 게시물에 URL 전체를 붙여 넣지 마세요. 오류 분석을 위해 화면을 공유해야 한다면 URL의 토큰과 계정 이름을 가려야 합니다.
업데이트는 성공했지만 노드 목록이 비어 있는 경우
구성이 실제로 활성화되어 있는지, 다른 프로필을 열어 둔 것은 아닌지 확인하세요. 제공업체가 ClashX에 맞지 않는 출력 형식을 반환했거나, 구독 내용이 노드가 아니라 다른 앱용 설정일 수도 있습니다. 설정 파싱 오류가 표시된다면 오류 로그에서 문제가 된 필드와 줄을 확인하세요. 오래된 코어는 최신 구독에서 사용하는 새 프로토콜이나 설정 필드를 읽지 못할 수 있습니다. 이 경우 구독 주소를 반복해서 갱신하기보다 ClashX 버전과 포함된 코어의 지원 범위, 제공업체가 안내하는 출력 형식을 확인하는 편이 좋습니다.
노드는 표시되지만 연결이 되지 않는 경우
먼저 정책 그룹에서 노드가 선택되어 있는지 확인하고, 해당 노드의 지연 시간 시험을 다시 실행합니다. 연결 기록에 요청이 나타나는지도 확인하세요. 기록이 전혀 없다면 macOS 시스템 프록시가 꺼져 있거나, 테스트하는 앱이 시스템 프록시를 따르지 않을 수 있습니다. ClashX 메뉴에서 시스템 프록시 상태를 확인하고, 브라우저나 다른 프록시 앱이 자체 프록시 설정을 사용하지 않는지 살펴보세요. 반대로 연결 기록에 요청이 있지만 실패한다면 선택한 노드의 상태, 규칙에 지정된 정책 그룹, DNS 오류와 코어 로그를 순서대로 확인합니다.
구독 링크와 Mac 프록시 설정을 안전하게 관리하기
구독 URL은 비밀번호처럼 취급해야 합니다. 주소를 가진 사람이 설정을 내려받거나 계정 사용량에 영향을 줄 수 있으므로, 공개 저장소나 화면 캡처에 노출하지 말고 클라우드 메모에 저장할 때도 접근 권한을 제한하세요. URL이 유출된 것으로 의심되면 제공업체 계정에서 구독 주소를 재발급하거나 기존 링크를 폐기할 수 있는지 확인합니다. 재발급한 뒤에는 ClashX에 저장된 이전 주소를 새 주소로 바꾸고 업데이트가 정상적으로 완료되는지 확인하세요.
Mac에서 다른 프록시 클라이언트나 VPN을 동시에 실행하면 시스템 프록시가 서로 덮어써지거나, 트래픽이 예상과 다른 경로를 지날 수 있습니다. 문제를 진단할 때는 다른 프록시 앱을 일시 중지하고 ClashX 하나만 켠 상태에서 테스트하세요. ClashX의 시스템 프록시는 macOS 프록시 설정을 따르는 앱에 적용되며, 모든 명령줄 도구와 모든 앱의 연결을 자동으로 가로채는 기능은 아닙니다. 앱별로 자체 프록시 옵션이 있다면 해당 설정도 확인해야 합니다.
평소에는 구독 주소를 안전하게 보관하고, 업데이트 뒤에는 활성 구성·노드 목록·정책 그룹 선택을 함께 점검하는 습관을 들이세요. 문제가 생겼을 때도 “구독 다운로드”, “노드 연결”, “Mac의 트래픽 전달”을 분리해 확인하면 원인을 더 빠르게 찾을 수 있습니다. 업데이트 실패는 서버나 링크 문제일 수 있고, 노드가 보이지 않는 문제는 형식이나 구성 활성화 문제일 수 있으며, 노드는 정상인데 앱만 접속하지 못하는 경우에는 시스템 프록시 경로가 원인일 수 있습니다.