v2rayN Linux 데스크톱 설치: deb·rpm 패키지 및 로그인 시 자동 실행 설정

Debian·Ubuntu와 Fedora·openSUSE 환경에서 v2rayN 데스크톱 설치, 의존성 해결, 바로가기 생성 및 로그인 후 자동 실행 설정을 안내합니다.

이 글의 핵심

Linux 그래픽 데스크톱에 v2rayN을 설치하거나 옮기려는 사용자를 위한 안내입니다. 먼저 배포판, 패키지 아키텍처, 의존성을 확인하고 애플리케이션 메뉴에서 직접 실행되는지 테스트한 뒤, 확인된 데스크톱 항목을 활용해 로그인 시 자동 실행을 설정합니다. 여기서 말하는 자동 실행은 사용자가 데스크톱에 로그인한 다음 시작하는 방식이며, 로그인 화면이 나타나기 전에 시스템 서비스로 실행하는 방식이 아닙니다.

deb 또는 rpm 선택: 배포판과 아키텍처 확인

먼저 cat /etc/os-release를 실행해 배포판과 버전을 확인하고, 이어서 uname -m으로 시스템 아키텍처를 확인합니다. Debian 계열에서는 dpkg --print-architecture로 패키지 관리자가 사용하는 아키텍처 이름을 확인할 수 있습니다. RPM 계열에서는 rpm --eval '%{_arch}'를 실행해 확인합니다. 파일명의 x64, amd64, x86_64는 대개 같은 종류의 시스템을 가리키지만, 호환 여부는 패키지 헤더에 선언된 값으로 패키지 관리자가 판단합니다.

Debian / Ubuntu

패키지 형식
.deb
64비트 x86 패키지 아키텍처
amd64
64비트 ARM 패키지 아키텍처
arm64
로컬 패키지 설치
apt install ./파일명.deb

APT로 로컬 패키지를 설치하면 활성화된 저장소에서 제공하는 의존성을 함께 해결합니다.

Fedora / openSUSE

패키지 형식
.rpm
64비트 x86 패키지 아키텍처
x86_64
64비트 ARM 패키지 아키텍처
aarch64
로컬 패키지 설치
Fedora는 DNF, openSUSE는 Zypper 사용

RPM 형식이 같아도 의존성까지 호환되는 것은 아닙니다. 대상 배포판과 버전을 확인하세요.

아키텍처 이름이 일치해도 해당 버전용 빌드가 반드시 제공되는 것은 아닙니다. 다운로드 페이지에 맞는 패키지가 없다면 확장자를 바꾸거나 아키텍처 검사를 강제로 무시해 설치하지 마세요. 같은 배포판 버전에 맞는 압축 패키지가 있다면 해당 빌드의 안내에 따라 지정된 사용자 디렉터리에 설치할 수 있습니다. 이후 생성할 데스크톱 항목에서 임시 압축 해제 경로를 사용하지 마세요.

패키지 관리자로 설치하고 의존성 해결하기

  1. 패키지 정보 확인

    설치 패키지가 있는 디렉터리에서 deb 파일은 dpkg-deb -f 파일명.deb Package Version Architecture Depends, rpm 파일은 rpm -qp --qf '%{NAME} %{VERSION}-%{RELEASE} %{ARCH}\n' 파일명.rpm을 실행합니다. 명령의 파일명은 실제로 다운로드한 이름으로 바꾸세요. 패키지 이름을 기록해 두세요. 애플리케이션 메뉴에 표시되는 v2rayN과 이름이 다를 수 있으며, 나중에 설치 파일을 조회할 때 필요합니다.

  2. 로컬 패키지 설치

    Debian 또는 Ubuntu에서는 먼저 sudo apt update를 실행한 뒤 sudo apt install ./파일명.deb를 실행합니다. Fedora에서는 sudo dnf install ./파일명.rpm, openSUSE에서는 sudo zypper install ./파일명.rpm을 사용합니다. 패키지 관리자가 로컬 경로로 인식하도록 ./를 그대로 두세요. 실제 파일명에 공백이 있으면 경로 전체를 따옴표로 감싸세요.

  3. 의존성 확인

    설치 프로그램에서 의존성 누락을 알리면 누락된 패키지명, 라이브러리명 또는 필요한 최소 버전을 기록하세요. APT를 사용한다면 Depends 항목을 확인하고, RPM 계열에서는 rpm -qpR 파일명.rpm으로 선언된 의존성을 확인합니다. 현재 배포판의 저장소에서 해당 의존성을 제공하는지 확인한 뒤 다른 빌드가 필요한지 판단하세요. 서로 다른 배포판의 저장소를 섞어 추가하거나 의존성 검사를 무시하는 옵션으로 설치하지 마세요.

  4. 직접 실행해 보기

    현재 사용자 계정의 애플리케이션 메뉴에서 v2rayN을 검색하세요. 창이 열리는지, 종료한 뒤 다시 실행할 수 있는지 확인한 다음 구독과 시스템 프록시를 설정합니다. 시스템 패키지 설치에는 관리자 권한을 사용하되, 클라이언트는 데스크톱에 로그인한 사용자 계정으로 실행하세요. 관리자 계정의 홈 디렉터리에 설정 파일이 저장되거나 현재 사용자가 쓸 수 없는 파일이 만들어지는 문제를 방지할 수 있습니다.

애플리케이션 메뉴, 바탕화면 바로가기 및 실행 명령

설치 패키지가 .desktop 파일을 등록하는 경우가 있습니다. 앞서 기록한 실제 패키지 이름으로 dpkg -L 패키지명 또는 rpm -ql 패키지명을 실행하고 출력에서 .desktop 파일을 찾으세요. 파일을 찾으면 Name, Exec, 기존에 지정된 TryExec 값을 확인하세요. 파일명만 보고 실제 실행 명령을 추측하지 마세요. 데스크톱 환경에 따라 시스템 트레이 아이콘이 표시되지 않을 수 있으므로 창, 프로세스 또는 로그도 함께 확인해야 합니다.

패키지에서 등록한 항목 재사용

권장

먼저 애플리케이션 메뉴에 등록된 항목을 사용하세요. 자주 쓰는 위치에 고정하려면 데스크톱 환경의 작업 표시줄 고정 또는 즐겨찾기 기능을 이용하세요. 실행 경로는 설치 패키지가 계속 관리합니다.

적합한 경우: deb 또는 rpm 패키지를 설치했고 애플리케이션 메뉴에서 정상 실행되는 경우

사용자용 항목 만들기

${XDG_DATA_HOME:-$HOME/.local/share}/applications에 v2rayn-local.desktop을 만드세요. 파일에 [Desktop Entry], Type=Application, Name=v2rayN, Terminal=false를 입력하고, Exec은 확인을 마친 실제 실행 파일을 가리키도록 설정합니다. 실행 파일 경로에 공백이 있으면 큰따옴표로 감싸세요. ~나 $HOME은 사용하지 마세요. 데스크톱 항목은 대화형 셸처럼 이를 확장하지 않습니다.

적합한 경우: 압축 패키지를 사용하거나 현재 빌드에 애플리케이션 메뉴 항목이 없는 경우

바탕화면에 아이콘을 두려면 xdg-user-dir DESKTOP을 실행해 현재 사용자 계정의 바탕화면 경로를 확인하세요. 경로 이름이 항상 Desktop이라고 가정하지 마세요. 데스크톱 환경이 바탕화면 아이콘을 지원하고 명령 결과가 실제 바탕화면 디렉터리일 때만 확인된 항목을 복사한 뒤, 데스크톱의 안내에 따라 실행을 허용하세요. 바탕화면 파일을 기본적으로 표시하지 않는 환경이라면 애플리케이션 메뉴 항목만 사용하면 됩니다.

로그인 시 자동 실행 설정 및 프록시 상태 확인

자동 실행 등록은 한 가지 방식만 사용하세요. 현재 빌드의 ‘설정’ → ‘매개변수 설정’에 로그인 시 실행 옵션이 있다면 먼저 해당 옵션을 사용하고 로그아웃 후 다시 로그인해 확인하세요. 옵션이 없다면 데스크톱 환경에서 지원하는 XDG 자동 실행 디렉터리를 이용하세요. 아래 경로는 데스크톱 항목, 자동 실행 항목, 로컬 리스너의 차이를 설명하기 위한 것으로, 서로 대체할 수 없습니다.

10808
로컬 리스너 포트 예시. 실제 값은 매개변수 설정을 확인하세요.
1
동일한 클라이언트에 등록할 자동 실행 항목 수
  1. mkdir -p "${XDG_CONFIG_HOME:-$HOME/.config}/autostart"를 실행하세요. 앞 단계에서 검증한 .desktop 파일을 해당 디렉터리에 복사합니다. sudo는 필요하지 않으며 그래픽 클라이언트를 시스템 서비스로 등록할 필요도 없습니다.
  2. 복사한 파일의 Exec과 TryExec이 현재 설치 경로를 가리키는지 확인하세요. Hidden=true, OnlyShowIn, NotShowIn 항목이 있다면 자동 실행을 막거나 현재 데스크톱 환경을 제외하는지 확인합니다. Exec에 파일 또는 URL 인자 필드가 포함되어 있다면 자동 실행용 복사본에는 파일이나 URL을 전달하지 말고, 검증된 일반 실행 명령을 사용하세요.
  3. 클라이언트를 종료한 뒤 로그아웃하고 같은 그래픽 데스크톱 계정으로 다시 로그인하세요. 먼저 직접 실행하지 말고 프로그램이 이미 시작되었는지 확인한 다음 ‘설정’ → ‘매개변수 설정’에서 로컬 리스너 포트를 확인합니다. 포트가 실제로 10808이라면 ss -ltn 'sport = :10808'을 실행해 리스닝 상태를 확인할 수 있습니다. 포트를 다른 프로세스가 사용 중이라면 ss -ltnp 'sport = :10808'으로 해당 프로세스를 확인해 보세요.
  4. 마지막으로 시스템 프록시 설정과 대상 애플리케이션이 해당 설정을 사용하는지 확인하세요. 리스너 포트가 열려 있다는 것은 프로세스가 로컬 연결을 받고 있다는 뜻일 뿐, 브라우저가 프록시를 사용하거나 라우팅 규칙이 예상한 아웃바운드를 선택한다는 뜻은 아닙니다. 먼저 기존에 수동으로 작동했던 노드와 애플리케이션으로 확인하고, 구독·포트·라우팅을 한꺼번에 변경하지 마세요.

Linux 설치 관련 자주 묻는 질문

로컬 패키지 설치 중 의존성 버전이 너무 낮다는 오류가 나면 어떻게 하나요?

cat /etc/os-release를 실행해 빌드 대상과 현재 배포판을 비교하세요. Debian 계열에서는 apt-cache policy 패키지명으로 후보 버전을 확인합니다. 배포판 저장소에서 필요한 버전을 제공하지 않는다면 현재 배포판에 맞는 빌드를 사용하거나 배포판을 정식 절차에 따라 업그레이드하세요. 시스템 공유 라이브러리를 교체하면 같은 라이브러리에 의존하는 다른 프로그램에 영향을 줄 수 있습니다.

메뉴에서는 실행되는데 로그아웃 후 다시 로그인하면 시작되지 않나요?

실제 XDG_CONFIG_HOME 값을 확인하고 해당 계정의 autostart 디렉터리에 항목이 있는지 살펴보세요. applications에만 넣은 것은 아닌지 확인합니다. 자동 실행용 복사본의 경로와 데스크톱 제한 필드도 점검하세요. 사용자 지정 명령이 터미널 시작 스크립트에서 설정되는 환경 변수에 의존한다면 설치 패키지의 항목이나 데스크톱 세션에서 독립적으로 실행할 수 있는 명령을 사용하세요.

로그인 후 여러 번 실행되거나 업그레이드 후 실행 오류가 발생하나요?

먼저 데스크톱 환경의 자동 실행 목록과 사용자 자동 실행 디렉터리를 확인해 클라이언트 내장 설정과 수동 항목이 중복 등록되지 않았는지 살펴보세요. 업그레이드한 뒤에는 패키지에 포함된 데스크톱 항목을 다시 확인하세요. 수동 복사본이 이전 경로를 가리킨다면 새로 검증한 항목으로 교체합니다. 수동 자동 실행을 중지하려면 자동 실행 디렉터리에 있는 복사본만 삭제하고 애플리케이션 메뉴 항목은 유지하세요.

v2rayN 다운로드