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

1. 배포판·아키텍처·설치 방식 확인

v2rayN은 데스크톱 클라이언트입니다. 설치가 완료되어도 연결이 바로 가능한 것은 아닙니다. 유효한 서버 설정 또는 구독과 프로토콜에 맞는 코어가 필요합니다. 이 글은 그래픽 데스크톱에 클라이언트를 설치하는 방법을 다루며, 로그인하지 않은 상태에서 실행되는 시스템 프록시 서비스를 설명하지 않습니다. 터미널만 있는 서버에는 이 데스크톱 자동 실행 절차를 적용하기 어렵습니다.

터미널을 열고 아래 두 명령을 실행하세요. 첫 번째 명령은 배포판 정보와 버전을, 두 번째 명령은 시스템 아키텍처를 확인합니다. 일반적으로 x86_64는 x64 패키지, aarch64는 arm64 패키지에 해당합니다. 아키텍처가 맞지 않으면 의존성을 추가해도 실행 파일이 작동하지 않습니다.

cat /etc/os-release
uname -m

2. Ubuntu·Debian에 deb 패키지 설치

로컬 deb 파일은 dpkg -i만 실행하기보다 apt install로 설치하는 편이 좋습니다. apt는 설정된 저장소에서 패키지에 선언된 의존성을 해결하려고 시도합니다. 아래 명령은 Bash 터미널에서 실행하세요. 안내가 나타나면 다운로드한 파일의 실제 경로를 입력합니다. 경로에 공백이 있어도 경로 자체를 입력하면 되며, 따옴표로 감쌀 필요는 없습니다.

read -r -p "deb 파일의 실제 경로를 입력하세요: " pkg
pkg="$(realpath -- "$pkg")"
dpkg-deb -f "$pkg" Package Version Architecture
sudo apt update
sudo apt install "$pkg"

1. 패키지 정보 확인

   위 출력에서 Package, Version, Architecture 항목을 확인하세요. 정보를 읽지 못하면 입력한 파일이 웹 페이지나 압축 파일이 아니라 다운로드한 deb 파일인지 확인하세요.

2. 설치 계획 확인

   apt가 표시하는 추가·업그레이드·삭제 항목을 살펴보세요. 데스크톱 구성 요소가 대량으로 삭제될 예정이라면 작업을 취소하고, 저장소에 다른 배포판이나 버전이 섞여 있지 않은지 확인하세요.

3. 앱 메뉴에서 실행

   설치가 끝나면 데스크톱 앱 메뉴에서 v2rayN을 찾아 일반 사용자로 실행하세요. 소프트웨어 설치에 관리자 권한이 필요하다고 해서 그래픽 클라이언트 실행에도 관리자 권한이 필요한 것은 아닙니다.

4. 오류 출력 기록

   창이 열리지 않으면 패키지에 포함된 데스크톱 실행기를 찾아 Exec 항목을 확인하세요. 해당 명령을 터미널에서 실행하고 누락된 라이브러리나 권한 오류를 기록합니다.

이전에 dpkg -i를 실행해 설치가 미완료 상태라면 sudo apt --fix-broken install을 실행할 수 있습니다. 복구 계획을 확인한 뒤 진행하세요. 의존성을 추가할 수도 있지만, 의존성을 만족할 수 없는 패키지를 제거할 수도 있으므로 클라이언트가 반드시 유지된다고 볼 수는 없습니다. 저장소에 연결되지 않는다면 설치를 반복하지 말고 먼저 저장소 접속 문제를 해결하세요.

3. Fedora에 rpm 설치 및 실행 위치 확인

Fedora에서는 dnf로 로컬 rpm 패키지를 설치합니다. dnf는 시스템 저장소를 이용해 의존성을 해결합니다. 반면 rpm -i만 사용하면 인터넷에서 의존성을 내려받아 설치하지 않습니다. 아래와 같이 실제 파일 경로를 입력하고, 패키지 정보를 확인한 다음 설치하세요.

read -r -p "rpm 파일의 실제 경로를 입력하세요: " pkg
pkg="$(realpath -- "$pkg")"
rpm -qp --queryformat '%{NAME}\n%{VERSION}-%{RELEASE}\n%{ARCH}\n' "$pkg"
sudo dnf install "$pkg"

의존성 충돌이 표시되더라도 의존성 검사를 건너뛰거나 강제로 덮어쓰는 옵션을 추가하지 마세요. 공유 라이브러리 누락, 패키지 아키텍처 불일치, 저장소 버전 혼용은 서로 다른 문제이므로 터미널에 표시된 패키지 이름을 기준으로 원인을 찾으세요. Fedora가 아닌 rpm 계열 배포판에서는 같은 패키지가 호환된다고 단정할 수도 없습니다.

데스크톱 실행기는 이후 문제 해결과 자동 실행 설정의 기준이 됩니다. Exec 항목에 %U, %F 같은 데스크톱 필드 코드가 포함되어 있다면 터미널에서 직접 테스트할 때 일반 인수처럼 그대로 복사하지 마세요. 패키지에 기록된 실제 경로를 사용하고, 설치 디렉터리 전체를 모든 사용자가 쓸 수 있도록 재귀적으로 권한 변경하지 마세요.

4. 첫 연결: 구독·포트·시스템 프록시

처음 실행할 때는 일반 프록시 방식을 유지하고 TUN은 아직 활성화하지 마세요. 메인 화면에서 ‘구독 그룹’ → ‘구독 그룹 설정’을 열어 그룹을 추가하고 구독 주소를 입력한 뒤 저장합니다. 그런 다음 ‘구독 그룹’ 메뉴에서 업데이트를 실행하세요. 버전에 따라 버튼 이름이 조금 다를 수 있으니 그룹 설정 창과 업데이트 메뉴를 기준으로 진행하세요. 구독 주소에 접속 정보가 포함될 수 있으므로 터미널 스크린샷이나 문의 내역을 공유할 때는 가리세요.

연결에 사용할 서버를 선택한 뒤 ‘설정’ → ‘매개변수 설정’에서 로컬 수신 정보를 확인하고, 클라이언트 로그에 기록된 실제 수신 주소도 살펴보세요. 아래에서는 10808을 확인 예시로 사용하지만, 모든 버전과 기존 설정에서 이 포트를 사용하는 것은 아닙니다. 해당 포트가 HTTP 또는 혼합 프록시를 지원하는지 확인한 경우에만 관련 curl 명령을 그대로 사용할 수 있습니다.

ss -ltnp 'sport = :10808'
curl --proxy http://127.0.0.1:10808 --max-time 15 -I https://example.com

전용 SOCKS 포트를 설정했다면 curl의 프록시 인수를 --proxy socks5h://127.0.0.1:10808로 바꾸고, 포트도 실제 설정에 맞추세요. socks5h는 대상 도메인 조회를 프록시 측에서 처리합니다. HTTP 응답을 받았다면 이번에 지정한 프록시 요청이 응답한 것입니다. 시스템의 모든 앱이 프록시를 사용한다는 뜻은 아닙니다.

• 로컬 수신 포트가 열리지 않음: 코어 시작 로그, 설정 구문 오류, 포트 충돌을 확인하세요. 브라우저 설정부터 변경하지 마세요.
• 지정한 프록시는 작동하지만 브라우저에서 사용할 수 없음: 클라이언트의 ‘시스템 프록시’ 메뉴 상태와 데스크톱의 네트워크 프록시 설정을 확인하세요. 일부 앱은 데스크톱 프록시 설정을 따르지 않습니다.
• 터미널에서 여전히 직접 연결됨: 터미널 프로그램은 그래픽 데스크톱의 프록시 설정을 자동으로 사용하지 않는 경우가 많습니다. 프로그램 자체의 프록시 옵션으로 확인하는 편이 정확합니다.
• TUN을 활성화하려는 경우: 먼저 라우팅과 DNS 설정을 백업한 뒤 현재 버전의 권한 요구 사항에 맞게 설정하세요. 일반 프록시를 테스트하려고 데스크톱 프로그램 전체를 root로 실행하지 마세요.

5. 트레이 아이콘이 없거나 창이 표시되지 않을 때

GNOME, KDE Plasma 등 데스크톱 환경마다 트레이 프로토콜 지원 방식이 다릅니다. GNOME에서 트레이 아이콘이 보이지 않아도 v2rayN이 실행 중일 수 있습니다. 상태 표시기 지원이 없거나 관련 확장 기능이 설치되어 있지만 활성화되지 않았을 수도 있습니다. 먼저 앱 메뉴에서 창을 다시 열고, 이어서 프로세스와 로컬 수신 포트를 확인하세요.

프로그램이 정상적으로 열리고 연결도 되는데 트레이 아이콘만 없다면 코어를 다시 설치하지 말고 데스크톱 통합부터 해결하세요. 로그에서 코어 프로세스가 종료된 것으로 확인되면 설정과 코어 권한을 다시 점검해야 합니다. 트레이 확장 기능으로 프로토콜 설정 오류나 포트 충돌을 해결할 수는 없습니다.

6. 로그인 후 자동 실행: 데스크톱 실행기 재사용

흔히 ‘부팅 시 자동 실행’이라고 하지만 v2rayN 그래픽 클라이언트는 정확히 말해 ‘사용자가 데스크톱에 로그인한 뒤 실행’됩니다. 전원을 켠 직후, 로그인 전이거나 텍스트 터미널만 실행 중인 상태, 원격 명령으로 로그인한 상태는 그래픽 세션이 준비된 것과 다릅니다. 일반적인 데스크톱 환경은 XDG 자동 실행 디렉터리 ~/.config/autostart/를 지원합니다. Exec 경로를 추측하기보다 패키지에 포함된 desktop 파일을 재사용하는 편이 안전합니다.

1. 수동 실행이 되는지 확인

   먼저 앱 메뉴에서 프로그램을 실행해 연결을 한 번 테스트하세요. 클라이언트에 자동 실행 옵션이 있다면 먼저 자동 실행 항목이 이미 생성되었는지 확인해 중복 설정을 피하세요.

2. 실행기 찾기

   앞에서 확인한 패키지 파일 목록에서 앱에 해당하는 desktop 파일을 찾으세요. 파일을 열어 Exec 경로를 확인하고, 제거 프로그램이나 임시 다운로드 디렉터리를 가리키지 않는지 살펴보세요.

3. 사용자 디렉터리에 복사

   아래 명령을 실행하고 해당 desktop 파일의 전체 경로를 입력하세요. 대상 파일 이름은 확인과 되돌리기가 쉽도록 v2rayN.desktop으로 고정합니다. 이 작업은 현재 사용자에게만 적용됩니다.

4. 로그아웃 후 확인

   작업 중인 내용을 저장하고 로그아웃한 뒤 데스크톱에 다시 로그인하세요. 클라이언트 프로세스와 창 또는 트레이 아이콘을 확인한 다음 로컬 포트와 실제 연결도 점검하세요. 아이콘만 보고 자동 실행이 성공했다고 판단하지 마세요.

read -r -p "앱 desktop 파일의 전체 경로를 입력하세요: " entry
grep -E '^(Type|Exec|TryExec|Hidden|OnlyShowIn|NotShowIn)=' "$entry"
install -Dm644 "$entry" "$HOME/.config/autostart/v2rayN.desktop"

복사하기 전에 grep 출력을 확인하세요. Hidden=true이면 해당 자동 실행 항목이 비활성화되고, OnlyShowIn 및 NotShowIn은 적용할 데스크톱 환경을 제한합니다. 복사한 뒤 실행되지 않으면 텍스트 편집기로 이 항목들을 확인하고 X-GNOME-Autostart-enabled=false가 있는지도 살펴보세요. Name만 수정하지 마세요. Name은 화면에 표시되는 이름일 뿐 프로그램을 실행하지 않습니다.

이 절의 설정을 되돌리려면 이번에 만든 파일만 삭제하면 됩니다. 시스템 설정에 v2rayN 자동 실행 항목이 추가로 있다면 함께 확인하고 비활성화하세요. 그래야 설정을 취소했는데도 효과가 없는 것으로 오해하지 않습니다.

rm -- "$HOME/.config/autostart/v2rayN.desktop"

7. 업그레이드 및 재부팅 후 확인 목록

같은 이름의 패키지를 업그레이드하면 일반적으로 apt 또는 dnf가 프로그램 파일을 교체합니다. 하지만 사용자 설정, 자동 실행용 복사본, 데스크톱 프록시 상태는 각각 별도로 관리됩니다. 업그레이드 전에 클라이언트를 종료하고 실제 사용 중인 설정 디렉터리를 백업하세요. 디렉터리 위치는 현재 버전의 설정이나 로그에서 확인하고 사용자 설정 전체를 함부로 삭제하지 마세요.

• 프로그램 실행: 앱 메뉴에서 새 버전이 열리는지 확인하세요. 실행기가 작동하지 않으면 새 패키지의 파일 목록과 Exec 경로를 비교하세요.
• 자동 실행 파일: 설치 후 원본 desktop 파일과 ~/.config/autostart/v2rayN.desktop을 비교하세요. 프로그램 경로가 바뀌었다면 필요한 사용자 설정을 유지한 채 파일을 다시 복사하세요.
• 연결 설정: 활성 서버와 구독 그룹, 라우팅 선택을 확인해 업그레이드 후 다른 설정이 잘못 선택되지 않았는지 점검하세요.
• 로컬 수신 포트: 실제 포트를 기준으로 ss 명령을 실행한 뒤 프록시를 지정해 요청을 테스트하세요. 수신은 정상이지만 원격 연결에 실패한다면 패키지를 반복해서 설치하지 말고 연결 로그를 확인하세요.
• 종료 동작: 클라이언트를 종료한 뒤 데스크톱의 네트워크 프록시 상태를 확인하세요. 꺼진 로컬 포트를 계속 가리키고 있다면 시스템 프록시를 해제하거나 기존 네트워크 설정을 복원하세요.

완료 여부는 수동 실행 성공, 지정 프록시 작동, 필요한 앱 사용 가능 여부, 로그아웃 후 재로그인 시 복구 여부 순으로 확인하세요. ‘부팅 후 아이콘이 나타나는지’만 보는 것보다 네 가지를 각각 점검하면 문제 원인을 찾기 쉽습니다. 구독 가져오기와 기본 설정은 입문 가이드에서 확인하고, 라우팅과 DNS를 더 조정하려면 고급 설정을 참고하세요.