Shadowrocket Linux 설치 가이드: deb·rpm·AppImage 선택과 apt·dnf 명령

1. 배포판·아키텍처·패키지 형식 확인

파일 확장자만 보고 바로 설치하지 마세요. 사용할 패키지 관리자는 배포판에 따라 달라지고, 파일을 실행할 수 있는지는 CPU 아키텍처에 따라 결정됩니다. 먼저 터미널에서 다음 두 명령을 실행해 배포판의 ID, ID_LIKE와 아키텍처를 확인한 뒤 다운로드 가이드의 Linux 항목에서 제공되는 패키지를 선택하세요.

cat /etc/os-release
uname -m

x86_64는 보통 다운로드 페이지의 x64 또는 amd64 표기에 해당하고, aarch64는 보통 ARM64에 해당합니다. 서로 같은 아키텍처의 다른 표기일 뿐, 패키지를 서로 바꿔 설치할 수 있다는 뜻은 아닙니다. 다운로드 페이지에 맞는 아키텍처가 없다면 다른 아키텍처의 패키지를 억지로 설치하지 마세요. 컴퓨터 브랜드만으로 CPU 종류를 추측해서도 안 됩니다.

rpm을 사용하는 다른 배포판이 반드시 dnf를 쓰는 것은 아닙니다. 해당 시스템의 기본 패키지 관리 방식을 사용하세요. AppImage도 모든 Linux에서 실행되는 것은 아닙니다. 데스크톱 세션, 시스템 라이브러리, 실행 환경이 실제 요구 사항을 충족해야 합니다. 아래 명령은 데스크톱 설치용이며, 그래픽 환경이 없는 서버에서 실행할 수 있다고 전제하지 않습니다.

2. 다운로드부터 실행까지: 먼저 5단계

Linux 설치 파일은 이 사이트의 다운로드 페이지에서 받으세요. 이 글에는 고정된 파일 직접 링크가 없습니다. 다운로드 파일 이름이 계속 같다고 가정하지 않도록 아래 예시에서는 파일 이름을 직접 바꿔 사용합니다. 예시 이름은 명령 사용법을 위한 것으로 실제 다운로드 파일의 이름이 아닙니다.

1. 시스템 확인

   cat /etc/os-release와 uname -m을 실행해 배포판과 CPU 아키텍처를 확인하세요. 파일 확장자만으로 아키텍처를 판단하면 안 됩니다.

2. 설치 파일 선택

   다운로드 가이드를 열고 Linux 항목에서 현재 시스템에 맞는 deb, rpm 또는 AppImage를 선택하세요. 사용할 형식만 내려받으면 됩니다.

3. 로컬 파일 정리

   파일 관리자에서 선택한 파일의 이름을 shadowrocket-local.deb, shadowrocket-local.rpm 또는 Shadowrocket-local.AppImage로 바꾸세요. 해당 확장자는 그대로 유지해야 합니다.

4. 터미널 열기

   파일이 있는 폴더에서 데스크톱 환경이 제공하는 터미널 실행 기능을 사용하고, pwd와 ls -l을 실행해 현재 위치를 확인하세요. 터미널의 시작 폴더가 브라우저의 다운로드 폴더와 다를 수 있습니다.

5. 설치 및 실행

   아래에서 해당하는 형식의 명령을 실행하세요. deb와 rpm은 설치를 마친 뒤 앱 메뉴에서 확인하고, AppImage는 현재 폴더에서 바로 실행합니다. 처음 실행할 때 창이 정상적으로 열리는지 확인한 다음 연결 설정을 진행하세요.

3. deb와 rpm: 패키지 관리자로 로컬 파일 설치

Debian·Ubuntu: apt로 deb 설치

deb 파일을 저장한 폴더에서 다음 명령을 실행하세요. ./는 현재 폴더의 파일을 뜻합니다. 이를 붙이면 apt가 저장소에서 패키지 이름을 검색하는 대신 로컬 패키지를 설치합니다. apt update는 저장소 색인을 갱신하는 명령이며, 시스템 전체를 업그레이드하지는 않습니다.

sudo apt update
sudo apt install ./shadowrocket-local.deb

apt가 표시하는 설치 계획을 먼저 읽고 실행을 확인하세요. 의존성을 해결할 수 없다면 오류에 나온 패키지 이름과 버전 조건을 확인하고, 현재 배포판의 저장소가 정상인지와 선택한 패키지가 시스템에 맞는지 점검하세요. 의존성을 무시해 설치 실패를 겉으로만 성공한 것처럼 만들지 마세요. 설치 안내 하나를 해결하려고 다른 배포판의 저장소를 함부로 추가해서도 안 됩니다.

Fedora 등 dnf 환경: rpm 설치

sudo dnf install ./shadowrocket-local.rpm

dnf도 로컬 패키지 정보를 읽고 설정된 저장소에서 의존성을 해결하려고 합니다. 패키지 서명이나 출처 관련 안내가 표시되면 먼저 파일을 이 사이트의 다운로드 페이지에서 받았는지 확인하고, 안내가 설치 파일에 관한 것인지 저장소 설정에 관한 것인지 살펴보세요. 검증을 건너뛰는 옵션을 바로 추가하지 마세요. 설치가 완료되었다는 것은 패키지 관리 절차가 끝났다는 뜻이지, 데스크톱 세션과 네트워크 설정까지 완료되었다는 뜻은 아닙니다.

4. AppImage: 실행 권한을 추가한 뒤 실행

AppImage는 파일에 실행 권한을 추가한 다음 현재 폴더에서 실행하면 됩니다. 보통 apt나 dnf의 설치 기록에는 등록되지 않습니다. 아래 명령은 앞에서 정한 로컬 파일 이름을 사용합니다. 일반 사용자 권한으로 실행할 수 있으므로, 두 번 클릭해도 반응이 없다고 그래픽 프로그램을 sudo로 실행하지 마세요.

chmod u+x ./Shadowrocket-local.AppImage
./Shadowrocket-local.AppImage

chmod u+x는 파일 소유자에게 실행 권한만 추가합니다. 빠진 시스템 구성 요소를 설치하거나 파일 시스템의 noexec 제한을 해제하지는 않습니다. 외장 저장 장치, 공유 폴더 또는 실행이 제한된 마운트 지점에 파일이 있다면 먼저 개인 홈 폴더의 실행 가능한 일반 디렉터리로 옮긴 뒤 필요에 따라 실행하세요. 복사 후 ls -l로 권한을 확인할 수 있습니다. 파일 하나를 실행하려고 홈 폴더 전체의 권한을 재귀적으로 변경하지 마세요.

• Permission denied가 표시되면 실행 권한, 상위 디렉터리 접근 권한, 해당 마운트 지점의 실행 제한 여부를 먼저 확인하세요.
• Exec format error가 표시되면 먼저 uname -m 결과와 다운로드한 패키지의 아키텍처를 비교하고, 다운로드가 끝까지 완료되었는지 확인하세요.
• FUSE 또는 libfuse.so.2 관련 오류가 표시되면 현재 배포판에서 필요한 호환 구성 요소를 확인하세요. 배포판마다 패키지 이름이 다를 수 있으므로 다른 시스템의 설치 명령을 그대로 사용하지 마세요.
• 공유 라이브러리나 데스크톱 화면 관련 오류가 표시되면 터미널 출력을 모두 보관하고 시스템 라이브러리 문제인지 그래픽 세션 문제인지 구분하세요. 이를 실행 권한 오류로 분류하지 마세요.

AppImage에 특정 FUSE 구성 요소가 필요한지는 패키징 방식과 실행 환경에 따라 다르며, 실행할 때마다 반드시 누락되는 것은 아닙니다. 오류 메시지를 먼저 읽고 필요한 조치를 하세요. 그러면 불필요한 구성 요소의 설치를 피할 수 있습니다. 데스크톱 파일 관리자에서 실행 파일을 두 번 클릭했을 때의 동작은 환경마다 다를 수 있으므로, 처음 문제를 확인할 때는 터미널에서 실행하는 편이 오류 원인을 파악하기 쉽습니다.

5. deb·rpm·AppImage의 유지 관리 방식

패키지 형식은 첫 실행뿐 아니라 이후 업데이트와 제거 방식에도 영향을 줍니다. 로컬 deb나 rpm을 설치했다고 해서 자동 업데이트 저장소까지 추가된 것은 아닙니다. 업데이트 저장소가 있는지는 실제 설치 결과를 확인하세요. 업데이트할 때는 클라이언트를 종료한 다음 다운로드 페이지에서 현재 시스템에 맞는 파일을 선택하고, 패키지 관리자가 표시하는 변경 계획을 읽으세요.

어떤 형식을 사용하든 프로그램 파일 삭제와 개인 설정 삭제는 별개의 작업입니다. 설치 방식을 바꾸기 전에 현재 설정을 보관하세요. 용도를 모르는 상태에서 사용자 설정 폴더 전체를 비우지 마세요. 앱 메뉴 실행과 직접 실행의 동작이 다르면 먼저 실행 중인 복사본을 모두 종료하고 실제 실행 파일 경로를 확인한 뒤 다음 문제 해결 단계를 진행하세요.

6. 설치 후: 실행·설정·연결 문제 구분

창이 열린 것은 설치 단계의 확인일 뿐, 연결 서비스가 작동한다는 증거는 아닙니다. 이후 단계는 사용자가 이미 보유한 서비스와 구독을 전제로 합니다. 이 사이트는 노드·구독·연결 서비스를 제공하거나 판매하거나 추천하지 않습니다. 클라이언트 설치와 사용자가 이미 보유한 연결 서비스는 별도로 진행해야 합니다.

• 프로그램이 실행되지 않음: 먼저 아키텍처, 의존성, 실행 권한, 그래픽 세션 문제를 확인하세요. 아직 구독이나 규칙은 변경하지 마세요.
• 프로그램은 실행되지만 설정이 없음: 사용 가이드에 따라 사용자가 이미 보유한 설정을 가져오고 링크가 온전한지 확인하세요. 클라이언트 설치에 성공했다고 연결 정보가 자동으로 제공되는 것은 아닙니다.
• 가져온 뒤 연결되지 않음: 서버 주소, 포트, 프로토콜, 인증 정보가 기존 설정과 일치하는지 확인한 다음 네트워크 오류를 살펴보세요. 반복해서 재설치해도 이 항목들은 보통 수정되지 않습니다.
• 연결 후 접속에 문제가 있음: 문제 해결 가이드에 따라 라우팅, 규칙, DNS 문제를 구분하세요. 여러 설정을 한꺼번에 바꾸고 원인을 판단하지 마세요.

해당 인터페이스를 사용하는 기기에서는 Home에서 연결 상태와 설정 진입점을 확인하고, Config에서 규칙 설정을 관리하며, Settings에서 환경을 설정합니다. 이러한 작업은 Linux 패키지 관리자의 의존성 설치와는 별개의 단계입니다. 여러 플랫폼을 비교할 때는 현재 기기에 실제로 표시되는 메뉴를 기준으로 삼고, 한 플랫폼의 시스템 VPN 권한 설정 절차를 Linux에 그대로 적용하지 마세요.

7. Linux 설치 관련 자주 묻는 질문