v2rayN 첫 설치 설정 체크리스트: Windows·macOS 공통 항목과 주의사항

설치 파일 선택: 운영체제, 아키텍처, 인터페이스 버전

v2rayN은 노드를 관리하고 프록시 코어를 실행하며 시스템 프록시를 설정하는 데스크톱 클라이언트입니다. 설치를 마쳤다고 바로 사용할 수 있는 노드가 생기는 것은 아닙니다. 처음 다운로드할 때는 파일 크기만 보지 말고 운영체제와 프로세서 아키텍처를 확인하세요. Windows의 x64와 ARM64, macOS의 Intel과 Apple 칩은 각각 다른 빌드에 해당합니다. 화면이 열리더라도 포함된 코어가 기기에 맞는다는 뜻은 아닙니다.

• Windows: 「설정」→「시스템」→「시스템 정보」에서 「시스템 종류」에 표시된 프로세서 아키텍처를 확인하세요. 일반적인 Intel·AMD 데스크톱은 보통 x64를 선택하며, ARM 기기는 다운로드 페이지의 안내에 따라 선택해야 합니다.
• macOS: Apple 메뉴→「이 Mac에 관하여」에서 「칩」 또는 「프로세서」를 확인하세요. Apple 칩 기기는 해당 ARM64 빌드를, Intel 기기는 해당 x64 빌드를 선택하세요.
• 인터페이스 버전: 크로스 플랫폼 데스크톱 버전은 Windows, macOS, Linux용이며 클래식 WPF 버전은 Windows용입니다. 두 버전의 메뉴 배치는 완전히 같지 않으므로 한 버전의 버튼 위치를 다른 버전과 픽셀 단위로 비교하지 마세요.

설치 위치: 압축을 완전히 푼 다음 실행

압축 파일은 압축 프로그램의 미리보기 창에서 바로 실행할 수 없습니다. 기본 프로그램은 보통 같은 폴더에 있는 코어, 리소스, 설정 파일도 필요합니다. 실행 파일 하나만 따로 꺼내면 화면은 열려도 코어 프로세스를 불러오지 못할 수 있습니다. 설치 프로그램, 압축 파일, 디스크 이미지의 설치 방법은 다르므로 선택한 파일의 안내를 따르세요.

1. 파일 형식 확인

   설치 프로그램은 안내에 따라 설치하고, 압축 파일은 먼저 지정한 폴더에 완전히 풀어 주세요. macOS에서 디스크 이미지 파일을 제공하는 경우, 이미지를 연 뒤 앱을 「응용 프로그램」으로 옮기세요. 마운트된 이미지에서 계속 실행하지 마세요.

2. 고정된 위치에 저장

   Windows 압축 해제 버전은 D:\Apps\v2rayN처럼 쓰기 가능한 폴더에 둘 수 있습니다. 임시 폴더, 압축 프로그램의 미리보기 폴더, 동기화 폴더는 피하세요. 경로에 한글이 있다고 무조건 문제가 되는 것은 아니며, 폴더에 쓸 수 있고 파일이 온전한지가 중요합니다.

3. 실행 관련 알림 처리

   Windows에서 런타임이 없다는 알림이 뜨면 이름과 아키텍처를 확인한 뒤 해당 패키지 안내에 따라 설치하세요. 임의로 DLL 파일을 다운로드하지 마세요. macOS에서 개발자를 확인할 수 없다는 알림이 뜨면 먼저 출처를 확인하고, 「시스템 설정」→「개인정보 보호 및 보안」에서 해당 앱을 허용하는 항목이 있는지 살펴보세요.

4. 처음에는 일반 권한으로 실행

   먼저 일반 사용자 권한으로 실행해 시스템 프록시 모드만 테스트하세요. TUN은 아직 켜지 말고, 모든 문제를 해결하려고 곧바로 관리자 권한을 부여하지도 마세요. 권한 문제와 노드 문제를 구분하기 쉽습니다.

5. 실행 정보 기록

   「도움말」→「정보」에서 클라이언트 버전을 기록하고, 로그에서 코어 이름과 버전을 확인하세요. 한 번 종료한 뒤 다시 열어 노드가 그대로 있는지 살펴보고 설정이 정상적으로 저장되는지도 확인하세요.

코어 로딩: 화면 실행과 프록시 준비 상태를 따로 확인

v2rayN의 화면 프로세스와 실제 트래픽을 전달하는 코어 프로세스는 다릅니다. 노드를 선택해 활성 서버로 지정한 다음에도 코어가 정상적으로 시작되고 로컬 포트에서 연결을 수신하는지 확인해야 합니다. 로그의 「파일을 찾을 수 없음」, 「권한 부족」, 「주소가 이미 사용 중」은 각각 다른 문제를 가리킵니다. 연결 버튼을 반복해서 눌러도 해결되지 않습니다.

「설정」→「매개변수 설정」에서 현재 버전에 제공되는 코어 선택 또는 「Core 유형」 관련 항목을 찾아 노드에서 사용할 코어를 확인하세요. 화면 구성이 다르면 기능 이름과 실행 로그를 기준으로 확인하면 됩니다. 노드 이름에 V2Ray가 있다고 해서 모든 설정을 특정 코어로 바꾸지 마세요. VMess와 VLESS는 프로토콜 이름이고 Xray 등은 코어 구현체입니다. 노드 요구 사항에는 전송 방식과 보안 매개변수도 포함됩니다.

• 코어 파일이 없음: 필요한 코어가 포함된 전체 패키지를 다운로드했는지 확인하세요. 해당 빌드에서 코어를 별도로 준비해야 한다면 패키지 안내에 따라 지정 위치에 넣고, 파일 이름은 임의로 바꾸지 마세요.
• VLESS와 REALITY: 선택한 코어가 서버에서 요구하는 조합을 지원하는지 확인하세요. 서버 이름, 공개 키, 짧은 ID, flow 등은 구독 원본 값을 그대로 사용해야 하며 임의로 추측해 입력하면 안 됩니다.
• VMess와 시간: 로그에 인증 또는 시간 관련 오류가 표시되면 먼저 시스템 시간이 자동으로 동기화되는지 확인한 다음 노드 매개변수를 점검하세요. 시스템 시간이 크게 어긋나면 TLS 인증서 검증에도 영향을 줄 수 있습니다.
• 이전 프로세스 종료: 트레이 또는 메뉴 막대에서 다른 v2rayN을 먼저 종료한 다음 현재 버전을 실행하세요. 각 버전이 별도의 코어를 실행해 같은 포트를 놓고 충돌할 수 있습니다.

구독 가져오기: 출처를 확인한 뒤 노드 하나로 테스트

클라이언트 설치 파일에는 서버 연결 정보가 포함되어 있지 않습니다. 구독 주소는 서비스 제공자가 발급하며 보통 접속 인증 정보가 포함되므로 계정 비밀번호처럼 안전하게 보관해야 합니다. 전체 구독 링크를 공개 스크린샷, 게시판, 온라인 파싱 도구에 붙여 넣지 마세요. 도움을 요청할 때는 상태 코드와 오류를 설명하고 링크의 토큰은 숨기세요.

1. 「구독 그룹」→「구독 그룹 설정」을 열고 그룹을 추가한 다음 구분하기 쉬운 이름과 구독 URL을 입력하세요. 버전에 따라 추가 작업이 「추가」 또는 「+」로 표시될 수 있습니다.
2. 저장한 뒤 「구독 그룹」 메뉴에서 현재 그룹을 업데이트하세요. 처음에는 사용할 프록시가 없으므로 먼저 프록시를 사용하지 않고 업데이트를 시도하세요. 직접 연결이 실패하고 사용 가능한 노드가 있을 때만 프록시를 통한 업데이트를 시도하세요.
3. 업데이트가 끝나면 서버 목록에 항목이 실제로 추가되었는지 확인하세요. 그룹 이름만 있고 서버가 없다면 응답 내용이 비어 있거나 구독이 만료되었거나 현재 버전에서 지원하지 않는 형식일 수 있습니다. 먼저 업데이트 로그를 확인하세요.
4. 노드를 선택하고 마우스 오른쪽 버튼 메뉴에서 「활성 서버로 설정」을 선택한 뒤 코어 로그를 확인하세요. 표에서 행을 선택하는 것만으로 실제 아웃바운드가 바뀌었다고 판단하지 마세요.

처음에는 노드 하나만 테스트하면 됩니다. 구독 전체를 반복해서 속도 측정할 필요는 없습니다. 지연 시간 테스트 성공은 해당 테스트 요청에 응답이 왔다는 뜻일 뿐, 브라우저가 프록시를 사용하거나 다운로드 속도가 특정 수준에 도달한다는 뜻은 아닙니다. 먼저 같은 노드로 실제 웹페이지를 열어 본 다음 다른 노드와 비교하면 테스트 결과를 재현하기 쉽습니다.

시스템 프록시와 포트: 브라우저 연결부터 기준으로 확인

시스템 프록시와 라우팅 분기는 서로 다른 설정입니다. 시스템 프록시는 앱이 요청을 로컬 프록시로 보낼지 결정하고, 라우팅 분기는 코어로 들어온 요청을 어디로 내보낼지 결정합니다. 첫 테스트에서는 v2rayN 기본 화면이나 트레이의 「시스템 프록시」 메뉴에서 「시스템 프록시 자동 설정」을 선택하고 일반 라우팅 설정은 그대로 두세요. 「시스템 프록시 사용」이 모든 프로그램의 트래픽을 프록시로 보낸다는 뜻은 아닙니다. 일부 앱은 시스템 프록시를 사용하지 않습니다.

Windows에서는 「설정」→「네트워크 및 인터넷」→「프록시」에서 시스템 프록시를 확인할 수 있습니다. macOS에서는 「시스템 설정」→「네트워크」→현재 연결→「세부사항」→「프록시」를 확인하세요. 시스템 메뉴 이름은 운영체제 버전에 따라 달라질 수 있습니다. 먼저 클라이언트에서 설정한 다음 시스템 설정에서 적용 결과를 확인하세요. 양쪽에서 동시에 바꾸면 혼동될 수 있습니다.

curl -I -x http://127.0.0.1:10808 https://example.com

위 명령은 10808에서 실제로 HTTP 또는 혼합 프록시를 제공하는 설정에만 사용할 수 있습니다. Windows에서는 명령 별칭의 영향을 피하려면 curl.exe를 사용하세요. 프록시를 명시해 요청하면 로컬 프록시가 작동하는지, 시스템 프록시 설정이 앱에 적용되지 않는지 구분할 수 있습니다. HTTP 응답이 돌아오면 해당 요청이 응답을 받았다는 뜻이지 속도 측정 결과는 아닙니다. 연결이 거부되면 먼저 수신 포트를 확인하고, TLS 또는 원격 연결 오류는 코어 로그와 함께 살펴보세요.

• 명령은 성공하지만 브라우저에서 실패: 브라우저에서 별도로 프록시를 설정하는 확장 프로그램을 잠시 끄고 다른 포트를 사용 중인지 확인하세요.
• 명령과 브라우저 모두 실패: 먼저 코어가 실행 중인지 확인한 다음 활성 노드와 로그를 살펴보세요. 곧바로 DNS, Mux, 모든 라우팅 규칙을 바꾸지 마세요.
• 일부 웹사이트만 실패: 도메인, 발생 시각, 적용된 라우팅을 기록한 뒤 DNS 또는 분기 설정을 확인하세요. 한 번의 웹페이지 접속 실패를 설치 파일 문제로 단정하지 마세요.

시작 프로그램과 종료: 프록시 설정이 남지 않도록 확인

시작 프로그램 등록은 연결을 검증한 뒤 설정하세요. 클라이언트 자동 실행, 시작 시 최소화, 시스템 프록시 자동 설정은 각각 별개의 옵션입니다. 화면이 백그라운드에서 실행 중이어도 시스템 프록시가 적용됐다는 뜻은 아니며, 시스템 프록시가 켜져 있어도 이전 활성 노드가 계속 작동한다는 보장은 없습니다. 처음 설정을 마친 뒤에는 한 번 종료 후 다시 실행하고, 한 번 로그아웃했다가 다시 로그인해 확인하세요.

• 클라이언트 설정: 「설정」→「매개변수 설정」에서 자동 시작 및 시작 시 최소화 항목을 찾아 필요에 따라 켜세요. 현재 빌드에 해당 옵션이 없다면 운영체제의 시작 프로그램 관리 기능을 사용하세요.
• Windows 설정: 「설정」→「앱」→「시작 프로그램」에서 시작 항목을 확인하세요. 바로 가기, 작업 스케줄러, 클라이언트 자동 시작을 동시에 등록하지 마세요.
• macOS 설정: 「시스템 설정」→「일반」→「로그인 항목」에서 로그인 시 앱을 열도록 허용했는지 확인하세요. 앱을 다른 위치로 옮긴 뒤에는 로그인 항목이 계속 유효한지도 다시 확인해야 합니다.
• 종료하기 전: 「시스템 프록시」 메뉴에서 「시스템 프록시 지우기」를 선택한 다음 클라이언트를 종료하세요. 이후 일반 웹페이지를 열어 직접 연결이 복구됐는지 확인하세요. 회사나 기관 네트워크의 프록시를 사용했다면 설정을 무조건 지우지 말고 원래 값으로 복원하세요.

첫 설치에서 자주 겪는 문제: 증상에 따라 한 번에 하나씩 확인

설치 완료 여부는 구체적으로 확인할 수 있습니다. 클라이언트를 다시 열어도 설정을 읽고, 활성 노드에서 코어가 실행되며, 브라우저가 시스템 프록시를 통해 접속되고, 종료 후 직접 연결이 복구되며, 다시 로그인했을 때 시작 프로그램 설정이 예상대로 작동하면 됩니다. 「연결이 안 됨」이라는 말만 남기기보다 클라이언트 버전, 코어 버전, 리스닝 포트, 실패 로그를 기록하면 원인을 찾는 데 도움이 됩니다. 설정을 백업할 때는 구독 인증 정보와 노드 키가 포함될 수 있으므로 공개하지 마세요.