Mac에서 ClashX 구독 링크를 추가하면 제공업체의 프록시 서버 목록과 라우팅 설정을 프로필로 불러와 사용할 수 있습니다. 다만 구독 주소를 등록하는 것만으로 연결이 시작되는 것은 아닙니다. 링크가 ClashX가 읽을 수 있는 형식인지 확인하고, 내려받은 프로필을 선택한 뒤 macOS 시스템 프록시까지 활성화해야 합니다. 아래에서는 구독 URL 등록부터 프로필 갱신, 불러오기 오류 점검, 구독 주소 보안까지 순서대로 살펴봅니다.

시작 전에 확인할 사항

먼저 제공업체에서 발급한 Clash 호환 구독 URL을 준비하세요. 일반적으로 웹 브라우저에서 계정에 로그인한 다음 구독 또는 클라이언트 설정 페이지에서 복사할 수 있습니다. URL에는 계정 식별 정보가 포함될 수 있으므로 다른 사람에게 공유하거나 공개된 문서에 붙여 넣지 마세요.

모든 구독 링크가 같은 형식인 것은 아닙니다. Clash용 YAML 설정 파일을 내려주는 주소도 있고, 다른 클라이언트용 링크나 변환 서비스 주소도 있습니다. 브라우저에서 열었을 때 로그인 화면, HTML 안내 페이지, 오류 문구가 표시된다면 해당 주소가 ClashX용 설정 파일을 제공하는지 제공업체에 확인해야 합니다. 링크의 끝부분이 특정 파일 확장자로 끝나지 않아도 정상일 수 있으므로 URL 모양만으로 판단하지 마세요.

  • 링크가 만료되지 않았는지, 계정의 구독 상태가 유효한지 확인합니다.
  • 링크를 복사할 때 앞뒤 공백이나 줄바꿈이 포함되지 않았는지 확인합니다.
  • 사용 중인 ClashX 버전과 구독 설정이 요구하는 프록시 프로토콜이 호환되는지 확인합니다.
  • 현재 사용 중인 프로필을 보관해야 한다면 기존 YAML 파일이나 설정을 먼저 백업합니다.
구독 URL은 비밀번호와 비슷한 인증 정보입니다. 링크를 받은 사람은 계정에 연결된 서버 정보나 사용 권한에 접근할 수 있습니다. 화면 캡처를 공유할 때 주소 표시줄과 클립보드 기록에 링크가 노출되지 않도록 주의하세요.

ClashX에 구독 URL 추가하기

ClashX는 보통 macOS 메뉴 막대의 아이콘에서 설정과 프로필을 관리합니다. 메뉴 이름은 앱 버전이나 번역 상태에 따라 다를 수 있지만, 원격 설정 또는 원격 구성 파일을 관리하는 항목을 찾으면 됩니다. 구독을 추가할 때는 링크 자체를 프록시 노드 목록에 붙여 넣는 것이 아니라, 원격 프로필의 주소로 등록해야 합니다.

  1. ClashX를 실행하고 메뉴 막대에서 ClashX 아이콘을 클릭합니다.
  2. Config, Configuration 또는 이와 비슷한 설정 메뉴를 열고 원격 설정을 관리하는 항목을 선택합니다.
  3. 새 원격 구성을 추가하거나 URL로 설정 파일을 다운로드하는 기능을 엽니다.
  4. 제공업체의 구독 URL을 입력란에 붙여 넣고, 프로필을 구분할 수 있는 이름을 지정합니다.
  5. 다운로드 또는 확인을 눌러 설정 파일을 가져옵니다. 성공 메시지가 나오거나 새 프로필이 목록에 나타날 때까지 기다립니다.

버전에 따라 원격 프로필을 추가하는 메뉴가 바로 보이지 않을 수 있습니다. 이 경우 설정 메뉴에서 Remote Config, Download from URL, Manage Config처럼 원격 파일이나 설정 목록을 뜻하는 항목을 찾아보세요. 메뉴 명칭이 다르더라도 목적은 URL에서 Clash 설정을 가져와 프로필로 저장하는 것입니다. 메뉴에 해당 기능이 전혀 없다면 앱 버전이나 배포판에서 원격 설정 가져오기를 지원하는지 확인하고, 제공업체의 YAML 파일을 내려받아 로컬 설정으로 불러오는 방법을 문의하세요.

구독이 등록된 뒤에도 기존 로컬 설정이 자동으로 사라지는 것은 아닙니다. 프로필 목록에서 방금 추가한 항목의 이름과 갱신 시각을 확인하면 새 설정이 실제로 들어왔는지 판단하기 쉽습니다.

프로필 선택과 프록시 활성화

다운로드가 끝나면 ClashX 메뉴에서 새로 추가한 프로필을 선택합니다. 원격 구성을 등록했어도 현재 활성 프로필이 이전 설정으로 남아 있으면 새 구독의 노드가 표시되지 않을 수 있습니다. 프로필을 바꾼 다음에는 메뉴에 현재 선택된 설정 이름이 표시되는지 확인하세요.

그다음 프록시 모드를 선택합니다. 처음 확인할 때는 규칙 기반 모드를 사용하는 것이 일반적입니다. 이 모드에서는 설정 파일의 규칙에 따라 연결을 직접 보낼지 프록시 노드로 보낼지 결정합니다. 모든 연결을 프록시로 보내야 하는 특별한 이유가 있다면 전역 모드를 사용할 수 있지만, 모든 서비스가 같은 경로를 이용하므로 필요에 맞게 선택해야 합니다. 모드 이름과 동작은 구독 설정에 따라 조금씩 달라질 수 있습니다.

프로필을 선택했는데 연결이 되지 않는다면 메뉴에서 사용할 프록시 그룹과 노드도 확인하세요. 일부 설정에는 자동 선택 그룹과 국가별 그룹이 함께 포함됩니다. 그룹을 열어 사용 가능한 노드를 선택하고, 필요하면 지연 시간 테스트를 실행합니다. 테스트 결과가 실패로 표시되더라도 테스트 주소가 네트워크에서 차단되었을 수 있으므로, 다른 사이트 접속이나 다른 노드 선택으로 실제 연결 여부도 확인하세요.

확인 항목확인 방법문제가 있을 때
활성 프로필메뉴에서 새 구독 프로필이 선택됐는지 확인목록에서 구독 프로필을 다시 선택
프록시 그룹노드 또는 자동 선택 그룹이 표시되는지 확인프로필을 갱신하고 그룹 구성을 확인
시스템 프록시ClashX 메뉴에서 macOS 프록시 설정 상태 확인시스템 프록시 활성화 여부와 포트 충돌 점검
접속 결과브라우저에서 대상 사이트를 열고 연결 상태 확인다른 노드와 규칙 모드를 각각 시험

ClashX 메뉴에서 시스템 프록시가 활성화되어 있는지도 확인해야 합니다. 이 기능은 macOS 네트워크 설정에 프록시 정보를 적용해, 시스템 프록시를 따르는 앱의 연결을 ClashX로 전달합니다. 모든 앱이 시스템 프록시 설정을 따르는 것은 아니며, 일부 앱은 별도 프록시 설정이나 VPN 방식의 네트워크 처리를 사용합니다. 따라서 ClashX가 실행 중이어도 특정 앱만 우회한다면 해당 앱이 시스템 프록시를 사용하는지 확인하세요.

구독 프로필과 노드 갱신

구독 프로필의 갱신 기능은 제공업체에서 최신 설정을 다시 가져오는 작업입니다. 노드가 추가·삭제되거나 서버 정보가 바뀌었을 때 사용할 수 있습니다. ClashX 메뉴에서 프로필 관리 항목을 열고 해당 원격 구성의 업데이트 또는 새로고침 기능을 선택하세요. 업데이트가 완료된 뒤 프로필을 다시 선택하거나 노드 목록을 열어 변경 사항이 반영됐는지 확인합니다.

갱신 간격을 설정할 수 있는 버전이라면 제공업체가 안내한 주기를 따르세요. 너무 짧은 간격으로 반복 요청하면 서비스 측에서 요청을 제한할 수 있고, 불필요한 트래픽도 발생합니다. 갱신 직후에도 노드가 보이지 않는다면 구독 서버가 같은 설정을 반환하는지, 현재 선택한 프로필이 갱신한 항목과 일치하는지 확인하세요. 자동 갱신을 지원하지 않는 버전에서는 필요한 시점에 수동으로 업데이트하면 됩니다.

  1. ClashX 메뉴에서 구독 프로필 관리 화면을 엽니다.
  2. 갱신할 프로필을 선택하고 업데이트 또는 새로고침을 실행합니다.
  3. 완료 알림이나 마지막 업데이트 시각을 확인합니다.
  4. 프로필을 다시 활성화하고 프록시 그룹에 최신 노드가 표시되는지 확인합니다.
  5. 새 노드가 표시되지 않으면 URL 유효성, 제공업체 상태, 프로필 선택을 차례로 점검합니다.

프로필 업데이트는 설정 파일 전체를 새로 가져올 수 있으므로, 직접 수정한 로컬 설정이 있다면 원격 프로필 갱신 후에도 유지될 것이라고 가정하지 마세요. 구독에서 제공하는 설정과 사용자가 별도로 편집한 설정은 관리 방식이 다를 수 있습니다. 사용자 지정 규칙이나 로컬 노드를 보존하려면 별도 백업을 만들고, 프로필 갱신 전후에 어떤 항목이 바뀌었는지 확인하는 습관을 들이세요.

불러오기 실패와 연결 문제 해결

가장 흔한 오류는 URL을 열 수 없거나 설정 파일을 읽을 수 없다는 메시지입니다. 먼저 Mac이 인터넷에 연결되어 있는지 확인하고, 브라우저에서 구독 주소를 열어 응답이 오는지 살펴보세요. 브라우저에서 로그인 페이지나 이용권 만료 안내가 나타난다면 ClashX의 문제가 아니라 계정 인증 또는 구독 상태 문제일 수 있습니다. 제공업체가 요구하는 사용자 인증이나 접근 방식을 확인한 뒤 새 URL을 발급받으세요.

주소가 정상적으로 응답해도 설정 파싱 오류가 발생할 수 있습니다. 제공업체가 다른 클라이언트용 형식을 반환했거나, 설정에 사용 중인 ClashX가 지원하지 않는 문법 또는 프로토콜이 포함되었을 수 있습니다. 특히 오래된 클라이언트와 최신 구독 설정 사이에는 지원 기능 차이가 있을 수 있습니다. 오류가 반복되면 설정 파일이 ClashX 호환 형식인지, 필요한 프로토콜을 현재 앱이 지원하는지 제공업체의 안내와 함께 확인하세요.

  • 구독 주소 오류: URL을 다시 복사하고 공백이 들어갔는지 확인합니다. 만료된 주소라면 제공업체 계정에서 새 링크를 발급받습니다.
  • 다운로드 시간 초과: 네트워크를 바꾸어 다시 시도하고, 제공업체의 서비스 상태나 접근 제한 공지를 확인합니다.
  • 노드가 표시되지 않음: 갱신이 완료됐는지, 올바른 프로필이 선택됐는지 확인합니다. 빈 설정이나 만료 안내가 내려왔을 가능성도 있습니다.
  • 노드는 보이지만 연결되지 않음: 다른 노드를 선택하고, 노드 자격 정보와 이용 기간이 유효한지 확인합니다.
  • 일부 앱만 연결 실패: 시스템 프록시 적용 여부와 앱 자체의 네트워크 설정을 확인합니다.
  • 갱신 후 설정이 달라짐: 구독 측에서 프로필을 변경했는지 확인하고, 직접 수정한 항목은 백업에서 복구할 수 있는지 점검합니다.

오류 해결을 위해 구독 URL이나 전체 설정 파일을 공개 게시판에 올리는 것은 피해야 합니다. 설정에는 서버 주소, 계정 식별 정보, 인증 키 또는 비밀번호가 들어갈 수 있습니다. 지원팀에 문의할 때는 오류 문구와 앱 버전, macOS 버전, 발생 시점을 전달하고, 민감한 값은 가린 화면이나 로그만 공유하세요.

자주 묻는 질문

구독 URL을 추가했는데 노드가 보이지 않는 이유는 무엇인가요?

원격 설정을 등록한 것과 해당 프로필을 활성화하는 것은 별개의 단계입니다. 새 구독 프로필을 선택하고 업데이트가 완료됐는지 확인하세요. 그래도 노드 목록이 비어 있다면 주소가 Clash용 형식인지, 계정의 구독 권한이 유효한지, 설정이 현재 ClashX에서 지원되는지 확인해야 합니다.

구독 링크를 브라우저에서 열면 파일이 표시되지 않아도 괜찮나요?

주소가 다운로드를 시작하거나 텍스트 형식의 설정을 반환하면 정상일 수 있습니다. 반면 로그인 화면, 결제 안내, 접근 거부 또는 일반 웹페이지가 표시된다면 ClashX가 사용할 설정을 받지 못한 것입니다. 제공업체에서 Clash 호환 URL을 다시 확인하거나 새 링크를 발급받으세요.

프로필을 갱신하면 직접 수정한 설정도 유지되나요?

원격 구독은 제공업체가 반환하는 설정을 다시 가져오므로, 직접 추가한 로컬 변경 사항이 덮어써지거나 반영되지 않을 수 있습니다. 갱신 전 설정을 백업하고, 사용자 지정 규칙을 지원하는 별도 설정 구조가 필요한지 확인하세요.

ClashX가 실행 중인데도 특정 앱은 프록시를 사용하지 않아요.

ClashX의 시스템 프록시 설정을 켰는지 먼저 확인하세요. 일부 앱은 macOS 시스템 프록시를 따르지 않으므로 앱 내부의 프록시 설정이나 별도 네트워크 모드를 확인해야 합니다. 프로필에서 올바른 노드와 라우팅 모드가 선택되어 있는지도 함께 점검하세요.

ClashX 구독 설정은 주소를 안전하게 보관하고, 프로필을 올바르게 선택하며, 필요할 때 최신 설정으로 갱신하는 세 단계가 핵심입니다. 처음 연결할 때는 시스템 프록시 상태와 선택한 노드를 함께 확인하고, 갱신 전에는 직접 수정한 설정을 백업해 두세요. 이렇게 점검하면 링크 만료, 프로필 선택 오류, 앱별 프록시 차이로 생기는 문제를 더 빠르게 구분할 수 있습니다.