이 글에서는 Shadowrocket Linux 설치 패키지 선택, CPU 아키텍처 확인, 로컬 설치 명령과 첫 실행 점검 방법을 설명합니다. deb와 rpm은 해당 시스템의 패키지 관리자로 설치하고, AppImage는 실행 권한과 호환되는 실행 환경이 필요합니다. 이미 사용할 서비스 제공업체와 구독을 보유한 경우를 전제로, 먼저 프로그램을 설치한 뒤 설정과 네트워크 연결을 따로 확인합니다.
1. 배포판을 확인한 다음 설치 패키지 선택
설치 패키지를 고를 때는 먼저 배포판의 패키지 관리 체계를 확인하고, 다음으로 CPU 아키텍처를 확인하세요. 데스크톱 환경은 판단 기준이 아닙니다. GNOME이나 KDE를 사용하는 시스템이라도 기반 배포판에 따라 deb 또는 rpm을 사용할 수 있습니다. 터미널을 열고 다음 명령을 실행해 현재 시스템 정보를 확인하세요.
cat /etc/os-release
uname -m
/etc/os-release의 ID는 현재 배포판을 나타내고, ID_LIKE는 계열을 파악하는 데 도움이 됩니다. uname -m은 시스템 아키텍처를 출력합니다. 일반적으로 x86_64는 x86 64비트 아키텍처를 뜻하며 다운로드 페이지에서 amd64로 표시되기도 합니다. aarch64는 ARM 64비트 아키텍처를 뜻하며 arm64로 표시되기도 합니다. 실제로 사용할 수 있는 아키텍처는 다운로드 페이지에 표시된 파일을 기준으로 확인하고, 확장자만 보고 선택하지 마세요.
| 시스템 환경 | 패키지 형식 | 설치 또는 실행 방법 | 먼저 확인할 항목 |
|---|---|---|---|
| Debian, Ubuntu 및 관련 파생 배포판 | deb | apt로 로컬 파일 설치 | 패키지 아키텍처와 종속성의 호환성 |
| Fedora 등 dnf를 사용하는 배포판 | rpm | dnf로 로컬 파일 설치 | 배포판 호환성과 종속성 출처 |
| 그 밖의 호환되는 Linux 데스크톱 환경 | AppImage | 실행 권한을 부여한 뒤 실행 | CPU 아키텍처, 런타임 라이브러리, 마운트 조건 |
rpm 형식이라고 해서 rpm을 사용하는 모든 시스템에서 같은 파일을 실행할 수 있는 것은 아닙니다. 예를 들어 다른 패키지 관리 프런트엔드를 사용하는 배포판에서는 dnf 명령을 그대로 사용할 수 없습니다. AppImage도 시스템 환경과 완전히 분리된 컨테이너가 아닙니다. 시스템의 런타임 라이브러리가 요구 사항을 충족하지 않으면 실행 권한을 부여해도 시작되지 않을 수 있습니다.
2. 다운로드 페이지에서 파일을 받고 경로 확인
전체 플랫폼 다운로드 페이지에서 Linux 설치 패키지를 찾아 앞 절에서 확인한 형식과 아키텍처에 맞는 파일을 선택하세요. 이 글에서는 패키지 파일명을 고정하지 않으며, 파일명에 포함된 숫자를 호환성 판단 기준으로 삼지 않습니다. 다음 명령에서는 실제로 내려받은 파일 경로를 입력합니다.
-
시스템 확인
cat /etc/os-release와uname -m을 실행해 배포판과 CPU 아키텍처를 확인하세요. 데스크톱 테마로 시스템 종류를 판단하지 마세요. -
파일 선택
전체 플랫폼 다운로드 페이지의 Linux 섹션을 열고 호환되는 deb, rpm 또는 AppImage를 선택하세요. 브라우저의 다운로드가 완료된 뒤 진행합니다.
-
경로 복사
파일 관리자의 속성에서 파일 위치를 확인하고 파일명을 포함한 절대 경로를 복사하세요. 아래 입력 안내에 경로를 붙여넣을 때 따옴표를 추가하지 마세요.
-
형식에 맞게 실행
Bash 터미널에서 해당 절의 명령을 실행하세요. 오류가 발생하면 먼저 터미널 출력을 확인하고, 여러 형식을 연달아 설치해 덮어쓰지 마세요.
3. Debian 및 Ubuntu: apt로 deb 설치
현재 시스템에 맞는 deb 파일은 apt로 로컬 설치하는 것이 좋습니다. 단순히 압축을 푸는 방식과 달리 apt는 종속성을 확인하고, 설정된 소프트웨어 저장소에서 필요한 종속성을 가져오려고 합니다. 설치 중 배포판 소프트웨어 저장소에 접속해야 할 수 있으므로, 설치 파일을 로컬에 보유하고 있어도 전체 과정을 오프라인으로 완료할 수 있는 것은 아닙니다.
read -r -p "deb 파일의 절대 경로를 입력하세요: " pkg
dpkg-deb -f "$pkg" Package Architecture
sudo apt install "$pkg"
첫 번째 확인 명령은 패키지 이름과 아키텍처를 읽으며 프로그램을 설치하지 않습니다. 출력이 예상과 일치하는지 확인한 다음 설치 명령을 실행하세요. 절대 경로를 사용하는 이유는 apt가 입력을 로컬 파일로 인식하게 하기 위해서입니다. 상대 경로를 사용한다면 파일명만 쓰지 말고 ./를 붙이세요.
- 종속성 다운로드에 실패하면 네트워크, 저장소 주소, 패키지 색인 상태를 확인하세요. 필요하면
sudo apt update를 실행한 뒤 다시 시도합니다. - 아키텍처가 일치하지 않는다는 메시지가 나오면 다운로드 페이지의 파일과
uname -m출력을 다시 확인하세요. 강제 옵션으로 검사를 우회하지 마세요. - 설치 가능한 종속성 후보가 없다는 메시지가 나오면 현재 배포판이 패키지 요구 사항을 충족하는지 확인하세요. 다른 배포판의 소프트웨어 저장소를 함께 사용하지 마세요.
- 설치가 완료되면 애플리케이션 메뉴에서 Shadowrocket을 실행하세요. 그래픽 인터페이스를 시작하려고 sudo를 다시 사용하지 마세요.
이후 새 로컬 deb 파일로 업데이트할 때도 apt로 새 파일을 설치하면 패키지 관리자가 업그레이드 여부를 판단합니다. 로컬 deb 하나를 설치했다고 시스템에 애플리케이션 업데이트 저장소가 설정되는 것은 아닙니다. 업데이트 저장소의 유무는 실제 저장소 설정을 확인해야 하며, 설치가 성공했다는 사실만으로 추정할 수 없습니다.
4. Fedora: dnf로 rpm 설치
dnf를 사용하는 시스템에서는 rpm 패키지 정보를 먼저 확인한 다음 설치하세요. dnf는 로컬 패키지와 시스템에 이미 설치된 항목, 활성화된 소프트웨어 저장소를 함께 고려해 종속성을 계산합니다. 확장자가 같더라도 다른 배포판용으로 빌드된 rpm은 필요한 런타임 라이브러리가 다를 수 있습니다.
read -r -p "rpm 파일의 절대 경로를 입력하세요: " pkg
rpm -qp --queryformat '%{NAME}\n%{ARCH}\n' "$pkg"
sudo dnf install "$pkg"
설치 작업을 시작하기 전에 dnf가 표시하는 추가·업그레이드·제거 항목을 확인하세요. 예상하지 못한 다수의 시스템 구성 요소가 교체될 예정이라면 작업을 취소하고 다운로드 페이지에서 파일과 배포판 요구 사항을 다시 확인하세요. 애플리케이션 하나를 설치하기 위해 설명할 수 없는 시스템 전체 변경을 그대로 진행하지 마세요.
deb 설치 확인
- 시스템 정보
cat /etc/os-release- 패키지 정보
dpkg-deb -f "$pkg" Package Architecture- 로컬 설치
sudo apt install "$pkg"
apt가 설치 작업과 종속성을 처리합니다. 입력 파일은 현재 시스템에 맞아야 합니다.
rpm 설치 확인
- 시스템 아키텍처
uname -m- 패키지 정보
rpm -qpi "$pkg"- 로컬 설치
sudo dnf install "$pkg"
이 명령은 dnf 환경용입니다. rpm 형식이라고 해서 배포판 간 호환성이 보장되는 것은 아닙니다.
5. AppImage: 실행 권한을 부여한 뒤 실행
AppImage는 일반적으로 apt나 dnf로 설치하지 않습니다. 현재 사용자가 읽을 수 있는 위치에 파일을 저장하고 실행 권한을 부여한 다음 바로 실행하면 됩니다. 실행 후 원본 파일을 이동하거나 삭제하지 않도록 먼저 저장 위치를 정해 두는 것이 좋습니다. 다음 명령은 선택한 파일만 수정하며 디렉터리 권한을 재귀적으로 변경하지 않습니다.
read -r -p "AppImage 파일의 절대 경로를 입력하세요: " pkg
chmod +x "$pkg"
"$pkg"
파일을 두 번 클릭해도 아무 반응이 없다면 먼저 터미널에서 마지막 줄을 실행하고 오류 메시지를 보관하세요. Permission denied가 표시되면 파일에 실행 권한이 없거나 파일이 저장된 파티션에 noexec 마운트 옵션이 적용된 것일 수 있습니다. chmod를 반복 실행해도 파티션의 마운트 제한은 바뀌지 않습니다.
ls -l "$pkg"를 실행해 권한을 확인하고 현재 사용자에게 읽기 및 실행 권한이 있는지 확인하세요.Exec format error가 표시되면 먼저 CPU 아키텍처와 파일 다운로드가 완료되었는지 확인하세요. 이를 구독 연결 오류로 오해하지 마세요.- FUSE 관련 오류가 표시되면 현재 배포판 문서에서 필요한 호환 구성 요소를 확인하세요. 배포판마다 패키지명이 다르므로 다른 시스템의 설치 명령을 그대로 사용하지 마세요.
- 공유 라이브러리나 런타임 기호가 없다는 메시지가 표시되면 전체 오류를 기록하고 시스템 호환 요구 사항을 확인하세요. 실행 권한만으로 실행 환경을 보완할 수는 없습니다.
AppImage 파일은 일반적으로 로컬 deb나 rpm처럼 패키지 관리자에 설치된 항목으로 자동 등록되지 않습니다. 따라서 애플리케이션 메뉴에 실행 항목이 반드시 생성된다고 볼 수 없습니다. 업데이트하기 전에 실행 중인 프로그램을 종료하고 설정을 보관한 뒤, 다운로드 페이지 안내에 따라 파일을 교체하세요. 새 파일에는 실행 권한을 다시 부여해야 할 수 있습니다.
6. 첫 실행: 설치 확인과 라우팅 확인은 별도로
Shadowrocket이 열린다는 것은 프로그램이 실행되었다는 뜻일 뿐, 구독이 유효하거나 트래픽이 프록시를 통과한다는 의미는 아닙니다. 먼저 보유한 서비스 정보를 확인한 다음 Home에서 서버 선택과 연결 상태를 살펴보세요. Config에서 구성 파일을 관리하고, Global Routing에서 현재 라우팅 방식을 설정합니다. 문제를 확인할 때는 한 번에 변수 하나만 변경하세요.
아래에서는 Shadowrocket의 Global Routing 설정을 비교합니다. 설치 패키지별 성능 차이를 비교하는 것이 아닙니다. deb, rpm, AppImage는 배포 형식이며 연결 속도를 구분하는 기준으로 삼아서는 안 됩니다.
Config
권장현재 설정된 규칙에 따라 연결 경로를 결정합니다. 규칙은 프록시, 직접 연결 또는 그 밖에 정의된 정책을 지정할 수 있으며, 규칙에 일치하지 않는 모든 트래픽이 기본적으로 직접 연결되는 것은 아닙니다. 최종 경로는 기본 규칙에도 영향을 받습니다.
적합한 경우: 사용 가능한 구성이 있고 도메인 또는 IP 규칙에 따라 트래픽을 분리하려는 경우
Proxy
클라이언트가 처리하는 연결을 현재 프록시 정책으로 보냅니다. 분할 라우팅 규칙의 영향을 잠시 제외해 확인할 때 사용할 수 있지만, 서버 설정 오류를 자동으로 해결하지 않으며 프록시가 처리하지 않는 트래픽까지 프록시를 통과하게 해 주지는 않습니다.
적합한 경우: 프록시 연결 문제와 규칙 매칭 문제가 같은 원인인지 잠시 확인하려는 경우
Direct
클라이언트가 처리하는 연결을 직접 연결로 보냅니다. Direct에서 웹페이지가 열린다고 해서 프록시 서버가 작동한다는 뜻은 아닙니다. 프록시 기능을 테스트하기 전에 현재 라우팅 방식을 확인하세요.
적합한 경우: 원래 네트워크에서 대상에 접속할 수 있는지 비교하려는 경우
예를 들어 다음 두 줄은 example.com과 하위 도메인을 직접 연결하고, 나머지 연결은 FINAL이 PROXY로 보내도록 지정합니다. 여기서 PROXY는 현재 구성에서 사용할 수 있는 정책이어야 합니다. 이 예시는 규칙 순서를 설명하기 위한 것으로, 기존 구성을 대체할 수 있는 완전한 설정 파일이 아닙니다.
DOMAIN-SUFFIX,example.com,DIRECT
FINAL,PROXY
Home의 Connectivity Test에서 결과가 나오지만 브라우저 접속이 예상과 다르다면 브라우저에 별도의 프록시 설정이 있는지, 시스템 프록시가 실제 리스닝 주소를 가리키는지, Global Routing이 현재 테스트 목적에 맞는지 확인하세요. 인터넷에서 자주 보이는 포트 번호를 그대로 적용하지 마세요. 로컬 리스닝 포트는 실제 설정을 기준으로 해야 합니다.
7. 설치 및 실행 관련 자주 묻는 질문
apt에서 파일을 찾을 수 없다고 나옵니다. 패키지가 손상된 건가요?
먼저 입력한 경로가 완전한 로컬 파일 경로인지 확인하세요. ls -l "$pkg"로 파일이 존재하는지, 브라우저의 임시 다운로드 파일은 아닌지 확인합니다. 상대 경로에는 ./를 붙이고 절대 경로는 /로 시작해야 합니다. 파일 경로는 소프트웨어 저장소의 패키지명이 아닙니다.
AppImage에 chmod를 적용했는데도 열리지 않는 이유는 무엇인가요?
터미널에서 파일을 실행해 오류를 확인하세요. 실행 권한, noexec 마운트, 아키텍처, FUSE, 런타임 라이브러리 문제를 구분한 뒤 해당 항목을 해결합니다. 파일 권한을 불필요하게 확대하는 chmod 777을 사용하지 말고, 모든 실행 오류를 네트워크 문제로 돌리지 마세요.
deb를 설치한 뒤 AppImage도 설치해야 하나요?
설치가 끝나고 정상적으로 실행된다면 구독을 가져오기 위해 다른 형식의 파일을 추가로 설치할 필요가 없습니다. 프로그램을 여러 개 설치하면 실행 항목과 설정 위치를 구분하기가 더 복잡해집니다. 형식을 바꾸기 전에 프로그램을 종료하고 설정을 백업한 다음 기존 설치 방식을 기록해 두세요.
프로그램은 열리는데 구독 업데이트에 실패합니다. 재설치해야 하나요?
먼저 보유한 구독 주소와 유효 상태, 현재 네트워크를 확인한 다음 해당 주소에 접속하는 데 필요한 라우팅 조건을 점검하세요. 구독은 설정 데이터이므로 프로그램을 재설치해도 서버 주소나 인증 상태는 바뀌지 않습니다. 문제를 확인할 때 접근 토큰이 포함될 수 있는 구독 링크 전체를 공개하지 마세요.
문제를 기록해야 한다면 배포판 이름, uname -m 출력, 설치 형식, 실행한 명령과 전체 오류 메시지를 남기세요. 이 정보로 설치 작업 실패, 실행 환경 미충족, 연결 설정 오류를 구분할 수 있습니다. 기록을 공유하기 전에 구독 토큰, 서버 비밀번호 및 기타 접속 자격 증명을 삭제하세요.
Shadowrocket 다운로드 및 설정 이어서 하기
iPhone / iPad 버전은 App Store에서 $2.99에 한 번 구매하며, 시스템 요구 사항은 App Store 페이지 표기를 따릅니다. Mac(Apple 실리콘 및 Intel), Windows, Android, Linux 버전은 무료입니다. 다운로드 페이지에서 운영체제에 맞는 파일을 선택한 뒤 설치하고, 안내에 따라 보유한 구독을 가져와 라우팅 설정을 확인하세요.