Debian, Ubuntu, Fedora에서는 각 배포판에 맞는 기본 패키지를 우선 사용하세요. 적합한 패키지가 없으면 AppImage 실행 조건을 확인하세요. Linux 데스크톱에 Shadowrocket을 처음 설치하는 사용자를 위해 배포판과 아키텍처 확인, 로컬 패키지 설치, AppImage 실행, 의존성 누락 및 권한 오류 해결 방법을 안내합니다.
먼저 배포판과 CPU 아키텍처 확인
Shadowrocket을 실행할 Linux 데스크톱에서 터미널을 열고 아래 두 명령을 실행하세요. 첫 번째 명령은 배포판 식별자와 버전을 표시하고, 두 번째 명령은 현재 커널이 보고하는 시스템 아키텍처를 표시합니다. 가상 머신에서 클라이언트를 사용할 예정이라면 호스트가 아니라 가상 머신 안에서 확인한 정보로 패키지를 선택하세요.
grep -E '^(ID|ID_LIKE|VERSION_ID)=' /etc/os-release
uname -m
시스템 확인
ID=debian또는ID=ubuntu이면 deb를,ID=fedora이면 rpm을 선택합니다. 파생 배포판은ID_LIKE를 참고할 수 있지만, 이는 배포판 간의 관계만 나타내며 패키지 의존성이 모두 충족된다는 보장은 없습니다. 다운로드하기 전에 페이지에 표시된 지원 시스템도 확인하세요.아키텍처 확인
x86_64와 deb에서 흔히 쓰는amd64는 같은 아키텍처 계열이며,aarch64와arm64도 마찬가지입니다. Debian이나 Ubuntu에서는dpkg --print-architecture를 실행해 패키지 관리자가 사용하는 아키텍처 이름을 확인할 수도 있습니다. 일치하는 빌드가 없으면 파일 확장자를 바꾸거나 강제로 설치하지 마세요.파일 다운로드
클라이언트 다운로드 페이지를 열고 Linux 섹션에서 지원되는 형식과 아키텍처를 선택하세요. 다운로드가 끝나면 파일 관리자에서 브라우저의 실제 저장 위치를 열고 전체 파일명을 확인하세요. 특히 확장자와 브라우저가 파일명 뒤에 덧붙일 수 있는 중복 번호를 구분해야 합니다.
디렉터리로 이동
파일 관리자에서 현재 디렉터리의 터미널 열기 기능을 사용하거나(데스크톱 환경에서 제공하는 경우), 터미널에서
cd로 실제 저장 디렉터리로 이동하세요.pwd와ls -l을 실행해 위치와 파일을 확인합니다. 아래에서는 예시 파일명으로local.deb,local.rpm,local.AppImage를 사용합니다. 실행할 때는 다운로드한 파일의 전체 이름으로 바꾸고, 파일명에 공백이 있으면 따옴표를 유지하세요.
Debian·Ubuntu: apt로 deb 설치
패키지 파일이 있는 디렉터리에서 아래 명령을 실행하세요. ./는 소프트웨어 저장소에서 같은 이름의 패키지를 검색하는 대신 현재 디렉터리의 파일을 처리하도록 apt에 지정합니다. apt는 로컬 패키지의 의존성을 확인하고 설정된 저장소에서 누락된 항목을 가져오려고 합니다.
dpkg-deb -f "./local.deb" Package Architecture Depends
sudo apt install "./local.deb"
첫 번째 명령은 패키지 정보를 조회하므로 패키지 이름, 아키텍처, 의존성을 확인할 수 있습니다. 두 번째 명령은 실제 설치를 진행합니다. 확인을 누르기 전에 터미널에 표시된 추가·업그레이드·제거 항목을 살펴보세요. 관련 없는 패키지가 대량으로 제거될 예정이라면 작업을 취소하고 배포판 호환성과 저장소 설정을 다시 확인하세요.
- 의존성을 찾을 수 없음: 저장소 설정이 올바르다면 먼저
sudo apt update를 실행해 인덱스를 갱신한 다음 다시 설치해 보세요. 갱신에 성공했는데도 특정 의존성의 설치 후보 버전이 없다고 나오면, 오류에 표시된 패키지 이름과 버전 조건을 기록하고 현재 배포판이 요구 사항을 충족하는지 확인하세요. - 아키텍처가 일치하지 않는다는 메시지:
dpkg-deb출력의Architecture값을dpkg --print-architecture결과와 비교하세요. 아키텍처가 맞는 파일을 다시 받아 해결하세요. 데스크톱 앱 하나를 설치하려고 시스템 아키텍처 설정을 변경하지 마세요.
Fedora: dnf로 rpm 설치
Fedora에서는 dnf로 로컬 rpm 패키지를 설치합니다. 설치 트랜잭션을 분석하고 활성화된 저장소에서 필요한 의존성을 가져옵니다. 아래의 rpm -qp는 파일의 메타데이터만 조회하며 시스템에 소프트웨어를 설치하지 않습니다.
rpm -qp --queryformat '%{NAME} %{ARCH}\n' "./local.rpm"
sudo dnf install "./local.rpm"
두 형식의 기본 패키지는 각각 해당 패키지 관리자가 관리합니다. 설치 여부를 확인하거나 제거하려면 다운로드 파일명이 아니라 앞서 조회한 패키지 이름을 사용하세요.
deb 설치 정보
- 패키지 정보
dpkg-deb -f "./local.deb" Package Architecture- 설치 상태 확인
dpkg-query -s 실제 패키지명- 제거 명령
sudo apt remove 실제 패키지명
명령의 ‘실제 패키지명’을 Package 필드의 값으로 바꾸세요.
rpm 설치 정보
- 패키지 정보
rpm -qpi "./local.rpm"- 설치 상태 확인
rpm -q 실제 패키지명- 제거 명령
sudo dnf remove 실제 패키지명
명령의 ‘실제 패키지명’을 rpm -qp로 조회한 NAME 값으로 바꾸세요.
dnf에서 의존성을 충족할 수 없다고 나오면 먼저 오류를 읽고 누락된 패키지나 라이브러리가 무엇인지 확인하세요. 그런 다음 dnf repolist --enabled로 저장소가 활성화되어 있는지 확인합니다. 충돌 메시지가 표시되더라도 의존성 검사를 강제로 무시해 설치하지 마세요. 설치 작업이 완료되지 않은 경우와 설치는 성공했지만 앱이 열리지 않는 경우는 서로 다른 문제입니다.
AppImage: 실행 권한을 부여한 뒤 실행
사용할 수 있는 deb나 rpm이 없으면 아키텍처와 실행 조건이 맞는지 확인한 뒤 AppImage를 사용해 볼 수 있습니다. 현재 사용자가 쓰기 권한을 가진 실행 가능한 위치에 파일을 두고, 고정된 디렉터리에서 관리하는 것이 좋습니다. 아래에서는 u+x를 사용해 파일 소유자에게만 실행 권한을 부여합니다. 이는 chmod +x의 권한 범위를 제한한 방식입니다. 두 명령은 일반 데스크톱 사용자 계정으로 실행하세요.
chmod u+x "./local.AppImage"
"./local.AppImage"
AppImage는 터미널에서 바로 실행할 수 있습니다. 실행 권한을 설정해도 시스템 패키지로 등록되지 않으며, 앱 메뉴에 자동으로 표시되지 않을 수도 있습니다. 아래에서는 Shadowrocket의 두 가지 배포 방식을 비교합니다. 권장 방식은 다운로드 페이지에 지원되는 기본 패키지가 있는 경우를 전제로 합니다.
패키지 관리자로 관리
권장apt 또는 dnf로 설치하면 나중에 패키지 이름으로 상태를 확인하거나 제거할 수 있습니다. 로컬에서 설치한 패키지에 해당 저장소의 업데이트가 제공되지 않으면 새 버전 파일을 다운로드해 같은 패키지 관리자로 다시 설치해야 합니다.
적합한 경우: 지원되는 deb 또는 rpm이 있고 시스템 도구로 설치 기록을 관리하려는 경우
사용자 계정으로 독립 실행
파일이 있는 위치에서 AppImage를 바로 실행합니다. 파일을 교체하기 전에는 실행 중인 앱을 종료한 다음 새 파일에 실행 권한을 부여하세요. 직접 실행 바로가기를 만들었다면 새 파일이 있는 위치를 가리키도록 수정해야 합니다.
적합한 경우: 지원되는 기본 패키지가 없고 실행 파일을 사용자 디렉터리에 보관하려는 경우
설치 후 실행되지 않을 때: 오류에 따라 해결
먼저 문제가 발생한 단계를 구분하세요. 패키지 관리자에서 설치가 완료되지 않았다면 설치 작업 중 처음 발생한 구체적인 오류부터 해결합니다. 설치 상태는 정상인데 창이 나타나지 않는다면 현재 데스크톱 세션에서 실행 문제를 재현해 보세요. AppImage는 터미널에서 바로 실행할 수 있어 더블 클릭으로는 확인하기 어려운 오류를 읽을 수 있습니다.
chmod를 실행했는데도 Permission denied가 표시되는 이유는 무엇인가요?
먼저 ls -l "./local.AppImage"로 파일 소유자의 권한에 x가 있는지 확인한 다음, findmnt -T "./local.AppImage" -o TARGET,OPTIONS로 마운트 옵션을 살펴보세요. noexec가 표시되면 파일 권한을 바꿔도 해당 위치에서 실행할 수 없습니다. 시스템 마운트 설정을 변경할 필요 없이 파일을 실행이 허용된 사용자 디렉터리로 옮겨 다시 시도하세요.
터미널에 libfuse.so.2를 찾을 수 없다고 표시됩니다. 어떻게 해야 하나요?
현재 AppImage 런타임에서 FUSE 2 호환 라이브러리를 찾지 못했다는 뜻입니다. 먼저 배포판 저장소에서 libfuse2, libfuse2t64 또는 이에 해당하는 패키지를 확인한 뒤, 해당 배포판의 패키지 이름에 맞춰 호환 라이브러리를 설치하세요. 시스템에 이미 설치된 FUSE 3 구성 요소는 삭제하지 마세요. 시스템 정책상 필요한 FUSE 기능을 사용할 수 없다면 호환되는 기본 패키지가 있는지 먼저 확인하세요.
Exec format error가 표시됩니다. 권한 문제인가요?
대개 chmod를 반복하기보다 파일 형식과 아키텍처를 먼저 확인해야 합니다. file 명령을 사용할 수 있다면 file "./local.AppImage"를 실행하고 uname -m 결과와 비교하세요. 다른 CPU 아키텍처로 확인되면 다운로드 페이지에서 다시 선택하세요. HTML 문서로 인식되면 실행 패키지가 아닌 파일이 저장된 것이므로 다시 다운로드해야 합니다.
패키지를 설치했는데 앱 메뉴에 표시되지 않는 이유는 무엇인가요?
먼저 로그인한 데스크톱 세션에서 Shadowrocket을 검색하세요. 그래도 찾을 수 없다면 dpkg-query -L 실제 패키지명 또는 rpm -ql 실제 패키지명으로 패키지에 .desktop 실행 항목이 포함되어 있는지 확인합니다. 실행 환경이 원격 터미널뿐이거나 데스크톱 세션이 없다면 설치가 정상적으로 기록되어도 그래픽 창이 표시된다는 뜻은 아닙니다. AppImage가 메뉴에 나타나지 않으면 이전 절의 터미널 명령으로 실행하세요.