Windows
v2rayN데스크톱 버전은 크로스 플랫폼 인터페이스를 제공하며, 클래식 WPF 버전은 익숙한 조작 방식을 유지합니다. 새로 설치한다면 먼저 데스크톱 버전을 살펴보고, 기존 설정과 사용 방식이 있다면 인터페이스 차이를 비교한 뒤 결정하세요. 설치 후에는 클라이언트가 코어를 정상적으로 실행하는지 확인하고 구독을 가져오세요. 프로그램이 실행됐다는 사실만으로 프록시가 작동한다고 판단해서는 안 됩니다.
운영체제에 맞는 클라이언트를 선택하고 한국어 안내에 따라 구독을 가져온 다음 라우팅과 DNS 설정을 확인하세요. 먼저 연결을 확인하고 항목별로 조정하면 됩니다.
데스크톱에서는 v2rayN, Android 기기에서는 v2rayNG를 먼저 확인하세요. V2Fly 코어가 필요하다면 v2flyNG도 살펴볼 수 있습니다. 설치 파일은 운영체제와 프로세서에 따라, 연결 방식은 설정과 코어에 따라 달라집니다. 두 가지를 나눠서 확인하면 잘못 선택할 가능성이 줄어듭니다. 다운로드 페이지에서 각 파일과 설치 요구 사항을 확인하고, 이 페이지에서는 적합한 방향을 찾아보세요.
클라이언트는 설정을 저장하고 코어를 실행하며 트래픽 진입점을 지정합니다. 사용할 수 있는 원격 서비스를 자동으로 만들어 주지는 않습니다. 시작하기 전에 사용 권한이 있는 구독 주소나 서버 정보를 준비하세요. 기존 설정을 옮긴다면 그룹과 사용자 지정 라우팅을 먼저 보존한 뒤 설치하거나 마이그레이션하세요. 처음 사용한다면 안내에 따라 단일 연결부터 확인하고, 고급 옵션을 한꺼번에 켜지 않는 편이 좋습니다.
데스크톱 버전은 크로스 플랫폼 인터페이스를 제공하며, 클래식 WPF 버전은 익숙한 조작 방식을 유지합니다. 새로 설치한다면 먼저 데스크톱 버전을 살펴보고, 기존 설정과 사용 방식이 있다면 인터페이스 차이를 비교한 뒤 결정하세요. 설치 후에는 클라이언트가 코어를 정상적으로 실행하는지 확인하고 구독을 가져오세요. 프로그램이 실행됐다는 사실만으로 프록시가 작동한다고 판단해서는 안 됩니다.
먼저 시스템의 ‘이 Mac에 관하여’에서 칩을 확인하고 Apple Silicon 또는 Intel에 맞는 항목을 선택하세요. 구독을 가져온 뒤 시스템 프록시가 켜져 있는지, 브라우저가 시스템 설정을 따르는지 확인합니다. TUN이 필요할 때만 권한을 별도로 설정하세요. 처음부터 시스템 프록시와 가상 네트워크 인터페이스를 함께 켜면 원인을 파악하기 어려워질 수 있습니다.
v2rayNG는 Xray 코어를 사용하며, v2flyNG는 V2Fly 코어를 사용하는 대안입니다. 비교적 최신 스마트폰이라면 arm64를 먼저 확인하고, 아키텍처를 모르면 기기 정보를 확인하거나 범용 패키지를 고려하세요. 처음 연결할 때는 시스템 VPN 권한을 승인해야 합니다. 백그라운드로 전환한 뒤 연결이 끊긴다면 배터리 최적화, 백그라운드 권한, VPN 통로를 사용하는 다른 앱을 확인하세요.
배포판의 패키지 형식에 따라 deb 또는 rpm을 선택한 뒤 프로세서 아키텍처를 확인하세요. 그래픽 클라이언트의 시스템 프록시 설정이 터미널 프로그램에도 적용되는 것은 아닙니다. 각 앱이 프록시를 사용하는지 따로 확인해야 합니다. 브라우저에서는 접속되지만 명령줄에서는 안 된다면 서버 설정 전체를 바꾸기 전에 해당 프로그램의 프록시 설정과 환경 변수를 살펴보세요.
먼저 세 가지 계층을 구분하세요. 앱은 요청을 로컬 인바운드로 전달하고, 코어는 규칙에 따라 아웃바운드를 선택하며, DNS는 연결에 필요한 주소를 조회합니다. 클라이언트는 이 설정을 그래픽 인터페이스에서 관리합니다. 문제가 생기면 같은 구독을 반복해서 가져오기보다 이 경로를 따라 점검하는 편이 효과적입니다.
구독을 이용하면 여러 서버 설정을 하나의 업데이트 경로에서 관리할 수 있습니다. 먼저 그룹을 만든 다음 사용 권한이 있는 주소를 붙여 넣고, 업데이트 후 목록에 실제 설정이 나타났는지 확인하세요. 일반 업데이트에 실패하면 기존 연결이 작동하는 경우 프록시를 통한 업데이트를 시도할 수 있습니다. 구독 주소에는 접속 정보가 포함될 수 있으므로 스크린샷이나 공개 로그에 노출하지 마세요. 설정을 하나씩 입력하는 것보다 그룹을 사용하면 출처와 업데이트 범위를 관리하기 쉽습니다. 다만 사용자 지정 메모, 정렬 순서, 라우팅은 별도로 백업하세요. 원격 업데이트가 로컬 설정까지 영구 보관해 주는 것은 아닙니다. 오른쪽 예시는 JSON에서 URL을 저장하는 방식이며, 클라이언트 구독 파일 형식이 아닙니다.
{
"url": "https://example.com/sub"
}
VMess, VLESS, Trojan은 서로 다른 아웃바운드 프로토콜이며 임의로 바꿔 쓸 수 있는 라벨이 아닙니다. 가져온 뒤에는 포트, 전송 방식, TLS 같은 보안 설정도 확인하세요. 프로토콜이 같더라도 모든 매개변수가 호환되는 것은 아닙니다. 그래픽 클라이언트에서는 여러 설정을 저장하고 전환할 수 있지만, 실제 실행 여부는 선택한 코어에 달려 있습니다. 먼저 서버에서 제공한 매개변수를 그대로 사용하고 연결에 성공한 뒤 전송 옵션을 조정하세요. 오른쪽은 direct와 block의 기본 아웃바운드 예시로, 라우팅에서 tag를 참조하는 방식을 이해하는 데 도움이 됩니다. 원격 서버 정보는 포함되어 있지 않으므로 사용할 수 있는 프록시 설정을 대신하지 않습니다.
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom"
},
{
"tag": "block",
"protocol": "blackhole"
}
]
}
라우팅은 연결을 어떤 아웃바운드로 보낼지 결정합니다. 규칙은 위에서 아래로 검사되므로 예외 규칙은 대체로 범위가 넓은 규칙보다 앞에 둡니다. geosite는 도메인 목록, geoip는 IP 주소 목록을 사용하며 각각 관련 데이터베이스가 필요합니다. 처음에는 로컬 네트워크 주소를 직접 연결하는 규칙처럼 명확한 항목만 두고 필요한 도메인을 하나씩 추가하세요. 모든 트래픽을 같은 경로로 보내는 것보다 분할 라우팅을 사용하면 로컬 서비스에 미치는 영향을 줄일 수 있지만, 규칙 순서와 아웃바운드 태그를 관리해야 합니다. 예시의 direct는 실제 아웃바운드에 존재해야 합니다. 수정 후에는 구체적인 대상에 규칙이 적용되는지 확인하세요. 규칙이 저장됐다는 사실만으로 작동한다고 판단하지 마세요.
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}
DNS 설정은 주소 조회 서버를 입력하는 데 그치지 않습니다. 누가 조회를 요청하는지, 어떤 경로로 전달되는지, 조회 결과가 라우팅에 어떻게 반영되는지도 관련됩니다. 코어에 내장된 DNS가 시스템의 모든 앱에서 자동으로 사용되는 것은 아닙니다. 도메인 접속에 실패하면 먼저 이름 조회 오류인지 연결 오류인지 구분한 뒤 조회 정책과 실제 아웃바운드를 확인하세요. 조회 서버를 계속 바꾸기보다 앱·시스템·코어의 역할을 분명히 나누는 편이 도움이 됩니다. 예시는 서버 목록과 IPv4 조회 정책을 작성하는 방법이며 모든 네트워크에 권장되는 값은 아닙니다. 수정 전에 기존 설정을 기록하고 한 번에 한 항목씩 바꿔야 무엇이 영향을 줬는지 알 수 있습니다.
{
"dns": {
"servers": [
"1.1.1.1",
"localhost"
],
"queryStrategy": "UseIPv4"
}
}
시스템 프록시는 시스템 설정을 따르는 앱이 로컬 프록시를 사용하게 합니다. TUN은 가상 네트워크 인터페이스로 트래픽을 처리하므로 필요한 권한과 적용 범위가 다릅니다. 처음에는 시스템 프록시로 연결을 확인한 뒤 필요에 따라 TUN을 살펴보세요. 오른쪽은 로컬 SOCKS 인바운드 예시이지 TUN 설정이 아닙니다. 루프백 주소에서 수신하면 이 기기에서 시작된 연결만 허용됩니다. 로컬 네트워크 전체에 수신을 개방하는 것보다 접근 범위를 제어하기 쉽습니다. 다른 기기의 연결이 꼭 필요하다면 방화벽, 인증, 네트워크 경계도 함께 확인하세요. 수신 주소를 모든 인터페이스로 바꾸는 것만으로 설정이 끝나는 것은 아닙니다.
{
"inbounds": [
{
"tag": "socks-in",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"udp": true
}
}
]
}
클라이언트 인터페이스와 프록시 코어는 서로 다른 역할을 합니다. 인터페이스에 옵션이 표시되더라도 현재 코어가 해당 필드를 인식한다는 뜻은 아닙니다. 코어를 바꾸기 전에 설정에서 사용하는 프로토콜, 전송 방식, 보안 기능을 확인하고 코어의 지원 범위를 살펴보세요. 이름만 비교하는 것보다 시작 로그를 확인하면 지원되지 않는 필드나 매개변수를 더 정확히 찾을 수 있습니다. 작동하는 설정을 별도로 보관하고, 코어를 바꾼 뒤에는 최소한의 연결부터 테스트한 다음 사용자 지정 라우팅과 DNS를 복원하세요. 오른쪽은 일반적인 로그 수준 예시이지 코어 선택 스위치가 아닙니다. 코어는 보통 클라이언트 설정에서 선택하며 JSON에 임의의 필드를 추가한다고 바뀌지 않습니다.
{
"log": {
"loglevel": "warning"
}
}
구독이 업데이트됐는데도 접속할 수 없다면 먼저 유효한 설정을 선택했는지, 코어 시작 로그에 오류가 있는지 확인하세요. 다음으로 앱이 실제로 로컬 인바운드에 연결하는지 살펴보고, 마지막으로 라우팅에서 선택한 아웃바운드와 도메인 조회를 점검합니다. TCP 포트에 연결할 수 있다는 것은 핸드셰이크가 시작될 수 있다는 뜻일 뿐, 프로토콜 연결 전체가 성공했다는 뜻은 아닙니다. 테스트 대상 자체에 접근할 수 없어 실패할 수도 있습니다. ‘시간 초과’라고만 기록하기보다 원래 오류 메시지를 보존하면 문제를 찾기 쉽습니다.
설정 레퍼런스의 JSON은 필드 간 관계를 설명하기 위한 예시입니다. 클라이언트는 보통 인터페이스 설정을 바탕으로 실행 설정을 생성하므로 임시 생성 파일을 직접 수정하면 다음 실행 때 덮어써질 수 있습니다. 계속 유지할 규칙은 클라이언트가 지원하는 사용자 지정 설정에 추가하고, 변경 후 생성된 결과를 확인하세요. 전체 필드 설명은 인바운드 섹션부터 읽고, 처음 설정한다면 구독 가져오기 안내를 따라가세요.
일상적인 대화에서 ‘V2Ray’는 넓은 의미의 범주로 쓰이곤 합니다. 하지만 실제 설정에서는 프로젝트 생태계, 프록시 코어, 그래픽 클라이언트를 구분하는 편이 좋습니다. Project V는 모듈형 프록시 도구의 기반을 제공하며, 인바운드는 요청을 받고 라우팅은 경로를 결정하고 아웃바운드는 연결을 처리합니다. V2Fly는 V2Ray의 커뮤니티 개발을 이어가고, Xray는 별도의 코어 계열로 발전했습니다. 기술적 배경을 공유하지만 각자 기능이 발전해 왔으므로 이름이 비슷하다고 설정이 항상 호환되는 것은 아닙니다.
클라이언트는 조작 화면을 제공하고 코어는 연결을 처리합니다.v2rayN은 구독, 서버 목록, 시스템 프록시, 설정 옵션을 데스크톱 인터페이스에 모아 해당 코어를 실행합니다. v2rayNG는 Android 기기용으로 Xray 코어를 사용하고, v2flyNG는 V2Fly 코어 계열을 제공합니다. 세 클라이언트 모두 소스 코드가 공개된 소프트웨어 프로젝트입니다. 기기를 먼저 확인하고 설정 요구 사항을 살펴보세요. 이름을 통일하려고 기기마다 같은 인터페이스를 억지로 맞출 필요는 없습니다.
프로토콜 지원은 세부 기능까지 확인해야 합니다. VMess, VLESS, Trojan은 프로토콜 선택을 가리키며, 전송 방식과 TLS·REALITY 같은 보안 설정은 별개의 요소입니다. 설정을 실행할 수 있는지는 클라이언트가 올바르게 가져오는지, 코어가 인식하는지, 서버 매개변수가 일치하는지에 달려 있습니다. ‘VLESS 지원’만으로 특정 전송 방식과 보안 옵션을 포함한 설정의 호환성을 판단할 수는 없습니다. 실행에 실패하면 클라이언트를 계속 바꾸기보다 먼저 오류 필드를 확인하고 지원 범위를 대조하세요.
오픈 소스 라이선스도 프로젝트별로 확인해야 합니다. v2rayN·v2rayNG·v2flyNG는 GPL 계열 라이선스를 사용하고, V2Fly와 Xray 코어 프로젝트는 MPL 2.0을 사용합니다. 라이선스는 소스 코드의 사용·수정·배포 조건을 설명하며 원격 서비스 이용 권한과는 별개입니다. 구독, 서버, 네트워크에도 각각 관리 범위가 있습니다. 일상적으로 사용하는 데 모든 라이선스 조항을 살펴볼 필요는 없지만 코드를 재배포하거나 수정·통합하려면 ‘오픈 소스’에 조건이 없다고 단정하지 말고 해당 프로젝트의 라이선스 전문을 확인하세요.
업데이트도 대상별로 나뉩니다. 클라이언트 업데이트는 인터페이스와 통합 기능을 바꾸고, 코어 업데이트는 프로토콜 구현에 영향을 줍니다. 구독 업데이트는 원격 설정을 바꾸며 규칙 데이터베이스 업데이트는 도메인 및 IP 목록을 갱신합니다. 네 가지 업데이트는 서로 다른 문제를 해결하므로 오류가 났다고 한꺼번에 실행할 필요는 없습니다. 특정 사이트의 라우팅이 잘못됐다면 규칙 순서와 데이터베이스를 먼저 확인하세요. 코어가 지원되지 않는 필드를 보고한다면 코어 기능을 살펴보고, 구독 그룹 하나만 업데이트에 실패했다면 주소와 권한, 업데이트 경로부터 확인하세요.
한 번에 완벽하게 설정하기보다 문제가 생겼을 때 되돌릴 수 있도록 설정을 보관하는 편이 현실적입니다. 변경 전에 현재 아웃바운드, 라우팅 모드, DNS, 프록시 진입점을 기록하고 한 번에 한 묶음씩 수정하세요. 브라우저 접속을 확인한 뒤 필요한 다른 앱도 테스트합니다. 백그라운드 앱, 게임, 명령줄 프로그램이 모두 시스템 프록시를 따르는 것은 아닙니다. TUN을 켜면 모든 네트워크 상황이 자동으로 처리된다고 가정해서도 안 됩니다. 트래픽 진입점과 라우팅, DNS는 기기 환경에 맞춰 검증해야 합니다. 인터페이스의 스위치 상태는 설정을 나타낼 뿐 결과를 보장하지 않습니다.
연결 테스트 결과가 무엇을 의미하는지 알아야 합니다. TCPing은 포트 연결 가능성을 확인하는 데 가깝고, 실제 연결 테스트는 프로토콜 핸드셰이크와 테스트 대상까지 확인합니다. 테스트 결과에는 로컬 네트워크, 서버 상태, 이름 조회, 대상 서버의 응답이 모두 영향을 줍니다. 한 번 성공했다고 모든 앱이 작동하는 것은 아니며, 한 번 실패했다고 클라이언트에 문제가 있다고 단정할 수도 없습니다. 설정 선택, 코어 실행, 프록시 모드 확인, 대상 접속, 로그 점검 순서로 테스트 절차를 고정하세요. 같은 절차를 유지해야 결과를 비교할 수 있습니다.
한국어 안내에서는 ‘사용 방법’과 ‘설정 이유’를 나눠 설명합니다. 사용법은 설치 후 이어지는 작업 순서를, 설정 레퍼런스는 필드와 설정 예시를, 문제 해결은 증상에 따른 점검 범위를, 기술 노트는 특정 작동 원리를 다룹니다. 이 사이트는 독립적인 클라이언트 정보 사이트이며 원격 연결 서비스를 제공하지 않습니다. 사용할 권한이 있는 설정을 준비한 뒤 기본 연결부터 확인하고, 필요할 때 복잡한 분할 라우팅을 설정하세요. 당면한 문제에 맞춰 읽으면 되므로 모든 문서를 한 번에 읽을 필요는 없습니다.
구독을 가져왔는데도 연결되지 않나요?현재 선택한 설정과 코어 로그를 확인한 뒤 시스템 프록시를 살펴보세요. 자세한 절차는 연결 문제 해결에서 확인할 수 있습니다.
브라우저에서는 되는데 다른 앱에서는 안 되나요?앱이 시스템 프록시를 사용하는지, 자체 프록시 설정이 있는지 확인한 뒤 TUN 사용 여부를 결정하세요. 진입점과 트래픽 범위는 인바운드 설정 안내를 참고하세요.
규칙을 설정했는데 예상대로 라우팅되지 않나요?매칭 순서와 아웃바운드 태그, 데이터베이스를 먼저 확인하세요. 도메인이 라우팅에 들어가기 전에 이미 조회됐는지도 살펴보세요. 자세한 내용은 라우팅 규칙 레퍼런스에서 확인할 수 있습니다.
네트워크를 바꾼 뒤 도메인 접속에 문제가 생겼나요?이름 조회 오류와 연결 오류를 구분해 기록하고 DNS 조회 경로를 확인한 다음 설정을 하나씩 되돌리세요. 관련 필드는 DNS 설정 섹션에서 확인할 수 있습니다.
기본 연결을 확인한 다음 필요한 주제를 살펴보세요. 아래 세 문서에서는 최초 연결 확인, 코어 선택, FakeDNS를 각각 설명해 서로 다른 계층의 설정을 한꺼번에 조정하지 않도록 돕습니다.
예약된 주소 대역의 가상 IP로 도메인 정보를 보존하는 FakeDNS의 작동 방식과 sniffing·TUN 모드의 연동 방법을 설명합니다. 활성화할 만한 상황과 오히려 문제를 일으킬 수 있는 경우도 살펴봅니다.
읽을거리: FakeDNS 작동 원리Project V 이후 V2Fly와 Xray 두 계열이 어떻게 나뉘었는지 살펴보고 VLESS·XTLS·REALITY 등의 기능 지원 차이를 비교합니다. v2rayNG와 v2flyNG 중 무엇을 선택할지도 안내합니다.
읽을거리: Xray와 V2Fly 코어 비교구독을 가져온 뒤 먼저 할 일을 안내합니다. TCPing과 실제 연결 테스트 결과의 차이를 알아보고, 사용할 서버를 선택한 다음 시스템 프록시 모드에서 브라우저로 접속해 트래픽이 프록시를 통하는지 확인하세요.
읽을거리: v2rayN 첫 연결 확인