Linux에서 v2rayN 설치하는 방법: deb/rpm 패키지 설치, 의존성 해결 및 로그인 후 자동 시작 설정

설치 전 배포판, 아키텍처 및 데스크톱 환경 확인

Linux에 v2rayN을 설치할 때는 바로 설치 명령을 실행하기보다 현재 시스템이 어떤 패키지 형식을 사용하는지 먼저 확인해야 합니다. Debian, Ubuntu 및 일반적인 파생 배포판은 보통 deb 패키지를 사용하고, Fedora, openSUSE와 RPM 패키지 체계를 사용하는 배포판은 rpm 패키지를 사용합니다. 패키지 형식을 잘못 선택해도 시스템이 다른 형식으로 자동 변환해 주지는 않습니다.

프로세서 아키텍처도 확인해야 합니다. 일반적인 데스크톱 PC에서는 보통 x86_64로 표시되며, 다운로드 페이지에서는 x64에 해당할 수 있습니다. 일부 장치는 aarch64 또는 arm64로 표시됩니다. 설치 패키지의 아키텍처는 시스템 아키텍처와 일치해야 합니다. 그렇지 않으면 패키지 관리자가 아키텍처 불일치를 알리거나 프로그램이 시작 단계에서 바로 종료될 수 있습니다.

uname -m
cat /etc/os-release

uname -m은 프로세서 아키텍처를 확인하는 명령입니다. /etc/os-release에는 배포판 이름, 버전 및 식별자가 표시됩니다. GNOME, KDE Plasma 같은 데스크톱 환경은 여러 배포판에 설치할 수 있으므로 데스크톱 화면만 보고 시스템 종류를 판단하지 마세요.

Debian 및 Ubuntu 사용자는 다음 명령으로 패키지 관리자가 인식한 아키텍처를 확인할 수도 있습니다:

dpkg --print-architecture

Fedora 및 openSUSE 사용자는 RPM으로 아키텍처를 확인할 수 있습니다:

rpm --eval '%{_arch}'

v2rayN은 데스크톱 클라이언트입니다. 이 글의 실행, 시스템 프록시 및 자동 시작 절차는 그래픽 데스크톱 세션이 있는 Linux 시스템을 전제로 합니다. 터미널 환경만 제공되는 장치라면 데스크톱 클라이언트를 설치하는 방식은 적합하지 않은 경우가 많습니다. 설치에 성공하더라도 그래픽 세션, 디스플레이 서비스 또는 데스크톱 구성 요소가 없어 기본 창이 열리지 않을 수 있습니다.

다운로드 전 네 가지 정보 확인

• 배포판 체계: deb인지 rpm인지 확인하고 파일 아이콘만 보고 판단하지 마세요.
• 프로세서 아키텍처: 설치 패키지의 아키텍처가 uname -m 결과와 일치하는지 확인하세요.
• 데스크톱 세션: GNOME, KDE Plasma 또는 다른 데스크톱 환경에 정상적으로 로그인할 수 있는지 확인하세요.
• 기존 버전 상태: v2rayN을 이미 설치했다면 실행 중인 클라이언트를 먼저 종료한 뒤 업그레이드하거나 다시 설치하세요.

설치 패키지는 사이트의 클라이언트 다운로드 페이지에서 받으세요. 다운로드가 끝나면 파일 관리자를 사용해 파일이 실제로 다운로드 폴더에 있는지 확인한 뒤 터미널을 여세요. 브라우저에 따라 파일이 “다운로드” 폴더, 사용자가 지정한 폴더 또는 이전에 사용한 폴더에 저장될 수 있으므로 터미널의 경로는 실제 저장 위치와 일치해야 합니다.

Debian 및 Ubuntu에서 deb 패키지 설치

Debian과 Ubuntu에서는 apt install로 로컬 deb 패키지를 설치하는 방법을 우선 권장합니다. dpkg -i만 실행하는 것과 달리 APT는 패키지에 선언된 의존성을 함께 분석하고, 현재 시스템에 설정된 저장소에서 의존성을 보완하려고 시도합니다. 명령의 ./은 현재 디렉터리에 있는 로컬 파일을 설치한다는 뜻으로, 같은 이름의 저장소 패키지를 찾지 않도록 하므로 중요합니다.

1단계: 다운로드 폴더로 이동하고 파일 이름 확인

cd ~/Downloads
ls -lh v2rayN*.deb

일부 중국어 데스크톱 환경에서는 다운로드 폴더가 현지화된 이름으로 표시될 수 있지만 실제 경로는 XDG 사용자 디렉터리 설정에 따라 달라질 수 있습니다. ~/Downloads가 없다면 먼저 실제 다운로드 폴더를 확인하세요:

xdg-user-dir DOWNLOAD

그다음 명령이 반환한 폴더로 이동합니다. ls를 실행하면 deb 파일의 전체 이름이 표시되어야 합니다. 버전이 바뀌면 파일 이름도 달라질 수 있으므로 현재 컴퓨터에 다운로드된 파일 이름을 기준으로 사용하세요.

2단계: APT로 로컬 패키지 설치

sudo apt update
sudo apt install ./v2rayN-linux-64.deb

위 파일 이름은 명령 구조를 설명하기 위한 예시입니다. 다운로드한 파일 이름이 다르면 명령 끝부분을 터미널에 실제로 표시된 전체 이름으로 바꾸세요. sudo 비밀번호를 입력할 때 터미널에 별표나 점이 표시되지 않는 것은 정상입니다. 입력을 마친 뒤 Enter 키를 누르면 됩니다.

apt update는 패키지 저장소 색인만 새로 고치며 시스템 전체를 자동으로 업그레이드하지는 않습니다. 색인을 갱신하면 “의존성은 있지만 현재 색인에서 찾을 수 없음”과 같은 문제를 줄일 수 있습니다. 네트워크를 일시적으로 사용할 수 없고 의존성이 이전에 설치되어 있지 않다면 APT가 필요한 구성 요소를 보완할 수 없습니다.

3단계: dpkg 설치 후 남은 의존성 문제 해결

이전에 sudo dpkg -i를 실행해 “의존성 문제” 또는 “패키지가 아직 설정되지 않음”이라는 메시지가 표시되었다면 같은 dpkg 명령을 반복하지 마세요. 먼저 APT로 완료되지 않은 의존성 상태를 복구합니다:

sudo apt --fix-broken install
sudo dpkg --configure -a

첫 번째 명령은 누락된 의존성을 확인하고 설치를 완료합니다. 두 번째 명령은 압축이 풀렸지만 아직 설정이 끝나지 않은 패키지의 설정을 계속 진행합니다. 실행이 끝나면 로컬 deb 설치 명령을 다시 실행하세요. 특정 의존성 패키지를 찾을 수 없다는 메시지가 나오면 배포판 버전이 아직 지원되는지, 저장소를 사용할 수 있는지, 설치 패키지가 현재 시스템 버전용인지 먼저 확인하세요.

4단계: 애플리케이션 메뉴에서 실행

설치가 끝나면 데스크톱 애플리케이션 메뉴에서 v2rayN을 검색하세요. 애플리케이션 메뉴에서 실행 항목을 찾을 수 있다면 데스크톱 파일이 시스템에 인식된 것입니다. 아이콘이 바로 나타나지 않으면 데스크톱 세션에서 로그아웃했다가 다시 로그인하거나, 터미널에서 실행 명령을 확인하세요:

command -v v2rayN
v2rayN

두 번째 명령은 시작 단계의 터미널 출력을 확인할 때 유용합니다. 창이 정상적으로 나타나면 터미널을 닫고 애플리케이션 메뉴에서 실행해 보세요. 터미널에서 명령을 찾을 수 없다고 해도 설치 경로를 임의로 추측하지 마세요. 먼저 패키지 목록에서 실제 설치 위치를 확인하세요:

dpkg -L v2rayn | grep -E 'bin/|applications/'

패키지 이름의 대소문자와 표기 방식은 버전에 따라 달라질 수 있습니다. 해당 패키지가 설치되지 않았다는 메시지가 나오면 먼저 dpkg -l | grep -i v2ray를 실행한 다음 결과에 표시된 패키지 이름을 사용하세요.

Fedora 및 openSUSE에서 rpm 패키지 설치

RPM은 패키지 형식이고, DNF와 Zypper가 의존성을 분석하고 저장소를 호출해 설치를 수행하는 관리 도구입니다. 하위 수준 명령인 rpm -i로 파일을 직접 설치할 수도 있지만 DNF나 Zypper처럼 의존성을 자동으로 해결하지는 않습니다. 따라서 데스크톱 사용자는 배포판에 기본 제공되는 상위 수준 패키지 관리자를 사용하는 편이 좋습니다.

Fedora: DNF로 설치

먼저 다운로드 폴더로 이동해 파일을 확인하세요:

cd ~/Downloads
ls -lh v2rayN*.rpm

파일이 있는 것을 확인한 뒤 다음 명령을 실행하세요:

sudo dnf install ./v2rayN-linux-64.rpm

최신 Fedora 버전에서는 명령 내부에 새로운 DNF 구현이 사용될 수 있지만 로컬 rpm 설치 방식은 동일합니다. 설치 전에 트랜잭션 요약을 확인하고 새로 설치되는 항목, 업그레이드되는 항목 및 제거되는 항목을 중점적으로 살펴보세요. 일반적으로 로컬 클라이언트 설치 때문에 데스크톱 기본 소프트웨어를 대량으로 제거할 필요는 없습니다.

설치가 중단된 적이 있다면 먼저 RPM 데이터베이스와 설치 상태를 확인할 수 있습니다:

rpm -qa | grep -i v2ray
sudo dnf check

dnf check는 설치된 패키지 사이의 의존성 문제를 찾는 명령입니다. 오류가 완료되지 않은 시스템 업데이트에서 비롯되었다면 현재 진행 중인 패키지 트랜잭션을 먼저 완료한 뒤 v2rayN을 다시 설치하세요. 연속해서 강제로 덮어쓰는 것보다 일관된 상태로 복구하기 쉽습니다.

openSUSE: Zypper로 설치

openSUSE 사용자도 먼저 다운로드 폴더에 있는 rpm 파일을 확인한 다음 Zypper로 의존성을 해결하세요:

cd ~/Downloads
ls -lh v2rayN*.rpm
sudo zypper install ./v2rayN-linux-64.rpm

Zypper는 여러 의존성 해결 방안을 제시할 수 있습니다. 데스크톱 환경과 시스템 기본 라이브러리를 유지하는 방안을 우선 선택하세요. 특정 방안에서 핵심 구성 요소를 대규모로 다운그레이드하거나 교체하려 한다면 먼저 취소하고, 다운로드한 패키지가 현재 배포판 버전에 맞는지 확인하세요.

설치가 끝나면 다음 명령으로 패키지 내부 파일의 위치를 확인할 수 있습니다:

rpm -ql v2rayn | grep -E 'bin/|applications/'

패키지 이름과 명령이 일치하지 않으면 먼저 rpm -qa | grep -i v2ray를 실행해 정확한 이름을 확인하세요. 애플리케이션 메뉴가 아직 갱신되지 않았다면 데스크톱 세션에서 로그아웃한 뒤 다시 로그인하세요. 터미널에서 한 번 실행해 전체 오류 메시지를 확인하는 방법도 있습니다.

클라이언트 최초 실행, 구독 가져오기 및 코어 확인

v2rayN 창이 열렸다는 것은 데스크톱 프로그램 설치가 완료되었다는 뜻일 뿐, 프록시 연결이 사용할 수 있는 상태라는 의미는 아닙니다. 처음 실행한 뒤에는 “구성 가져오기, 구독 업데이트, 노드 선택, 코어 시작, 시스템 프록시 설정” 순서로 진행하세요. 각 단계를 완료한 후 다음 단계로 넘어가면 구독 문제, 노드 문제 및 데스크톱 프록시 문제를 빠르게 구분할 수 있습니다.

1. 구독 가져오기: 구독 그룹 또는 구독 설정에서 전체 구독 주소를 추가하고 저장한 뒤 수동으로 업데이트하세요.
2. 노드 목록 확인: 업데이트 후 서버 항목이 나타나는지, 프로토콜 필드가 서버에서 제공한 정보와 일치하는지 확인하세요.
3. 활성 노드 선택: 사용할 항목을 선택하고 현재 활성 서버로 지정하세요.
4. 코어 시작: 로그 영역에서 포트 사용 중, 구성 해석 실패 또는 코어 시작 실패 메시지가 없는지 확인하세요.
5. 시스템 프록시 설정: 코어가 정상적으로 실행된 후 시스템 프록시 자동 설정을 선택하세요.

VMess와 VLESS는 서로 다른 프록시 프로토콜입니다. 클라이언트는 노드 구성에 따라 해당 코어 구성을 생성하므로 사용자가 한 프로토콜을 다른 프로토콜로 직접 바꿔 쓸 필요는 없습니다. 구독을 업데이트한 뒤 노드가 없다면 구독 주소가 완전한지, 구독이 아직 유효한지, 업데이트 작업에서 오류가 반환되었는지 먼저 확인하세요. 구독 내용이 비어 있는 문제를 해결하기 위해 클라이언트를 반복해서 재설치하지 마세요. 패키지 설치와 구독 응답은 서로 다른 단계입니다.

v2rayN 데스크톱 버전은 일반적으로 Xray 또는 V2Fly 계열 코어와 함께 사용할 수 있으며, 실제 선택 항목은 현재 버전의 화면을 기준으로 확인해야 합니다. 기존 구독에 특정 전송 방식이나 프로토콜 확장이 포함되어 있다면 해당 매개변수를 해석할 수 있는 코어를 사용하세요. 코어를 전환한 뒤에는 관련 프로세스를 다시 시작하고 로그에 “지원하지 않는 필드” 또는 구성 해석 오류가 나타나는지 확인하세요.

먼저 로그를 확인한 뒤 연결 실패 지점을 판단하세요

로그에 “수신 대기 포트가 시작됨”과 같은 메시지가 표시되면 보통 로컬 프록시 진입점이 만들어졌다는 뜻입니다. 그렇다고 원격 연결까지 성공했다는 의미는 아닙니다. 대상 사이트에 접속할 때 실제 연결이 시도됩니다. 로컬 포트가 사용 중이라는 메시지가 나오면 v2rayN 설정에서 로컬 수신 포트를 변경하거나 해당 포트를 점유한 기존 프로세스를 종료하세요.

ss -lntp
ps -ef | grep -i v2ray

ss -lntp는 현재 수신 대기 중인 TCP 포트를 확인하는 명령입니다. 일반 사용자는 모든 프로세스 세부 정보를 보지 못할 수 있으므로 필요하면 sudo ss -lntp를 사용하세요. v2rayN 인스턴스 두 개를 동시에 실행하면 나중에 시작한 인스턴스가 같은 로컬 포트에 바인딩하지 못할 수 있습니다. 트레이에 남아 있는 기존 인스턴스를 완전히 종료한 뒤 클라이언트를 다시 여세요.

Linux 데스크톱 시스템 프록시 설정

코어 실행과 시스템 프록시는 서로 독립된 상태입니다. 코어는 로컬 프록시 포트를 만들고 원격 서버에 연결하며, 시스템 프록시는 데스크톱 애플리케이션에 요청을 이 로컬 포트로 보내도록 알립니다. 코어만 시작하고 시스템 프록시를 설정하지 않으면 브라우저와 다른 애플리케이션이 여전히 인터넷에 직접 연결할 수 있습니다.

v2rayN에서 시스템 프록시 자동 설정을 선택한 뒤 데스크톱 환경의 네트워크 또는 프록시 설정을 열어 HTTP, HTTPS 또는 SOCKS 항목이 변경되었는지 먼저 확인하세요. 표시 방식은 데스크톱 환경과 클라이언트 버전에 따라 다릅니다. 다른 컴퓨터의 포트를 그대로 사용하지 말고 현재 v2rayN 설정 화면에 표시된 로컬 포트를 기준으로 하세요.

GNOME 데스크톱 확인

GNOME 사용자는 “설정”을 열고 “네트워크”의 프록시 설정으로 이동해 모드가 수동으로 바뀌었는지, 주소가 로컬 컴퓨터를 가리키는지 확인할 수 있습니다. 명령으로 현재 프록시 모드를 확인할 수도 있습니다:

gsettings get org.gnome.system.proxy mode
gsettings get org.gnome.system.proxy.http host
gsettings get org.gnome.system.proxy.http port

프록시를 클라이언트가 자동으로 제어하는 경우 GNOME 설정에서 동시에 수동 변경을 반복하지 않는 것이 좋습니다. 양쪽에서 조작하면 클라이언트에는 활성화된 것으로 표시되지만 데스크톱에는 다른 포트가 저장되는 문제가 생길 수 있습니다. v2rayN을 종료하기 전에는 클라이언트의 “시스템 프록시 지우기” 또는 해당 기능을 사용해 데스크톱이 정상적인 연결 방식으로 돌아가게 하세요.

KDE Plasma 데스크톱 확인

KDE Plasma 사용자는 시스템 설정의 네트워크 프록시 페이지에서 구성을 확인할 수 있습니다. Plasma 버전에 따라 메뉴 위치는 조금 다를 수 있지만 확인할 내용은 같습니다. 프록시 주소는 로컬 컴퓨터 주소여야 하고 포트는 v2rayN의 현재 수신 대기 포트와 일치해야 합니다. 변경 후 이미 열려 있던 애플리케이션은 새 설정을 읽도록 다시 시작해야 할 수 있습니다.

브라우저와 터미널의 동작이 다른 이유

일부 애플리케이션은 데스크톱 시스템 프록시를 따르고, 일부는 자체 네트워크 설정을 사용하며, 일부 명령줄 도구는 환경 변수만 읽습니다. 따라서 “브라우저는 접속되지만 터미널 명령은 프록시를 사용하지 않음”이 반드시 코어 오류를 뜻하는 것은 아닙니다. 먼저 애플리케이션이 어떤 프록시 설정을 사용하는지 확인한 뒤 필요한 경우 별도로 설정하세요.

현재 터미널 세션에서만 프록시를 사용하려면 v2rayN에 표시된 실제 수신 유형과 포트에 맞춰 환경 변수를 설정할 수 있습니다. 아래에는 명령 구조만 제시하며 포트는 클라이언트 화면의 값과 일치해야 합니다:

export http_proxy=http://127.0.0.1:10808
export https_proxy=http://127.0.0.1:10808
export all_proxy=socks5://127.0.0.1:10808

현재 포트가 10808이 아니라면 실제 값으로 바꾸세요. 터미널을 닫으면 이 임시 변수는 사라집니다. 로컬 포트를 확인하지 않은 상태에서 셸 시작 파일에 기록하지 마세요. 터미널을 열 때마다 존재하지 않는 프록시 진입점을 가리키게 됩니다.

로그인 후 자동 시작 및 자동 실행 설정

데스크톱 클라이언트에서 말하는 자동 시작은 정확히는 “사용자가 그래픽 데스크톱에 로그인한 뒤 자동으로 시작”하는 것을 뜻하는 경우가 많습니다. v2rayN은 데스크톱 세션, 트레이 및 사용자 설정 디렉터리가 필요하므로 시스템 수준 백그라운드 서비스로 너무 일찍 강제 실행하는 방식은 적합하지 않습니다. 먼저 클라이언트 설정의 자동 시작 옵션을 사용하고, 현재 데스크톱 환경에서 적용되지 않을 때 XDG 자동 시작 디렉터리를 사용하세요.

방법 1: 클라이언트 내장 옵션 활성화

1. v2rayN 설정을 열고 자동 시작 또는 로그인 후 시작 옵션을 찾으세요.
2. 설정을 저장한 뒤 클라이언트를 완전히 종료하세요.
3. 현재 데스크톱 사용자 세션에서 로그아웃한 다음 다시 로그인하세요.
4. 트레이 아이콘, 프로세스 및 로그를 확인해 인스턴스가 하나만 실행되는지 확인하세요.
5. 클라이언트가 시작된 후 시스템 프록시 상태가 예상대로 복원되는지 확인하세요.

테스트할 때는 창만 닫지 말고 로그아웃한 뒤 다시 로그인하세요. 일부 데스크톱 환경에서는 기본 창을 닫으면 트레이로 최소화된 것으로 처리되어 프로세스가 계속 실행됩니다. 이 상태에서는 자동 시작이 실제로 적용되었는지 확인할 수 없습니다.

방법 2: 기존 데스크톱 실행 항목을 autostart로 복사

패키지를 설치하면 보통 데스크톱 실행 항목 파일이 함께 제공됩니다. 먼저 해당 파일을 찾은 다음 현재 사용자의 자동 시작 디렉터리로 복사할 수 있습니다:

find /usr/share/applications -iname '*v2rayn*.desktop'
mkdir -p ~/.config/autostart
desktop_file="$(find /usr/share/applications -iname '*v2rayn*.desktop' | head -n 1)"
test -n "$desktop_file" && cp "$desktop_file" ~/.config/autostart/

복사가 끝나면 로그아웃한 뒤 다시 로그인하세요. 첫 번째 명령에서 결과가 나오지 않으면 먼저 패키지 파일 목록으로 데스크톱 파일의 설치 위치를 확인하세요. 알 수 없는 프로그램 경로를 가리키는 시작 항목을 임의로 만들지 마세요. deb 시스템에서는 dpkg -L로, rpm 시스템에서는 rpm -ql로 조회할 수 있습니다.

로그인 후 v2rayN 인스턴스가 두 개 나타난다면 클라이언트 내장 시작 항목과 수동으로 복사한 XDG 시작 항목이 동시에 적용된 것입니다. 한 가지 방식만 남기면 됩니다. 사용자 디렉터리의 중복 항목을 삭제할 수 있습니다:

rm -f ~/.config/autostart/*v2rayN*.desktop
rm -f ~/.config/autostart/*v2rayn*.desktop

삭제하기 전에 ls -la ~/.config/autostart로 파일을 확인할 수 있습니다. Linux에서는 파일 이름의 대소문자를 구분하므로 여기서는 자주 사용되는 대소문자 형식을 각각 처리했습니다. 자동 시작 항목을 삭제해도 v2rayN이 제거되거나 구독 및 클라이언트 설정이 삭제되지는 않습니다.

시스템 수준 service로 데스크톱 창을 시작하지 마세요

그래픽 클라이언트를 시스템 수준 service로 직접 등록하면 그래픽 디스플레이를 찾지 못하거나, 사용자 세션에 연결하지 못하거나, 잘못된 홈 디렉터리를 읽거나, 관리자 권한으로 설정 파일을 만드는 문제가 흔히 발생합니다. 데스크톱 사용자는 클라이언트 내장 옵션 또는 XDG autostart를 사용해야 합니다. 사용자 서비스, 데스크톱 세션 환경 및 프로그램 시작 인수를 명확히 이해하는 경우에만 추가 서비스 관리 방식을 고려하세요.

자주 발생하는 설치 및 실행 문제별 해결 방법

패키지에서 아키텍처 불일치를 알리는 경우

uname -m을 다시 실행하고 다운로드 파일에 표시된 아키텍처와 대조하세요. x64 패키지는 arm64 시스템에 직접 설치할 수 없으며 그 반대도 마찬가지입니다. 아키텍처 불일치는 의존성 부족 문제가 아니므로 런타임 라이브러리를 추가로 설치해도 해결되지 않습니다.

패키지를 두 번 클릭해도 반응이 없음

파일 관리자에서 두 번 클릭해 설치하는 방식은 데스크톱의 소프트웨어 설치 프런트엔드에 의존합니다. 해당 프런트엔드가 설치되지 않았거나 권한 알림이 가려져 있거나 파일 연결에 문제가 있으면 두 번 클릭해도 눈에 띄는 반응이 없을 수 있습니다. APT, DNF 또는 Zypper로 설치하면 오류 내용을 바로 확인할 수 있어 경로, 아키텍처 또는 의존성 문제를 판단하기 쉽습니다.

실행 후 창이 비어 있거나 바로 종료됨

먼저 터미널에서 실행해 전체 출력을 보존하세요. 데스크톱 세션이 정상인지, 시스템 그래픽 구성 요소가 완전한지, 패키지가 현재 배포판 버전에 맞는지 확인하세요. 대규모 시스템 업그레이드를 방금 마쳤다면 로그아웃하거나 시스템을 재부팅해 새 그래픽 라이브러리와 데스크톱 구성 요소가 완전히 로드되도록 하세요.

사용자 설정 디렉터리의 권한도 확인하세요. 과거에 sudo로 그래픽 클라이언트를 직접 실행했다면 일부 설정 파일의 소유자가 관리자 사용자가 되어 일반 사용자가 이후 파일을 쓰지 못할 수 있습니다. v2rayN을 장기간 관리자 권한으로 실행하지 마세요. 먼저 사용자 디렉터리의 관련 파일 소유자를 확인하고, 해당 클라이언트에 속한다고 확인된 디렉터리만 권한을 수정하세요.

클라이언트는 정상적으로 시작되지만 웹 페이지에 연결되지 않음

네 단계로 확인하세요. 1단계는 노드가 선택되었는지, 2단계는 코어가 정상적으로 시작되어 로컬 포트를 수신 대기 중인지, 3단계는 시스템 프록시가 해당 포트를 가리키는지, 4단계는 대상 애플리케이션이 시스템 프록시를 따르는지 확인하는 것입니다. 처음부터 구독을 삭제하거나 클라이언트를 재설치하지 마세요.

일부 웹사이트만 실패한다면 라우팅 분기 규칙도 확인해야 합니다. v2rayN은 도메인, 주소 범위 또는 규칙 세트에 따라 직접 연결, 프록시 또는 차단을 결정할 수 있습니다. 잘못된 규칙 때문에 대상 요청이 적절하지 않은 출구로 전달될 수 있습니다. 테스트할 때는 일시적으로 판단하기 쉬운 라우팅 모드로 전환해 기본 연결이 정상인지 확인한 뒤, 원래 모드로 돌아와 사용자 지정 규칙을 하나씩 점검하세요.

구독 업데이트는 성공했지만 목록이 바뀌지 않음

먼저 올바른 구독 그룹을 업데이트했는지 확인하고 업데이트 로그를 확인하세요. 일부 구독 응답은 비어 있거나 클라이언트가 해석할 수 없는 형식일 수 있습니다. 이때는 구독 주소, 그룹 설정 및 서버에서 제공하는 형식을 점검하세요. 패키지 설치가 정상이라고 해서 구독 내용도 유효한 것은 아니므로 두 문제를 분리해 처리해야 합니다.

재부팅 후 시스템 프록시가 작동하지 않는 포트를 가리킴

대개 시스템 프록시 상태가 클라이언트보다 먼저 복원되었거나 v2rayN이 자동으로 시작되지 않은 경우입니다. 먼저 데스크톱 시스템 프록시를 지운 다음 클라이언트를 시작하고 코어 포트를 확인한 뒤 시스템 프록시 자동 설정을 다시 활성화하세요. 이어서 자동 시작 항목이 중복되었는지, 로그인 후 클라이언트가 충돌하는지, 로컬 포트를 다른 프로그램이 사용 중인지 확인하세요.

제거, 재설치 및 업그레이드 순서

업그레이드하기 전에 v2rayN을 종료해 기존 프로세스가 파일이나 로컬 포트를 계속 점유하지 않도록 하세요. 같은 패키지 체계로 새 버전을 설치하면 APT, DNF 또는 Zypper가 보통 업그레이드 트랜잭션으로 인식합니다. 실행 전에 트랜잭션 요약을 읽고 패키지 이름과 아키텍처가 올바른지 확인하세요.

제거해야 한다면 먼저 시스템 프록시를 지우고 클라이언트를 종료하세요. Debian과 Ubuntu에서는 정확한 패키지 이름을 조회한 뒤 APT로 삭제하고, Fedora와 openSUSE에서는 RPM으로 패키지 이름을 조회한 뒤 해당 관리자로 처리하세요. /usr 아래의 개별 파일을 직접 삭제하지 마세요. 패키지 데이터베이스에는 프로그램이 계속 설치된 상태로 남습니다.

dpkg -l | grep -i v2ray
rpm -qa | grep -i v2ray

애플리케이션 제거와 사용자 설정 삭제는 별개의 작업입니다. 일반적인 제거는 보통 사용자 디렉터리의 구독, 라우팅 및 인터페이스 설정을 보존하므로 재설치 후 다시 사용할 수 있습니다. 문제가 설정 내용에서 비롯되었다면 패키지만 재설치해도 문제가 계속될 수 있습니다. 초기화가 필요하다면 필요한 구독 정보를 먼저 백업한 뒤 클라이언트의 초기화 기능을 사용하거나 설정 디렉터리를 정확히 확인한 후 처리하세요.