Shadowrocket Linux 설치 방법: deb·rpm·AppImage 선택 가이드

이 글의 핵심

Linux 데스크톱에 Shadowrocket을 설치하려는 사용자를 위한 안내입니다. 먼저 배포판과 CPU 아키텍처를 확인한 뒤 다운로드 페이지에서 알맞은 형식의 파일을 받으세요. deb·rpm은 시스템 패키지 관리자로 설치하고, AppImage는 실행 권한을 추가한 후 실행합니다. 마지막으로 프로그램 실행, 기존 구독 가져오기, Global Routing을 각각 점검해 설치 문제와 연결 문제를 구분하세요.

배포판·아키텍처·데스크톱 환경 확인

설치 파일 형식은 데스크톱 테마가 아니라 배포판의 패키지 관리 체계에 따라 결정됩니다. GNOME을 사용하는 Ubuntu와 Fedora도 보통 각각 deb와 rpm을 선택합니다. 다른 배포판에서는 AppImage를 고려할 수 있지만, CPU 아키텍처와 시스템 런타임 라이브러리, 데스크톱 환경에 따라 실행이 제한될 수 있습니다. 모든 Linux 시스템에서 바로 실행된다고 볼 수는 없습니다.

cat /etc/os-release
uname -m

첫 번째 명령으로 ID, ID_LIKE, PRETTY_NAME을 확인하고, 두 번째 명령으로 시스템 아키텍처를 확인합니다. 일반적으로 x86_64는 x64, aarch64는 ARM64에 해당합니다. 다운로드할 때는 페이지에 실제로 제공되는 아키텍처를 기준으로 선택하세요. deb, rpm, AppImage 확장자를 바꿔도 파일 형식은 변하지 않으며 아키텍처 불일치도 해결되지 않습니다.

Debian / Ubuntu: deb 파일을 선택하고 apt로 설치하면 사용 가능한 소프트웨어 저장소의 의존성을 함께 처리할 수 있습니다.
Fedora: rpm 파일을 선택하고 dnf로 설치합니다. openSUSE도 rpm 체계를 사용하지만 zypper를 이용합니다.
그 외 데스크톱 배포판: 호환되는 AppImage가 있는지 확인한 뒤 실행 조건을 점검하세요.
명령줄 전용 서버: 이 안내는 데스크톱 앱 설치를 다룹니다. 그래픽 프로그램을 백그라운드 서비스와 동일하게 취급하지 않습니다. 그래픽 세션이 없다면 창이 나타나지 않는다는 이유만으로 설치가 손상됐다고 판단하지 마세요.

다운로드 후 네 단계로 준비하기

아래 명령에 나오는 파일명은 입력하기 편하도록 정한 로컬 이름이며, 사이트 설치 파일의 고정 이름이 아닙니다. 파일 관리자를 열어 다운로드가 완료된 파일의 이름을 해당 이름으로 바꾼 다음 명령을 실행하세요. 원래 이름을 유지하려면 파일을 터미널로 끌어다 놓아 전체 경로를 입력할 수도 있습니다. 브라우저에서 다운로드가 끝나지 않은 임시 파일을 설치 파일로 사용하지 마세요.

시스템 확인

cat /etc/os-release와 uname -m을 실행해 배포판과 아키텍처를 확인하세요. Debian 계열에서는 dpkg --print-architecture로 패키지 관리자가 사용하는 아키텍처 이름도 확인할 수 있습니다.
파일 다운로드

Linux 다운로드 섹션을 열고 페이지에 실제로 제공되는 형식과 아키텍처에 맞춰 파일을 받으세요. 확장자를 바꿔 설치 파일 형식을 변환하지 마세요.
경로 정리

파일을 ~/Downloads에 넣고 형식에 따라 Shadowrocket.deb, Shadowrocket.rpm 또는 Shadowrocket.AppImage로 이름을 바꾸세요. 시스템의 다운로드 폴더 이름이 다르면 실제 경로를 사용하세요.
설치 및 실행

선택한 파일 형식에 해당하는 명령만 실행하세요. deb·rpm은 설치 후 앱 메뉴에서 실행하고, AppImage는 파일을 직접 실행합니다. 처음 문제를 점검할 때는 터미널 출력을 보관하세요.

deb 및 rpm: 시스템 패키지 관리자로 설치

로컬 패키지 경로 앞의 ./는 중요합니다. 패키지 관리자가 저장소에서 패키지 이름만 검색하는 대신 현재 디렉터리의 파일을 읽도록 지정합니다. 설치에는 sudo 권한을 사용하되, 그래픽 앱은 일반 사용자로 실행하세요. 데스크톱 세션 전체를 root 권한으로 실행하지 마세요.

배포판	로컬 설치 명령	설명
Debian / Ubuntu	`sudo apt install ./Shadowrocket.deb`	apt가 로컬 패키지를 설치하고 저장소에서 구할 수 있는 의존성을 처리합니다.
Fedora	`sudo dnf install ./Shadowrocket.rpm`	먼저 작업 요약을 읽고 설치되거나 변경될 패키지를 확인하세요.
openSUSE	`sudo zypper install ./Shadowrocket.rpm`	둘 다 rpm 형식이지만 의존성 이름과 사용 가능 여부는 다를 수 있습니다.

Debian / Ubuntu에서 설치하기

cd ~/Downloads
dpkg-deb -f ./Shadowrocket.deb Package Architecture Depends
sudo apt install ./Shadowrocket.deb

dpkg-deb -f는 패키지 메타데이터를 확인하는 명령이며 프로그램을 설치하지 않습니다. apt에서 저장소 인덱스가 오래됐다고 알리면 sudo apt update를 실행한 뒤 다시 시도하세요. 아키텍처 오류가 표시되면 강제 설치 옵션을 추가하지 말고 올바른 아키텍처의 파일을 다시 선택하세요. 의존성을 해결할 수 없다면 구체적인 의존성 이름과 시스템 버전을 기록하세요. 시스템 핵심 라이브러리를 바로 제거하지 마세요.

Fedora / openSUSE에서 설치하기

cd ~/Downloads
rpm -qp --queryformat '%{NAME} %{ARCH}\n' ./Shadowrocket.rpm

# Fedora
sudo dnf install ./Shadowrocket.rpm

# openSUSE: 이 명령을 사용하고 위의 dnf 명령은 실행하지 마세요
sudo zypper install ./Shadowrocket.rpm

rpm은 패키지 형식일 뿐, rpm을 사용하는 모든 배포판의 실행 환경이 같다는 뜻은 아닙니다. 패키지 관리자가 사용할 수 없는 의존성을 명확히 보고하면 먼저 다운로드 페이지의 지원 조건을 확인하세요. 의존성을 무시해 오류를 실행 단계로 넘기지 마세요. 설치가 끝났다는 것은 파일과 등록 정보가 시스템에 기록됐다는 뜻일 뿐, 설정과 네트워크 연결이 확인됐다는 의미는 아닙니다.

AppImage: 실행 권한을 추가한 뒤 터미널에서 실행

AppImage는 보통 deb·rpm처럼 시스템 패키지 데이터베이스에 등록되지 않습니다. 파일 하나로 보관하며, 처음 사용할 때 실행 권한을 추가해야 합니다. 파일을 이동하거나 삭제하면 기존 바로 가기가 작동하지 않을 수 있습니다. 자동 정리될 수 있는 다운로드 폴더에 계속 두기보다 고정된 위치에 보관하는 것이 좋습니다.

mkdir -p "$HOME/Applications"
mv "$HOME/Downloads/Shadowrocket.AppImage" "$HOME/Applications/"
cd "$HOME/Applications"
chmod u+x ./Shadowrocket.AppImage
./Shadowrocket.AppImage

파일 실행 조건

저장 위치: ~/Applications
권한 확인: ls -l ./Shadowrocket.AppImage
실행 방법: ./Shadowrocket.AppImage
실행 사용자: 현재 데스크톱의 일반 사용자

chmod의 u+x는 파일 소유자에게만 실행 권한을 추가합니다. 모든 사용자에게 쓰기 권한을 확대할 필요는 없습니다.

실행 오류 확인

Permission denied: 실행 권한과 마운트 옵션 noexec를 확인하세요.
Exec format error: 파일 형식과 CPU 아키텍처를 확인하세요.
FUSE 관련 오류: 배포판 문서에서 해당하는 호환 런타임 라이브러리를 확인하세요.
연결 오류 표시: 유효한 데스크톱 그래픽 세션에서 실행 중인지 확인하세요.

AppImage마다 실행 조건이 다를 수 있으므로 이번 실행에서 나온 원본 오류 메시지를 기준으로 확인하세요.

chmod가 성공했는데도 실행 권한이 부족하다는 메시지가 표시되면 findmnt -T ./Shadowrocket.AppImage로 파일 시스템의 마운트 정보를 확인하세요. 이동식 디스크나 제한된 디렉터리에는 noexec가 설정돼 있을 수 있습니다. 실행이 허용된 사용자 디렉터리로 파일을 옮기는 방법을 먼저 시도하세요. 앱 하나 때문에 디스크 전체의 제한을 완화할 필요는 없습니다. FUSE 관련 오류가 표시되면 다른 배포판의 라이브러리 이름을 그대로 따라 하지 말고, 먼저 시스템 전체 업그레이드를 실행하지도 마세요.

첫 실행: 설정을 가져온 뒤 Global Routing 확인

창이 표시되면 설치 단계는 대체로 완료된 것입니다. 다음으로 사용자가 보유한 설정에 따라 진행하세요. Home에서는 서버와 구독을 관리하고, Config에서는 규칙 구성을 관리하며, Settings에서는 클라이언트 설정을 조정합니다. 설치 파일 형식이 이 설정을 대신하거나 연결 가능한 서비스를 자동으로 제공하지는 않습니다.

Home에서 “+”를 누르고 Type을 Subscribe로 설정한 다음, 보유한 구독 주소를 입력해 저장하세요. 가져온 뒤 구독을 새로고침하고 예상한 항목이 목록에 표시되는지 확인합니다. 구독 주소에는 보통 접근 인증 정보가 포함되므로 공개 스크린샷에 노출하지 마세요.
Home에서 기존 항목을 선택하고 Connectivity Test를 실행하세요. 테스트에 실패하면 주소, 포트, 인증 정보, 현재 네트워크를 먼저 확인하세요. 설치가 성공했다는 사실만으로 원격 서버에 연결할 수 있다고 판단할 수는 없습니다.
Config에서 직접 준비한 규칙 구성을 가져와 선택한 뒤 Global Routing을 확인하세요. 처음 연결을 확인할 때는 수동으로 조작하고, 자동 연결이 필요하면 Settings → On Demand에서 별도로 설정하세요. 이 설정은 프로토콜 매개변수와 라우팅 규칙을 대신하지 않습니다.

Global Routing → Config

권장

현재 활성화된 Config 규칙에 맞춰 정책을 선택하세요. 먼저 규칙이 유효하고 정책 참조가 존재하는지 확인한 다음, 실제 요청으로 적용 결과를 점검하세요.

적합한 경우: 규칙 구성을 준비해 일상적으로 트래픽을 분기할 때

Global Routing → Proxy

클라이언트가 처리하는 연결에 선택한 프록시를 적용해 프록시 경로를 확인합니다. 이를 근거로 모든 시스템 프로세스의 트래픽이 클라이언트에서 처리된다고 단정할 수는 없습니다.

적합한 경우: 규칙 기반 트래픽 분기의 영향을 일시적으로 제외할 때

Global Routing → Direct

클라이언트가 처리하는 연결을 직접 연결해 로컬 네트워크 연결 문제와 프록시 경로 문제를 구분합니다. 프록시 서버가 정상인지 확인하는 테스트 방법은 아닙니다.

적합한 경우: 로컬 네트워크가 작동하는지 비교 점검할 때

현재 화면에 Scene이 표시된다면 선택한 장면의 조건과 정책을 확인하세요. Scene을 Config와 같은 의미로 취급하지 마세요. 설정을 변경한 뒤에는 새 요청을 보내세요. 브라우저에 남아 있는 기존 연결로 새 설정을 판단하지 않도록 주의하세요. 규칙 문법이나 DNS를 점검하려면 문제 해결 가이드를 참고하세요.

설치·업데이트·실행 관련 자주 묻는 질문

apt에서 파일을 찾을 수 없다고 나오는 이유는 무엇인가요?

pwd와 ls -l을 실행해 현재 디렉터리와 파일명이 일치하는지 확인하세요. Linux에서는 파일명의 대소문자를 구분합니다. 로컬 파일을 설치할 때는 ./를 포함하세요. 경로에 공백이 있다면 경로 전체를 따옴표로 묶으세요.

설치 후 앱 메뉴에 아이콘이 보이지 않으면 어떻게 하나요?

먼저 패키지 관리 작업이 정상적으로 끝났는지 확인하세요. deb 파일은 dpkg-deb -f ./Shadowrocket.deb Package로 실제 패키지 이름을 확인한 뒤 dpkg로 설치 상태와 파일 목록을 조회할 수 있습니다. rpm은 패키지 메타데이터에서 이름을 확인하세요. 실행 파일 이름을 추측하지 말고, 메뉴 아이콘이 보이지 않는 문제를 연결 오류와 혼동하지 마세요.

AppImage를 두 번 클릭해도 반응이 없으면 어떻게 하나요?

터미널에서 파일이 있는 디렉터리로 이동한 뒤 ./Shadowrocket.AppImage를 실행하고 첫 번째 오류 메시지를 확인하세요. 실행 권한, 아키텍처, 런타임 라이브러리, 그래픽 세션 문제를 구분해 점검하세요. 창은 열리지만 연결에 실패한다면 Home으로 이동해 기존 설정을 확인하세요.

나중에 업데이트할 때 구독을 다시 가져와야 하나요?

업데이트 전에 Config와 필요한 설정을 백업하고, 본인의 구독 주소를 안전하게 보관하세요. deb·rpm은 새 패키지에 같은 종류의 설치 명령을 사용합니다. AppImage는 프로그램을 종료한 뒤 파일을 교체하고 실행 권한을 다시 확인하세요. 패키지 업데이트와 구독 내용 새로고침은 별개의 작업이므로, 업데이트 후에도 선택된 구성과 연결 상태를 점검해야 합니다.

세 가지 형식을 모두 설치해 두어도 되나요?

문제 해결 중에는 여러 사본을 동시에 실행하지 않는 것이 좋습니다. 메뉴 항목, 데스크톱 바로 가기, 수동 실행이 서로 다른 파일을 가리킬 수 있어 변경 사항이 적용됐는지 혼동하기 쉽습니다. 현재 사용하는 형식을 확인하고 다른 프로세스를 종료한 뒤, 필요 없는 패키지는 해당 패키지 관리자로 제거하거나 사용하지 않는 AppImage 파일을 삭제하세요.

Shadowrocket 다운로드 및 설치 안내

iPhone / iPad 버전은 App Store에서 $2.99를 한 번 결제하며, 시스템 요구 사항은 App Store 페이지 표기를 따릅니다. Mac(Apple 실리콘 / Intel) / Windows / Android / Linux 버전은 무료입니다. 다운로드 페이지에서 플랫폼을 선택하거나 설정 및 첫 연결 가이드를 확인하세요.

다운로드 페이지로 이동 사용법 보기