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

이 글 한눈에 보기

Shadowrocket Linux 버전은 무료이며, Mac(Apple 실리콘 / Intel), Windows, Android 버전도 무료입니다. iPhone / iPad 버전은 App Store에서 $2.99 일회성 결제로 이용할 수 있으며, 시스템 요구 사항은 App Store 페이지를 기준으로 합니다. 이 글에서는 Linux 데스크톱 클라이언트 설치를 위해 시스템 확인, 패키지 형식 선택, 로컬 설치, 실행 문제 해결 및 연결 점검 순으로 설명합니다. 설치 파일은 모두 이 사이트의 다운로드 페이지에서 받을 수 있으므로 타사 소프트웨어 저장소를 먼저 찾을 필요가 없습니다.

1. 배포판과 프로세서 아키텍처 확인

deb, rpm, AppImage는 서로 다른 배포 형식이지 연결 프로토콜이 아닙니다. 설치 파일을 고를 때는 먼저 배포판에서 사용하는 패키지 관리자를 확인한 다음 프로세서 아키텍처를 확인하세요. 확장자가 같더라도 현재 기기에서 사용할 수 있다는 뜻은 아닙니다. Linux 데스크톱 환경, 런타임 라이브러리, 파일 시스템 권한도 실행 여부에 영향을 미치므로 다운로드가 완료됐다는 이유만으로 실행 조건이 갖춰졌다고 판단할 수 없습니다.

터미널에서 아래 명령어 두 개를 실행하세요. 첫 번째 명령어로 배포판 식별 정보를 확인하고, 특히 ID와 ID_LIKE를 살펴봅니다. 두 번째 명령어는 현재 시스템이 보고하는 머신 아키텍처를 확인합니다. 두 명령어 모두 정보만 읽으며 소프트웨어를 설치하거나 연결 설정을 변경하지 않습니다.

cat /etc/os-release
uname -m

배포판 확인

Debian / Ubuntu: deb를 선택하고 apt로 로컬 파일을 설치하는 것이 좋습니다.
Fedora: rpm을 선택하고 dnf로 로컬 파일을 설치하는 것이 좋습니다.
기타 배포판: 먼저 배포판 안내를 확인한 뒤 AppImage 실행 조건을 점검하세요.

rpm 확장자라고 해서 모든 rpm 기반 시스템의 의존성 환경이 같은 것은 아닙니다.

아키텍처 및 권한

x86_64: 일반적으로 x64 / amd64 표기와 일치하는 빌드입니다.
aarch64: 일반적으로 ARM64 아키텍처에 해당하며, 다운로드 페이지에 호환되는 빌드가 있어야 합니다.
설치 권한: deb / rpm 기반 시스템에서 설치할 때는 보통 sudo 권한이 필요합니다.

다운로드 페이지에서 실제로 제공하는 아키텍처를 기준으로 선택하세요. 다른 아키텍처용 패키지를 호환 패키지로 간주하지 마세요.

다운로드 페이지의 Linux 섹션에서 실제로 제공되는 패키지를 선택하세요. 프로세서와 일치하는 파일이 없다면 설치를 중단해야 합니다. 확장자를 바꾸거나 설치 명령어를 반복 실행해도 한 아키텍처의 파일이 다른 아키텍처용으로 바뀌지는 않습니다.

2. 다운로드 후 동일한 순서로 준비

아래 단계에서는 먼저 파일 위치와 이름을 정리한 다음 해당 설치 명령어를 실행합니다. 여기서 사용하는 shadowrocket-local.deb, shadowrocket-local.rpm, shadowrocket-local.AppImage는 입력하기 쉽도록 붙인 로컬 이름입니다. 다운로드 사이트의 실제 패키지 이름이 아니며 버전을 나타내지도 않습니다.

설치 파일 선택

이 사이트의 앱 다운로드 페이지에서 Linux를 선택한 뒤 배포판과 아키텍처에 맞는 파일 하나를 다운로드하세요. deb, rpm, AppImage 중 한 가지 설치 방법만 선택하면 됩니다.
파일 위치 확인

파일 관리자에서 파일이 있는 폴더를 연 다음, 데스크톱 환경의 ‘터미널에서 열기’ 기능을 사용하세요. 다운로드 폴더 이름이 반드시 Downloads라고 가정하지 마세요. 현지화 설정이나 브라우저 설정에 따라 이름이 다를 수 있습니다.
로컬 파일 이름 간소화

방금 다운로드한 파일만 이름을 바꾸세요. deb는 shadowrocket-local.deb, rpm은 shadowrocket-local.rpm, AppImage는 shadowrocket-local.AppImage로 변경합니다. 기존 확장자는 그대로 유지하세요.
해당 명령어 실행

다음 섹션에서 apt, dnf, chmod 중 해당하는 방법을 선택하세요. 설치가 끝나면 앱 메뉴나 파일에서 Shadowrocket을 실행한 뒤 Home에서 기존 연결 정보를 확인합니다.

3. Debian / Ubuntu: apt로 deb 설치

Debian / Ubuntu 시스템에서는 로컬 deb 파일을 apt로 설치하는 것이 좋습니다. 시스템에 설정된 소프트웨어 저장소에 접근할 수 있다면 apt가 의존성을 처리합니다. dpkg -i만 실행하면 의존성이 충족되지 않은 상태로 설치가 남을 수 있습니다. 설치 전에 패키지의 아키텍처 정보를 확인해 앞서 확인한 시스템 아키텍처와 비교할 수 있습니다.

dpkg-deb -f ./shadowrocket-local.deb Architecture
sudo apt install ./shadowrocket-local.deb

sudo를 실행할 때는 현재 Linux 사용자의 권한 비밀번호를 입력합니다. 터미널에는 입력한 문자가 보이지 않는 것이 일반적입니다. apt가 설치하거나 변경할 패키지 목록을 표시하면 먼저 요약 내용을 확인하세요. 이번 설치와 관계없는 항목이 대량으로 삭제될 예정이라면 작업을 취소하고 시스템 저장소와 의존성 상태를 점검하세요. 내용을 확인하지 않고 그대로 진행하지 마세요.

의존성을 충족할 수 없다는 메시지가 표시되는 경우: 배포판이 계속 지원되는지, 소프트웨어 저장소에 접근할 수 있는지, 패키지 아키텍처가 일치하는지 먼저 확인하세요. 필요한 경우 sudo apt update를 실행해 패키지 목록을 갱신한 뒤 로컬 파일을 다시 설치합니다.
패키지 관리자 잠금이 사용 중이라는 메시지가 표시되는 경우: 시스템 업데이트나 다른 apt 작업이 끝날 때까지 기다리세요. 진행 중인 작업이 손상될 수 있으므로 잠금 파일을 직접 삭제하지 마세요.
패키지가 등록됐는지 확인하려면: dpkg-deb -f ./shadowrocket-local.deb Package를 실행해 실제 패키지 이름을 확인한 다음 시스템 소프트웨어 관리자에서 해당 이름을 검색하세요.

설치가 끝나면 앱 메뉴에서 Shadowrocket을 실행하세요. 그래픽 데스크톱은 일반적으로 설치 패키지에 포함된 앱 실행 항목을 읽습니다. 터미널에서 설치가 완료됐는데 아이콘이 바로 나타나지 않으면 앱 메뉴를 닫았다가 다시 열어 보세요. 제품 표시 이름만 보고 터미널 실행 파일의 대소문자를 추측하지 마세요.

4. Fedora: dnf로 rpm 설치

Fedora에서는 dnf를 사용해 로컬 rpm 파일을 설치하고, 의존성은 현재 시스템에 설정된 소프트웨어 저장소에서 가져옵니다. 설치 전에 패키지 이름과 아키텍처를 확인하세요. 조회 명령어는 앱을 실행하지 않습니다. rpm을 사용하는 다른 배포판에서는 해당 배포판의 패키지 관리 문서를 따르세요. Fedora의 명령어나 저장소 설정을 그대로 적용해서는 안 됩니다.

rpm -qp --qf '%{NAME}\n%{ARCH}\n' ./shadowrocket-local.rpm
sudo dnf install ./shadowrocket-local.rpm

dnf에서 의존성 누락 오류가 표시되면 전체 오류 메시지를 보관하고 ‘저장소에 접근할 수 없음’, ‘필요한 의존성 없음’, ‘아키텍처 불일치’를 구분하세요. 세 가지 문제는 해결 방법이 다릅니다. 네트워크 문제는 저장소 접근을 복구하고, 의존성 문제는 시스템 호환성을 확인하며, 아키텍처 문제는 파일을 다시 선택해야 합니다.

의존성을 무시하는 옵션으로 설치를 강행하지 마세요. 패키지가 등록됐더라도 프로그램이 정상적으로 실행된다는 보장은 없습니다.
클라이언트 하나를 설치하기 위해 현재 배포판과 호환되지 않는 소프트웨어 저장소를 추가하지 마세요.
이후 업데이트할 때는 이 사이트의 다운로드 페이지에서 호환되는 rpm을 다시 받은 다음 dnf로 로컬 업데이트를 진행할 수 있습니다. 로컬 패키지를 직접 다운로드해 설치했다고 해서 자동 업데이트 저장소를 구독한 것은 아닙니다.

5. AppImage: 실행 권한과 실행 환경을 각각 확인

AppImage는 사용자 폴더에서 앱 파일을 관리하려는 경우에 적합하지만, ‘단일 파일’이라는 이유만으로 모든 Linux 시스템에서 사용할 수 있는 것은 아닙니다. CPU 아키텍처, 기본 런타임 라이브러리, 데스크톱 환경, 패키징 방식의 영향을 받으며, 일부 AppImage는 마운트 실행에 FUSE가 필요합니다. 관리자 권한이 없는 경우에도 현재 시스템에 필요한 조건이 갖춰져 있는지 먼저 확인하세요.

다운로드한 파일의 이름을 앞에서 설명한 대로 바꾼 다음, 파일이 있는 폴더에서 아래 명령어를 실행하세요. 첫 번째 명령어는 현재 사용자에게만 실행 권한을 부여하고, 두 번째 명령어는 현재 폴더에서 파일을 실행합니다. 폴더 전체를 모든 사용자가 쓸 수 있도록 변경할 필요는 없습니다.

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

Permission denied: ls -l ./shadowrocket-local.AppImage로 사용자 실행 권한을 확인하세요. 이미 실행 권한이 있다면 noexec 옵션으로 마운트된 파티션에 파일이 있는지 점검합니다.
Exec format error: chmod를 반복 실행하기보다 프로세서 아키텍처와 파일 형식을 먼저 확인하세요.
FUSE 또는 libfuse 관련 메시지가 표시되는 경우: 현재 배포판의 문서에 따라 호환되는 런타임 구성요소를 설치하세요. 배포판마다 패키지 이름이 다를 수 있으므로 시스템에 설치된 FUSE 구성요소를 바로 삭제하거나 교체하지 마세요.
공유 라이브러리가 없다는 메시지가 표시되는 경우: 터미널에 표시된 라이브러리 이름과 오류 내용을 빠짐없이 기록한 뒤 배포판 호환성을 확인하세요. 출처가 불분명한 웹페이지에서 시스템 라이브러리를 따로 다운로드해 기존 파일을 덮어쓰지 마세요.

다운로드 폴더를 정리하다 파일을 실수로 삭제하지 않도록 AppImage를 사용자 홈 디렉터리 아래의 앱 전용 폴더에 보관할 수 있습니다. 파일을 가리키는 데스크톱 바로가기가 있다면 파일을 옮기거나 이름을 바꾼 뒤 바로가기의 경로도 수정해야 합니다. 일반 파일 권한 문제를 우회하려고 sudo로 그래픽 앱 전체를 실행하지 마세요. 시스템 권한이 필요한 네트워크 작업은 앱과 시스템의 권한 안내에 따라 처리하세요.

6. 설치 후 실행, 구성, 네트워크 문제 구분

앱이 열린다는 것은 설치와 기본 실행 환경이 첫 번째 점검을 통과했다는 뜻일 뿐입니다. 연결 기능을 사용하려면 사용자가 이미 보유한 서비스 구성이 필요합니다. 이 사이트는 노드, 구독 또는 서비스 제공자를 제공하거나 판매하거나 추천하지 않습니다. 클라이언트 설치와 회선 서비스는 별개의 문제입니다.

Home에서 기존 서버나 구독을 가져왔는지 확인하고, Config에서 현재 사용하는 구성을 살펴본 다음 Global Routing을 확인하세요. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard는 프로토콜 종류이지 설치 패키지 형식이 아닙니다. 서버에서 안내한 프로토콜, 포트, 인증 정보, 전송 매개변수를 각각 일치시켜야 하며 Linux로 바꿨다는 이유만으로 임의로 변경해서는 안 됩니다.

Config: 규칙 모드

권장

현재 구성의 규칙에 따라 연결을 처리합니다. 먼저 구성의 출처와 규칙 내용이 필요한 용도에 맞는지 확인한 다음 일상적인 사용 모드로 설정하세요. 구성에 따라 규칙에 일치하지 않는 연결이 직접 연결로 처리되지 않을 수도 있습니다.

적합한 경우: 이미 명확한 분류 규칙이 있고 도메인이나 IP별로 연결을 다르게 처리하려는 경우

Proxy: 프록시 모드

클라이언트가 처리하는 연결을 프록시 모드로 다룹니다. 규칙 매칭 때문에 차이가 발생하는지 임시로 확인할 때 사용할 수 있습니다. 모든 앱, 컨테이너 또는 독립된 네트워크 공간의 트래픽까지 처리된다는 뜻은 아닙니다.

적합한 경우: 프록시 연결 자체가 작동하는지 잠시 확인한 뒤 필요한 모드로 되돌릴 때

Direct: 직접 연결 모드

클라이언트가 처리하는 연결을 직접 연결 모드로 다룹니다. 현재 Direct 상태라면 서버를 선택했더라도 웹 요청이 해당 서버를 통해 전달되고 있다고 볼 수 없습니다.

적합한 경우: 기기의 기본 네트워크를 점검해 직접 연결 문제와 프록시 연결 문제를 구분할 때

예를 들어 특정 도메인은 프록시로, 나머지는 직접 연결로 처리하려면 다음 두 줄로 규칙을 작성할 수 있습니다. example.com은 문법 예시일 뿐이며, PROXY가 가리키는 프록시 정책은 실제 구성에서 사용할 수 있어야 합니다. 규칙은 위에서부터 순서대로 적용되며 마지막 줄의 FINAL은 앞선 규칙에 일치하지 않은 연결을 처리합니다.

DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

브라우저에서 인터넷이 된다고 해서 시스템 전체가 같은 네트워크 설정을 사용한다고 볼 수는 없습니다. 명령줄 프로그램은 자체 프록시 매개변수를 읽을 수 있고, 백그라운드 서비스와 컨테이너도 별도의 환경을 사용할 수 있습니다. 로컬 프록시 포트를 직접 입력해야 한다면 클라이언트의 현재 설정에 표시된 실제 수신 포트를 확인하세요. 튜토리얼에 나온 고정 숫자를 그대로 사용하지 마세요.

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

deb가 설치되지 않는데 확장자를 바꿔 rpm으로 만들 수 있나요?

안 됩니다. 이름을 바꿔도 패키지 내부의 메타데이터, 의존성 정의, 설치 스크립트는 달라지지 않습니다. 이 사이트의 다운로드 페이지로 돌아가 현재 배포판에 맞는 파일을 선택하세요. 이 글에서 안내한 로컬 파일 이름 변경 방법도 기존 확장자를 유지해야 합니다.

AppImage를 두 번 클릭해도 반응이 없으면 무엇부터 확인하나요?

먼저 파일이 있는 폴더에서 ./shadowrocket-local.AppImage를 실행해 터미널 오류를 확인하세요. 권한 오류라면 실행 권한과 마운트 옵션을 확인하고, FUSE 오류라면 런타임 구성요소를 점검하세요. 아키텍처 오류라면 uname -m 결과를 다시 확인합니다. 오류를 진단하는 대신 연속으로 두 번 클릭하지 마세요.

세 가지 패키지를 모두 설치해야 하나요?

그럴 필요 없습니다. 시스템에 맞는 설치 방법 하나만 선택하면 됩니다. 시스템 패키지와 여러 AppImage 사본을 함께 사용하면 실행 항목이 중복될 수 있습니다. 문제를 해결할 때는 먼저 현재 실행 중인 파일을 확인한 뒤 필요한 설치 방식만 남기세요.

앱은 실행되는데 구독 업데이트에 실패하면 어떻게 하나요?

먼저 기기 시간이 정확하고 기본 네트워크가 정상인지 확인한 다음 Home에 등록된 기존 구독 주소가 완전하고 유효한지 점검하세요. 오류 메시지를 보관하고 기존 서비스 제공자에게 접속 조건을 확인하세요. deb나 rpm을 다시 설치해도 만료된 구독 주소가 복구되는 경우는 드뭅니다. 진단 정보를 공유할 때는 구독 token과 인증 정보를 가리세요.

문제 해결 기록에는 배포판 이름, uname -m 결과, 선택한 패키지 형식, 실행한 명령어, 터미널에 표시된 전체 오류를 포함하는 것이 좋습니다. ‘파일 호환성 → 설치 작업 → 앱 실행 → 연결 구성’ 순서로 점검하면 패키지 관리 문제를 규칙 문제로 오해하거나 연결 실패 때문에 클라이언트를 반복 설치하는 일을 줄일 수 있습니다.