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

Linux 배포판에 맞는 설치 파일을 선택하세요. Debian·Ubuntu는 apt로 deb를, Fedora는 dnf로 rpm을 설치하고, 그 외 배포판에서는 AppImage에 실행 권한을 부여해 실행할 수 있습니다.

이 글의 핵심

이 글은 Linux 데스크톱에서 Shadowrocket을 사용하려는 분을 위한 안내입니다. 먼저 배포판과 CPU 아키텍처를 확인하고, 사이트의 다운로드 페이지에서 deb, rpm 또는 AppImage를 선택해 실제 파일 경로를 지정하여 설치합니다. 마지막으로 프로그램 실행, 구독 가져오기, 트래픽 처리 여부를 각각 확인합니다. 명령어는 특정 설치 파일 이름이나 기기의 프록시 포트를 미리 가정하지 않습니다.

1. 배포판, 아키텍처, 설치 파일 형식 확인하기

deb, rpm, AppImage는 프로그램 배포 형식이지 프록시 프로토콜이 아닙니다. 먼저 시스템의 패키지 관리 도구를 확인하고 다운로드 페이지에 표시된 아키텍처를 살펴보세요. Debian과 Ubuntu에서는 보통 deb, Fedora에서는 rpm을 선택합니다. 다른 배포판에서는 AppImage의 실행 조건을 충족하는지 확인할 수 있습니다. 파일의 압축을 풀 수 있다고 해서 다른 패키지 관리 체계의 소프트웨어를 설치해도 된다는 뜻은 아닙니다.

터미널에서 아래 두 명령어를 실행하세요. 첫 번째는 배포판 정보를, 두 번째는 시스템 아키텍처를 확인합니다. 데스크톱 화면만 보고 시스템을 판단하지 마세요. 같은 데스크톱 환경을 사용하는 컴퓨터라도 기반 배포판과 패키지 형식은 다를 수 있습니다.

cat /etc/os-release
uname -m

시스템 정보

NAME / ID
/etc/os-release에서 배포판을 확인합니다.
ID_LIKE
배포판 계열을 파악하는 참고 정보이며, 호환성 안내를 대신하지 않습니다.
uname -m
x86_64와 aarch64는 서로 다른 CPU 아키텍처입니다.

파일 확장자뿐 아니라 패키지 형식과 아키텍처가 모두 맞는지 확인하세요.

다운로드 및 실행

deb
apt로 로컬 파일을 설치하고 의존성을 처리합니다.
rpm
Fedora에서는 dnf로 로컬 파일을 설치합니다.
AppImage
실행 권한을 부여한 뒤 현재 데스크톱 사용자로 실행합니다.

다운로드 페이지에 실제로 제공된 형식과 아키텍처를 기준으로 선택하세요. 설치 파일 형식을 변환하지 마세요.

설치 파일은 모두 다운로드 가이드의 Linux 섹션에서 받으세요. 설치 파일은 사이트의 /dl/ 다운로드 경로를 통해 제공됩니다. 이 문서의 명령어를 조합해 다운로드 주소를 만들지 마세요. Shadowrocket은 폐쇄형 상용 앱입니다. iPhone / iPad에서는 App Store에서 받을 수 있으며, $2.99 일회성 결제입니다. Mac(Apple 실리콘 및 Intel), Windows, Android, Linux 버전은 무료입니다.

2. Debian / Ubuntu: apt로 로컬 deb 설치하기

아래 명령어는 Bash에서 실행합니다. 첫 번째 줄에서 다운로드한 파일의 전체 경로를 입력합니다. 입력할 때 경로에 따옴표를 따로 붙이지 마세요. 이후 명령어의 큰따옴표가 경로에 포함된 공백을 처리합니다. 먼저 패키지 메타데이터를 확인한 다음 설치를 진행합니다. 이 명령어는 로컬 파일을 읽으며, 같은 이름의 소프트웨어를 대신 검색하지 않습니다.

read -r -e -p "다운로드한 deb 파일의 전체 경로 입력: " pkg
pkg="$(realpath -- "$pkg")"
dpkg-deb --field "$pkg" Package Architecture Depends
dpkg --print-architecture
sudo apt install "$pkg"

전체 경로를 지정하면 apt가 로컬 파일을 설치 대상으로 인식합니다. 경로 없이 소프트웨어 이름만 입력하면 저장소에서 패키지를 검색하라는 뜻이 됩니다. dpkg -i만 실행하는 것보다 apt를 사용해 로컬 deb를 설치하면 한 번의 작업에서 의존성을 처리하기 쉽습니다. 다만 기기에서 저장소에 접속할 수 있고 의존성 조건을 충족해야 합니다.

Unable to locate package가 표시되면 입력한 값이 실제 파일 경로인지 먼저 확인하세요. 의존성을 충족할 수 없다는 메시지가 나오면 배포판 호환성과 저장소 상태를 살펴보세요. 의존성을 강제로 무시해 오류를 건너뛰지 말고, 설치 작업이 완료되지 않았는데 성공한 것으로 간주하지 마세요.

3. Fedora: dnf로 로컬 rpm 설치하기

rpm 패키지도 먼저 아키텍처와 패키지 정보를 확인하세요. 아래 절차는 Fedora의 dnf 환경을 기준으로 합니다. rpm을 사용하는 다른 배포판은 패키지 관리 명령어와 의존성 구성이 다를 수 있으므로, 확장자가 같다는 이유만으로 호환된다고 판단하지 마세요.

read -r -e -p "다운로드한 rpm 파일의 전체 경로 입력: " pkg
pkg="$(realpath -- "$pkg")"
rpm -qpi "$pkg"
rpm -qp --requires "$pkg"
uname -m
sudo dnf install "$pkg"

rpm -qpi는 아직 설치하지 않은 패키지 파일의 정보를 조회하고, rpm -qp --requires는 필요한 기능이나 의존성을 표시합니다. dnf로 설치할 때는 작업 요약을 확인한 뒤 진행을 승인하세요. 로컬 패키지를 다운로드했다고 해서 모든 의존성까지 받은 것은 아닙니다. 의존성 확인 과정에서 기기에 설정된 저장소에 접속해야 할 수 있습니다.

4. AppImage: 실행 권한 부여는 시스템 설치와 다릅니다

AppImage는 대개 실행 파일 하나로 보관하며, apt나 dnf에 일반 패키지로 등록하지 않습니다. 먼저 파일을 계속 보관할 위치로 옮긴 다음 실행 권한을 추가하세요. 임시 다운로드 폴더에서 바로 실행하면 나중에 폴더를 정리할 때 기존 실행 경로를 사용할 수 없게 됩니다.

read -r -e -p "다운로드한 AppImage 파일의 전체 경로 입력: " app
app="$(realpath -- "$app")"
file -- "$app"
chmod u+x -- "$app"
"$app"

chmod u+x는 파일 소유자에게만 실행 권한을 추가합니다. 마지막 줄은 현재 사용자로 프로그램을 실행하며, 진단 출력은 현재 터미널에 표시됩니다. 데스크톱 프로그램을 실행할 때 무심코 sudo를 붙이지 마세요. 의존성 설치에 필요한 관리자 권한과 앱을 평소 실행하는 사용자 권한은 별개입니다.

  1. Permission denied가 표시되면 먼저 ls -l로 실행 권한이 설정됐는지 확인한 다음, 파일이 있는 파티션이 noexec 옵션으로 마운트됐는지 살펴보세요. 실행 권한을 추가해도 마운트 제한은 해제되지 않습니다.
  2. 오류에 FUSE 또는 libfuse.so.2가 표시되면 현재 AppImage를 마운트해 실행하기 위한 조건이 충족되지 않은 것입니다. 사용 중인 배포판의 패키지 안내를 참고해 필요한 런타임 의존성을 설치하세요. 배포판마다 패키지 이름이 다를 수 있습니다.
  3. Exec format error가 표시되면 먼저 다운로드한 아키텍처가 맞는지 확인하세요. 파일이 예상한 실행 파일로 인식되지 않는다면 설치 파일을 다시 받으세요.
  4. 창이 나타나지 않으면 터미널의 원본 출력 내용을 보관하세요. AppImage는 모든 환경에서 호환되는 범용 실행 계층이 아닙니다. 그래픽 세션, 시스템 라이브러리, 보안 정책이 실행에 영향을 줄 수 있습니다.

보안 기능을 끄는 것을 일반적인 해결책으로 삼지 마세요. AppImage가 데스크톱 아이콘을 자동으로 만들거나 로그인 시 자동 실행 목록에 추가된다고 가정하지 마세요. 해당 기능의 지원 여부는 실제 화면과 설치 결과를 확인해야 합니다.

5. 처음 실행할 때: 설치, 구독, 연결을 따로 확인하기

창이 열렸다는 것은 프로그램이 실행됐다는 뜻일 뿐, 구독을 사용할 수 있거나 앱 트래픽이 프록시를 통과한다는 의미는 아닙니다. 아래 절차는 이미 이용 중인 서비스 제공업체와 구독이 있는 경우를 전제로 합니다. 이 사이트는 노드나 구독을 제공·판매·추천하지 않습니다. 클라이언트 설치와 회선 서비스는 별개의 과정입니다.

  1. 실행 확인

    데스크톱 실행기에서 Shadowrocket을 여세요. AppImage를 사용하는 경우 먼저 터미널에서 실행합니다. Home 화면까지 진입할 수 있는지 확인한 뒤 연결 설정을 진행하세요. 프로그램이 종료되는 문제와 네트워크 시간 초과를 혼동하지 않도록 합니다.

  2. 구독 가져오기

    Home 화면 오른쪽 위의 「+」에서 Type을 Subscribe로 설정하고, 보유 중인 구독 링크를 입력한 뒤 저장하세요. 예시 https://example.com/sub?token=xxxx는 가짜 값이므로 실제 연결에 사용할 수 없습니다.

  3. 설정 확인

    Home에서 업데이트 후 항목이 표시되는지 확인하고, Config에서 현재 사용하는 설정을 확인한 다음 Global Routing을 살펴보세요. 노드 목록을 가져오는 것과 규칙 설정을 활성화하는 것은 서로 다른 작업입니다.

  4. 트래픽 확인

    연결한 다음 같은 앱으로 같은 주소에 접속해 결과를 비교하고, 시간 초과나 이름 확인 오류가 있는지 기록하세요. 브라우저만 작동하고 터미널 도구는 작동하지 않는다면 각 프로그램의 프록시 설정과 환경 변수를 확인하세요.

Linux 데스크톱 앱마다 시스템 프록시를 따르는 방식이 다릅니다. HTTP 또는 SOCKS 프록시를 설정할 때는 기기에서 실제로 수신 대기 중인 주소와 포트를 확인하세요. 온라인에서 찾은 고정 숫자를 그대로 사용하지 마세요. 앱에서 해당 트래픽 처리 방식을 명시적으로 지원하고 활성화한 경우에만 그 방식에 따라 문제를 확인하세요. 연결 스위치가 켜졌다고 해서 모든 프로세스의 트래픽이 처리된다고 볼 수는 없습니다.

6. Global Routing: 규칙 문제와 연결 문제 구분하기

설치 파일 형식은 Global Routing의 의미를 바꾸지 않습니다. 문제를 확인할 때는 테스트 대상과 사용할 연결 항목을 고정하고, 매번 설정 하나만 바꾸세요. 아래 비교는 Shadowrocket의 처리 경로로 들어오는 트래픽을 대상으로 하며, 시스템의 모든 프로그램을 자동으로 처리한다는 뜻은 아닙니다.

Config

권장

현재 설정의 규칙에 따라 정책을 결정합니다. DOMAIN-SUFFIX, IP-CIDR, GEOIP 등의 규칙 순서를 확인하고 FINAL의 기본 처리 정책도 살펴보세요. Config를 선택했다고 해서 규칙에 해당하지 않는 모든 트래픽이 반드시 직접 연결되는 것은 아닙니다.

적합한 경우: 기존 규칙 설정을 활용해 평소처럼 사용할 때.

Proxy

처리 경로에 들어오는 트래픽을 Config의 도메인 또는 주소 규칙에 따라 나누지 않고 선택한 프록시 정책으로 보냅니다. Config와 결과가 다르면 규칙 적용 여부와 정책 선택을 확인하세요.

적합한 경우: 프록시 연결 문제와 규칙 문제를 임시로 구분할 때.

Direct

처리 경로에 들어오는 트래픽에 직접 연결 정책을 적용합니다. 다른 프로그램에 별도로 설정한 프록시는 끄지 않으며, 현재 네트워크에서 테스트 대상에 접속할 수 있다는 보장도 하지 않습니다.

적합한 경우: 직접 연결 상태와 비교해 대상에 접속할 수 있는지 확인할 때.

설정에 DOMAIN-SUFFIX,example.com,DIRECT가 있다면 해당 도메인으로 테스트하세요. IP 주소로 직접 접속하면 도메인 규칙이 적용되지 않을 수 있습니다. Scene을 사용하는 경우에는 설정된 장면 조건과 해당 정책에 따라 확인하세요. Scene을 고정된 전역 프록시 모드로 간주하지 마세요. 진단이 끝나면 평소 설정으로 되돌려 임시 테스트가 이후 판단에 영향을 주지 않도록 합니다.

7. 업데이트, 제거 및 자주 발생하는 설치 문제

deb와 rpm은 패키지 관리자가 설치 상태를 기록하지만, 로컬 파일을 직접 설치했다고 해서 Shadowrocket을 자동 업데이트하는 저장소가 추가되는 것은 아닙니다. 업데이트하려면 사이트의 다운로드 페이지에서 현재 시스템에 맞는 패키지를 받은 다음 같은 패키지 관리자로 처리하세요. AppImage는 보통 실행 중인 파일을 새 파일로 교체해야 합니다. 데스크톱 바로가기가 이전 경로를 가리키고 있지는 않은지도 확인하세요.

deb를 설치했는데 자동으로 업데이트되지 않는 이유는 무엇인가요?

먼저 시스템에 해당 업데이트 저장소가 설정돼 있는지 확인하세요. 로컬 deb 설치만으로 업데이트 저장소가 있다고 볼 수는 없습니다. 수동으로 업데이트하려면 다운로드 페이지에서 파일을 다시 받아 sudo apt install 뒤에 실제 전체 경로를 입력하고 작업 요약을 확인하세요.

제거할 때 어떤 패키지 이름을 입력해야 하나요?

deb는 dpkg-deb --field "$pkg" Package로 이름을 확인하고, rpm은 rpm -qp --queryformat '%{NAME}\n' "$pkg"로 확인하세요. 출력된 실제 이름을 apt remove 또는 dnf remove에 사용하고, 파일 이름으로 추측하지 마세요.

AppImage를 삭제하면 설정도 사라지나요?

반드시 그런 것은 아닙니다. 프로그램 파일과 사용자 설정은 보통 별도로 저장되므로 AppImage를 삭제해도 설정이 남을 수 있습니다. 설정을 정리하려면 앱에 제공된 설정 관리 기능을 먼저 사용하고, 개인 설정을 백업하세요. 추측한 경로를 기준으로 사용자 폴더의 파일을 한꺼번에 삭제하지 마세요.

프로그램은 열리지만 구독 목록이 계속 비어 있나요?

먼저 Home에서 Subscribe 유형으로 저장했는지 확인하고, 링크가 완전한지, 의도치 않은 공백이 있는지, 업데이트 중 오류가 반환됐는지 살펴보세요. 기존 서비스 제공업체에 링크 상태를 문의할 때는 공개 스크린샷에 token이 노출되지 않도록 주의하세요. deb나 rpm을 바꿔도 만료되거나 작동하지 않는 구독 링크는 해결되지 않습니다.

문제를 문의할 때는 배포판 이름, uname -m 출력, 사용한 패키지 형식, 실패 단계, 터미널의 원본 오류 메시지를 남기면 됩니다. 구독 주소, 비밀번호, PrivateKey 등 민감한 정보는 로그를 보내기 전에 삭제하세요. “Linux에서 작동하지 않음”이라고만 설명하기보다 “패키지 관리자 설치 실패”, “AppImage 실행 실패”, “실행 후 연결 실패”처럼 문제 단계를 구체적으로 알려주면 확인하기 쉽습니다.

Shadowrocket 공식 다운로드