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

이 글 미리 보기

Shadowrocket Linux 버전을 설치하려면 먼저 배포판과 프로세서 아키텍처를 확인한 뒤, 사이트의 다운로드 페이지에서 deb, rpm 또는 AppImage를 선택하세요. 이 글에서는 파일 경로를 이용한 설치 명령, AppImage 실행 권한 설정, 최초 실행 확인 방법과 설치 오류 및 연결 설정 오류를 구분하는 방법을 안내합니다. 데스크톱 Linux 환경을 갖추고 기존 서비스 제공업체의 설정을 가져오려는 사용자를 위한 안내입니다.

배포판, 아키텍처, 실행 환경 확인

설치 파일 형식과 프로세서 아키텍처는 각각 별도로 확인해야 합니다. deb는 Debian·Ubuntu 패키지 체계에 적합하고, 이 글에서는 Fedora의 dnf 설치 절차에 rpm을 사용합니다. AppImage는 다른 데스크톱 배포판에서 선택할 수 있지만 프로세서 아키텍처, 시스템 라이브러리, 실행 환경의 제약을 받으므로 모든 Linux에서 실행된다고 볼 수는 없습니다.

시스템의 Terminal을 열고 아래 명령 두 개를 실행하세요. 첫 번째 명령은 배포판 식별 정보를 읽고, 두 번째 명령은 커널이 보고하는 시스템 아키텍처를 표시합니다. 다운로드 페이지에 실제로 표시된 아키텍처와 대조하세요. 컴퓨터 브랜드만 보고 판단하거나 파일 확장자를 다른 형식으로 바꾸지 마세요.

cat /etc/os-release
uname -m

3가지

Linux 설치 형식: deb / rpm / AppImage

2가지

배포판 계열과 프로세서 아키텍처 확인

1가지

AppImage 실행 전 파일 권한 확인

ID=ubuntu 또는 ID=debian: deb 설치 파일을 우선 확인하세요.
ID=fedora: rpm 설치 파일을 우선 확인하고 dnf로 의존성을 처리하세요.
x86_64는 일반적으로 x64 / amd64에 해당하고, aarch64는 일반적으로 ARM64에 해당합니다. 실제 다운로드 페이지에서 제공하는 선택지를 기준으로 확인하세요.
명령줄만 있는 서버는 데스크톱 환경과 다릅니다. 그래픽 세션이 없어 발생한 실행 오류를 설치 파일 손상으로 오해하지 마세요.

환경에 맞는 설치 방식 선택

클라이언트 다운로드 페이지에서 Linux 항목을 열고 시스템에 맞는 파일을 선택하세요. 현재 다운로드 경로로 오인할 수 있는 오래된 파일명을 안내하지 않도록 이 글에서는 설치 파일명을 고정해 두지 않습니다. 다운로드가 끝나면 브라우저의 다운로드 기록에서 저장 위치를 확인하고, 이후 명령에는 실제 파일 경로를 사용하세요.

선택 기준: 시스템 패키지 관리와 독립 실행 파일

Debian / Ubuntu / Fedora

Debian·Ubuntu에서는 deb를 선택하고 apt로 로컬 파일을 설치합니다.
Fedora에서는 rpm을 선택하고 dnf로 로컬 파일을 설치합니다.
패키지 관리자는 설치 결과를 기록하고, 활성화된 소프트웨어 저장소에서 의존성을 해결하려고 시도합니다.

그 외 데스크톱 배포판

먼저 다운로드 페이지에 아키텍처와 일치하는 AppImage가 있는지 확인하세요.
파일에 실행 권한을 부여한 뒤 일반 사용자로 실행하세요.
쓰기와 실행이 가능한 위치에 파일을 보관하고, 의존성 오류가 발생하면 해당 배포판에 맞게 처리하세요.

호환되는 시스템 패키지를 사용할 수 있다면 패키지 관리자를 우선 사용하세요. AppImage를 선택했다면 시스템 호환성과 실행 권한도 별도로 확인해야 합니다.

한 번에 하나의 설치 방식만 검증하세요. deb 설치 버전과 AppImage를 함께 두면 데스크톱 메뉴와 터미널에서 실행되는 파일이 서로 다를 수 있습니다. 문제를 확인할 때 실제 실행 경로를 기록해 두어, 한 파일만 수정하고 다른 복사본을 계속 실행하는 일을 피하세요.

설치 명령: 다운로드한 파일의 실제 경로 사용

아래 명령은 Bash용입니다. 각 단계가 시작되면 파일의 전체 경로를 입력하라는 메시지가 표시됩니다. 경로를 그대로 붙여넣고 따옴표를 덧붙이지 마세요. 명령의 큰따옴표는 공백이 포함된 경로를 처리하기 위한 것이며, realpath -e는 파일이 실제로 존재해야 통과합니다. 경로를 잘못 입력했다면 중단하고 설치 명령을 실행하지 마세요.

Debian·Ubuntu: apt로 deb 설치

read -r -p 'deb 파일의 전체 경로를 입력하세요: ' pkg
pkg=$(realpath -e -- "$pkg") && sudo apt install "$pkg"

여기에는 소프트웨어 저장소의 패키지명이 아닌 로컬 파일의 절대 경로를 입력합니다. apt는 설치 예정 패키지, 의존성, 디스크 사용량을 표시하므로 내용을 확인한 뒤 진행하세요. 의존성 다운로드를 위해서는 시스템에 설정된 저장소에 접근할 수 있어야 합니다. 실패하면 터미널에 표시된 의존성 이름과 저장소 오류를 먼저 확인하고, 설치 파일을 반복해서 더블 클릭하지 마세요.

파일이 없다는 메시지가 표시되면 브라우저의 다운로드 기록으로 돌아가 경로, 대소문자, 다운로드 완료 여부를 확인하세요.
의존성을 충족할 수 없다는 메시지가 표시되면 배포판 버전, 아키텍처, 저장소 설정을 확인하세요. 필요한 경우 sudo apt update를 실행한 뒤 다시 시도하고, 원래 오류 메시지를 보관하세요.
패키지 관리자가 사용 중이라는 메시지가 표시되면 시스템 업데이트가 끝날 때까지 기다리세요. 잠금 파일을 직접 삭제하지 마세요.

Fedora: dnf로 rpm 설치

read -r -p 'rpm 파일의 전체 경로를 입력하세요: ' pkg
pkg=$(realpath -e -- "$pkg") && sudo dnf install "$pkg"

저수준 설치 명령만 실행하지 말고 dnf를 사용하면 시스템 저장소에서 제공하는 의존성도 함께 처리할 수 있습니다. rpm은 파일 형식일 뿐이며, rpm을 사용하는 모든 배포판의 의존성 버전이 같다는 뜻은 아닙니다. 다른 배포판에 Fedora의 호환성 판단을 그대로 적용하지 마세요.

설치 작업에 표시된 변경 사항을 확인하세요. 예상치 못하게 많은 항목을 제거하려 한다면 먼저 취소하세요.
아키텍처가 맞지 않거나 시스템 라이브러리가 없다는 오류가 발생하면 다운로드 페이지로 돌아가 패키지의 지원 범위를 확인하세요.
의존성 검사를 무시해 설치를 강행하지 마세요. 프로그램을 실행할 수 없는 상태가 될 수 있습니다.

AppImage: 권한을 설정한 뒤 실행

read -r -p 'AppImage 파일의 전체 경로를 입력하세요: ' app
if app=$(realpath -e -- "$app"); then
  chmod u+x -- "$app" && "$app"
fi

chmod u+x는 파일 소유자에게만 실행 권한을 추가합니다. 모든 사용자에게 쓰기 권한을 부여할 필요는 없습니다. AppImage 자체를 실행할 때 sudo를 사용하지 마세요. 처음에는 터미널에서 실행하는 것이 좋습니다. 창이 열리지 않더라도 누락된 라이브러리, FUSE 또는 그래픽 세션 관련 오류를 확인할 수 있습니다.

최초 실행: 프로그램 확인 후 설정 가져오기

설치 완료와 연결 성공은 별개의 단계입니다. 먼저 프로그램이 열리는지 확인하고, 이어서 기존 설정을 가져온 뒤 연결 결과를 점검하세요. 아래에서는 Home, Config, Settings의 기능 위치를 기준으로 설명합니다. 플랫폼에 따라 버튼 배치가 다를 수 있으므로 아이콘 위치만 보고 조작하지 말고 화면의 메뉴명을 확인하세요.

실행 확인

시스템 패키지로 설치했다면 데스크톱 앱 메뉴에서 Shadowrocket을 여세요. AppImage는 앞서 확인한 전체 경로로 실행합니다. 창이 나타나지 않으면 네트워크 설정을 바로 변경하지 말고 먼저 Terminal 출력을 확인하세요.
기존 설정 가져오기

Home → 추가 메뉴 → Type → Subscribe로 이동한 뒤, 본인의 구독 주소를 입력하고 저장한 다음 업데이트하세요. 구독 주소에 접근 자격 정보가 포함될 수 있으므로 전체 주소를 공개 로그나 스크린샷에 올리지 마세요.
규칙 확인

Config에서 현재 활성화된 설정을 확인한 뒤 Global Routing 선택 항목을 점검하세요. 설치를 마쳤다고 기존 규칙, 정책 이름, 서버 매개변수가 서로 자동으로 일치하는 것은 아닙니다.
연결 확인

Home에서 기존 설정에 포함된 사용 가능한 연결을 선택하고 스위치를 켠 다음, 연결 상태와 브라우저 접속 결과를 각각 확인하세요. 권한 요청이 표시되면 요청을 보낸 앱을 확인한 뒤 시스템 안내에 따라 처리하세요.

프로그램은 정상적으로 열리지만 연결되지 않는다면 설치 파일을 반복해서 바꾸기보다 주소, 포트, 인증 정보, 전송 매개변수를 확인하세요. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard는 매개변수 구성이 서로 다르므로 서버 주소만 복사했다고 설정이 완료되는 것은 아닙니다. 이 사이트에서는 노드나 구독을 제공·판매·추천하지 않습니다.

Global Routing 설정과 설치 문제 구분

브라우저에서 특정 웹사이트에 접속된다는 사실만으로 트래픽이 예상한 정책을 따랐다고 단정할 수 없습니다. 연결 스위치가 켜져 있어도 모든 연결이 같은 경로를 사용하는 것은 아닙니다. 먼저 Global Routing을 확인하고 현재 설정의 규칙과 함께 살펴보세요. 아래 내용은 Shadowrocket 설정별 용도만 비교합니다.

Config

권장

현재 설정에 포함된 규칙에 따라 트래픽 처리 방식을 선택합니다. 규칙 순서와 연결된 정책이 결과를 결정하므로 Config를 ‘일부는 직접 연결, 나머지는 프록시’처럼 단순화해서 이해하면 안 됩니다.

적합한 경우: 규칙 설정을 보유한 상태에서 일상적으로 사용하거나 트래픽 분기 결과를 확인할 때.

Proxy

클라이언트가 처리하는 연결을 프록시 모드로 전환합니다. Config 설정 결과를 비교할 때 사용할 수 있지만, 시스템의 모든 프로세스에서 발생하는 모든 트래픽을 반드시 처리한다는 뜻은 아닙니다.

적합한 경우: 문제가 규칙 매칭과 관련 있는지 일시적으로 확인할 때.

Direct

클라이언트가 처리하는 연결을 직접 연결 모드로 전환합니다. 이 모드에서는 웹페이지가 열린다는 사실만으로 프록시 매개변수가 올바르다고 판단할 수 없습니다.

적합한 경우: 로컬 네트워크에서 직접 접속한 결과와 비교할 때.

현재 Global Routing에서 Scene을 사용한다면 실제로 활성화된 장면과 조건을 먼저 확인한 뒤 위 모드와 비교하세요. Settings → On Demand는 조건에 따라 연결을 시작하는 기능입니다. 의존성을 설치하거나 AppImage 실행 권한 문제를 해결하는 스위치가 아닙니다.

DOMAIN-SUFFIX: 일치시킬 도메인 접미사와 매칭 후 참조하는 정책이 존재하는지 확인하세요.
IP-CIDR 및 GEOIP: IP 범위 또는 지리적 위치 규칙을 확인하세요. 브라우저에 표시된 도메인만으로 규칙 매칭 결과를 추측하지 마세요.
FINAL: 앞선 규칙에 매칭되지 않은 연결이 마지막에 어떻게 처리되는지 확인하세요.

자주 발생하는 오류: 증상별로 확인하고 재설치를 반복하지 마세요

AppImage를 더블 클릭해도 반응이 없을 때 확인할 항목

먼저 Terminal에서 파일을 실행해 오류를 확인하세요. Permission denied가 표시되면 chmod u+x가 정상적으로 적용됐는지 확인합니다. 이미 실행 권한이 있다면 파일이 있는 파티션이 noexec로 마운트됐는지 살펴보세요. 파일을 실행할 수 있는 사용자 디렉터리로 옮겨 다시 시도할 수 있습니다. 디스크 전체의 보안 정책은 변경하지 마세요.

파일이 디렉터리에 있는데 왜 찾을 수 없다고 표시되나요?

Linux는 기본적으로 현재 디렉터리에서 실행 파일을 검색하지 않습니다. 파일의 절대 경로를 사용하거나 파일명 앞에 ./를 붙이세요. 절대 경로를 사용해도 No such file or directory가 표시된다면 파일명을 반복해서 바꾸기보다 프로그램 로더 또는 누락된 런타임 라이브러리에서 발생한 오류인지 확인해야 합니다.

Exec format error가 표시되면 rpm으로 바꿔야 하나요?

먼저 uname -m을 실행해 아키텍처를 확인하고 다운로드한 파일 형식을 점검하세요. 이 오류는 아키텍처 불일치와 관련 있을 수 있으며 파일 확장자를 바꿔도 해결되지 않습니다. 다운로드가 완료되지 않았거나 실제 프로그램 파일이 아닌 경우도 있으므로 다운로드 기록으로 돌아가 확인하세요. 오류 하나만으로 원인을 단정할 수는 없습니다.

창은 열리지만 연결을 켜면 웹페이지에 접속할 수 없을 때는 어떻게 하나요?

이 경우 정상 실행되는 설치 환경은 그대로 두고 Home의 연결 매개변수, Global Routing, Config를 확인하세요. 시스템 시간이 정확한지 대조한 뒤 서버 연결과 규칙 적용 결과를 각각 테스트합니다. 매개변수 확인을 대신해 앱을 삭제하고 다시 설치하지 마세요.

업데이트와 정리: 복구할 수 있도록 설정 보관

업데이트 전에 현재 설정과 필요한 연결 매개변수를 저장하고 백업 파일의 실제 내용을 확인하세요. 설정에 구독 주소, 비밀번호 또는 키가 포함될 수 있으므로 본인만 접근할 수 있는 위치에 보관해야 합니다. 앱 화면의 스크린샷을 완전한 백업으로 간주하지 말고, 앱을 삭제한 뒤 설정이 반드시 유지되거나 삭제된다고 가정하지 마세요.

deb / rpm: 사이트의 다운로드 페이지에서 호환되는 파일을 다시 받은 뒤 해당하는 apt / dnf 로컬 설치 절차를 이용해 업데이트하세요. 패키지 관리자는 패키지 메타데이터를 기준으로 업데이트 관계를 판단합니다. 로컬 패키지를 다운로드했다고 해서 지속적인 업데이트를 위한 저장소가 추가되는 것은 아닙니다.
AppImage: 실행 중인 인스턴스를 종료한 뒤 새 파일이 정상적으로 실행되는지 확인하세요. 새 파일의 실행과 설정 확인이 끝날 때까지 기존 파일을 보관하고, 기존 데스크톱 바로 가기가 여전히 이전 경로를 가리키는지도 확인하세요.
시스템 패키지 제거: 시스템의 소프트웨어 관리 화면에서 설치된 패키지의 실제 이름을 확인한 뒤 제거하세요. 표시 이름만 보고 명령에 사용할 패키지명을 추측하지 마세요.
AppImage 정리: 파일을 삭제하면 해당 실행 파일만 제거됩니다. 사용자 설정, 캐시, 바로 가기가 남아 있는지는 별도로 확인해야 합니다.

배포판, 아키텍처, 설치 방식, 실행 방법, 터미널에 표시된 첫 오류를 기록해 두면 단순히 ‘열리지 않는다’고 설명하는 것보다 문제를 찾기 쉽습니다. 설치가 끝난 뒤에는 실제 오류를 중심으로 확인하세요. 저장소, 파일 권한, 연결 설정을 한꺼번에 변경하면 어떤 조치가 영향을 주었는지 파악하기 어렵습니다.