Linux 데스크톱에 Shadowrocket을 설치할 때는 먼저 배포판과 시스템 아키텍처를 확인한 뒤 패키지 형식을 선택하세요. deb와 rpm은 시스템 패키지 관리자로 설치하고, AppImage는 사용자 실행 권한이 있는 디렉터리에 저장한 다음 실행 권한을 추가해 바로 실행하면 됩니다. 경로 오류, 의존성 문제, 파일 실행 오류를 구분하는 방법도 설명합니다.
01 · 배포판과 시스템 아키텍처 확인
배포판 확인
터미널을 열고
cat /etc/os-release를 실행하세요. 먼저ID를 확인해 현재 배포판을 파악합니다. 배포판이 익숙하지 않다면ID_LIKE를 참고해 계열을 확인하세요.ID_LIKE는 배포판 간의 관계를 나타낼 뿐, 패키지 의존성이 반드시 호환된다는 뜻은 아닙니다.아키텍처 확인
uname -m을 실행해 커널 아키텍처를 확인하세요. 일반적으로x86_64는 deb의amd64에,aarch64는 deb의arm64에 해당합니다. Debian 또는 Ubuntu에서는dpkg --print-architecture로 패키지 관리자가 사용하는 아키텍처도 확인하세요. 다운로드 페이지에서 실제로 제공하며 시스템과 일치하는 패키지만 선택하세요.패키지 형식 선택
Debian과 Ubuntu에서는
.deb, Fedora와 RHEL에서는.rpm을 우선 선택하세요. 그 외 배포판에서는 기기의 아키텍처와 실행 환경에 맞는.AppImage가 있는지 먼저 확인할 수 있습니다. 시스템에 특정 패키지 관리 도구가 설치되어 있다는 이유만으로 다른 배포판 계열용 패키지를 설치하지 마세요.설치 패키지 받기
클라이언트 다운로드 페이지로 이동해 Linux 플랫폼에서 알맞은 형식을 선택하세요. 다운로드가 완료되면 파일 관리자에서 파일을 찾아 전체 경로와 확장자를 확인합니다. 아래 명령에 입력하는 것은 다운로드한 파일의 로컬 경로이며, 다운로드 링크가 아닙니다.
02 · apt 또는 dnf로 로컬 패키지 설치
아래 명령은 apt 또는 dnf가 설치된 시스템에서 각각 사용할 수 있습니다. 다운로드한 형식에 해당하는 명령만 실행하세요. 터미널에 경로 입력 안내가 표시되면 /로 시작하는 전체 파일 경로를 입력하고 따옴표는 덧붙이지 마세요. 명령의 "$pkg"는 경로에 포함된 공백을 그대로 처리합니다.
Debian / Ubuntu: deb 설치
printf 'deb 파일의 전체 경로를 입력하세요:'
>
printf 'deb 파일의 전체 경로를 입력하세요:'
IFS= read -r pkg
if [ -f "$pkg" ]; then
sudo apt install "$pkg"
else
printf '%s\n' '파일을 찾을 수 없습니다. 전체 경로를 확인하세요.'
fi
Fedora / RHEL: rpm 설치
printf 'rpm 파일의 전체 경로를 입력하세요:'
IFS= read -r pkg
if [ -f "$pkg" ]; then
sudo dnf install "$pkg"
else
printf '%s\n' '파일을 찾을 수 없습니다. 전체 경로를 확인하세요.'
fi
apt 설치 옵션
- 로컬 경로 입력
/로 시작하는.deb경로- 의존성 출처
- 활성화된 apt 저장소
- 패키지 정보 확인
dpkg-deb -f "$pkg" Package Architecture Depends
경로 없이 파일 이름만 입력하면 apt가 해당 이름을 저장소의 패키지 이름으로 처리할 수 있습니다.
dnf 설치 옵션
- 로컬 경로 입력
/로 시작하는.rpm경로- 의존성 출처
- 현재 활성화된 DNF 저장소
- 패키지 정보 확인
rpm -qpi "$pkg"
설치 전에 트랜잭션 요약을 확인하세요. 예상치 못한 제거 항목이 표시되면 취소하고 의존성 충돌을 확인하세요.
로컬 설치가 오프라인 설치를 뜻하지는 않습니다. 의존성이 부족하면 패키지 관리자가 활성화된 저장소에 온라인으로 접속할 수 있습니다. 특정 의존성이 없거나 이를 제공하는 패키지를 찾을 수 없다는 오류가 발생하면 먼저 오류에 표시된 패키지 이름을 기록한 뒤 배포판, 아키텍처, 저장소 상태를 확인하세요. 로컬 패키지 하나를 설치하려고 다른 배포판의 저장소를 함께 사용하지 마세요.
03 · AppImage 실행 권한 추가
AppImage는 apt install이나 dnf install로 설치하지 않습니다. 먼저 다운로드한 파일을 계속 보관할 사용자 디렉터리로 옮긴 다음 일반 사용자 권한으로 실행하세요. 아래의 chmod u+x는 chmod +x를 제한적으로 적용하는 방식으로, 파일 소유자에게만 실행 권한을 추가합니다.
printf 'AppImage 파일의 전체 경로를 입력하세요:'
IFS= read -r app
if [ -f "$app" ]; then
chmod u+x -- "$app" && "$app"
else
printf '%s\n' '파일을 찾을 수 없습니다. 전체 경로를 확인하세요.'
fi
- 먼저 권한 비트를 확인하세요: 같은 터미널에서
ls -l -- "$app"를 실행합니다. 본인이 소유한 파일이라면 권한 문자열의 소유자 항목에x가 표시될 때 실행 권한이 설정된 것입니다. - 권한 비트가 올바른데도 실행이 거부되는 경우:
findmnt -no TARGET,OPTIONS --target "$app"을 실행해 파일이 있는 파일 시스템을 확인하세요.noexec가 포함되어 있으면 실행 권한이 있어도 해당 위치에서 파일을 실행할 수 없습니다. 시스템에서 실행을 허용하는 사용자 디렉터리로 파일을 옮긴 다음 새 경로로 실행하세요. - FUSE 관련 오류가 표시되는 경우: 터미널에
libfuse.so.2가 없다고 명시적으로 표시되면 먼저 현재 배포판에서 제공하는 FUSE 2 호환 라이브러리를 확인하세요. 패키지 이름은 배포판마다 다릅니다. 실행 권한이 이미 올바르다면chmod를 다시 실행해도 런타임 라이브러리가 추가되지는 않습니다.
04 · 설치 후 Global Routing 확인
앱이 열린다는 것은 실행 단계가 완료되었다는 뜻일 뿐, 사용할 수 있는 프록시 서비스에 연결된다는 뜻은 아닙니다. 먼저 본인의 서비스 정보를 사용해 설정을 완료하세요. 현재 인터페이스의 Home에 Global Routing이 있다면 아래 용도에 따라 모드를 선택할 수 있습니다. 설정은 한 번에 하나씩만 변경하고, 정상적으로 접속되는 동일한 테스트 주소로 결과를 비교해 규칙 차이를 설치 문제로 오인하지 않도록 하세요.
Config
권장현재 Config의 규칙에 따라 각 요청의 경로를 결정합니다. 규칙은 위에서 아래로 적용됩니다. FINAL이 설정되어 있다면 앞선 규칙과 일치하지 않는 요청에는 FINAL에서 지정한 정책이 적용되며, 모두 직접 연결되는 것은 아닙니다.
적합한 경우: 서비스가 작동하는 것을 확인했고 설정된 규칙에 따라 트래픽을 분할하려는 경우
Direct
클라이언트가 처리하는 요청을 직접 연결해 동일한 대상에 직접 접속할 수 있는지 확인합니다. 이 결과만으로 설정된 프록시 서비스의 작동 여부를 판단할 수는 없습니다.
적합한 경우: 직접 연결 결과를 비교해 대상에 접속할 수 없는 문제와 프록시 경로 문제를 구분하려는 경우
Proxy
클라이언트가 처리하는 요청을 선택한 프록시 서비스로 보내며 Config 규칙에 따라 분할하지 않습니다. Proxy로는 접속되지만 Config로는 접속되지 않는다면 Config로 돌아가 해당 대상에 적용되는 규칙과 정책을 확인하세요.
적합한 경우: 프록시 경로를 잠시 확인한 뒤 원래 설정으로 되돌리려는 경우
05 · Linux 설치 관련 자주 묻는 질문
다운로드는 완료됐는데 터미널에 파일을 찾을 수 없다고 표시되는 이유는 무엇인가요?
같은 파일을 여러 번 다운로드하면 파일 이름에 번호가 붙을 수 있습니다. 파일 관리자로 돌아가 실제 이름과 디렉터리를 확인한 다음 전체 경로를 다시 입력하세요. 경로에 공백이 있다면 위 안내에 따라 그대로 입력하세요. 파일 관리자에 표시되는 file:// 주소를 경로로 사용하면 안 됩니다.
AppImage에서 Exec format error가 표시되는데, 권한 문제인가요?
먼저 file -- "$app"을 실행해 파일 형식과 아키텍처를 확인하세요. 결과가 HTML 또는 일반 텍스트로 표시되면 다운로드 페이지에서 패키지를 다시 받으세요. 실행 파일의 아키텍처가 기기와 맞지 않는다면 아키텍처에 맞는 패키지를 선택하세요. 실행 권한을 추가해도 파일 형식이나 아키텍처는 바뀌지 않습니다.
deb 또는 rpm 설치를 마쳤는데 앱 메뉴에서 찾을 수 없다면 어떻게 하나요?
먼저 패키지 정보 확인 명령으로 실제 패키지 이름을 확인한 다음 dpkg -l 또는 rpm -q 뒤에 패키지 이름을 붙여 설치 여부를 확인하세요. 설치된 경우 dpkg -L 또는 rpm -ql 뒤에 패키지 이름을 붙여 설치 파일을 확인하고, 그 안에 .desktop 실행 항목이 있는지와 해당 파일이 저장된 디렉터리를 살펴보세요. 메뉴에 표시되지 않는다고 해서 설치 작업이 실패한 것은 아닙니다.
업데이트할 때 기존 파일을 새 파일로 바꾸기만 하면 되나요?
deb와 rpm은 아키텍처가 같은 새 패키지를 사용하고 기존 패키지 관리자로 업데이트한 뒤 트랜잭션 요약을 확인하세요. AppImage는 먼저 실행 중인 앱을 종료하고 새 파일에 실행 권한을 추가한 다음 실행해 보세요. 직접 만든 실행 항목이 이전 경로를 가리키면 새 경로로 변경하세요. 이전 파일을 보관해도 설정이 백업되는 것은 아니므로 업데이트 전에 필요한 설정을 따로 저장해야 합니다.
Shadowrocket 클라이언트 다운로드
두 가지 방식으로 제공됩니다. iPhone / iPad 버전은 App Store에서 받을 수 있으며 $2.99 일회성 결제입니다. 시스템 요구 사항은 App Store 페이지를 기준으로 확인하세요. Mac(Apple Silicon 및 Intel) / Windows / Android / Linux 버전은 무료이며 설치 패키지는 이 사이트에서 제공합니다.