사용 설명서 / 설치 및 설정
V2Ray 전체 플랫폼설치 및 설정 가이드
운영체제별 설치 방법과 설정 단계별 문제 해결 방법을 확인하세요. 데스크톱은 v2rayN을 중심으로, Android는 v2rayNG와 v2flyNG를 안내합니다.
이 페이지는 설정 항목을 확인하고 플랫폼별 차이를 파악하거나 잘못된 설정을 복구할 때 참고하는 안내서입니다. 처음 사용한다면 먼저 입문 가이드를 읽고 ‘구독 가져오기 → 서버 선택 → 프록시 설정 → 연결 확인’ 순서로 진행한 뒤, 필요한 항목을 이 페이지에서 찾아보세요. 설치 파일은 클라이언트 다운로드 페이지에서 받을 수 있습니다.
클라이언트 업데이트에 따라 메뉴 이름이나 위치가 달라질 수 있습니다. 메뉴 위치가 다르면 버튼 위치를 기준으로 찾기보다 ‘구독 그룹’, ‘시스템 프록시’, ‘라우팅 설정’, ‘로그’ 등 기능 이름으로 찾아보세요.
시작 전 준비와 설정 단계
운영체제·아키텍처·클라이언트 확인
설치 전에 운영체제와 프로세서 아키텍처를 확인한 뒤 다운로드할 파일을 선택하세요. Windows에서는 ‘설정 → 시스템 → 정보’에서 시스템 종류를 확인합니다. macOS에서는 Apple 메뉴의 ‘이 Mac에 관하여’에서 칩을 확인하세요. Linux에서는 시스템 설정의 장치 정보를 확인하고, Android에서는 기기 정보에서 OS 버전을 확인한 뒤 기기 사양을 살펴보세요. 설치 파일 크기로 기기 호환성을 판단하지 말고, 운영체제 이름이 같다고 아키텍처까지 같다고 단정하지 마세요.
데스크톱에서는 v2rayN을 우선 사용하세요. 세 데스크톱 운영체제의 설정 방식은 비슷하지만 권한, 시스템 프록시, 설치 파일 형식은 다릅니다. Android에서는 Xray 코어를 사용하는 v2rayNG를 먼저 고려하고, 기존 설정이 V2Fly 동작에 의존하는 경우 v2flyNG를 검토하세요. 그래픽 클라이언트는 서버·구독·시스템 연결을 관리하고, 코어는 실제 연결을 처리합니다. 인터페이스가 실행된다고 코어까지 정상 작동하는 것은 아닙니다.
구독 주소와 복구용 기록 준비
클라이언트는 서버를 제공하지 않습니다. 설정을 시작하기 전에 사용할 권한이 있는 구독 주소나 단일 공유 링크를 준비하고, 서비스 이용 기간이 남아 있는지와 제공업체가 요구하는 프로토콜 및 전송 매개변수를 확인하세요. 구독 주소에는 접속 정보가 포함될 수 있으므로 비밀번호처럼 관리해야 합니다. 스크린샷, 로그, 문의 내용에 전체 주소가 노출되지 않도록 하세요. 특히 앞부분만 가리고 쿼리 매개변수를 그대로 두지 마세요.
기존 클라이언트 설정이 있다면 현재 사용 중인 서버, 구독 그룹, 로컬 수신 포트, 라우팅 모드, DNS 설정을 먼저 기록하세요. 이전이 필요하면 클라이언트의 내보내기 또는 백업 기능을 사용하고, 백업 파일은 접근이 제한된 폴더에 보관하세요. 운영체제 프록시 설정의 기존 값도 기록해야 합니다. 기기에 회사 네트워크 프록시가 이미 설정되어 있을 수 있으므로 그대로 지우면 기존 업무 환경에 문제가 생길 수 있습니다.
혼동하기 쉬운 네 가지 단계
첫 번째는 구독 가져오기입니다. 클라이언트가 구독 주소에서 서버 정보를 가져올 수 있는지 확인합니다. 두 번째는 코어 실행입니다. 로컬 포트가 정상적으로 열렸는지 살펴봅니다. 세 번째는 트래픽 유입입니다. 앱이 시스템 프록시, 수동 프록시 또는 TUN을 통해 요청을 전달하는지 확인합니다. 네 번째는 아웃바운드 선택입니다. 코어에 들어온 연결이 라우팅 규칙에 따라 직접 연결, 프록시 연결 또는 차단되는지 확인합니다. 문제를 해결할 때는 각 단계를 차례로 점검하고 모든 이상을 서버 장애 탓으로 돌리지 마세요.
| 단계 | 주요 점검 항목 | 자주 하는 오해 |
|---|---|---|
| 구독 가져오기 | 주소, 권한, 업데이트 로그 | 업데이트 성공 = 연결 가능 |
| 코어 실행 | 시작 로그, 로컬 수신 포트 | 창이 열림 = 코어가 실행됨 |
| 트래픽 유입 | 시스템 프록시, 앱 설정, TUN | 시스템 프록시 설정 = 모든 앱의 트래픽 처리 |
| 라우팅 및 아웃바운드 | 규칙 순서, 대상 도메인, DNS | 전역 모드 = 모든 프로그램의 트래픽이 프록시로 전달됨 |
시스템 프록시는 운영체제의 프록시 설정을 따르는 앱에 주로 적용됩니다. 일부 프로그램은 별도의 네트워크 스택을 사용하므로 프록시 주소를 직접 입력해야 합니다. TUN은 가상 네트워크 인터페이스를 통해 더 많은 트래픽을 받지만 권한, 라우팅, DNS 설정이 함께 맞아야 합니다. 라우팅의 ‘전역 프록시’는 일반적으로 이미 클라이언트에 들어온 트래픽의 아웃바운드 경로만 바꿉니다. 시스템 프록시를 우회하는 프로그램까지 자동으로 프록시를 사용하게 하지는 않습니다.
처음 설정할 때는 트래픽 유입 방식 하나만 활성화하고, 먼저 시스템 프록시로 브라우저 연결을 확인한 다음 TUN을 고려하세요. 프록시, 가상 네트워크 어댑터 또는 네트워크 라우팅을 변경하는 다른 프로그램은 잠시 종료해 시스템 설정을 동시에 수정하지 않도록 합니다. 한 번에 하나씩 설정을 바꾸고 변경 전후 로그를 보관하세요. 연결이 확인된 다음 자동 업데이트나 앱별 라우팅 같은 추가 기능을 설정하면 됩니다.
작업 전에 시스템 시간이 정확한지, 디스크에 쓸 수 있는지, 설치 폴더에 공간이 충분한지도 확인하세요. 인증서 검증에는 정확한 시간이 필요하고, 설정 저장에는 폴더 권한이, 코어 실행에는 실행 파일이 제대로 압축 해제되어 있어야 합니다. 이런 기본 조건을 미리 확인하는 편이 설치 후 프로토콜을 계속 바꾸는 것보다 효과적입니다. 가장 간단한 설정 절차가 필요하면 입문 가이드를 확인하세요. 플랫폼별 제한 사항을 알아보려면 아래 내용을 계속 읽어보세요.
Windows: v2rayN 설치 및 프록시 설정
데스크톱 버전과 클래식 WPF 버전 선택
Windows 다운로드에서 v2rayN을 선택하세요. 데스크톱 버전은 크로스 플랫폼 인터페이스를 사용하고, 클래식 WPF 버전은 Windows 데스크톱 인터페이스를 사용합니다. 메뉴 배치는 다를 수 있지만 설정 목표는 같습니다. 다운로드 페이지에 표시된 운영체제 및 아키텍처 요구 사항에 맞춰 선택하세요. 이름에 모두 v2rayN이 들어간다고 두 버전의 파일을 같은 폴더에 덮어쓰거나 각 버전의 프로그램 구성 요소를 섞어 사용하지 마세요.
설치 프로그램을 사용한다면 안내에 따라 설치를 마친 뒤 시작 메뉴에서 실행하세요. 압축 파일로 배포되는 경우에는 현재 계정에서 쓸 수 있고 계속 보관할 폴더에 전체 압축을 푼 다음 주 프로그램을 실행하세요. 압축 파일 미리보기에서 바로 실행하거나 주 프로그램만 꺼내고 주변의 종속 파일을 빠뜨리지 마세요. 경로는 짧게 유지하고 동기화 폴더, 임시 다운로드 폴더, 추가 권한이 필요한 시스템 폴더는 피하는 것이 좋습니다.
처음 실행할 때 실행 환경이 없다는 메시지가 나오면 필요한 구성 요소와 아키텍처를 확인한 뒤 시스템에서 인정하는 경로로 설치하세요. 창이 바로 닫히면 보안 프로그램의 격리 기록, 시스템 이벤트, 클라이언트 로그를 먼저 확인하세요. 보안 기능을 모두 끄는 것이 우선 해결책은 아닙니다. 일반적인 시스템 프록시 설정에는 관리자 권한이 필요하지 않습니다. 시스템 수준 기능을 켤 때만 클라이언트 안내에 따라 권한을 높이세요.
구독 그룹을 만들고 서버 연결
‘구독 그룹 설정’에서 새 그룹을 추가하고 알아보기 쉬운 별칭을 입력한 다음, 전체 구독 링크를 ‘주소(url)’에 붙여 넣고 저장하세요. 이후 해당 그룹의 ‘구독 업데이트’를 실행합니다. 사용할 수 있는 프록시가 처음부터 없다면 보통 프록시를 사용하지 않고 업데이트를 시도합니다. 주소에 기존 연결이 필요한 경우에는 연결이 정상임을 확인한 뒤 프록시를 통한 업데이트를 선택하세요. 시작 단계에서 서로 의존하는 상황이 생기지 않도록 주의해야 합니다.
업데이트가 끝나면 목록이 방금 선택한 그룹에 속하는지 확인하고, 서버 하나를 선택해 활성 항목으로 지정하세요. 로그에서 설정 파싱 오류, 코어 시작 오류, 포트 충돌이 발생했는지 살펴봅니다. 지연 시간 테스트는 서버를 추리는 참고 자료일 뿐입니다. 테스트 방식과 실제 앱의 연결 방식이 다를 수 있으므로 최종 확인은 브라우저 접속과 로그로 해야 합니다. 테스트 한 번이 실패했다고 구독 가져오기도 실패했다고 단정하지 마세요.
시스템 프록시 설정 및 필요할 때 TUN 사용
작업 표시줄 알림 영역에서 v2rayN 메뉴를 열고 ‘시스템 프록시’에서 ‘시스템 프록시 자동 설정’처럼 시스템 프록시를 적용하는 항목을 선택하세요. 알림 영역에 아이콘이 보이지 않으면 숨겨진 아이콘 영역을 확인합니다. 그런 다음 Windows의 ‘설정 → 네트워크 및 인터넷 → 프록시’에서 클라이언트가 설정한 로컬 주소와 포트를 확인하세요. 메뉴 이름은 Windows 인터페이스 업데이트에 따라 달라질 수 있으므로 주소와 포트를 중점적으로 확인하면 됩니다.
‘시스템 프록시 지우기’는 클라이언트가 설정한 값을 되돌리는 기능이고, ‘시스템 프록시 변경 안 함’은 기존 값을 수정하지 않는다는 뜻입니다. 두 기능은 같지 않습니다. 수동 프록시를 사용하는 앱에는 클라이언트가 실제로 수신 중인 프로토콜과 포트를 입력해야 합니다. 원격 서버의 포트를 로컬 프록시 항목에 입력하면 안 됩니다. 브라우저 확장 프로그램이 시스템 프록시를 덮어쓸 수 있으므로 테스트할 때는 브라우저가 시스템 설정을 사용하도록 되돌리세요.
일반 프록시 연결을 확인한 다음 TUN을 켜는 것이 좋습니다. 화면 안내에 따라 관리자 권한이나 서비스 관련 요구 사항을 처리하고 가상 인터페이스와 코어 로그를 확인하세요. TUN을 켠 뒤 모든 연결이 끊기면 먼저 TUN을 끄고 네트워크가 복구되는지 확인한 다음 다른 가상 네트워크 어댑터, 회사 네트워크 클라이언트 또는 보안 정책과 충돌하는지 살펴보세요. 원인을 파악하기 어렵게 만들 수 있으니 서버 변경, DNS 수정, 드라이버 재설치를 한꺼번에 진행하지 마세요.
종료·업데이트 및 Windows 관련 문제
창을 닫아도 알림 영역으로 최소화될 뿐, 프로그램이 종료되지 않을 수 있습니다. 업데이트 전에 트레이 메뉴에서 완전히 종료하고 코어 프로세스가 끝났는지 확인한 다음 클라이언트가 지원하는 업데이트 방식이나 새 설치 파일을 사용하세요. 기존 설정 백업을 보관하고 이전 프로그램 구성 요소를 새 폴더에 그대로 덮어쓰지 마세요. 파일이 사용 중이라는 메시지가 나오면 정상적인 실행 세션을 먼저 종료하세요. 사용 중인 파일을 반복해서 강제 삭제하지 마세요.
비정상 종료 후 브라우저에서 인터넷에 연결할 수 없다면 시스템 프록시가 중지된 로컬 포트를 가리키고 있는지 확인하고, 필요하면 설치 전 기록해 둔 프록시 설정을 복원하세요. 창은 열리지만 설정을 저장할 수 없다면 설치 폴더의 쓰기 권한을 확인합니다. 부팅 직후 연결에 실패한다면 네트워크가 아직 준비되지 않았는지 살펴보세요. 수동 연결이 안정된 다음 부팅 시 실행과 자동 연결을 켜야 시작 순서 문제를 지속적인 연결 장애로 오해하지 않습니다.
최초 설치 시 필요한 구성 요소, 압축 해제 위치, 실행 전 점검은 v2rayN 최초 설치 및 초기 설정에서도 확인할 수 있습니다. 일부 앱만 프록시를 사용하지 않는다면 클라이언트 전체를 재설치하기보다 해당 앱의 네트워크 설정을 먼저 살펴보세요.
macOS: 칩 확인과 네트워크 권한
칩에 맞는 버전 설치 및 첫 실행
먼저 Apple 메뉴에서 ‘이 Mac에 관하여’를 여세요. Apple 계열 칩이 표시되면 Apple Silicon 설치 파일을, Intel 프로세서가 표시되면 Intel 설치 파일을 선택합니다. 다운로드는 macOS 클라이언트 다운로드에서 할 수 있습니다. 구입 연도가 아니라 기기 정보를 기준으로 아키텍처를 선택하세요. 같은 제품군에도 서로 다른 프로세서가 사용될 수 있으므로 설치 파일 이름만으로 실제 시스템 정보를 대신할 수는 없습니다.
다운로드한 디스크 이미지를 열고 화면 안내에 따라 앱을 ‘응용 프로그램’ 폴더로 옮긴 뒤 그곳에서 실행하세요. 마운트된 디스크 이미지에서 계속 실행하거나, 같은 이름의 사본을 여러 위치에 두고 번갈아 실행하지 마세요. 앱을 옮긴 뒤 디스크 이미지를 추출하고 응용 프로그램 폴더에 있는 사본을 실행 중인지 확인하세요. 그래야 다른 사본을 업데이트하는 일을 방지할 수 있습니다.
처음 실행할 때 시스템 보안 검사로 차단되면 파일 출처와 기기 아키텍처를 확인한 뒤 ‘시스템 설정 → 개인정보 보호 및 보안’의 안내를 살펴보세요. 출처를 명확히 확인한 앱에 한해 시스템에서 허용하는 실행 절차를 따르세요. 클라이언트 하나를 실행하려고 보안 검사를 전역으로 끄지 마세요. 파일 손상, 아키텍처 미지원, 구성 요소 누락 메시지는 각각 따로 확인해야 하며 모두 같은 권한 문제로 취급해서는 안 됩니다.
구독을 가져오고 활성 서버 확인
v2rayN에서 구독 관리 메뉴를 열고 ‘구독 그룹 설정’에서 새 그룹을 추가하세요. 별칭과 전체 주소를 입력하고 저장한 뒤 해당 그룹을 업데이트합니다. 붙여넣을 때 메신저에서 복사한 내용에 설명 문구, 줄바꿈, 한글 문장 부호가 포함되지 않았는지 확인하세요. 링크의 대소문자, 인코딩된 문자, 쿼리 매개변수는 그대로 유지해야 합니다. 주소를 보기 좋게 만들려고 직접 수정하지 마세요.
업데이트가 끝나면 서버를 선택해 현재 활성 항목으로 설정한 뒤 코어 로그를 확인하세요. 메뉴 막대 아이콘과 메인 창은 서로 다른 상태 정보를 표시할 수 있습니다. 창이 열려 있다는 것은 인터페이스가 실행 중이라는 뜻일 뿐, 포트나 설정 문제로 코어가 시작되지 않았을 수도 있습니다. 연결을 확인할 때는 명확한 테스트 대상을 하나 정하고 서버, 유입 방식, 라우팅 모드를 기록해 두세요. 그래야 이후 결과를 비교할 수 있습니다.
네트워크 서비스별 시스템 프록시 확인
클라이언트에서 시스템 프록시 자동 설정을 선택한 다음 ‘시스템 설정 → 네트워크’로 이동하세요. 현재 사용 중인 네트워크 서비스를 선택하고 세부 정보에서 ‘프록시’를 확인합니다. 무선 네트워크와 유선 네트워크는 서로 다른 서비스이므로 연결 방식을 바꾼 뒤에는 다시 확인해야 합니다. 연결되지 않은 서비스만 확인하거나, 한 서비스에 설정이 적용됐다는 이유로 모든 네트워크 인터페이스에 같은 설정이 적용됐다고 생각하지 마세요.
시스템 프록시의 로컬 주소와 포트는 클라이언트가 실제로 수신 중인 값과 일치해야 합니다. 일부 앱은 자체 프록시 설정을 사용하고, 다른 앱은 실행할 때만 시스템 프록시를 읽습니다. 설정을 변경한 뒤에는 테스트 앱을 완전히 종료하고 다시 실행하세요. 브라우저 프록시 확장 프로그램, 업무용 구성 프로파일, 다른 네트워크 도구도 설정을 덮어쓸 수 있으므로 현재 요청을 실제로 제어하는 항목이 무엇인지 먼저 확인하세요.
TUN을 켤 때는 클라이언트 안내에 따라 필요한 권한을 처리하고 로그에서 인터페이스와 라우팅이 정상적으로 설정됐는지 확인하세요. 설치 방식에 따라 권한 부여 절차가 다를 수 있으므로 다른 버전의 터미널 권한 부여 명령을 그대로 따라 하지 마세요. 권한을 반복해서 요청한다면 앱을 옮겼는지, 다른 사본을 실행했는지, 설정 폴더가 여전히 현재 계정 소유인지 먼저 확인하세요.
절전 모드 복귀·네트워크 전환·업데이트
노트북이 절전 모드에서 깨어난 뒤 기존 연결이 끊길 수 있습니다. 무선 네트워크, 휴대폰 핫스팟, 유선 네트워크 사이를 전환한 경우 특히 그렇습니다. 먼저 운영체제가 정상적인 네트워크에 연결됐는지 확인한 뒤 클라이언트 연결을 다시 시작하세요. 일반 시스템 프록시는 정상인데 TUN만 작동하지 않는다면 복귀 후 라우팅과 DNS를 집중적으로 확인하세요. 처음부터 구독을 삭제할 필요는 없습니다. 잠깐 발생한 네트워크 끊김과 설정 오류는 여러 번 테스트해 구분하세요.
업데이트 전에 메뉴 막대의 클라이언트를 완전히 종료하고 설정 백업을 보관한 뒤 앱을 교체하세요. 프로그램을 닫았는데도 인터넷에 연결할 수 없다면 현재 네트워크 서비스에 로컬 프록시 설정이 남아 있는지 확인합니다. 복구할 때는 처음 기록한 값을 기준으로 처리하세요. 가정용 네트워크에서는 수동 프록시를 끄는 편이 적절할 수 있고, 업무용 네트워크에서는 기존 프록시 주소를 복원해야 할 수 있습니다. 모든 프록시 설정을 무조건 지우는 방식은 일반적인 해결책이 아닙니다.
설치 후 구독을 저장할 수 없다면 앱 설정 폴더의 권한과 여유 공간을 확인하세요. 특정 네트워크에서만 실패한다면 서버와 설정을 그대로 둔 채 네트워크를 바꿔 다시 테스트합니다. 한 번에 조건 하나만 바꾸면 기기 권한, 로컬 네트워크 제한, 서버 연결 문제를 구분할 수 있습니다. 복구할 수 없는 설정 조합이 되지 않도록 주의하세요.
Linux: 패키지 형식·데스크톱 프록시·TUN
배포판과 아키텍처에 맞는 설치 파일 선택
Linux 다운로드에서 v2rayN을 선택하세요. Debian 계열 패키지 관리자를 사용하는 배포판은 deb를, RPM 계열 패키지 관리자를 사용하는 배포판은 rpm을 선택합니다. 프로세서 아키텍처가 일반적인 x64인지 arm64인지도 확인하세요. 패키지 형식과 프로세서 아키텍처는 별개의 조건이므로 둘 중 하나만 맞으면 안 됩니다. 파생 배포판은 해당 배포판의 설치 안내와 종속성 요구 사항을 따르세요.
그래픽 소프트웨어 설치 프로그램에서 패키지를 열면 시스템이 종속성을 처리해 설치를 완료할 수 있습니다. 종속성이 부족하다는 메시지가 나오면 설치 프로그램에서 구체적인 구성 요소 이름과 시스템 지원 범위를 확인하세요. 다른 배포판의 라이브러리 파일을 시스템 폴더에 복사하지 마세요. 클라이언트는 그래픽 프로그램이므로 정상적으로 사용하려면 데스크톱 세션이 필요합니다. 순수 명령줄 서버 환경은 이 안내의 대상이 아닙니다.
아키텍처를 모르겠다면 터미널에서 아래 읽기 전용 명령을 실행해 확인할 수 있습니다. 일반적으로 x86_64는 x64에, aarch64는 arm64에 해당합니다. 다른 결과가 나오면 강제 설치로 패키지 관리자의 아키텍처 검사를 우회하지 말고 기기 및 설치 파일의 지원 여부를 먼저 확인하세요. 이 명령은 환경을 확인할 뿐 네트워크 설정을 변경하지 않습니다.
uname -m
cat /etc/os-release
일반 사용자로 실행하고 구독 가져오기
설치 후 데스크톱 앱 메뉴에서 v2rayN을 실행하고 현재 로그인한 일반 사용자 계정으로 사용하세요. 그래픽 프로그램 전체를 관리자 권한으로 계속 실행하지 마세요. 클라이언트 설정, 캐시, 로그는 대개 사용자 환경에 저장됩니다. 서로 다른 권한으로 번갈아 실행하면 폴더 소유자가 바뀌어 설정 저장 실패, 실행 후 그룹 누락, 업데이트 오류가 발생할 수 있습니다.
‘구독 그룹 설정’에서 그룹을 추가하고 주소를 입력해 저장한 뒤 업데이트를 실행하세요. 처음 업데이트가 실패하면 로그의 네트워크 오류와 파싱 오류를 구분해서 확인합니다. 네트워크 오류는 현재 네트워크, DNS, 업데이트 경로를 살펴보고, 파싱 오류는 받은 내용이 클라이언트에서 인식할 수 있는 형식인지 확인하세요. 가져오기에 성공하면 활성 서버를 지정하고 코어 실행 결과를 확인하세요. 곧바로 TUN 설정으로 넘어가지 마세요.
데스크톱 시스템 프록시와 앱별 프록시
Linux는 데스크톱 환경마다 프록시 설정 위치가 다릅니다. GNOME에서는 보통 시스템 설정의 네트워크 프록시에서 관리하고, 다른 데스크톱에는 별도 모듈이 있을 수 있습니다. 클라이언트가 자동으로 설정할 수 있는 범위도 현재 데스크톱 세션에 따라 달라집니다. 그래픽 설정에 프록시가 표시되더라도 일부 앱은 이를 사용하지 않을 수 있습니다. 데스크톱 프록시를 따르는 앱으로 먼저 테스트한 뒤 시스템 프록시가 작동하는지 판단하세요.
터미널 환경 변수와 데스크톱 프록시는 서로 다른 연결 경로입니다. 브라우저가 연결된다고 터미널 프로그램에도 프록시가 설정됐다는 뜻은 아니며, 그 반대도 마찬가지입니다. 특정 앱에 프록시를 직접 설정하려면 먼저 클라이언트가 수신 중인 프로토콜과 포트를 확인하고 해당 앱이 지원하는 프록시 유형을 입력하세요. 출처를 알 수 없는 전역 환경 변수를 계속 사용하거나 구독 주소를 프록시 서버 주소로 입력하지 마세요.
로컬 포트 충돌은 클라이언트 로그나 시스템의 수신 대기 정보를 확인하면 알 수 있습니다. 아래 명령은 현재 TCP 수신 대기 포트를 표시하며 결과는 계정 권한에 따라 다를 수 있습니다. 클라이언트 설정에 지정된 실제 포트를 확인하세요. 다른 안내에서 본 숫자와 같을 필요는 없습니다. 이미 다른 프로그램이 사용 중이라면 해당 프로세스의 용도를 먼저 파악한 뒤 충돌 프로그램을 종료하거나 클라이언트 포트를 변경하세요.
ss -ltnp
TUN 권한·라우팅·데스크톱 연동
TUN은 시스템 네트워크 기능이 필요하며 구체적인 처리 방식은 클라이언트 설치 형식에 따라 다릅니다. 먼저 인터페이스에서 제공하는 권한 설정과 실행 절차를 사용하세요. 설치 폴더 전체에 광범위한 권한을 부여하거나 온라인에서 찾은 권한 설정 명령을 무작정 실행하지 마세요. TUN을 켠 뒤에는 인터페이스가 정상적으로 만들어졌는지 확인하고 트래픽 라우팅을 점검하세요. 로그에 표시된 권한 부족과 원격 연결 시간 초과는 서로 다른 문제입니다.
TUN을 켠 뒤 로컬 네트워크 서비스에 접속할 수 없다면 로컬 네트워크 트래픽 처리, 제외할 주소 범위, 라우팅 우선순위 설정을 확인하세요. 다른 터널이나 컨테이너 네트워크도 실행 중이라면 새 도구를 잠시 중지해 비교하고 기존 라우팅 정보를 보관하세요. 네트워크 인터페이스를 모두 삭제하지 마세요. 현재 연결이 끊길 수 있고 문제를 재현해 점검하기도 어려워집니다.
일부 데스크톱에서는 트레이 아이콘이 기본으로 표시되지 않으며 창을 닫아도 백그라운드 프로세스가 남아 있을 수 있습니다. 업데이트, 포트 변경, 재실행 전에 기존 인스턴스가 실행 중인지 확인하세요. 설치 패키지는 해당 패키지 관리 절차에 따라 업데이트하고 서로 다른 출처의 프로그램 사본을 함께 두지 마세요. 프로그램은 실행되지만 설정을 저장하지 못한다면 실행 권한을 계속 높이기보다 사용자 폴더 권한을 먼저 확인하세요.
Android: 구독 가져오기와 VPN 인터페이스
v2rayNG와 v2flyNG 중 선택
Android 다운로드에서 Xray 코어를 사용하는 v2rayNG를 먼저 확인하세요. 기존 설정이 V2Fly에 의존한다면 v2flyNG를 살펴보세요. 대부분의 최신 스마트폰은 arm64를 선택할 수 있으며 기기의 앱 아키텍처를 모른다면 범용 버전을 고려할 수 있습니다. 프로세서가 특정 아키텍처를 지원하더라도 현재 시스템에서 같은 앱 환경을 제공한다는 뜻은 아닙니다. OS와 설치 안내를 함께 확인하세요.
설치할 때는 설치 작업을 수행하는 파일 관리자나 브라우저에 필요한 권한만 부여하고, 설치가 끝나면 알 수 없는 앱 설치 권한을 취소해도 됩니다. 시스템에서 설치할 수 없다고 나오면 아키텍처 불일치, 저장 공간 부족, 시스템 요구 사항 미충족, 기존 앱과의 충돌을 구분하세요. 기존 클라이언트를 덮어쓰려고 먼저 삭제하지 마세요. 앱을 제거하면 구독과 로컬 설정도 함께 삭제될 수 있으므로 먼저 백업해야 합니다.
다른 출처에서 앱을 옮기면 서명 차이 때문에 시스템이 바로 업데이트를 거부할 수 있습니다. 설치 버튼을 계속 눌러도 해결되지 않습니다. 먼저 설정을 저장하고 대상 클라이언트와 출처를 확인한 뒤 이전 방법을 결정하세요. v2rayNG와 v2flyNG는 서로 다른 앱입니다. 인터페이스가 비슷해도 데이터베이스를 바로 호환할 수 있다는 뜻은 아닙니다. 앱 간 이전에는 양쪽에서 지원하는 구독 또는 공유 형식을 우선 사용하세요.
구독 그룹 추가 및 설정 선택
클라이언트의 사이드 메뉴에서 ‘구독 그룹 설정’ 또는 구독 관리 메뉴를 찾아 새 그룹을 만드세요. 설명과 구독 주소를 입력한 뒤 저장하고 메인 화면으로 돌아와 ‘구독 업데이트’를 실행합니다. 단일 공유 링크를 복사했다면 클립보드에서 설정을 가져오는 메뉴를 사용하세요. 원격 구독 주소 입력란에 붙여 넣으면 안 됩니다. 두 메뉴의 용도가 다르므로 잘못 선택하면 가져오기에 실패하거나 형식 오류가 발생할 수 있습니다.
업데이트가 끝나면 설정 하나를 선택해 현재 항목으로 지정하고 연결 버튼을 눌러 시작하세요. 제공업체가 특정 전송 방식이나 보안 매개변수를 요구한다면 전체 공유 내용을 기준으로 설정하세요. 화면을 단순하게 만들려고 관련 옵션을 임의로 끄지 마세요. 먼저 기본 설정으로 연결을 확인한 다음 앱별 프록시, DNS, 라우팅 규칙을 조정하세요.
Android VPN 권한 이해하기
처음 연결할 때는 보통 시스템 VPN 연결 요청 창이 표시됩니다. 이는 클라이언트가 시스템 인터페이스를 통해 기기 트래픽을 받도록 허용하는 절차이며, 사용할 수 있는 서버를 자동으로 제공한다는 뜻은 아닙니다. 허용한 뒤에도 코어가 시작되고 원격 연결이 성공해야 합니다. 일반적으로 시스템에서는 일반 VPN 앱 두 개가 같은 인터페이스를 동시에 사용할 수 없습니다. 비슷한 연결이 실행 중이라면 먼저 연결을 끊고 테스트하세요.
Android에서는 데스크톱의 ‘시스템 프록시 자동 설정’ 절차를 그대로 따라 할 필요가 없습니다. 일반적으로 클라이언트가 시스템 VPN 인터페이스를 만들고 라우팅 및 앱별 설정에 따라 트래픽을 처리합니다. 연결 아이콘이 표시된다는 것은 인터페이스 상태만 보여줄 뿐, 대상 사이트가 원격 서버를 통해 접속됐다는 뜻은 아닙니다. 앱 접속 결과, 클라이언트 로그, 필요한 경우 라우팅 상태를 함께 확인하세요.
‘앱별 프록시’에서는 보통 특정 앱만 클라이언트에 연결하거나 지정 앱을 제외할 수 있습니다. 사용할 수 있는 방식은 화면의 모드에 따라 다릅니다. 설정 후 모드와 앱 목록을 모두 확인하세요. 같은 목록도 ‘프록시 사용’ 모드와 ‘우회’ 모드에서 의미가 반대입니다. 변경한 뒤 연결을 끊었다가 다시 연결하고 대상 앱도 완전히 종료한 다음 테스트해 이전 연결 경로가 남지 않도록 하세요.
백그라운드 제한·네트워크 전환·연결 복구
일부 기기는 화면이 잠긴 뒤 백그라운드 프로세스를 제한합니다. 화면이 켜져 있을 때는 정상인데 잠근 뒤 연결이 끊긴다면 배터리 최적화, 백그라운드 실행, 제조사 자동 실행 관리를 확인하고 클라이언트에 필요한 예외만 적용하세요. 모든 앱의 절전 설정을 끌 필요는 없습니다. 연결이 끊긴 시간과 상황을 기록한 뒤 프로세스 종료, 네트워크 전환, 원격 세션 만료를 구분하세요.
무선 네트워크에서 모바일 네트워크로 바꾸면 기존 연결을 다시 설정해야 할 수 있습니다. 먼저 기기 자체의 네트워크가 정상인지 확인하고 클라이언트 연결을 끊었다가 다시 연결하세요. 한 네트워크에서만 계속 실패한다면 같은 설정을 유지한 채 비교하세요. 프로토콜 매개변수를 동시에 바꾸지 마세요. 프라이빗 DNS, 다른 로컬 네트워크 도구, 핫스팟 공유를 사용 중이라면 이 조건도 기록해 시스템 차이를 놓치지 않도록 하세요.
시스템의 ‘VPN 항상 사용’과 ‘VPN 연결 없이는 차단’ 옵션은 연결을 끊은 뒤의 네트워크 동작에 영향을 줄 수 있습니다. 차단을 켜 둔 상태에서 클라이언트를 중지하면 기기가 정상적으로 인터넷에 접속하지 못할 수 있는데, 이는 시스템 고장이 아니라 예상된 동작일 수 있습니다. 문제 해결을 위해 연결을 끊기 전에 이 옵션을 이해하고 조정하세요. 관리 대상 기기의 정책은 임의로 변경하지 마세요.
구독·공유 링크·업데이트 관리
주소와 설정 내용 구분하기
구독 링크는 보통 원격 주소이며, 클라이언트가 해당 주소에 접속해 여러 설정을 가져옵니다. 단일 공유 링크는 서버 설정 하나를 직접 담고 있습니다. 구독 응답은 인코딩된 텍스트나 클라이언트가 지원하는 다른 형식일 수 있지만 웹페이지 링크가 모두 구독 링크인 것은 아닙니다. 계정 홈, 결제 페이지, 안내 문서가 정상적으로 열리더라도 구독 주소 입력란에 사용할 수 있는 것은 아닙니다.
데스크톱에서는 보통 ‘구독 그룹 설정’에 원격 주소를 저장하고, Android에서는 구독 관리 메뉴를 사용합니다. 클립보드 가져오기는 클라이언트가 지원하는 공유 내용을 가져올 때 적합하고, 파일 가져오기는 해당 설정 파일을 불러올 때 사용합니다. 메뉴를 선택하기 전에 가진 자료의 종류부터 확인하세요. 모든 가져오기 버튼을 차례로 눌러보지 마세요. 잘못된 메뉴를 사용하면 불완전한 항목이 생겨 이후 문제 해결이 더 어려워질 수 있습니다.
주소를 붙여 넣은 뒤 앞뒤 공백, 줄바꿈, 이스케이프 문자, 문장 부호가 포함되지 않았는지 확인하세요. 일부 메시지 앱에서는 링크 뒤의 마침표까지 함께 복사되며, 웹페이지에는 실제 주소 대신 단축된 문구가 표시될 수 있습니다. 링크의 전체 주소를 복사하고 쿼리 매개변수를 그대로 유지하세요. 인코딩된 기호를 보기 쉬운 문자로 직접 바꾸지 마세요. 예시 도메인으로는 실제 연결할 수 없습니다.
그룹 업데이트와 활성 설정의 관계
출처나 용도별로 그룹을 만들고 알아보기 쉬운 별칭을 지정하세요. 모든 구독을 구분할 수 없는 목록 하나에 넣지 않는 것이 좋습니다. 업데이트할 때는 현재 그룹을 먼저 선택하고 반환된 항목 수와 로그를 확인한 뒤 모든 그룹을 업데이트하세요. 여러 출처를 섞어 사용한다면 한 출처의 실패가 다른 그룹에 영향을 주지 않을 수 있습니다. 그룹별로 확인하면 여전히 쓸 수 있는 설정을 유지하고 전체 목록을 한꺼번에 지우는 일을 피할 수 있습니다.
구독을 업데이트하면 구독으로 관리되는 항목이 다시 만들어질 수 있습니다. 이런 항목의 설명이나 매개변수를 직접 수정해도 다음 업데이트 후 유지된다는 보장은 없습니다. 장기간 사용할 사용자 지정 설정은 클라이언트가 독립 항목이나 별도 그룹으로 복사하는 기능을 지원하는지 먼저 확인하세요. 백업 없이 구독 항목 하나에 유일한 수동 설정을 맡기거나 목록 순서가 항상 같다고 가정하지 마세요.
업데이트에 성공한 뒤에도 현재 활성 서버를 확인해야 합니다. 사용하던 항목이 삭제되거나 이름이 바뀌거나 다른 항목으로 대체됐을 수 있으며, 클라이언트가 다른 그룹의 활성 항목을 유지할 수도 있습니다. 연결을 다시 시작하기 전에 선택한 항목의 그룹, 프로토콜, 서버 주소를 확인하세요. 구독 관리와 연결 관리는 별도의 단계입니다. 업데이트 로그의 성공 메시지가 실제 연결 확인을 대신하지는 않습니다.
업데이트 경로와 자동 업데이트 간격
프록시 없이 업데이트하면 구독 요청이 현재 네트워크를 직접 사용합니다. 프록시를 통해 업데이트하면 이미 사용 가능한 프록시에 의존합니다. 후자는 연결이 정상임을 확인한 상황에 적합하지만, 유일하게 쓸 수 있는 설정이 이미 무효라면 이를 통해 새 설정을 가져오지 못할 수 있습니다. 문제를 해결할 때는 요청이 어느 경로를 사용하는지 먼저 확인하고, 그 경로의 네트워크를 점검하세요. 업데이트 버튼만 반복해서 누르지 마세요.
자동 업데이트를 사용하려면 ‘업데이트 사용’과 같은 스위치를 켜고 화면에 표시된 단위에 맞춰 간격을 입력해야 합니다. 입력란의 단위가 분이면 시간을 그대로 입력하면 안 됩니다. 제공업체 안내, 내용 변경 빈도, 기기 사용 습관에 맞춰 간격을 설정하세요. 너무 자주 업데이트하면 요청만 늘어납니다. 간격을 0으로 설정했을 때의 동작은 구현에 따라 다르므로 계속 업데이트된다고 단정하지 마세요.
기기가 절전 모드이거나 클라이언트가 종료됐거나 시스템이 백그라운드 실행을 제한하면 자동 업데이트가 예정대로 되지 않을 수 있습니다. 다시 사용할 때 최근 업데이트 결과를 확인하고 필요하면 수동으로 업데이트하세요. 자동 업데이트는 실패하지만 수동 업데이트는 정상이라면 실행 당시의 네트워크 상태, 프록시 경로, 권한을 비교하세요. 주소 형식부터 의심할 필요는 없습니다. 자세한 내용은 구독 업데이트 실패 해결 방법을 확인하세요.
오류 유형으로 원인 범위 좁히기
시간 초과는 정해진 시간 안에 요청이 완료되지 않았다는 뜻이므로 네트워크 경로와 주소 연결을 확인하세요. 접근 거부는 인증 정보, 접속 출처 제한, 서비스 상태와 관련될 수 있습니다. 응답을 파싱할 수 없다면 로그인 페이지나 오류 페이지, 또는 클라이언트가 지원하지 않는 형식이 반환됐는지 확인하세요. 응답 전체를 공개하지 마세요. 서비스 응답에도 접속 정보와 서버 인증 정보가 포함될 수 있습니다.
구독을 바꾸기 전에 여전히 사용할 수 있는 설정을 저장하고 새 주소가 기존의 신뢰할 수 있는 경로에서 제공됐는지 확인하세요. 주소가 유출된 것으로 의심되면 제공업체가 지원하는 경우 접속 정보를 재설정하세요. 로컬 그룹만 삭제해도 기존 주소가 무효화되지는 않습니다. 데스크톱과 Android 메뉴를 항목별로 비교하려면 구독 링크 가져오는 방법을 확인하세요.
시스템 프록시·TUN·라우팅·DNS
트래픽 유입 경로를 확인한 뒤 분기 규칙 점검
시스템 프록시, TUN, 라우팅 규칙은 서로 다른 문제를 해결합니다. 시스템 프록시는 이를 따르는 앱에 요청을 로컬 유입 지점으로 전달하도록 안내합니다. TUN은 시스템 네트워크 인터페이스를 통해 더 넓은 범위의 연결을 받습니다. 라우팅 규칙은 코어로 들어온 요청에 사용할 아웃바운드를 결정합니다. 먼저 요청이 클라이언트로 들어오는지 확인해야 직접 연결이나 프록시 규칙을 논의할 수 있습니다. 클라이언트를 우회하는 앱에는 규칙이 아무리 정확해도 적용되지 않습니다.
처음 문제를 점검할 때는 일반 시스템 프록시를 기준으로 사용하세요. 시스템 설정을 따르는 브라우저 하나를 선택하고 서버와 라우팅 설정은 유지합니다. 브라우저는 정상인데 다른 앱만 작동하지 않으면 해당 앱의 별도 프록시, 특수 전송 방식, 앱별 제외 설정을 확인하세요. 모든 앱이 작동하지 않으면 복잡한 분기 규칙을 추가하기 전에 코어, 로컬 포트, 원격 연결을 살펴보세요.
로컬 수신 주소는 보통 루프백 주소이며 같은 기기에서만 접속할 수 있습니다. LAN 수신을 켜면 접근 가능한 범위가 넓어지므로 사용 목적을 명확히 하고 방화벽 설정을 함께 확인하세요. 휴대폰이나 다른 기기에서 프록시를 설정할 때 루프백 주소는 클라이언트가 실행 중인 컴퓨터가 아니라 해당 기기 자신을 가리킵니다. 컴퓨터의 LAN 주소를 사용하고 두 기기가 서로 연결 가능한지, 수신 범위가 올바른지 확인해야 합니다.
규칙 순서와 아웃바운드 이름
라우팅 규칙은 일반적으로 위에서부터 순서대로 적용됩니다. 위쪽의 범위가 넓은 규칙이 아래쪽의 세부 규칙보다 먼저 적용될 수 있습니다. 특정 도메인을 직접 연결해야 한다면 규칙이 존재하는지만 확인하지 말고 위쪽 규칙에 먼저 해당하지 않는지 살펴보세요. 아웃바운드 태그는 현재 설정에 실제로 정의된 이름과 일치해야 합니다. 인터페이스에 표시되는 ‘프록시’, ‘직접 연결’은 화면용 이름이며 모든 설정에서 내부 태그가 동일하지는 않습니다.
아래는 Xray 라우팅 객체의 구조를 보여주는 예시이며, 규칙을 설명하기 위한 것입니다. 그대로 가져올 수 있는 완전한 클라이언트 설정은 아닙니다. 이 예시는 direct라는 이름의 아웃바운드가 이미 설정되어 있고 사용 중인 코어에 해당 도메인 데이터가 있다고 가정합니다. 그래픽 클라이언트로 관리한다면 ‘라우팅 설정’에서 같은 규칙을 만드는 것이 좋습니다. 클라이언트가 임시로 생성한 실행 파일을 직접 수정하지 마세요.
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}
]
}
}
geosite는 도메인 모음으로 일치 여부를 판단하고 geoip는 IP 주소 모음으로 판단합니다. 서로 바꿔 사용할 수 없습니다. 도메인 규칙을 적용하려면 코어가 판단에 필요한 도메인 정보를 받아야 합니다. 앱이 주소만 전달하는 경우에는 매칭 결과가 달라질 수 있습니다. 규칙을 추가하기 전에 입력 정보, 데이터 파일, 규칙 순서를 확인하고 도메인 스니핑 기능이 필요한지 판단하세요. 규칙 하나를 적용하려고 모든 옵션을 켜지 마세요.
DNS 조회 경로와 연결 경로
DNS는 도메인을 IP 주소로 변환하고 프록시 연결은 요청을 전송합니다. 두 경로는 분리되어 있을 수 있습니다. 도메인은 열리지 않지만 IP 주소로 접속된다고 해서 특정 DNS 서비스에 장애가 있다고 단정할 수는 없습니다. 먼저 시스템 DNS, 클라이언트 내부 DNS, 앱 자체 암호화 DNS를 구분한 뒤 실제 테스트에 사용된 경로를 확인하세요.
시스템 프록시 모드에서는 프로토콜과 앱 구현에 따라 앱이 직접 도메인을 조회하거나 도메인을 로컬 프록시에 전달할 수 있습니다. TUN 모드에서는 DNS 요청도 처리할 수 있어 일반 프록시와 동작이 다를 수 있습니다. 유입 방식을 바꾼 뒤에는 기존 브라우저 동작이 그대로 유지된다고 가정하지 말고 DNS 설정을 다시 확인하세요. 여러 경로가 서로 덮어쓰지 않도록 한 번에 하나의 DNS 유입 지점만 조정하세요.
사용자 지정 DNS 서버를 설정하기 전에 현재 네트워크에서 접속할 수 있는지, DNS 요청이 프록시를 통해 전송되는지 확인하세요. 원격 서버에 연결할 수 없는데 DNS 조회까지 같은 장애가 난 프록시에 맡기면 새로운 의존성 문제가 생길 수 있습니다. 원격 서버 주소에 도메인을 사용하는 경우 프록시 연결을 만들기 전 최초 조회가 어떻게 이루어지는지도 고려해야 합니다. 연결 후의 DNS 요청만 확인해서는 부족합니다.
TUN 사용 시 LAN 접근과 복구 범위
TUN이 트래픽을 처리하면 프린터, 네트워크 저장소, LAN 관리 페이지의 연결이 새 라우팅 규칙에 영향을 받을 수 있습니다. 클라이언트에 LAN 우회 또는 라우트 제외 설정이 있는지 확인하고 주소 범위가 실제 네트워크와 일치하는지 살펴보세요. 기기 하나에 다시 접속하려고 범위가 지나치게 넓은 직접 연결 규칙을 추가하지 마세요. 규칙 범위가 넓을수록 원래 프록시가 필요한 대상에도 영향을 줄 수 있습니다.
‘전역 프록시’는 라우팅 차이를 임시로 확인할 때 유용하지만 시스템의 모든 트래픽을 가로챈다는 뜻은 아닙니다. 테스트가 끝나면 일상적으로 사용할 규칙으로 되돌리고 내부 네트워크 접속도 확인하세요. 도메인 접두사, 주소 모음, 우선순위를 자세히 알아보려면 v2rayN 사용자 지정 라우팅 규칙 작성법을 참고한 뒤 실제 대상에 맞게 규칙 범위를 좁히세요.
설정 관련 자주 묻는 문제와 복구 순서
증상으로 문제 범위 나누기
먼저 ‘어떤 앱에서, 어떤 대상에, 어떤 네트워크로, 언제부터’ 문제가 생겼는지 기록한 뒤 시작, 구독, 유입, 아웃바운드 중 어느 단계에서 발생했는지 확인하세요. 창이 열리지 않는 문제와 사이트에 접속할 수 없는 문제는 다릅니다. 특정 사이트만 이상한 경우와 모든 앱에서 네트워크가 끊긴 경우도 같은 방식으로 해결할 수 없습니다. 원래 증상을 덮어쓰지 않도록 설정과 로그를 보관한 뒤 변경하세요.
클라이언트를 실행할 수 없다면 설치 방식, 시스템 아키텍처, 실행 환경, 폴더 권한, 보안 프로그램 기록을 확인하세요. 클라이언트는 실행되지만 코어가 시작되지 않는다면 관련 오류 중 첫 번째 항목을 살펴보고 설정 파싱과 포트 수신 대기를 먼저 점검하세요. 이후에 이어지는 연결 오류는 앞선 시작 실패의 결과일 수 있습니다. 오류를 하나씩 모두 별도 문제로 취급하거나 모든 구독을 바로 삭제할 필요는 없습니다.
구독 업데이트는 성공했지만 연결할 수 없다면 활성 서버가 예상한 그룹에 속하는지, 코어가 실행 중인지 확인하세요. 이어서 테스트 앱의 트래픽이 프록시로 들어오는지 확인하고 원격 연결 로그를 살펴봅니다. 구독은 설정을 가져오는 경로일 뿐입니다. 서버 사용 가능 여부는 인증 매개변수, 서비스 상태, 네트워크 경로에 달려 있습니다. 업데이트 성공과 실제 연결은 별도로 확인해야 합니다.
최소한의 변경으로 비교하기
서버 하나, 테스트 앱 하나, 대상 하나를 정해 현재 네트워크에서 테스트하세요. 설정을 그대로 둔 채 다른 사용 가능한 네트워크로 바꿔 다시 확인합니다. 서버 하나에서만 실패한다면 같은 그룹의 다른 서버와 비교하세요. 모든 서버가 실패한다면 로컬 유입 경로와 네트워크 조건을 다시 확인합니다. 앱, 라우팅, DNS, 서버를 한꺼번에 바꾸면 어떤 변경이 영향을 줬는지 알 수 없습니다.
연결 거부, 연결 시간 초과, 인증 실패, 인증서 오류는 각각 의미가 다릅니다. 연결 거부는 대상 또는 로컬 포트가 연결을 받아들이지 않는 경우가 많습니다. 시간 초과는 지정된 시간 내에 연결 경로가 완료되지 않았다는 뜻입니다. 인증 실패는 설정과 서비스 상태를 확인해야 합니다. 인증서 오류가 나면 먼저 시스템 시간, 도메인, 필요한 보안 매개변수를 살펴보세요. 인증서 검증을 끄는 것을 장기적인 해결책으로 사용하면 실제 설정 문제를 숨기게 됩니다.
로컬 포트를 다른 프로세스가 사용 중이라면 먼저 해당 프로세스를 확인하세요. 이전 클라이언트 인스턴스라면 정상적으로 종료한 뒤 다시 시작합니다. 다른 필수 프로그램이라면 현재 클라이언트 포트를 변경하고 수동 프록시를 사용하는 앱의 설정도 함께 바꾸세요. 클라이언트 포트만 바꾸고 앱 설정을 그대로 두면 새 유입 오류가 생깁니다. 포트를 비우려고 정체를 알 수 없는 시스템 프로세스를 종료하지 마세요.
연결 해제 후 네트워크 복구와 백업
클라이언트를 중지한 뒤 인터넷에 연결할 수 없다면 데스크톱에서는 시스템 프록시가 아직 로컬 수신 주소를 가리키는지 확인하세요. TUN을 사용했다면 인터페이스와 라우팅이 정상적으로 해제됐는지 살펴봅니다. Android에서는 VPN을 사용하지 않을 때 연결을 차단하는 시스템 옵션이 켜져 있는지 확인하세요. 플랫폼별 기존 설정에 따라 복구하고 모든 네트워크 설정을 지우는 일을 첫 단계로 삼지 마세요. 원격 업무 세션에서 네트워크를 함부로 초기화하지도 마세요.
업데이트 후 문제가 생기면 백업 설정과 현재 설정을 비교하고 다른 설치 위치의 사본을 실행 중인지 확인하세요. 되돌려야 한다면 클라이언트가 지원하는 절차를 따르고 설정 형식이 바뀌었을 가능성도 고려하세요. 이전 설정과 현재 설정을 각각 보관하고 유일한 데이터 사본을 반복해서 덮어쓰지 마세요. 복구가 끝난 뒤 자동 업데이트, 시작 항목, 분기 설정을 다시 확인하세요.
로그에는 보통 시간, 대상 주소, 적용된 규칙, 오류 원인이 포함됩니다. 공유할 때는 재현 전후의 필요한 부분만 선택하고 인증 정보를 가리세요. 로그 수준을 일시적으로 높였다면 점검이 끝난 뒤 원래대로 되돌려 불필요하게 많은 기록이 계속 쌓이지 않도록 합니다. 문제를 설명할 때는 운영체제, 클라이언트 이름, 유입 방식, 이미 해본 비교 테스트를 함께 알려주세요. ‘연결할 수 없음’ 화면만 공유하지 마세요.
자주 묻는 질문 빠른 확인
브라우저는 되는데 다른 앱은 안 됩니다. 서버를 바꿔야 하나요?
먼저 다른 앱이 시스템 프록시를 따르는지, 별도 프록시가 설정되어 있는지, 앱별 규칙에서 제외됐는지 확인하세요. 브라우저가 작동한다면 적어도 하나의 연결 경로는 정상입니다. TUN을 사용하기 전에 해당 앱의 유입 경로를 먼저 확인하세요.
TUN을 켠 뒤 네트워크가 모두 끊겼습니다. 어떤 설정부터 복구하나요?
먼저 TUN을 끄고 일반 네트워크 연결이 복구되는지 확인한 다음 권한, 인터페이스 생성, 라우팅 로그를 점검하세요. 비교하는 동안 서버와 일반 프록시 설정은 그대로 유지하세요. 원인을 찾기 전에 DNS와 구독을 동시에 변경하지 마세요.
지연 시간 테스트는 성공했는데 사이트가 열리지 않는 이유는 무엇인가요?
테스트는 연결 과정의 일부만 확인할 수 있으므로 대상 사이트의 DNS 조회, 프로토콜, 라우팅까지 정상이라고 보장하지 않습니다. 실제 앱에서 문제를 재현한 뒤 요청이 클라이언트에 들어오는지, 어떤 아웃바운드를 사용하는지, 관련 오류 중 첫 번째 항목이 무엇인지 확인하세요.
자동 업데이트가 실행되지 않습니다. 간격을 크게 줄여야 하나요?
먼저 업데이트 스위치, 시간 단위, 클라이언트 실행 상태, 백그라운드 제한을 확인하세요. 기기가 절전 모드이거나 프로그램이 종료되어 있으면 예정된 업데이트가 실행되지 않을 수 있습니다. 간격을 줄여도 이런 조건은 해결되지 않으며 사용할 수 없는 구독 주소도 복구되지 않습니다.
복구가 끝나면 브라우저, 자주 쓰는 앱, LAN 서비스, 절전 모드 복귀 후 연결을 각각 확인해 특정 테스트 대상 하나만 고쳐진 것은 아닌지 살펴보세요. 최종적으로 사용할 유입 방식, 라우팅, DNS를 백업 설명에 기록하고 다음 문제 해결은 이 기준 설정부터 시작하세요. 전체 설정 절차를 다시 확인하려면 입문 가이드로 돌아가세요. 이 안내서의 고급 옵션을 한꺼번에 모두 켜지 마세요.