Shadowrocket Linux 설치 방법: deb, rpm, AppImage 패키지 선택 가이드

배포판에 맞는 패키지를 선택하세요. Debian/Ubuntu는 deb와 apt, Fedora 계열은 rpm과 dnf를 사용하고, 그 외 배포판에서는 AppImage에 실행 권한을 부여해 실행할 수 있습니다.

이 글의 핵심 내용

이 글은 그래픽 데스크톱 환경을 사용하는 Linux 기기를 대상으로 합니다. 먼저 터미널에서 배포판과 시스템 아키텍처를 확인한 다음, 다운로드 가이드에서 Shadowrocket 설치 패키지를 선택하세요. deb와 rpm은 시스템 패키지 관리자가 등록하고, AppImage는 실행 파일로 보관합니다. 아래에서는 형식별 설치 명령과 의존성, 권한, 첫 실행 오류의 해결 순서를 안내합니다.

설치 전: 배포판과 아키텍처 확인

패키지 형식은 배포판과 패키지 관리자에 따라 달라지고, 아키텍처는 패키지에 포함된 프로그램을 현재 시스템에서 실행할 수 있는지 결정합니다. Shadowrocket을 설치할 시스템에서 두 항목을 모두 확인하세요. 예를 들어 가상 머신에 설치한다면 호스트 기기의 사양이 아니라 가상 머신 안에서 확인한 결과를 기준으로 해야 합니다.

  1. 배포판 확인

    터미널을 열고 /etc/os-release에서 ID와 ID_LIKE를 확인하세요. ID=debian 또는 ID=ubuntu이면 deb, ID=fedora이면 rpm에 해당합니다. 파생 배포판은 ID_LIKE를 참고하되, 실제 사용하는 패키지 관리자와 다운로드 페이지에 표시된 지원 범위도 확인하세요.

  2. 시스템 아키텍처 확인

    uname -m을 실행해 커널 아키텍처를 확인하세요. x86_64는 deb에서 일반적으로 사용하는 amd64 표기에 해당하고, aarch64는 arm64에 해당합니다. deb를 설치할 때는 dpkg --print-architecture도 실행해 패키지 관리자가 보고하는 시스템 아키텍처를 기준으로 삼으세요.

  3. 설치 패키지 선택

    Shadowrocket 다운로드 가이드를 열고 Linux 섹션에서 패키지 형식과 아키텍처를 확인하세요. 다른 배포판이라면 호환되는 AppImage가 있는지 먼저 살펴보세요. 페이지에 맞는 아키텍처의 패키지가 없다면 파일 확장자를 바꾸거나 강제로 설치하지 마세요.

  4. 실행 및 확인

    아래에서 해당 패키지 형식에 맞는 절차를 진행하세요. deb 또는 rpm 설치를 마친 뒤에는 데스크톱의 애플리케이션 메뉴에서 Shadowrocket을 찾으세요. AppImage는 터미널에서 바로 실행할 수 있습니다. 창이 열리면 Home이 정상적으로 표시되는지 확인하세요. 창이 나타나지 않으면 터미널에 처음 표시된 오류를 기록한 뒤 아래 문제 해결 안내를 참고하세요.

grep -E '^(ID|ID_LIKE)=' /etc/os-release
uname -m

Debian/Ubuntu는 apt, Fedora는 dnf 사용

두 명령어 묶음 중 시스템에 해당하는 하나만 실행하세요. 예시는 Bash에서 실행합니다. 입력 안내가 나타나면 실제 파일의 절대 경로를 붙여 넣고 Enter를 누르세요. 입력값 앞뒤에 따옴표를 추가하지 마세요. 이후 명령에 있는 큰따옴표는 그대로 두어야 경로에 공백이 있어도 하나의 인수로 전달됩니다. 먼저 패키지 정보가 예상한 내용인지 확인한 다음 설치 명령을 실행하세요.

deb

지원 배포판
Debian、Ubuntu
설치 도구
apt install
로컬 패키지 조회
dpkg-deb -f
제거 도구
apt remove

제거할 때는 다운로드한 파일명이 아니라 Package 필드의 값을 사용하세요.

rpm

지원 배포판
Fedora 및 dnf를 사용하는 해당 파생 배포판
설치 도구
dnf install
로컬 패키지 조회
rpm -qpi
제거 도구
dnf remove

제거할 때는 Name 필드의 값을 사용하고, 먼저 트랜잭션 요약을 확인하세요.

deb 설치

read -r -p 'deb 파일의 절대 경로를 입력하세요: ' pkg
dpkg-deb -f "$pkg" Package Architecture
sudo apt install "$pkg"

apt는 설정된 저장소에서 필요한 의존성을 확인합니다. 디렉터리 경로가 없는 파일명은 저장소의 패키지명으로 처리될 수 있으므로 여기서는 절대 경로를 입력합니다. 의존성 목록이 오래된 인덱스를 기반으로 한다면 sudo apt update를 실행한 뒤 다시 시도하세요. 그래도 특정 의존성을 설치할 수 없다고 나오면 다른 배포판의 소프트웨어 저장소를 함께 사용하지 말고, 다운로드한 패키지의 시스템 요구 사항을 먼저 확인하세요.

rpm 설치

read -r -p 'rpm 파일의 절대 경로를 입력하세요: ' pkg
rpm -qpi "$pkg"
sudo dnf install "$pkg"

rpm -qpi는 로컬 패키지 정보를 조회할 뿐 소프트웨어를 설치하지 않습니다. 의존성 확인과 설치는 dnf가 현재 활성화된 저장소를 기준으로 처리합니다. 트랜잭션 요약에서 이번 설치와 관계없는 소프트웨어를 제거하겠다고 표시되면 취소한 뒤, 패키지의 지원 배포판과 저장소 설정을 확인하세요. 의존성 검사를 건너뛰지 마세요.

AppImage: 실행 권한을 부여하고 터미널에서 실행

AppImage는 보통 시스템 패키지 관리자로 등록할 필요가 없습니다. 먼저 파일을 홈 디렉터리 아래 계속 보관할 위치로 옮긴 다음, 파일 소유자에게 실행 권한을 부여하세요. 아래에서도 실제 파일의 절대 경로를 입력합니다. 프로그램을 실행할 때는 sudo가 필요하지 않습니다.

read -r -p 'AppImage 파일의 절대 경로를 입력하세요: ' app
file -- "$app"
chmod u+x -- "$app"
"$app"

첫 실행 후: 설치 문제와 라우팅 문제 구분하기

Home이 열리면 프로그램은 실행된 것이지만, 연결이나 규칙이 정상 작동한다는 뜻은 아닙니다. 이미 설정과 연결 정보를 보유한 사용자는 Config에서 현재 파일을 확인한 다음 Home으로 돌아가 Global Routing을 확인할 수 있습니다. 아래 두 설정은 규칙 기반 라우팅과 직접 연결을 비교하기 위한 것입니다. 모드를 전환해도 앱 실행 후 동작을 점검할 수 있을 뿐, 설치 의존성 문제가 해결되지는 않습니다.

Config

권장

현재 설정된 규칙 순서에 따라 요청을 처리합니다. 규칙에 일치해야 하는 도메인을 알고 있다면 이를 기준으로 확인하세요. 설정 끝에 FINAL이 있다면 앞선 규칙에 일치하지 않는 요청으로 기본 처리 동작도 확인할 수 있습니다.

적합한 경우: 설정이 이미 있고 규칙 기반 라우팅이 예상대로 작동하는지 처음 확인할 때

Direct

트래픽이 직접 연결되므로 이 결과로 규칙이 올바른지 판단하지 마세요. 임시로 전환한 뒤 같은 네트워크와 직접 연결 가능한 같은 대상으로 다시 확인하고, 비교를 마치면 원래 설정으로 되돌리세요.

적합한 경우: 현재 네트워크에서 대상에 직접 연결할 수 있는지 확인할 때

설치·업데이트·제거 관련 자주 묻는 질문

Ubuntu용으로 rpm을 받았는데 변환해야 하나요?

변환할 필요가 없습니다. 다운로드 가이드로 돌아가 dpkg --print-architecture의 출력과 일치하는 deb를 선택하세요. 파일 확장자를 바꿀 수 있더라도 패키지 내부의 메타데이터와 의존성은 원래 형식 그대로입니다.

AppImage를 두 번 클릭해도 반응이 없어요. 원인을 어떻게 확인하나요?

위 안내에 따라 터미널에서 실행하고, 오류가 권한 문제인지 실행 라이브러리 누락인지 또는 Exec format error인지 확인하세요. 마지막 오류가 표시되면 file과 uname -m을 사용해 파일과 시스템 아키텍처를 비교하세요. chmod를 반복 실행하지 마세요.

업데이트 전에 이전 패키지를 제거해야 하나요?

먼저 앱을 종료하고 보관할 설정을 백업하세요. 패키지명과 아키텍처가 같은 새 deb 또는 rpm은 기존 설치 명령으로 처리할 수 있습니다. 트랜잭션 요약에서 업그레이드로 표시되는지 먼저 확인하세요. 로컬 설치 패키지가 패키지 관리자에 등록되어 있어도 시스템 저장소를 통해 자동 업데이트된다는 뜻은 아닙니다.

다운로드한 파일을 삭제하면 제거한 건가요?

deb 또는 rpm은 다운로드 파일을 삭제해도 설치된 프로그램이 제거되지 않습니다. 해당 패키지 관리자를 통해 제거하세요. AppImage는 프로그램을 종료한 뒤 실행 파일을 삭제하고, 직접 만든 데스크톱 바로 가기 중 해당 파일을 가리키는 항목도 삭제할 수 있습니다. 사용자 설정과 프로그램 파일은 별개이므로 설정을 지우기 전에 보관할 필요가 있는지 확인하세요.

Shadowrocket 다운로드