Linux용 v2rayN 데스크톱 설치: deb/rpm 패키지 설치와 자동 실행 설정

Debian/Ubuntu와 Fedora/openSUSE에서 v2rayN을 설치하는 방법을 안내합니다. GNOME/KDE의 의존성, 바로가기, 로그인 시 자동 실행, 시스템 프록시 설정도 살펴봅니다.

이 글 미리 보기

Linux 그래픽 데스크톱에 v2rayN을 처음 설치하는 사용자를 위한 안내입니다. 배포판과 CPU 아키텍처에 맞는 패키지를 선택하고 일반 사용자 계정으로 실행한 다음, 구독을 가져와 로컬 프록시를 확인하세요. 수동 실행이 정상인지 확인한 후 같은 앱 바로가기를 로그인 시 자동 실행에 등록하고, GNOME 또는 KDE의 프록시 설정을 대상 앱이 읽는지 점검합니다.

설치 패키지 선택: 배포판과 CPU 아키텍처

터미널에서 cat /etc/os-release를 실행해 배포판을 확인하고, uname -m으로 CPU 아키텍처를 확인하세요. 결과가 x86_64이면 다운로드 항목에는 x64, deb 패키지 메타데이터에는 보통 amd64로 표시됩니다. aarch64이면 해당하는 ARM64 빌드를 선택하세요. 파일 확장자가 맞더라도 아키텍처가 일치하거나 현재 배포판 버전을 지원한다는 뜻은 아닙니다.

배포판용 패키지

권장

Debian과 Ubuntu에서는 deb를, Fedora와 openSUSE에서는 배포판과 호환되는 rpm을 선택하세요. 패키지 관리자는 선언된 의존성을 확인하고 설치한 파일을 기록합니다.

추천 대상: 다운로드 페이지에서 호환되는 아키텍처 패키지를 제공하고, 필요한 의존성을 시스템 저장소에서 설치할 수 있는 데스크톱 환경

압축 파일로 설치

다운로드 페이지에서 해당 아키텍처의 압축 파일을 제공한다면 사용자 디렉터리의 고정된 위치에 압축을 풀어 설치할 수 있습니다. 시스템 라이브러리가 추가로 필요할 수 있으며, 데스크톱 바로가기도 직접 추가해야 할 수 있습니다.

추천 대상: 사용자 디렉터리에서 프로그램을 관리하고 실행 환경의 호환성을 확인한 경우

deb 및 rpm 설치 명령

터미널에서 설치 패키지가 있는 디렉터리로 이동한 뒤, 아래 명령의 예시 파일명 v2rayN.deb 또는 v2rayN.rpm을 실제 파일명으로 바꾸세요. 앞의 ./는 현재 디렉터리에 있는 로컬 파일을 가리키므로 그대로 둡니다. 배포판에 맞는 명령 하나만 선택해 실행하면 됩니다.

아키텍처가 맞지 않는다는 메시지가 나오면 다운로드 페이지에서 다른 패키지를 선택하세요. 의존성을 찾을 수 없다는 메시지가 나오면 오류에 표시된 라이브러리 이름과 최소 버전을 확인한 뒤, 배포판 버전과 활성화된 저장소를 점검하세요. dpkg-deb -I "./v2rayN.deb"로 deb 메타데이터를 확인하거나 rpm -qpR "./v2rayN.rpm"으로 rpm에 선언된 의존성을 볼 수도 있습니다. 강제로 설치하지 마세요. 의존성 검사를 건너뛰어도 누락된 런타임 라이브러리가 설치되지는 않습니다.

첫 실행: 앱 바로가기, 구독, 수신 포트

  1. 앱 실행하기

    GNOME의 앱 개요나 KDE Plasma 앱 실행기에서 'v2rayN'을 검색한 뒤 일반 사용자로 실행하세요. 검색되지 않으면 설치 패키지에 .desktop 파일이 있는지 확인하세요. 실행 명령과 앱 표시 이름이 같다고 단정하지 마세요.

  2. 구독 추가

    메인 창에서 '구독 그룹' → '구독 그룹 설정'을 열고 그룹을 추가한 다음 구독 주소를 입력해 저장하세요. '+' 버튼이 있는 화면에서는 그룹 목록에서 바로 추가할 수도 있습니다. 그런 다음 '구독 그룹' 메뉴에서 업데이트를 실행하세요. 사용할 수 있는 노드가 아직 없다면 먼저 프록시를 사용하지 않는 업데이트 옵션을 시도하세요.

  3. 노드 선택

    방금 업데이트한 그룹으로 전환하고 후보 노드를 마우스 오른쪽 버튼으로 클릭한 다음 '활성 서버로 설정'을 선택하세요. 노드가 목록에 보이는 것은 가져오기가 완료됐다는 뜻일 뿐입니다. 메인 창의 로그에서 코어가 시작된 후 바로 종료되지 않았는지도 확인하세요.

  4. 로컬 포트 확인

    '설정' → '매개변수 설정'을 열어 로컬 수신 포트를 확인하세요. 현재 코어가 개별 포트와 혼합 포트 중 어느 것을 사용하는지 확인한 뒤 ss -ltn으로 해당 TCP 포트가 수신 중인지 점검합니다. 처음 확인할 때는 TUN을 꺼 두어 가상 네트워크 인터페이스 문제와 프록시 포트 문제를 혼동하지 않도록 하세요.

127.0.0.1
로컬 프록시의 IPv4 루프백 주소
10808
일반적인 로컬 프록시 포트입니다. 실제 설정을 기준으로 확인하세요.

포트 번호만으로 프로토콜을 판단하지 마세요. 현재 SOCKS 수신 포트라면 앱의 SOCKS 항목에 입력하고, HTTP 항목에는 실제로 HTTP를 지원하는 포트를 입력하세요. 로그에 주소가 이미 사용 중이라고 나오면 ss -ltnp로 현재 계정에서 확인할 수 있는 수신 프로세스를 살펴보세요. 중복 실행인지 다른 앱이 사용 중인지 확인한 뒤 기존 인스턴스를 종료하거나 포트를 변경하면 됩니다. 포트를 바꾼 경우 이전에 직접 입력한 프록시 주소도 업데이트하세요.

로그인 시 자동 실행: 그래픽 데스크톱 로그인 후 시작

데스크톱 앱의 자동 실행은 보통 그래픽 세션에 로그인한 뒤 프로그램을 실행하는 기능이며, 로그인 화면이 나타나기 전에 실행하는 기능은 아닙니다. 먼저 앱 메뉴에서 정상 실행되는지 확인한 다음, 클라이언트 내장 자동 실행이나 데스크톱 자동 시작 항목 중 하나를 선택하세요. 양쪽 모두 등록하면 중복 실행될 수 있습니다. 로그인 화면에 머물러 있는 상태만으로 자동 실행 실패 여부를 판단할 수도 없습니다.

GNOME과 KDE의 시스템 프록시 설정

GNOME

설정 경로
'설정' → '네트워크' → '네트워크 프록시'
모드
수동
주소
127.0.0.1, 포트는 프록시 종류에 맞게 입력

기존 설정을 먼저 기록해 두세요. v2rayN이 데스크톱 프록시 설정을 이미 적용했다면 별도로 수동 설정할 필요가 없습니다.

KDE Plasma

설정 경로
'시스템 설정'에서 '프록시' 검색
모드
프록시 설정 수동 지정
주소
HTTP와 SOCKS는 각각의 수신 설정에 맞춰 입력

저장한 뒤 대상 앱에서 확인하세요. 별도 프록시 옵션이 있는 브라우저는 특히 확인이 필요합니다.

시스템 프록시는 데스크톱 세션이 앱에 제공하는 설정이지, 시스템 전체의 트래픽을 처리하는 기능은 아닙니다. 브라우저에서 자체 수동 프록시를 선택했다면 브라우저 설정을 사용하고, 터미널 도구는 환경 변수나 명령 옵션만 읽을 수도 있습니다. 한 앱에서는 연결되지만 다른 앱에서는 안 된다면 노드 문제라고 단정하지 말고 두 앱이 각각 어디에서 프록시 설정을 읽는지 비교하세요. 일부 앱에만 프록시를 적용하려면 데스크톱의 기존 설정은 유지하고 대상 앱에만 로컬 프록시를 지정할 수 있습니다.

설치 및 자동 실행 문제 해결

설치했는데 앱 메뉴에 표시되지 않는 이유는?

dpkg-deb -c "./v2rayN.deb" 또는 rpm -qpl "./v2rayN.rpm"로 패키지에 데스크톱 바로가기가 포함되어 있는지 확인하고, 설치 작업이 완료됐는지도 점검하세요. 바로가기가 있는데 메뉴가 갱신되지 않았다면 로그아웃한 뒤 다시 로그인하세요. 패키지에 바로가기가 없다면 파일 목록에서 실제 실행 파일을 찾아 직접 실행하세요.

로그인 후 창이 보이지 않아요. 앱이 실행되지 않은 건가요?

반드시 그렇지는 않습니다. 먼저 로컬 수신 포트를 확인하고, 앱이 시작 시 최소화되도록 설정되어 있는지 살펴보세요. 일부 데스크톱 환경에서는 시스템 트레이 아이콘이 표시되지 않을 수 있으므로 창이 보이지 않는다고 프로세스가 실행되지 않은 것은 아닙니다. 수신 포트가 없다면 앱 메뉴에서 직접 실행해 로그인할 때만 문제가 생기는지 확인하세요.

클라이언트를 종료한 뒤 브라우저에서 웹 페이지가 열리지 않아요. 어떻게 복구하나요?

GNOME 또는 KDE의 프록시가 종료된 로컬 포트를 계속 가리키는지 확인하세요. 설정이 남아 있다면 이전 데스크톱 프록시 설정으로 복원하고, 이전에 프록시를 사용하지 않았다면 수동 프록시를 끄세요. 브라우저 하나만 영향을 받는다면 루프백 주소와 포트를 별도로 저장했는지도 확인하세요.

v2rayN 다운로드