V2Ray Mac 클라이언트 v2rayN 다운로드와 설정 가이드

구독 → 구독 추가
  주소       https://example.com/api/v1/client/subscribe?token=xxxx
  비고       예시 구독
  업데이트 간격   1440분
  자동 업데이트   사용

구독 링크는 노드 설정을 배포하는 방식입니다. 클라이언트가 정해진 간격으로 노드 목록을 가져오고, 로컬에는 링크 자체만 저장되며 노드 추가와 삭제는 구독 제공자가 서버에서 처리합니다. v2rayN은 여러 개의 구독을 추가할 수 있고 각각 업데이트 간격을 지정할 수 있으며, 자동 업데이트를 끄고 수동으로 새로 고침할 수도 있습니다. v2rayNG의 구독 메뉴는 사이드바에 있고, 가져온 뒤 길게 눌러 이름을 바꿀 수 있습니다. 가져오기 실패는 보통 세 가지 원인으로 모입니다. 링크 자체가 만료된 경우, 가져올 때 네트워크가 연결되지 않는 경우, 반환된 내용이 표준 노드 목록이 아닌 경우입니다. 문제를 확인할 때는 먼저 브라우저에서 링크를 열어 응답이 오는지 보고, 그다음 클라이언트 업데이트 로그에서 구체적인 오류를 확인합니다.

{
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      { "type": "field", "domain": ["geosite:cn"], "outboundTag": "direct" },
      { "type": "field", "ip": ["geoip:cn"], "outboundTag": "direct" },
      { "type": "field", "network": "tcp,udp", "outboundTag": "proxy" }
    ]
  }
}

라우팅은 연결이 프록시를 거칠지 직접 연결될지를 결정합니다. 규칙은 위에서 아래 순서로 매칭되고, 일치하면 바로 멈춥니다. 그래서 직접 연결 규칙은 최종 프록시 규칙보다 앞에 있어야 합니다. 도메인 규칙은 geosite:cn으로 주요 중국 본토 사이트를 처리하고, IP 규칙은 geoip:cn으로 도메인 조회 후의 주소를 처리합니다. domainStrategy를 IPIfNonMatch로 설정하면 도메인 규칙이 일치하지 않을 때만 IP를 조회해 한 번 더 매칭합니다. 규칙을 수정한 뒤에는 설정을 다시 불러오거나 코어를 재시작해야 적용되며, 로그에 실제로 일치한 규칙 태그가 출력되므로 분할이 의도대로 동작하는지 확인할 수 있습니다.

코어 설정
  현재 코어    Xray-core
  대체 코어    V2Fly-core
  전환 경로    설정 → 코어 설정 → 코어 파일 선택
  적용 방식    코어 재시작 후 적용

그래픽 클라이언트 자체는 프록시 트래픽을 처리하지 않습니다. 실제로 연결을 맺는 것은 코어입니다. v2rayN과 v2rayNG는 기본적으로 Xray-core를 사용하며 V2Fly-core로 전환할 수도 있습니다. 두 코어는 VMess, VLESS 등 프로토콜 기반을 공유하고 설정 형식도 거의 같지만, Xray는 REALITY, XTLS Vision 같은 새 기능을 더 빠르게 반영하고 V2Fly는 예전 설정과의 호환을 더 보수적으로 유지합니다. 코어를 바꾸는 것은 로컬의 파싱과 아웃바운드 구현에만 영향을 주며, 노드를 사용할 수 있는지는 여전히 서버 설정에 달려 있습니다. 특정 프로토콜이 새 코어에서 오류를 낼 때는 다른 코어로 먼저 확인해 문제가 설정에 있는지 코어 차이에 있는지 가릴 수 있습니다.

{
  "log": {
    "loglevel": "warning",
    "access": "none",
    "error": ""
  }
}

실행 로그는 시간 순서로 세 가지를 기록합니다. 설정 로딩, 노드와의 핸드셰이크, 규칙에 따른 연결 아웃바운드입니다. 로그를 볼 때는 첫 번째 error를 먼저 찾고, 그 위 몇 줄에서 보통 맥락을 확인합니다. failed to parse는 설정 문법 문제를, connection refused는 대상에 도달할 수 없음을, context deadline exceeded는 대부분 타임아웃을 뜻합니다. loglevel을 warning으로 올리면 일상적인 잡음을 걸러낼 수 있고, debug로 내리면 전체 핸드셰이크 과정을 볼 수 있습니다. 확인이 끝나면 원래대로 되돌리는 것을 잊지 마세요. 로그 패널은 비우기와 내보내기를 지원하므로 문제가 생긴 시점과 맞춰 보면 더 빠르게 찾을 수 있습니다.