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

먼저 배포판과 아키텍처 확인

Shadowrocket Linux 설치에서는 파일 확장자만 확인해서는 안 됩니다. deb와 rpm은 서로 다른 패키지 관리 체계의 형식이며, AppImage는 실행 가능한 애플리케이션 파일입니다. 세 형식 모두 현재 CPU 아키텍처와 실행 환경에 맞아야 합니다. 먼저 터미널에서 아래 읽기 전용 명령을 실행하세요. 시스템 설정은 변경되지 않습니다.

cat /etc/os-release
uname -m

/etc/os-release의 ID와 ID_LIKE로 배포판과 계열을 확인할 수 있습니다. uname -m의 출력이 x86_64이면 일반적인 64비트 Intel / AMD 아키텍처이고, aarch64이면 보통 ARM64입니다. 설치 파일은 형식과 아키텍처가 모두 맞아야 합니다. AppImage도 CPU 아키텍처가 다르면 바로 실행할 수 없습니다.

“rpm을 사용한다”는 말이 모든 rpm 기반 배포판에서 같은 파일을 바로 설치할 수 있다는 뜻은 아닙니다. 예를 들어 시스템의 패키지 관리자가 dnf가 아닐 수 있고, 기본 라이브러리 버전도 다를 수 있습니다. 의존성 문제가 발생하면 구체적인 오류를 확인하세요. 확장자를 deb로 바꾸거나 의존성 검사를 무시해서는 안 됩니다.

설치 파일 다운로드 및 정보 확인

이 사이트의 앱 다운로드 페이지에서 Linux 섹션을 열고 현재 제공되는 형식과 아키텍처에 맞는 파일을 선택하세요. 실제 설치 파일은 다운로드 페이지에서 이 사이트의 /dl/shadowrocket/ 경로로 연결됩니다. 예시를 보고 파일명을 임의로 만들지 말고, 브라우저 다운로드 목록에 이전 파일이 여러 개 있다고 해서 아무 파일이나 선택하지 마세요.

1. 시스템 확인

   cat /etc/os-release와 uname -m을 실행해 배포판 계열과 CPU 아키텍처를 확인하세요.

2. 형식 선택

   앱 다운로드 페이지에서 Linux용 deb, rpm 또는 AppImage를 선택하세요. 다운로드 페이지에 표시되지 않은 아키텍처는 다른 아키텍처의 파일로 대체하지 마세요.

3. 파일 위치 확인

   파일 관리자에서 다운로드가 완료됐는지 확인하고 전체 경로를 기록하세요. 아래 명령은 경로를 직접 입력받으므로 고정된 설치 파일명이 필요하지 않습니다.

4. 패키지 정보 확인

   deb 정보는 dpkg-deb -f, rpm 정보는 rpm -qpi로 확인하세요. AppImage는 먼저 file 명령으로 파일 형식과 아키텍처를 확인할 수 있습니다.

deb는 apt로 설치

Ubuntu와 Debian에서는 apt로 로컬 deb 파일을 설치하는 것이 좋습니다. 파일을 직접 풀어 설치하는 것과 달리 apt는 패키지 의존성을 확인하고, 현재 시스템에 설정된 소프트웨어 저장소에서 필요한 구성 요소를 가져오려고 합니다. 시스템 저장소를 사용할 수 없으면 클라이언트 설치도 의존성 다운로드 단계에서 멈출 수 있습니다.

read -r -p 'deb 파일의 전체 경로를 입력하세요: ' pkg
dpkg-deb -f "$pkg" Package Version Architecture
dpkg --print-architecture
sudo apt install "$pkg"

앞에서 확인한 아키텍처 정보가 서로 맞아야 합니다. 예를 들어 시스템 아키텍처가 amd64라면 이에 맞는 x86-64 설치 파일을 선택하세요. apt가 표시하는 설치 계획을 확인한 뒤 계속 진행하세요. sudo 비밀번호를 입력해도 터미널에 문자가 표시되지 않는 것이 일반적이며, 키보드가 작동하지 않는다는 뜻은 아닙니다.

• “파일을 찾을 수 없음” 오류: 다운로드한 파일의 전체 경로를 입력했는지 확인하세요. 다운로드 폴더나 브라우저에 표시된 웹 주소를 입력하면 안 됩니다.
• “의존성을 충족할 수 없음” 오류: 의존성 이름과 버전 조건을 모두 확인하고, 먼저 해당 패키지가 현재 배포판을 지원하는지 확인하세요.
• 소프트웨어 저장소 색인이 오래된 경우 sudo apt update를 실행한 뒤 설치를 다시 시도할 수 있습니다. 이 명령은 색인을 갱신하며 시스템의 모든 소프트웨어를 업그레이드하지는 않습니다.
• 이전에 완료되지 않은 패키지 작업이 있는 경우 apt 안내를 읽고 패키지 관리 상태를 먼저 정리하세요. 설치 프로세스를 여러 개 반복해서 실행하지 마세요.

설치가 완료되면 데스크톱 앱 메뉴에서 Shadowrocket을 실행하세요. 일반적인 실행 문제를 피하려고 그래픽 클라이언트 전체를 sudo로 실행하지 마세요. 시스템 네트워크 권한이 필요한 경우 실제로 표시되는 권한 요청에 따라 처리하세요.

rpm은 dnf로 설치

Fedora 등 dnf를 사용하는 시스템에서는 dnf로 로컬에 다운로드한 rpm 파일을 설치하세요. 의존성을 확인하고 설치 트랜잭션 계획을 표시합니다. 아래 조회 명령은 패키지 정보만 읽으며, 시스템을 실제로 변경하는 명령은 마지막 설치 명령입니다.

read -r -p 'rpm 파일의 전체 경로를 입력하세요: ' pkg
rpm -qpi "$pkg"
rpm --eval '%{_arch}'
sudo dnf install "$pkg"

rpm 정보의 Architecture가 현재 시스템과 일치하는지 확인하세요. 의존성 충돌이나 기본 라이브러리 버전 부족이 표시되면 먼저 배포판 지원 범위를 잘못 선택했는지 확인하세요. 의존성 검사를 건너뛰는 옵션으로 파일을 시스템에 강제로 설치하지 마세요.

AppImage는 먼저 실행 권한 설정

AppImage는 deb나 rpm처럼 시스템 패키지 데이터베이스에 등록할 필요는 없지만, “설치가 필요 없다”는 말이 실행 조건도 없다는 뜻은 아닙니다. 파일에 실행 권한이 있어야 하고 실행 가능한 위치에 저장해야 하며, 실행 환경에 FUSE 지원이 필요할 수도 있습니다. 먼저 사용자 로컬 디렉터리에 파일을 저장한 다음 터미널에서 실행해 오류를 확인하는 것이 좋습니다.

read -r -p 'AppImage 파일의 전체 경로를 입력하세요: ' app
file "$app"
chmod u+x "$app"
"$app"

chmod u+x는 파일 소유자에게만 실행 권한을 추가합니다. 모든 사용자에게 쓰기 권한을 열 필요는 없습니다. 마지막 줄은 사용자가 입력한 파일을 바로 실행합니다. 터미널에 Exec format error가 표시되면 먼저 아키텍처와 파일 형식을 확인하세요. 실행 권한을 반복해서 추가해도 아키텍처 불일치는 해결되지 않습니다.

• Permission denied: ls -l "$app"로 소유자와 실행 권한을 확인하세요. 실행 권한이 이미 있다면 파일이 있는 파티션에 noexec 마운트 옵션이 적용됐는지 확인하세요.
• libfuse.so.2가 없음: 현재 AppImage 실행 환경에 FUSE 2 호환 라이브러리가 필요하다는 뜻입니다. 배포판에 따라 패키지 이름이 libfuse2 또는 libfuse2t64일 수 있으므로, 현재 시스템의 소프트웨어 저장소에서 확인한 뒤 해당 라이브러리를 설치하세요.
• 더블 클릭해도 파일 선택 대화상자만 열리는 경우: 먼저 실행 권한을 설정하고 터미널에서 한 번 실행하세요. 파일 관리자의 더블 클릭 동작은 오류 로그를 대신할 수 없습니다.
• GLIBC 버전이 부족하다는 메시지: 기본 런타임 라이브러리의 호환성 문제입니다. 시스템 libc를 직접 덮어쓰지 말고 실행 요건을 충족하는 시스템 환경을 선택하세요.

첫 실행 후 확인

창이 열렸다는 것은 프로그램이 정상적으로 시작됐다는 뜻일 뿐, 사용할 수 있는 연결이 있다는 의미는 아닙니다. 아래 단계는 이미 직접 이용 중인 서비스 제공자와 구독이 있는 경우를 전제로 합니다. 이 사이트는 노드나 구독을 제공·판매·추천하지 않으며, 설치 파일에 서비스 인증 정보가 포함되어 있지도 않습니다.

1. Home에서 추가 메뉴를 열고 구독 유형으로 Subscribe를 선택한 다음, 이미 보유한 구독 주소를 붙여넣고 저장하세요. 구독 주소를 개별 서버의 주소 입력란에 넣지 마세요.
2. Home에서 구독을 업데이트하고 예상한 설정 항목이 표시되는지 확인하세요. 업데이트 결과가 비어 있으면 앱을 바로 다시 설치하지 말고 구독 유효 기간, 응답 내용, 접속 상태부터 확인하세요.
3. 규칙에 따라 트래픽을 분기하려면 Config에서 해당 구성을 가져와 활성화했는지 확인한 뒤 Global Routing을 Config로 설정하세요.
4. 사용할 수 있는 기존 항목을 선택하고 연결을 켠 다음, 안내에 따라 필요한 네트워크 권한을 허용하세요. 이후 접속 가능한 것으로 확인된 웹사이트를 테스트하세요.

문제를 점검할 때는 “구독 업데이트 실패”와 “연결을 켠 뒤 접속 실패”를 구분하세요. 전자는 설정을 가져오는 단계에서 발생하고, 후자는 서비스 상태와 DNS, 라우팅 규칙도 영향을 미칩니다. 설치 파일을 바꾸는 동시에 여러 설정을 변경하면 결과가 달라진 원인을 파악하기 어렵습니다.

첫 테스트는 수동 연결로 진행하세요. 이전에 자동 연결을 설정했다면 테스트 중 기존 조건이 연결 상태에 영향을 주지 않도록 Settings → On Demand의 현재 상태도 확인하세요. 플랫폼별로 실제 제공되는 옵션을 기준으로 설정해야 합니다.

자주 발생하는 오류 구분

오류를 기록할 때는 명령, 전체 오류 메시지, 시스템 아키텍처를 남기면 충분합니다. 구독 URL, 액세스 토큰, 서버 비밀번호는 공개 로그에 포함하지 마세요. 아래에서는 문제를 설치 전, 실행 중, 연결 후로 나눠 의존성 문제를 구독 문제로 오해하지 않도록 설명합니다.