증상: 확장 마켓만 돌고, 업데이트와 GitHub는 따로 놀 때

Cursor를 켠 뒤 확장 마켓 탭에서 검색창에 키워드를 넣었는데 목록이 비어 있거나 스피너만 길게 도는 반면, 일반 웹 검색이나 메일은 정상인 경우가 많습니다. 또 다른 패턴은 내장 업데이트 다이얼로그가 끝까지 가지 못하고, 동시에 터미널에서 git clone이나 패키지 매니저가 GitHub에서 메타데이터만 가져오다 멈추는 조합입니다. 사용자 입장에서는 모두 「인터넷은 되는데 에디터만 이상하다」로 느껴지지만, 실제로는 호스트마다 다른 CDN·다른 TLS 핸드셰이크 경로·그리고 Clash의 규칙 매칭 순서가 겹친 결과인 경우가 큽니다.

VS Code 기반 제품군은 마켓플레이스 메타데이터, 확장 .vsix 다운로드, 언어 서버가 끌어오는 외부 패키지, 그리고 Cursor 측 백엔드 API까지 여러 도메인으로 갈라집니다. 한 줄짜리 FINAL,PROXY만으로는 「어느 호스트가 어느 노드로 나갔는지」를 디버깅하기 어렵고, 상단에 깔린 GEOIP,CN,DIRECT나 넓은 직결 리스트 때문에 GitHub만 직결로 빠져 느려지는 사례도 흔합니다. 이 글은 합법적인 개발·원격 업무·학습 목적의 네트워크 정렬을 다루며, 특정 서비스 약관이나 소속 기관의 IT 정책을 우회하라는 뜻이 아닙니다.

왜 GitHub·업데이트·마켓을 나눠야 하는가

단일 select 그룹에 모든 해외 트래픽을 넣으면 운영은 단순해지지만, 지연·손실 특성이 다른 경로가 한 출구에 묶입니다. 예를 들어 영상 스트리밍에 적합한 노드가 GitHub REST API에는 버퍼가 크거나, 반대로 API는 빠른데 대용량 CDN 다운로드에서만 재전송이 잦을 수 있습니다. Cursor 사용자 커뮤니티에서 말하는 「확장 마켓이 안 열림」은 종종 마켓 메타 요청과 실제 아카이브 다운로드가 서로 다른 정책에 걸렸을 때 나타납니다.

그래서 DEV-GITHUB, DEV-VSCODE-CDN, DEV-CURSOR-API처럼 역할별 proxy-group을 두고, 각 그룹에는 해당 용도에 맞는 노드만 넣는 방식이 디버깅에 유리합니다. 나머지 웹은 기존 자동 선택 그룹을 유지하더라도, 문제 재현 시 한 그룹만 수동으로 바꿔 A/B 비교할 수 있습니다. 원격 목록으로 도메인을 관리하려면 Rule Providers·rule-set 구성 글을 함께 보세요. Google·Gemini만 따로 두는 시나리오는 Chrome·Gemini 분류 가이드와 도메인이 겹치므로, 이 글에서는 Cursor·GitHub·VS Code 업데이트 축에 초점을 맞춥니다.

도메인 묶음: 로그로 잡는 실무 순서

고정된 YAML 한 벌을 모든 사용자에게 강요할 수는 없습니다. 이유는 제품 버전과 CDN 계약이 바뀌면 호스트가 추가되기 때문입니다. 대신 재현 가능한 순서를 권합니다. 첫째, OS나 브라우저가 아니라 에디터 자체의 개발자 도구·네트워크 로그가 있다면 실패한 요청의 Host를 적습니다. 둘째, 시스템 프록시를 켠 상태에서 실패하는지, TUN만 켠 상태에서만 실패하는지를 나눕니다. 셋째, Clash 대시보드나 로그에서 동일 시각 연결이 어떤 policy·rule에 매칭됐는지 확인합니다.

출발점으로 자주 등장하는 축에는 github.com, api.github.com, raw.githubusercontent.com, objects.githubusercontent.com 같은 GitHub 계열과, VS Code 계열 업데이트에 쓰이는 update.code.visualstudio.com, vscode.blob.core.windows.net, marketplace.visualstudio.com 류의 Microsoft 마켓·CDN, 그리고 Cursor 클라이언트가 붙는 cursor.com, cursor.sh, api.cursor.com 등이 있습니다. Open VSX를 쓰는 워크스페이스라면 open-vsx.org가 추가됩니다. 위 이름은 예시이며, 실제 프로필에 넣기 전에 본인 환경의 로그로 한 번 더 확인해야 합니다.

# Example — replace host groups after verifying your own logs
proxy-groups:
  - name: DEV-GITHUB
    type: select
    proxies:
      - 🇸🇬 Low-latency API
      - ♻️ Auto
      - DIRECT
  - name: DEV-VSCODE-CDN
    type: select
    proxies:
      - 🇯🇵 Stable download
      - ♻️ Auto
      - DIRECT
  - name: DEV-CURSOR-API
    type: select
    proxies:
      - 🇺🇸 Reliable TLS
      - ♻️ Auto
      - DIRECT

rules:
  - DOMAIN-SUFFIX,github.com,DEV-GITHUB
  - DOMAIN-SUFFIX,githubusercontent.com,DEV-GITHUB
  - DOMAIN-SUFFIX,visualstudio.com,DEV-VSCODE-CDN
  - DOMAIN-SUFFIX,microsoft.com,DEV-VSCODE-CDN
  - DOMAIN-SUFFIX,cursor.com,DEV-CURSOR-API
  - DOMAIN-SUFFIX,cursor.sh,DEV-CURSOR-API

위 블록에서 DOMAIN-SUFFIX,microsoft.com은 범위가 매우 넓어 오탐이 나기 쉽습니다. 운영 프로필에서는 Microsoft 전체가 아니라, 로그에 실제로 찍힌 서브도메인만 좁혀 넣는 편이 안전합니다. DOMAIN-KEYWORD는 다른 서비스까지 끌어올 위험이 있어 테스트 전용 외에는 비추천입니다. 규칙 파일을 여러 조각으로 쪼개 저장했다면 rule-provider 병합 순서가 최종 YAML에서 어떻게 펼쳐지는지까지 확인해야 합니다.

규칙 우선순위와 직결(DIRECT) 오매칭

프로필 상단에 GEOIP,CN,DIRECT나 국내 CDN 직결 rule-set이 있고, 그 아래에 넓은 DOMAIN-SUFFIX가 끼어 있으면 GitHub 호스트가 DIRECT로 빠질 수 있습니다. 직결이 항상 빠른 것은 아니며, 특정 회선에서는 SNI만 맞고 중간에서 버퍼가 커져 화면에는 무한 로딩만 남기도 합니다. 반대로 FINAL만 PROXY로 두었는데도 마켓이 느리다면, 더 위에 있는 REJECT·광고 차단 규칙이 오탐으로 마켓 도메인을 잘랐는지 의심해야 합니다.

대응은 단순합니다. 문제 세션에서 rule hit 한 줄을 남겨 어떤 규칙에 걸렸는지 이름을 확인하고, DEV-GITHUB·DEV-VSCODE-CDN·DEV-CURSOR-API 블록을 충돌하는 DIRECT 규칙보다 위로 올리되, 다른 업무 트래픽을 깨지 않도록 DOMAIN 범위를 좁힙니다. Google·Anthropic·DeepSeek 전용 블록을 이미 쓰고 있다면 상대적 순서를 함께 봐야 하며, AI 호스트 글들과 도메인이 겹치지 않게 주석으로 구역을 나누어 두면 이후 유지보수가 쉬워집니다.

DNS·fake-ip가 Cursor 프록시 체감을 흔드는 경우

Clash DNS가 fake-ip일 때, OS resolver·브라우저·에디터 내장 스택이 서로 다른 IP 답을 쓰면 증상이 기묘해집니다. 한 경로만 프록시를 타고 다른 경로는 직결이라, 연결은 됐는데 UI만 비어 있는 것처럼 느껴질 수 있습니다. redir-host와 fake-ip를 바꿔 가며 재현되는지 확인해 보세요.

DoH 업스트림이 지역별로 다른 응답을 주면, 규칙상 SNI는 맞는데 실제 목적지가 기대와 달라지는 경우도 있습니다. 이때는 어떤 nameserver 그룹을 타는지, fallback이 과도하게 빨리 도는지, 그리고 마켓·GitHub 도메인이 fake-ip-filter에 필요한지를 점검합니다. TUN과 시스템 프록시를 동시에 켠 환경이라면 TUN 모드 가이드의 DNS 설명과 맞춰 읽으면 이해가 빠릅니다. 연결은 됐는데 페이지만 안 열릴 때의 공통 절차는 로그·DNS·규칙 가이드와도 맞물립니다.

UDP·HTTP/3와 대용량 다운로드

Chromium 계열이 HTTP/3(QUIC)을 선호하면, 프록시 노드나 중간 장비가 UDP를 제한할 때 TCP로 떨어지기 전까지 화면이 비어 있는 것처럼 느껴질 수 있습니다. 확장 마켓이 반쯤만 열리는 느낌이면 QUIC 간섭 가능성도 함께 의심합니다. 규칙 측면은 QUIC·HTTP/3 가이드를 참고하세요. 대용량 .vsix나 언어 서버 바이너리는 긴 세션이라, 유휴 타임아웃에 걸리기도 하므로 노드의 TCP 옵션·multiplex 설정을 함께 보는 것이 좋습니다.

검증 절차: 확장 마켓이 안 열릴 때의 체크리스트

아래 순서는 메모하기 쉽게 짧게 유지했습니다. 각 단계에서 전후 로그 한 줄만 남겨도 동료에게 넘기기 쉽습니다.

  1. 에디터·터미널에서 실패한 요청의 호스트명과 HTTP 상태를 기록한다.
  2. Clash에서 동일 시각 연결이 어느 policy와 rule에 매칭됐는지 확인한다.
  3. DEV-GITHUB·DEV-VSCODE-CDN·DEV-CURSOR-API 각각에서 노드를 바꿔 증상이 따라오는지 본다.
  4. DNS 모드·nameserver·fallback을 바꿔 재현 여부를 본다.
  5. 같은 노드로 다른 HTTPS 사이트를 열어 회선 자체 이슈인지 가른다.
  6. TUN·시스템 프록시·회사 SSL 검사가 동시에 개입하는지 확인한다.

이 과정을 거치면 「Cursor 프록시가 불안정하다」는 막연한 보고를 GitHub만 DIRECT에 걸림, 마켓 CDN만 특정 노드에서 손실, DNS 이중 해석 같은 구체 가설로 바꿀 수 있습니다. GitHub 분류를 한 번 정리해 두면 다른 IDE·CI·패키지 레지스트리에도 그대로 이식할 수 있어, 확장 마켓 문제만이 아니라 개발 전반의 네트워크 지원 비용이 줄어듭니다.

네트워크 프록시 도구는 합법적인 개인정보 보호·연구·원격 업무에 활용될 수 있지만, 관할 법령·서비스 약관·고용 계약을 위반하는 용도로 사용해서는 안 됩니다.
오픈소스 코어와 GUI는 GitHub 등에서 이슈와 릴리스 노트를 확인할 수 있습니다. 설치 패키지를 받는 주 경로는 본 사이트 다운로드 페이지를 우선 참고하고, 라이선스·기여 방법은 저장소를 별도로 열람하는 편이 혼선이 적습니다.

정리

Cursor 확장 마켓이 계속 로딩되거나 내장 업데이트와 GitHub 연동이 따로 불안정해 보일 때, 원인은 종종 노드 하나가 아니라 프록시 규칙·도메인 순서·DNS·전송 프로토콜의 조합에 있습니다. GitHub·VS Code CDN·Cursor API를 역할별 proxy-group으로 나누고, rule hit 로그로 직결 오매칭을 걸러 내면 같은 증상을 훨씬 빠르게 닫을 수 있습니다.

장기적으로는 원격 rule-set으로 호스트 목록을 갱신하고, 로컬 YAML에는 충돌이 적은 최소 규칙만 남기는 편이 안전합니다. 더 넓은 개념은 문서 허브의 고급 설정 파트와 맞춰 읽으면 흐름이 연결됩니다. Chrome·Gemini·Claude·DeepSeek 글에서 쓴 분류 뼈대를 Cursor에도 이식할 수 있되, 도메인 집합은 제품마다 다르다는 전제를 잃지 마세요.

동일한 Mihomo 코어를 쓰는 클라이언트라도 UI에서 보이는 로그 형식이 조금씩 다를 수 있으나, 어떤 규칙에 맞았는지와 어느 그룹으로 나갔는지만 일관되게 확인할 수 있으면 충분합니다. 일상용 프로필과 개발 실험용 프로필을 나누는 것도 실용적인 타협입니다.

Clash를 무료로 내려받고 Cursor 트래픽 분류와 DNS 점검을 안정적으로 맞춰 보기