빠른 시작 · 첫 설정

v2rayN macOS 설정 가이드

네 단계로 구독 가져오기, 프록시 선택, 연결 및 작동 확인을 마칩니다. 처음에는 시스템 프록시를 사용하고, TUN과 사용자 지정 DNS는 연결이 정상적으로 작동한 뒤 설정하세요.

처음 설정하는 데 약 10분 정도 걸립니다. 시작하기 전에 유효한 구독 링크나 서비스 제공업체가 전달한 완전한 서버 설정을 준비하세요. 클라이언트는 설정을 읽고 트래픽을 전달하는 역할을 하며, 클라이언트만 설치한다고 사용할 수 있는 서버가 생기지는 않습니다. 구독에는 보통 접속 정보가 포함되므로 전체 링크를 공개 게시판에 올리거나 링크, QR 코드, 계정 정보가 담긴 화면을 그대로 공유하지 마세요.

아직 설치하지 않았다면 macOS 다운로드 페이지에서 해당 설치 파일을 선택하세요. 시스템 메뉴에서 ‘이 Mac에 관하여’를 열어 Apple 칩 이름이 표시되면 Apple Silicon, Intel 프로세서가 표시되면 Intel용을 선택합니다. 설치 후 ‘응용 프로그램’에서 v2rayN을 실행하세요. 출처를 확인할 수 없다는 경고가 표시되면 먼저 다운로드 경로와 앱 이름을 확인한 다음 시스템에서 제공하는 보안 설정에 따라 진행하세요. 기기 전체의 보안 기능을 끄지는 마세요. 아래 단계는 클라이언트가 정상적으로 실행되는 상태에서 시작합니다.

1단계: 구독 가져오기

먼저 v2rayN을 실행하고 ‘구독 그룹’ 관리 화면에서 새 그룹을 추가합니다. 알아보기 쉬운 별칭을 입력한 뒤 구독 링크 전체를 주소 입력란에 붙여 넣으세요. 별칭은 로컬에서 그룹을 구분하는 용도이므로 출처나 사용 목적에 맞춰 지정하면 됩니다. 업데이트할 때 실제로 접속하는 곳은 주소 입력란에 입력한 링크입니다. 붙여 넣은 뒤 앞뒤에 공백이나 줄바꿈이 없는지, 메신저가 문장 부호를 덧붙이지 않았는지, 링크가 잘리지 않았는지 확인하고 그룹을 저장하세요.

그룹을 저장해도 서버 설정을 가져온 것은 아닙니다. 메인 창으로 돌아가 구독 메뉴에서 업데이트를 실행하고 방금 만든 그룹이 대상으로 선택됐는지 확인하세요. 사용할 수 있는 프록시가 아직 없고 현재 네트워크에서 구독 주소에 직접 접속할 수 있다면 우선 ‘프록시를 사용하지 않고 구독 업데이트’를 시도하세요. 제공업체가 구독 주소에 접속할 때 프록시를 사용해야 한다고 명시한 경우에는 먼저 작동하는 연결을 만든 뒤 프록시를 통해 업데이트해야 합니다. 첫 연결을 설정하기도 전에 프록시가 필요한 업데이트를 반복하지 마세요.

업데이트가 끝나면 해당 그룹으로 돌아가 서버 목록을 확인하세요. 정상적으로 가져왔다면 빈 그룹만 보이는 것이 아니라 선택할 수 있는 설정 항목이 표시됩니다. 목록의 별칭, 프로토콜 유형, 연결 매개변수는 구독 내용에 따라 달라지므로 이름만으로 사용 가능 여부를 판단하지 마세요. 업데이트 성공 메시지가 표시됐는데 목록이 비어 있다면 그룹을 잘못 선택했는지, 검색창에 필터가 남아 있는지 확인한 뒤 구독이 만료됐거나 클라이언트가 인식할 수 있는 설정을 반환하지 않았는지 살펴보세요.

구독 주소가 아니라 단일 서버 설정 공유 링크를 받았다면 서버 메뉴의 클립보드 가져오기 기능을 사용하세요. 이 링크를 구독 업데이트 주소에 억지로 입력하지 마세요. 가져오기 전에 내용을 전부 복사하고, 가져온 뒤 클라이언트가 해당 프로토콜을 인식했는지 확인합니다. 서버 정보를 직접 입력할 때는 주소, 포트, 사용자 ID, 전송 방식, TLS 관련 매개변수를 제공된 정보와 일치시켜야 합니다. 누락된 항목은 제공업체 안내에서 확인하고 임의로 값을 채우지 마세요.

v2rayNG: 소스를 추가한 뒤 업데이트

v2rayNG에서 구독 그룹 설정을 열고 새 그룹을 추가한 다음 메모와 구독 주소를 입력하고 저장하세요. 메인 화면으로 돌아가 메뉴에서 구독을 업데이트한 뒤 해당 그룹을 선택해 설정을 확인합니다. 단일 공유 링크를 사용하는 경우 메인 화면의 추가 메뉴에서 클립보드 가져오기를 선택할 수 있습니다. 버전에 따라 메뉴 위치는 달라질 수 있지만, 소스 저장과 내용 업데이트는 별개의 작업입니다. 그룹 이름이 보인다고 서버까지 가져온 것은 아닙니다.

이 단계에서는 목록에 사용할 서버가 있는지만 확인하면 됩니다. 모든 항목을 급히 테스트할 필요는 없습니다. 서버 하나를 선택한 뒤 다음 단계에서 트래픽을 클라이언트로 전달하는 방법을 설정하세요. 업데이트에 실패하면 링크 유효 기간, 기기 날짜, 현재 네트워크에서 구독 소스에 접속할 수 있는지부터 확인하세요. 프록시, DNS, 전송 매개변수를 한꺼번에 변경하지 마세요. 자세한 해결 방법은 구독 업데이트 실패 및 자동 업데이트 설정을 참고하세요. 이 가이드에서는 구독을 정상적으로 가져온 상태에서 계속 진행합니다.

2단계: 프록시 모드 선택

구독을 가져온 뒤에는 두 가지 기능을 구분해야 합니다. 시스템 프록시는 어떤 앱이 요청을 클라이언트에 전달할지 정하고, 라우팅 규칙은 클라이언트가 받은 요청을 직접 연결할지 프록시로 보낼지 결정합니다. 각각 트래픽의 진입과 출구를 담당하므로 서로 대체할 수 없습니다. 처음 설정할 때는 시스템 프록시를 사용해 이를 따르는 브라우저에서 먼저 확인하세요. ‘TUN 사용’은 끈 상태로 두어 권한, 가상 네트워크 인터페이스, DNS 처리 같은 변수를 한꺼번에 추가하지 않는 편이 좋습니다.

v2rayN 메인 창 하단이나 메뉴 막대의 상태 메뉴에서 ‘시스템 프록시’를 찾아 ‘시스템 프록시 자동 설정’을 선택하세요. 같은 메뉴의 ‘시스템 프록시 해제’는 클라이언트가 설정한 시스템 프록시를 제거하며, ‘시스템 프록시 변경 안 함’은 시스템의 현재 설정을 그대로 유지합니다. 후자를 선택했다고 트래픽이 v2rayN으로 전달되는 것은 아닙니다. 설정을 선택한 뒤 메인 창에 자동 설정 상태가 표시되는지 확인하세요. 코어가 아직 실행되지 않았다면 브라우저에서 웹 페이지를 열지 못할 수 있으므로 다음 단계에서 연결한 뒤 결과를 확인합니다.

다음으로 라우팅 모드를 찾아 처음에는 ‘중국 본토 우회’ 또는 현재 버전에서 이에 해당하는 분할 라우팅 규칙을 선택할 수 있습니다. 일반적으로 직접 연결 규칙에 해당하는 요청은 바로 접속하고 나머지는 프록시 규칙에 따라 처리하지만, 실제 동작은 클라이언트가 불러온 규칙에 따라 달라집니다. ‘전역’은 더 많은 요청을 프록시 아웃바운드로 보내는 설정으로, 잠시 비교하며 문제를 확인할 때 쓸 수 있습니다. 다만 시스템의 모든 앱이 자동으로 프록시를 사용하게 되는 것은 아닙니다. 시스템 프록시를 사용하지 않는 앱은 라우팅을 바꿔도 클라이언트로 전달되지 않습니다.

이 단계에서는 원격 DNS를 직접 입력하거나 브라우저의 여러 네트워크 옵션을 바꿀 필요가 없습니다. 클라이언트 기본 설정을 유지하고 처음에는 브라우저 하나만 대상으로 확인하세요. 브라우저에 별도 프록시 확장 프로그램이 설치돼 있다면 잠시 비활성화하거나 시스템 설정을 따르도록 변경하세요. 시스템 프록시를 변경하는 다른 도구도 종료해 두 프로그램이 같은 설정을 번갈아 바꾸지 않도록 합니다. 조직에서 관리하는 네트워크의 프록시를 사용 중이라면 기존 설정을 먼저 확인하고 관리 정책을 따르세요.

v2rayNG: 라우팅 및 VPN 처리 방식 확인

v2rayNG 안드로이드 버전은 일반적으로 로컬 VPN 인터페이스를 통해 앱 트래픽을 받으므로 데스크톱의 시스템 프록시 메뉴를 그대로 따라 설정할 필요가 없습니다. 설정에서 라우팅 옵션을 열고 처음에는 기본 규칙이나 필요한 분할 라우팅 모드를 선택하세요. 앱별 프록시 기능을 사용 중이라면 테스트할 브라우저가 프록시 범위에 포함됐는지 확인합니다. ‘선택한 앱만 프록시 사용’과 ‘선택한 앱 우회’는 반대 동작이므로 화면 안내를 확인하고 저장하세요.

설정을 마치면 현재 조합을 기억해 두세요. 대상 서버 하나, 라우팅 모드 하나, 테스트 브라우저 하나로 구성하면 문제가 생겼을 때 연결 실패인지 앱이 프록시로 전달되지 않은 것인지 구분하기 쉽습니다. TUN은 시스템 프록시를 따르지 않는 앱을 처리하는 데 유용하지만 처음 연결할 때 반드시 필요한 기능은 아닙니다. 시스템 프록시, TUN, 분할 라우팅 규칙, DNS의 연동 방식을 더 알아보려면 전체 플랫폼 설치 및 설정 가이드를 참고하세요. 이번 연결 확인이 끝나기 전에 모든 기능을 한꺼번에 켜지 마세요.

3단계: 연결 및 실행 상태 확인

v2rayN 서버 목록으로 돌아가 사용할 항목을 활성 서버로 설정하세요. 버전에 따라 서버를 마우스 오른쪽 버튼으로 클릭한 뒤 ‘활성 서버로 설정’을 선택하면 됩니다. 목록에서 활성 표시가 대상 항목에 있는지 확인하세요. 행을 클릭하면 목록에서 선택만 될 뿐 활성 설정은 바뀌지 않을 수 있으므로 배경색이 아니라 활성 상태를 확인해야 합니다. 서버를 전환하면 클라이언트가 설정을 적용하고 프록시 코어를 시작하거나 다시 불러오는 경우가 많습니다.

다음으로 로그 영역을 확인하세요. 설정이 정상적으로 읽혔는지, 코어가 계속 실행 중인지, 로컬 리스너가 만들어졌는지가 핵심입니다. 특정 형식의 성공 메시지를 찾을 필요는 없습니다. 코어와 버전에 따라 로그 문구가 다를 수 있으므로 똑같은 문장이 없다는 이유만으로 실패로 판단하지 마세요. 오류가 계속 표시되면 이번 실행과 관련된 첫 오류부터 확인해 후속 반복 메시지에 혼란스럽지 않도록 합니다. 설정을 바꾼 뒤에는 이전 로그와 새 로그도 구분하세요.

로컬 포트가 사용 중이라고 나오면 다른 클라이언트 인스턴스나 프록시 프로그램이 실행 중인지 확인하세요. 충돌하는 프로그램을 종료한 뒤 현재 설정을 다시 적용하고, 포트를 무작정 여러 개 바꾸지는 마세요. 리스닝 포트를 꼭 변경해야 한다면 클라이언트 설정에서 저장한 뒤 시스템 프록시를 다시 적용해 시스템이 새 리스닝 주소를 가리키도록 하세요. 로그에 인식할 수 없는 설정 항목이 표시되면 해당 클라이언트와 코어가 구독 설정을 지원하는지 먼저 확인하세요. 의미를 모르는 항목을 바로 삭제하지 마세요.

코어가 시작되면 시스템 프록시가 여전히 ‘시스템 프록시 자동 설정’ 상태인지 확인하세요. macOS에서 메인 창을 닫았더라도 메뉴 막대 아이콘이 계속 실행 중인지 확인해야 합니다. 창을 닫는 것과 앱을 완전히 종료하는 것은 다를 수 있습니다. 처음 확인하는 동안에는 상태를 살펴볼 수 있도록 메인 창을 열어 두세요. 클라이언트의 연결 테스트 기능으로 참고할 수는 있지만, 결과는 해당 테스트 방식의 상태만 보여 주므로 다음 단계의 실제 브라우저 접속 확인을 대신할 수 없습니다.

v2rayNG: 로컬 VPN 연결 시작

v2rayNG 메인 화면에서 대상 설정을 선택하고 연결 버튼을 누르세요. 처음 연결할 때 시스템에 VPN 연결 요청이 표시됩니다. 요청을 보낸 앱이 v2rayNG인지 확인한 뒤 승인하세요. 시스템 상태 표시줄에 VPN 아이콘이 나타나면 로컬 트래픽 처리가 시작된 것입니다. 다만 원격 서버까지 사용할 수 있다는 뜻은 아닙니다. 다른 VPN 앱도 연결 중이라면 먼저 해당 연결을 중지한 뒤 v2rayNG를 실행해 VPN 처리 상태가 서로 영향을 주지 않도록 하세요.

연결 시간이 초과되면 먼저 시스템 날짜와 시간을 확인하고, 현재 서버가 여전히 유효한지 확인한 다음 로그의 구체적인 오류를 살펴보세요. TLS, 서버 이름, 전송 경로가 일치하지 않으면 연결에 실패할 수 있습니다. 설정 출처와 매개변수를 하나씩 대조하고 인증서 검증을 끄는 방법으로 해결하려 하지 마세요. 복잡한 오류를 진단해야 한다면 노드 시간 초과 및 연결 실패 점검 순서를 참고하세요. 이 단계의 완료 기준은 활성 설정이 명확하고, 코어가 계속 실행되며, 트래픽 진입 기능이 켜져 있는 것입니다.

4단계: 프록시 작동 여부 확인

클라이언트를 실행 상태로 유지하고 시스템 프록시를 따르는 브라우저에서 새 탭을 여세요. 아직 방문하지 않았고 현재 규칙에 따라 프록시를 사용해야 하는 웹 페이지에 접속합니다. 이미 열린 페이지를 새로고침하는 것만으로 확인하지 마세요. 네트워크가 끊겨도 캐시된 내용이 표시되어 잘못 판단할 수 있습니다. 먼저 페이지 본문이 제대로 로드되는지 확인한 뒤 사이트의 다른 페이지도 열어 요청이 계속 정상적으로 처리되는지 살펴보세요. 직접 연결될 것으로 예상되는 자주 쓰는 웹 페이지도 확인해 일반 접속에 문제가 없는지 점검합니다.

이어서 클라이언트로 돌아가 이번 접속에 해당하는 로그를 확인하세요. 로그 수준에 따라 접속이나 라우팅 정보가 기록된다면 요청이 클라이언트에 전달됐는지, 어떤 규칙과 아웃바운드가 적용됐는지 살펴봅니다. 접속 기록이 보이지 않는다면 먼저 현재 로그 설정이 해당 정보를 표시하는지 확인하세요. 바로 프록시가 작동하지 않는다고 단정하지 마세요. 클라이언트 화면에 실행 중이라고 표시되거나 테스트에서 응답 시간이 나왔다는 이유만으로 브라우저가 프록시를 사용한다고 판단해서도 안 됩니다.

외부로 나가는 IP가 달라졌는지 확인하려면 신뢰할 수 있는 네트워크 정보 조회 페이지를 참고할 수 있습니다. 다만 라우팅 규칙을 고려해 결과를 해석해야 합니다. 조회 페이지 요청이 직접 연결 규칙에 따라 처리됐다면 로컬 네트워크의 외부 IP가 표시되는 것이 정상입니다. 먼저 해당 요청에 어떤 아웃바운드가 적용돼야 하는지 확인한 뒤 접속 결과를 살펴보는 편이 정확합니다. 낯선 확인 페이지에 구독 주소, 계정 정보, 전체 설정을 입력하지 마세요. 연결 여부를 확인하는 데는 일반 웹 요청이면 충분합니다.

클라이언트 테스트는 성공하지만 브라우저에서 웹 페이지가 열리지 않는다면 먼저 다른 도구가 시스템 프록시 설정을 바꿨는지, 브라우저 확장 프로그램이 시스템 설정을 덮어쓰는지 확인하세요. 다음으로 로컬 리스닝 포트와 시스템 프록시가 가리키는 주소가 일치하는지 살펴본 뒤 라우팅과 DNS를 확인합니다. 한 번에 조건 하나만 바꾸고 새 페이지를 열어 다시 확인하며 변경 전 설정도 기록해 두세요. 전체 점검 방법은 연결됐지만 인터넷이 안 될 때 확인할 항목을 참고해 사용 가능한 설정을 더 찾기 어려운 상태로 바꾸지 않도록 하세요.

사용 종료: 프록시를 복구한 뒤 종료

macOS에서 사용을 마칠 때는 먼저 v2rayN에서 ‘시스템 프록시 해제’를 선택한 다음 클라이언트를 완전히 종료하세요. 종료 후 일반 웹 페이지를 다시 열어 요청이 중지된 로컬 리스닝 포트로 계속 전달되지 않는지 확인합니다. 컴퓨터를 덮거나 창을 닫거나 프로세스를 강제 종료하는 것만으로는 시스템 프록시가 원래 상태로 돌아오지 않을 수 있습니다. 다시 연결했을 때 모든 웹 페이지가 열리지 않는다면 클라이언트를 재설치하기 전에 시스템 프록시부터 확인하세요.

v2rayNG 사용자는 연결 중지 버튼을 누르고 시스템의 VPN 아이콘이 사라졌는지 확인한 뒤 일반 네트워크 접속을 확인하세요. 화면을 끈 뒤에만 연결이 끊기고 화면이 켜져 있을 때는 정상이라면 v2rayNG의 배터리 및 백그라운드 실행 제한을 확인하세요. 백그라운드 제한 문제를 구독 만료와 혼동하지 마세요. 구독 업데이트, 대상 서버 실행, 예상한 웹 접속, 종료 후 네트워크 복구까지 확인하면 첫 설정이 완료된 것입니다.

V2Ray 클라이언트 다운로드