이 글은 Linux 데스크톱에 Shadowrocket을 설치하려는 사용자 중 이용 중인 서비스 제공업체와 구독 링크가 있는 분을 위한 안내입니다. 먼저 배포판과 CPU 아키텍처를 확인한 뒤 deb, rpm, AppImage 중 적합한 형식을 선택하세요. 설치 후에는 앱 실행, 구독 가져오기, 요청 연결을 각각 확인해 설치 문제와 설정 문제를 구분합니다.
1. 배포판, 아키텍처, 설치 파일 형식 확인하기
deb, rpm, AppImage는 Linux 소프트웨어를 배포하는 서로 다른 형식이며, 프록시 프로토콜의 종류가 아닙니다. 배포판에서 사용하는 패키지 관리자를 확인하고 다운로드 페이지에 표시된 아키텍처와 실행 요건을 확인해 형식을 선택하세요. 파일 확장자를 .rpm에서 .deb로 바꿔도 패키지 형식은 변환되지 않으며, 아키텍처 불일치도 해결되지 않습니다.
터미널을 열고 다음 명령을 실행하세요. /etc/os-release는 배포판을 확인할 때, uname -m은 아키텍처를 확인할 때 사용합니다. 두 정보를 각각 확인해야 하며 데스크톱 외관만으로 판단하면 안 됩니다.
cat /etc/os-release
uname -m
| 설치 형식 | 주요 사용 환경 | 설치 방법 | 유의 사항 |
|---|---|---|---|
| deb | Debian, Ubuntu 및 apt를 사용하는 파생 배포판 | apt로 로컬 파일 설치 | 패키지 관리자가 패키지를 등록하고, 설정된 저장소에서 의존성을 확인합니다. |
| rpm | Fedora 및 dnf를 사용하는 배포판 | dnf로 로컬 파일 설치 | rpm 형식을 사용한다고 해서 모든 배포판에서 dnf를 사용하는 것은 아닙니다. |
| AppImage | 해당 파일의 실행 요건을 충족하는 Linux 데스크톱 | 실행 권한을 부여한 뒤 실행 | CPU 아키텍처, 시스템 라이브러리, FUSE, 마운트 옵션의 영향을 받습니다. |
예를 들어 x86_64는 다운로드 페이지의 x64 또는 amd64와 대응하는 경우가 많고, aarch64는 arm64와 대응하는 경우가 많습니다. 이는 아키텍처 명칭 간 대응 관계를 설명한 것으로, 사이트에서 모든 조합의 파일을 제공한다는 뜻은 아닙니다. 실제로 사용할 수 있는 파일은 전체 플랫폼 다운로드 페이지에서 확인하세요. 아키텍처가 맞지 않는 파일에 실행 권한을 반복해서 부여하지 마세요.
2. 설치 파일을 받고 설치 전 정보 기록하기
다운로드 페이지에서 Linux를 선택한 다음 배포판에 맞는 형식을 고르세요. 이 안내에 나오는 파일 다운로드는 모두 사이트의 다운로드 페이지에서 진행하며, 설치 파일 주소를 직접 조합할 필요는 없습니다. 다운로드한 파일의 폴더와 전체 파일명을 기록해 두세요. 설치, 문제 해결, 패키지 정보 확인에 필요합니다.
-
시스템 확인
터미널을 열고 앞 절의 두 명령을 실행해 배포판 이름과 아키텍처를 기록하세요. 원격 터미널의 시스템이 현재 데스크톱과 다를 수 있으므로, 어떤 시스템에서 작업하는지 확인해야 합니다.
-
형식 선택
전체 플랫폼 다운로드 페이지에서 Linux 섹션으로 이동하세요. apt를 사용하는 시스템은 deb를, dnf를 사용하는 시스템은 rpm을 선택합니다. AppImage를 고려한다면 먼저 해당 형식의 실행 요건을 확인하세요.
-
파일 경로 기록
파일 관리자에서 파일 속성을 열어 실제 절대 경로를 복사하세요. 아래 터미널 안내에 경로를 입력할 때 따옴표를 덧붙이지 말고, 홈 디렉터리 대신 확장되지 않은 물결표를 사용하지 마세요.
-
파일 출처 확인
파일을 사이트의 다운로드 페이지에서 받았고 다운로드가 완료됐는지 확인하세요. 브라우저의 임시 다운로드 확장자가 표시된다면 완료될 때까지 기다린 뒤 설치하세요. 확장자를 직접 지우고 강제로 실행하지 마세요.
3. deb, rpm, AppImage 설치하기
아래 명령은 Bash에서 실행하세요. 선택한 형식에 해당하는 명령 묶음 하나만 실행하면 됩니다. 명령은 실제 파일 경로를 입력받으며 설치 파일명을 미리 가정하지 않습니다. 변수 주위의 큰따옴표는 경로에 공백이 있을 때도 올바르게 처리하기 위한 것입니다. 설치하기 전에 실행 중인 Shadowrocket을 종료하세요.
deb: apt로 로컬 파일과 의존성 설치
Debian, Ubuntu 등 apt 환경에서 다음 명령을 실행하세요. 파일의 절대 경로를 입력한 뒤 apt가 표시하는 설치, 업그레이드 또는 제거 계획을 확인하고 진행 여부를 결정하세요. 의존성 오류를 건너뛰려고 강제 설치 옵션을 바로 사용하지 마세요.
read -r -p "deb 파일의 절대 경로를 입력하세요: " pkg
dpkg-deb -f "$pkg" Package Architecture
sudo apt install "$pkg"
dpkg-deb는 패키지 이름과 아키텍처를 출력하므로 선택한 파일을 확인할 때 유용합니다. apt에서 의존성을 찾을 수 없다고 표시되면 먼저 시스템 저장소를 사용할 수 있는지 확인하세요. 패키지 색인을 새로 고쳐야 한다면 sudo apt update를 실행한 뒤 다시 시도하세요. 색인 새로 고침은 시스템 전체 업그레이드가 아니며, 호환되지 않는 배포판 요건까지 자동으로 해결하지 않습니다.
rpm: dnf 환경에서 로컬 파일 설치
Fedora 등 dnf를 사용하는 시스템에서는 아래 명령을 실행할 수 있습니다. 먼저 패키지 정보를 확인한 뒤 dnf가 의존성을 처리하도록 하세요. rpm 형식을 사용하지만 dnf를 사용하지 않는 시스템은 해당 배포판의 패키지 관리 방법을 따르세요. 명령을 그대로 복사하려고 패키지 관리자를 바꾸지 마세요.
read -r -p "rpm 파일의 절대 경로를 입력하세요: " pkg
rpm -qp --queryformat '%{NAME} %{ARCH}\n' "$pkg"
sudo dnf install "$pkg"
nothing provides가 표시되면 뒤에 나오는 의존성 이름을 확인하고, 시스템 지원 요건과 활성화된 저장소를 점검하세요. 의존성을 무시하는 옵션으로 설치 상태만 강제로 성공으로 바꾸지 마세요. 패키지가 등록됐더라도 프로그램 실행에 필요한 라이브러리가 갖춰졌다는 뜻은 아닙니다.
AppImage: 실행 권한을 부여한 뒤 바로 실행
일반 사용자 계정으로 접근할 수 있고 임의로 정리되지 않는 위치에 파일을 둔 다음 아래 명령을 실행하세요. AppImage는 apt나 dnf에 등록되지 않으므로 첫 실행만으로 패키지 관리자가 제공하는 업데이트 및 제거 기능이 생기지 않습니다.
read -r -p "AppImage 파일의 절대 경로를 입력하세요: " pkg
chmod u+x "$pkg"
"$pkg"
chmod u+x는 파일 소유자에게만 실행 권한을 추가합니다. 모든 사용자에게 쓰기 권한을 개방할 필요는 없습니다.- 평소에는 일반 사용자로 실행하세요. 창이 나타나지 않는다는 이유로 그래픽 앱 전체를
sudo로 실행하지 마세요. - 실행이 확인되면 파일을 보관하세요. 바탕 화면 바로 가기를 직접 만들 경우 대상 경로가 파일의 실제 저장 위치를 가리키도록 설정하세요.
- AppImage에 앱 파일이 함께 들어 있을 수는 있지만, 모든 데이터가 같은 폴더에 저장되거나 모든 시스템 의존성이 포함된다고 단정할 수는 없습니다.
4. 첫 실행 후 설정과 연결을 따로 확인하기
창이 열린 것은 앱이 시작됐다는 뜻일 뿐, 구독과 서버, 분할 라우팅이 모두 설정됐다는 뜻은 아닙니다. 처음에는 Home, Config, Settings 순서로 각 화면의 역할을 확인하세요. Home에서 연결과 서버를 살펴보고, Config에서 사용할 구성을 확인한 뒤, Settings에서 관련 설정을 점검합니다. 시스템 네트워크 권한 요청이 나타나면 안내 내용을 먼저 확인한 다음 승인하세요.
앱에서 확인할 항목
- Home
- 가져온 서버 목록과 현재 선택한 서버를 확인합니다.
- Config
- 활성화된 Config와 Rule 섹션을 확인합니다.
- Global Routing
- 현재 Config, Proxy, Direct 중 무엇을 사용 중인지 확인합니다.
- Connectivity Test
- 선택한 서버의 연결을 확인한 다음 실제 요청을 테스트합니다.
한 번에 설정 하나만 바꾸고 변경 전 상태를 기록해 두면 결과를 파악하기 쉽습니다.
시스템에서 확인할 항목
- CPU 아키텍처
- uname -m 출력 결과와 다운로드 페이지의 아키텍처 표기를 대조합니다.
- 시스템 시간
- 시간대와 날짜를 확인하세요. 시간이 크게 어긋나면 TLS 인증에 영향을 줄 수 있습니다.
- 네트워크 환경
- 먼저 일반 네트워크와 로그인이 필요한 네트워크 인증 페이지를 사용할 수 있는지 확인합니다.
- 서버 포트
- 서비스 제공업체의 안내에 따라 입력하세요. 모든 프로토콜의 포트를 기본값 443으로 설정하지 마세요.
시스템의 인터넷 연결 여부와 프록시 연결 사용 가능 여부는 별개의 검사이며 서로 대체할 수 없습니다.
구독이 있다면 Home 오른쪽 상단의 «+»를 눌러 추가 화면으로 이동한 다음 Type에서 Subscribe를 선택하고 서비스 제공업체에서 받은 구독 링크를 입력해 저장하세요. 이어서 구독을 업데이트하고 Home에 서버 항목이 표시되는지 확인합니다. 구독 업데이트는 일반적으로 서버 정보를 새로 고치는 기능이며, Config의 분할 라우팅 규칙 전체를 교체하는 것으로 간주하면 안 됩니다.
서버를 직접 추가할 때는 Shadowsocks, VMess, VLESS, Trojan, Hysteria2, WireGuard의 입력 항목을 서로 바꿔 쓸 수 없습니다. 서비스 제공업체가 안내한 프로토콜, 주소, 포트, 인증 정보를 각각 입력하세요. 구독 링크를 특정 프로토콜의 서버 주소로 입력하지 마세요. 문제 해결 정보를 공유하기 전에 구독 토큰, 비밀번호, Private Key를 가리세요.
5. Global Routing으로 설치 문제와 분할 라우팅 문제 구분하기
설치 후 일부 웹사이트만 열리지 않는다면 바로 재설치하지 말고 Global Routing부터 확인하세요. 아래 설명은 Shadowrocket 내부의 요청 처리 방식을 비교합니다. 실제 적용 범위는 앱이 처리하는 트래픽에 따라 달라지므로, Proxy를 모든 시스템 프로세스의 트래픽이 반드시 전달되는 모드로 이해하면 안 됩니다.
Config
권장현재 Config에 따라 요청을 처리합니다. Rule 섹션의 순서와 정책을 확인하고 대상 도메인에 최종적으로 어떤 규칙이 적용되는지 살펴보세요. 규칙 설정이 올바른 경우 일상적인 사용에 적합합니다.
적합한 용도: 도메인과 주소에 따른 일상적인 분할 라우팅
Proxy
앱에서 처리하는 요청을 프록시 방식으로 처리하므로 일부 분할 라우팅 규칙의 영향을 일시적으로 배제할 때 사용할 수 있습니다. 전환 후 증상이 달라졌다면 Config를 더 확인하세요. 이를 근거로 시스템 설치가 손상됐다고 판단하면 안 됩니다.
적합한 용도: 규칙 및 정책 선택을 짧게 점검할 때
Direct
요청을 직접 연결 방식으로 처리하며 프록시 서버를 통해 전달하지 않습니다. 원래 네트워크 상태를 확인할 때 사용할 수 있습니다. 프록시가 필요한 대상이 이 모드에서 연결되지 않더라도 서버를 사용할 수 없다는 증거는 아닙니다.
적합한 용도: 직접 연결과 프록시 연결의 차이 확인
Config에서 DOMAIN-SUFFIX는 도메인 접미사, IP-CIDR은 IP 주소 대역, GEOIP는 IP 주소의 위치 정보를 기준으로 일치 여부를 확인하며, FINAL은 마지막으로 적용할 기본 규칙입니다. 규칙은 일반적으로 위에서 아래 순서로 확인합니다. 대상이 앞선 규칙에 이미 일치했다면 뒤쪽 규칙을 수정해도 해당 요청의 결과는 달라지지 않습니다. 수정 전에 현재 Config를 백업하고 임시 진단 설정을 검증한 뒤 원래대로 복구하세요.
6. 첫 실행 시 자주 발생하는 오류와 해결 순서
문제를 진단할 때는 “열리지 않음”이라고만 기록하지 말고 전체 오류 메시지와 재현 단계를 남기세요. 아래는 Linux 설치 및 실행 중 발생할 수 있는 일반적인 문제 유형이며, 모든 배포판에서 나타나는 것은 아닙니다. 먼저 파일 실행과 의존성 문제를 해결하고, 다음으로 앱 설정을 확인한 뒤, 마지막으로 실제 요청을 테스트하세요.
AppImage에서 Permission denied가 표시됩니다. 다운로드는 완료했는데 어떻게 해야 하나요?
먼저 실제 파일에 chmod u+x "$pkg"를 실행한 다음 같은 터미널에서 실행하세요. 계속 실패하면 findmnt -T "$pkg" -o TARGET,OPTIONS를 실행해 파일이 있는 파일 시스템에 noexec 옵션이 적용됐는지 확인하세요. 해당 옵션이 있으면 실행이 허용되는 사용자 디렉터리로 파일을 옮길 수 있습니다. 시스템 마운트 정책을 직접 변경하지 마세요.
Exec format error가 표시되는데 권한이 부족한 건가요?
대개 권한을 추가하기 전에 파일 형식이나 아키텍처를 확인해야 합니다. uname -m 결과, 다운로드 페이지의 아키텍처 표기, file "$pkg" 출력 내용을 대조하세요. file 명령에서 HTML 문서로 표시된다면 잘못된 페이지를 받은 것일 수 있습니다. 다운로드 페이지로 돌아가 올바른 파일을 다시 받으세요.
AppImage에서 libfuse.so.2가 없다고 나옵니다. 무엇을 설치해야 하나요?
먼저 전체 오류 메시지를 기록한 다음 현재 배포판의 패키지 검색 도구로 해당 파일을 제공하는 FUSE 호환 런타임을 찾으세요. 패키지 이름은 배포판과 버전에 따라 다를 수 있으므로 기존 FUSE 구성 요소를 바로 삭제하지 마세요. 호환되는 의존성을 설치한 뒤 일반 사용자 계정으로 터미널에서 실행하세요.
아이콘을 눌러도 창이 나타나지 않습니다. 원인을 어떻게 확인하나요?
AppImage는 앞에서 설정한 경로 변수를 사용해 터미널에서 바로 실행할 수 있습니다. deb 또는 rpm은 데스크톱 실행기의 속성에서 실제 실행 명령을 확인한 뒤 터미널에서 실행하세요. 라이브러리 누락, 그래픽 세션, 권한과 관련된 출력을 기록하세요. 실행 파일명을 추측하거나 보안 기능을 함부로 끄지 마세요.
설치가 완료됐는데 구독 업데이트는 왜 실패하나요?
먼저 일반 네트워크가 작동하는지, 시스템 시간이 올바른지, 구독 링크에 공백이나 줄바꿈이 섞이지 않았는지 확인한 다음 서비스 제공업체에서 구독이 유효한지 확인하세요. 특정 구독 하나만 실패한다면 해당 링크와 네트워크 경로를 먼저 점검하세요. 앱을 재설치해도 만료되거나 유효하지 않은 토큰은 보통 해결되지 않습니다.
7. 업데이트 및 제거 전에 보관할 정보
이후 업데이트도 사이트의 다운로드 페이지에서 시스템 아키텍처에 맞는 파일 형식을 선택해 받으세요. deb와 rpm은 일반적으로 해당 패키지 관리자가 패키지 메타데이터를 기준으로 업그레이드합니다. AppImage는 앱을 종료한 뒤 새 파일로 교체하고 실행 권한과 바로 가기 경로를 다시 확인하세요. 파일을 다운로드 폴더에 넣기만 하면 자동으로 적용된다고 생각하지 마세요.
- 업데이트 전에 직접 수정한 Config를 백업하고 현재 활성화된 Config와 Global Routing 상태를 기록하세요.
- 서비스 제공업체가 제공한 원본 설정 정보를 보관하세요. 백업에 포함된 구독 링크, 비밀번호, 키는 민감 정보로 취급해 안전하게 보관해야 합니다.
- deb 또는 rpm을 제거할 때는 먼저 실제 패키지 이름을 확인하고 apt 또는 dnf의 제거 명령을 사용하세요. 확인 목록을 읽은 뒤 실행합니다.
- AppImage 파일을 삭제해도 사용자 Config까지 지워지는 것은 아닙니다. 데이터를 정리하려면 실제 저장 위치를 먼저 확인하고, 경로를 추측해 폴더를 한꺼번에 삭제하지 마세요.
- 업데이트 후에는 “앱 실행 → Home 확인 → Config 확인 → 요청 테스트” 순서로 다시 점검하면 어느 단계에서 변화가 생겼는지 파악하기 쉽습니다.
설치 형식은 현재 시스템의 관리 방식에 맞춰 선택하는 것이 핵심입니다. apt 환경에서는 해당 deb를, dnf 환경에서는 해당 rpm을 우선 사용하세요. AppImage를 선택했다면 파일 위치, 권한, 실행 의존성을 직접 확인해야 합니다. 설치를 마친 뒤에는 기존 서비스 제공업체 정보를 사용해 구독과 연결을 설정하세요.