Windows 10 / Windows 11에서 v2rayN을 처음 설치하는 사용자와, 6.x에서 업그레이드한 뒤 메뉴가 달라진 기존 사용자 모두를 위한 글입니다. 다 읽으면 하나의 완전한 경로를 얻을 수 있습니다. 시스템 버전에 맞춰 인터페이스 갈래를 고르고, 동기화와 권한 간섭을 받지 않는 디렉터리에 프로그램을 풀고, 구독이나 공유 링크로 노드를 가져오고, 시스템 프록시와 로컬 수신 포트가 모두 정상인지 확인합니다. 트레이 아이콘이 사라지거나 10808 포트가 점유되거나 부팅 후 자동 시작이 연결되지 않을 때, 노드만 계속 바꾸지 않고 순서대로 구체적인 단계를 찾아낼 수 있습니다.
두 인터페이스 버전, 어떻게 고를까
결론부터 말하면, 시스템이 Windows 10 1809 이상이면 데스크톱 버전 7.24.1을 설치하세요. 시스템이 Windows 7 SP1 / 8.1에 머물러 있거나 6.x의 설정 디렉터리를 계속 써야 할 때만 WPF 클래식 버전을 선택합니다. 두 버전은 기능 면에서 비슷하고, 차이는 시스템 요구 사항, 인터페이스 프레임워크, 이후 업데이트 세 가지에 있습니다.
데스크톱 버전 v2rayN 7.24.1
추천동일한 인터페이스로 Windows, macOS, Linux를 지원하며 코어는 기본 Xray이고 설정에서 v2ray 또는 sing-box로 전환할 수 있습니다. 파일 이름에 Desktop이 들어간 패키지는 런타임을 내장해 압축을 풀면 바로 실행되며, 새 코어와 새 프로토콜이 모두 이 라인을 따라갑니다.
적합: Windows 10 1809 이상, 새로 설치하거나 장기 사용 예정
WPF 클래식 버전 v2rayN 6.60
인터페이스가 WPF 기반이라 용량이 작고 실행이 빨라 저사양 PC에 더 적합하지만, 버전이 6.60에서 멈춰 이후 코어와 프로토콜 업데이트를 따라가지 않으며, 새 프로토콜 노드를 만나면 핸드셰이크 단계에서 바로 실패할 수 있습니다.
적합: Windows 7 SP1 / 8.1 구형 PC, 또는 기존 6.x 설정을 그대로 쓰고 싶은 경우
두 갈래의 설정 파일 형식은 서로 다릅니다. 데스크톱 버전은 노드, 구독, 인터페이스 환경설정을 프로그램 디렉터리의 guiConfigs 아래에 두므로 업그레이드할 때 이 디렉터리를 복사해 가면 됩니다. 6.60에서 7.x로 옮길 때는 먼저 이전 디렉터리를 백업한 뒤 복사하고, 프로그램이 읽지 못하면 구독을 다시 한 번 업데이트하는 편이 노드를 수동으로 채우는 것보다 훨씬 빠릅니다.
결론: 인터페이스 습관이 아니라 시스템 버전이 선택을 결정하게 하세요
Windows 10 1809 이후 환경이라면 6.60에 머물 이유가 없습니다. 코어와 프로토콜 업데이트는 7.x 라인에서만 이어지고, 구버전은 새 프로토콜 노드를 만나면 로그에 보통 핸드셰이크 단계 오류가 남아 노드를 바꿔도 해결되지 않습니다.
압축 해제 위치: 자리를 잘못 고르면 이후가 전부 문제
v2rayN은 압축 파일 형태로 배포되며 설치 과정이 없고 레지스트리도 건드리지 않습니다(선택 사항인 '부팅 시 자동 시작'만 시작 항목을 하나 기록합니다). 따라서 압축을 푼 위치가 이후 권한과 파일 점유 문제를 겪을지 결정합니다. 아래 다섯 가지는 중요도 순으로 정리했습니다.
- 경로는
D:\apps\v2rayN처럼 영문만, 공백 없이 유지하세요. 한글이나 공백이 포함된 경로는 코어가 명령줄 방식으로 실행될 때 파싱 오류를 일으키며, 로그에는 보통 설정 파일을 찾을 수 없다는 형태로 나타납니다. C:\Program Files또는C:\Program Files (x86)아래에 두지 마세요. 이 두 디렉터리는 기본적으로 관리자 권한이 있어야 쓸 수 있어 구독 파일과 실행 로그가 기록되지 않습니다.- 바탕 화면, 문서, OneDrive 같은 동기화 디렉터리에 두지 마세요. 동기화 프로세스가 프로그램 실행 중
guiConfigs디렉터리를 잠글 수 있어 구독 업데이트 시 파일이 사용 중이라는 오류가 납니다. - 압축을 푼 뒤 디렉터리에
v2rayN.exe와bin폴더가 있는지 확인하세요.bin아래에는 코어별로 xray, v2ray, sing-box 하위 디렉터리가 있습니다. 코어 파일이 없으면 프로그램은 열리지만 연결되지 않습니다. - 다운로드할 때는 파일 이름에 Desktop이 들어간 패키지를 우선 선택하세요. 런타임을 내장하고 있습니다. 런타임 의존 패키지를 받았다면 처음 더블클릭할 때 .NET 런타임이 없다는 안내가 뜨므로, 안내에 따라 한 번 설치한 뒤 다시 실행하세요.
첫 실행 시 두 가지 차단 지점
v2rayN.exe를 처음 더블클릭하면 Windows SmartScreen이 'Windows에서 PC를 보호했습니다' 창을 띄웁니다. '추가 정보'를 누른 뒤 '실행'을 누르세요. 디렉터리를 바꾸면 다시 한 번 뜹니다. 이어서 첫 연결 시 보안 프로그램이 코어 프로세스를 차단할 수 있으니 허용을 선택하거나, 압축을 푼 디렉터리 전체를 신뢰 목록에 추가한 뒤 프로그램을 다시 시작하세요. 로그가 코어 시작 줄에서 멈춰 있다면 거의 차단된 것입니다.
노드 가져오기부터 인터넷 연결까지: 다섯 단계
아래 경로는 새로 압축을 푼 데스크톱 버전 7.24.1 기준이며, 순서를 바꾸지 마세요. 먼저 프로그램이 설정 디렉터리를 만들게 하고, 노드를 가져온 다음, 마지막에 시스템 프록시를 켭니다.
- 첫 실행으로 설정 디렉터리 생성.
v2rayN.exe를 더블클릭하면 프로그램 디렉터리에guiConfigs폴더가 생기고, 그 안에 인터페이스와 프록시 설정을 저장하는guiNConfig.json, 노드와 구독을 저장하는guiNDB.db가 들어 있습니다. 이후 업그레이드와 이전은 모두 이 디렉터리를 중심으로 이루어집니다. - 노드 가져오기. 구독 방식: 왼쪽 '구독' → '구독 설정' → '추가'를 눌러 구독 주소를 붙여 넣고 저장한 뒤, 메인 화면으로 돌아와 '구독' → '구독 업데이트(프록시 사용 안 함)'를 클릭합니다. 단일 노드 방식: 공유 링크를 복사한 뒤 메인 화면에서 '서버' → '클립보드에서 일괄 URL 가져오기'를 선택합니다. 구독 주소가 직결로 열리지 않으면 '구독 업데이트(프록시 사용)'로 바꾸세요. 단, 현재 사용 가능한 노드가 하나 있어야 합니다.
- 지연 측정 후 노드 선택. 노드 목록에서 마우스 오른쪽 버튼을 눌러 '서버 실제 연결 지연 테스트'를 선택하고, 결과를 오름차순으로 정렬해 200ms 이내이면서 패킷 손실이 0인 노드를 우선 고른 뒤 더블클릭해 활성 노드로 지정합니다.
- 시스템 프록시 켜기. 트레이 아이콘을 마우스 오른쪽 버튼으로 클릭 → '시스템 프록시' → '시스템 프록시 자동 구성', 또는 '설정' → '매개변수 설정' → '시스템 프록시'에서 같은 항목을 선택합니다. 켜면 시스템 프록시가 127.0.0.1:10809를 가리킵니다.
- 확인. 브라우저에서 아무 웹페이지나 열어 보세요. 확실하지 않으면 메인 화면 하단의 '로그' 탭으로 이동해 코어 출력에 10808과 10809 수신 대기 두 줄이 나타나는지 확인합니다.
두 포트 모두 '설정' → '매개변수 설정' → '코어: 기본 설정'에서 변경할 수 있습니다. 변경한 뒤에는 시스템 프록시와 브라우저 확장 프로그램의 포트도 함께 수정해야 합니다. 그렇지 않으면 '프로그램은 연결됨으로 표시되는데 웹페이지가 열리지 않는' 상황이 생깁니다. 포트 불일치의 가장 전형적인 증상입니다.
트레이·권한·부팅 시 자동 실행: 자주 겪는 네 가지 문제
아래 네 가지 문제는 설치 단계에서 가장 자주 나타나며, 해답은 모두 구체적인 스위치와 디렉터리에 있습니다.
창을 닫았더니 트레이 아이콘도 사라졌는데 프록시는 켜져 있나요?
데스크톱 버전은 기본적으로 닫기 버튼을 눌러도 트레이로 최소화될 뿐입니다. 트레이 영역에 아이콘이 보이지 않으면 먼저 작업 표시줄의 '숨겨진 아이콘 표시'를 눌러 아이콘을 끌어내고, '설정' → '매개변수 설정' → '기본 설정'의 '창을 닫을 때 프로그램 종료'가 체크되어 있는지 확인하세요.
TUN 모드를 켠 뒤 관리자 권한이 필요하다는 메시지가 뜨나요?
TUN 모드는 가상 네트워크 어댑터를 만들어 전체 트래픽을 가로채므로 반드시 관리자 권한으로 실행해야 합니다. v2rayN.exe를 마우스 오른쪽 버튼으로 클릭해 '관리자 권한으로 실행'을 선택하거나, 바로 가기 속성 → '호환성'에서 '이 프로그램을 관리자 권한으로 실행'을 체크하세요. 시스템 프록시만 사용할 때는 관리자 권한이 필요하지 않습니다.
부팅 시 자동 시작을 체크했는데 부팅 후 연결되지 않나요?
'설정' → '매개변수 설정' → '기본 설정'의 '부팅 시 자동 시작'은 프로그램과 코어를 실행할 뿐이며, 시스템 프록시를 함께 켤지는 '시스템 프록시 자동 구성'이 결정합니다. 두 항목을 모두 체크하고, 마지막 종료 시 선택했던 노드가 여전히 사용 가능한지 확인하세요.
6.60에서 7.24.1로 바꿨더니 노드 목록이 비어 있나요?
두 버전의 설정 디렉터리 구조가 달라 프로그램 파일을 그대로 덮어써도 데이터가 이전되지 않습니다. 먼저 6.60을 종료하고 그 디렉터리의 guiConfigs를 7.24.1 프로그램 디렉터리로 통째로 복사한 뒤 실행하세요. 그래도 읽지 못하면 구독을 다시 업데이트하는 편이 가장 간단합니다.
연결되지 않을 때 점검 순서
점검은 '로컬 포트 → 시스템 프록시 → 노드' 순서로 진행하고, 처음부터 노드를 바꾸지 마세요. 첫 단계로 10808과 10809가 다른 프로그램에 점유되어 있는지 확인하고, 명령 프롬프트에서 다음을 차례로 실행합니다:
netstat -ano | findstr 10808
netstat -ano | findstr 10809
tasklist /fi "pid eq 12345"앞의 두 명령에 출력이 없으면 포트가 비어 있는 것입니다. 출력이 있으면 마지막 열의 PID를 기록해 두고, 세 번째 명령의 12345를 이 PID로 바꾸면 포트를 점유한 프로세스 이름을 볼 수 있습니다. 충돌이 확인되면 '설정' → '매개변수 설정' → '코어: 기본 설정'에서 로컬 수신 포트를 10810 / 10811로 바꾸고 클라이언트를 다시 시작하면 됩니다.
| 증상 | 로그 또는 안내 키워드 | 처리 |
|---|---|---|
| 트레이 아이콘은 정상인데 브라우저에서 웹페이지가 열리지 않음 | 로그에 이상 없음 | '시스템 프록시 자동 구성'인지 확인하고, 'Windows 설정' → '네트워크 및 인터넷' → '프록시'의 수동 프록시가 다른 프로그램에 의해 바뀌지 않았는지 점검 |
| 코어가 시작 직후 종료됨 | address already in use | 위 명령으로 점유 프로세스를 확인하거나, 로컬 수신 포트를 10810 / 10811로 바로 변경 |
| 모든 노드 시간 초과 | dial tcp ... i/o timeout | 실제 연결 지연을 다시 측정해 노드를 바꾸고, 구독 만료 여부도 확인 |
| 일부 웹페이지만 열리고 일부는 시간 초과 | 없음 | 라우팅 규칙을 확인해 대상 도메인이 규칙에 의해 직결로 분류되지 않았는지 점검 |
결론: 노드를 의심하기 전에 로컬 포트와 시스템 프록시부터 확인하세요
포트 점유와 시스템 프록시가 다른 프로그램에 의해 변경되는 두 가지 로컬 문제는 로그에 거의 흔적을 남기지 않지만, '연결 안 됨'의 가장 흔한 원인입니다. 이 두 가지를 먼저 정리한 뒤 노드를 바꾸면 점검 효율이 훨씬 높아집니다.
업그레이드와 삭제: 설정 디렉터리 처리 방법
v2rayN에는 설치 마법사가 없어 업그레이드와 삭제 모두 디렉터리 작업입니다. 순서를 틀리면 두 가지 잔여물이 남습니다. 무효가 된 시작 항목, 그리고 127.0.0.1:10809를 가리키는 시스템 프록시입니다. 아래 순서대로 하면 피할 수 있습니다.
- 업그레이드: 실행 중인 v2rayN을 먼저 종료하고, 새 버전 압축 파일을 다른 디렉터리에 푼 뒤, 이전 디렉터리의
guiConfigs를 통째로 복사합니다. 새 버전을 실행해 노드와 구독이 모두 있는지 확인한 다음 이전 디렉터리를 삭제하세요. - 삭제: 프로그램 종료 → 시스템 프록시 끄기 → '부팅 시 자동 시작' 체크 해제 → 프로그램 디렉터리 전체 삭제. 중간 두 단계를 빼먹으면 Windows 프록시 설정이 127.0.0.1:10809에 머물고, 시작 항목도 존재하지 않는 경로를 가리킵니다.
- 잔여물 확인: 'Windows 설정' → '네트워크 및 인터넷' → '프록시'를 열어 '프록시 서버 사용'이 꺼져 있는지 확인하고, '작업 관리자' → '시작 앱'에서 v2rayN 관련 항목이 없는지도 확인하세요.
guiConfigs 디렉터리에는 무엇이 들어 있나
구독 주소, 노드 정보, 라우팅 규칙, 인터페이스 환경설정이 모두 guiConfigs에 저장되므로, 이 디렉터리를 다른 사람에게 보내는 것은 모든 노드를 넘기는 것과 같습니다. 백업이나 이전 시 이 점을 전제로 처리하고, 클라우드 공유 디렉터리에 무심코 넣지 마세요.