Debian과 Ubuntu에서는 deb를, dnf를 사용하는 Fedora에서는 rpm을 우선 선택하세요. 프로그램을 사용자 디렉터리에 보관하고 파일을 직접 실행하려면 아키텍처와 실행 환경의 호환성을 확인한 뒤 AppImage를 선택할 수 있습니다. 다음 절차는 처음 설치하거나 패키지 형식을 바꾸는 경우에 적용되며, 다운로드 전 확인 사항과 설치 명령어, 첫 실행 오류를 다룹니다.
배포판과 프로세서 아키텍처에 맞는 형식 선택
패키지 형식과 프로세서 아키텍처는 서로 별개의 조건입니다. Ubuntu와 Fedora는 같은 프로세서를 사용하더라도 보통 각각 deb와 rpm을 사용합니다. 반대로 파일 두 개의 확장자가 모두 .deb여도 대상 아키텍처가 다를 수 있습니다. 먼저 시스템을 확인한 다음 다운로드 페이지에 표시된 내용을 기준으로 파일을 선택하세요. 확장자를 바꿔 한 패키지를 다른 형식으로 변환하면 안 됩니다.
cat /etc/os-release
uname -m
첫 번째 명령어로 배포판을 확인합니다. 특히 ID를 확인하고, 파생 배포판이라면 ID_LIKE도 참고하세요. 두 번째 명령어는 현재 커널 아키텍처를 확인합니다. 일반적으로 x86_64는 다운로드 페이지의 x86-64 표시에 해당하며 deb 패키지에서는 보통 amd64라고 부릅니다. aarch64는 64비트 ARM에 해당하며 deb 패키지에서는 보통 arm64라고 합니다. 시스템의 사용자 공간 아키텍처가 커널과 다르면 패키지 관리자가 처리할 수 있는 아키텍처를 기준으로 하세요. Debian이나 Ubuntu에서는 dpkg --print-architecture로 확인할 수 있습니다. 이름이 대응된다고 해서 모든 형식에 모든 아키텍처용 빌드가 제공되는 것은 아닙니다.
패키지 관리자를 이용한 설치
권장배포판에 맞는 deb 또는 rpm을 사용하세요. apt나 dnf는 설치된 패키지를 기록하고, 활성화된 소프트웨어 저장소에서 의존성을 확인합니다. 로컬 파일을 설치했다고 해서 업데이트 저장소가 추가되는 것은 아닙니다.
적합한 경우: 배포판에 맞는 패키지가 있고, 시스템 패키지 관리자로 Shadowrocket을 확인하거나 제거하려는 경우.
AppImage 파일 실행
파일을 사용자 디렉터리에 저장하고 실행 권한을 추가한 뒤 바로 실행합니다. apt나 dnf에 먼저 등록할 필요는 없습니다. 단, 해당 파일의 아키텍처와 실행 환경 요구 사항을 충족해야 합니다.
적합한 경우: 프로그램 파일을 직접 관리하고 싶거나, 시스템에 적합한 deb·rpm은 없지만 해당 AppImage를 실행할 수 있는 경우.
다운로드한 파일의 위치와 이름 확인
다운로드 페이지 열기
다운로드 페이지의 Linux 섹션으로 이동해 앞서 확인한 패키지 형식과 아키텍처에 맞는 파일을 선택하세요. 설치 방법은 하나만 선택하면 됩니다. 세 가지 형식을 모두 다운로드해도 의존성이 추가로 해결되지는 않습니다.
다운로드한 파일 찾기
브라우저의 다운로드 기록에서 방금 받은 파일을 찾아 저장된 폴더를 열고 다운로드가 완료됐는지 확인하세요. 임시 다운로드 파일을 설치 패키지로 착각하지 않도록 주의하고, 파일이 반드시
Downloads라는 이름의 디렉터리에 저장된다고 가정하지 마세요.파일이 있는 디렉터리 열기
터미널에서
cd로 파일이 있는 디렉터리로 이동하세요. 경로에 공백이 있으면 큰따옴표로 묶습니다.pwd로 현재 디렉터리를 확인한 다음ls -l로 파일 이름을 확인하세요. 이후 명령어는 모두 이 디렉터리에서 실행합니다.명령어 인수 확인
명령어에 나오는
Shadowrocket.deb,Shadowrocket.rpm,Shadowrocket.AppImage는 예시 파일 이름입니다. 실행할 때는 실제 파일 이름을 사용하고 앞의./를 그대로 두세요. Linux에서는 파일 이름의 대소문자를 구분합니다. 파일 이름에 공백이 있으면./파일 이름전체를 큰따옴표로 묶으세요.
apt로 deb 설치, dnf로 rpm 설치
아래 두 명령어 중 다운로드한 형식에 맞는 하나만 실행하세요. ./는 패키지 관리자에 소프트웨어 저장소에서 이름으로 패키지를 찾는 대신 현재 디렉터리의 로컬 파일을 사용하라고 지정합니다. 명령어가 설치·업그레이드·제거할 패키지 목록을 표시합니다. 목록을 확인한 다음 진행하세요. 특히 예상하지 못한 제거 항목이 있는지 살펴보세요.
deb 설치
- 대상 시스템
- Debian, Ubuntu 등 apt를 사용하는 배포판
- 설치 명령어
sudo apt install "./Shadowrocket.deb"- 아키텍처 확인
dpkg --print-architecture- 패키지 이름 확인
dpkg-deb -f "./Shadowrocket.deb" Package
의존성이 없다는 메시지가 표시되면 오류에 나온 패키지 이름과 버전 요구 사항을 확인한 다음 현재 배포판의 소프트웨어 저장소를 점검하세요.
rpm 설치
- 대상 시스템
- Fedora 등 dnf를 사용하는 배포판
- 설치 명령어
sudo dnf install "./Shadowrocket.rpm"- 패키지 아키텍처 확인
rpm -qp --qf '%{ARCH}\n' "./Shadowrocket.rpm"- 패키지 이름 확인
rpm -qp --qf '%{NAME}\n' "./Shadowrocket.rpm"
rpm은 패키지 형식입니다. rpm을 사용하는 모든 배포판이 dnf를 사용하는 것은 아니며, 서로 다른 배포판의 패키지를 서로 바꿔 설치할 수 있다는 뜻도 아닙니다.
명령어가 완료되면 안내 카드의 조회 명령어로 패키지 내부 이름을 확인할 수 있습니다. deb 사용자는 해당 패키지 이름과 함께 dpkg -s를 실행해 상태를 확인하세요. Status: install ok installed가 표시되면 설치 완료로 등록된 것입니다. rpm 사용자는 해당 패키지 이름과 함께 rpm -q를 사용해 조회합니다. 조회할 때 다운로드 파일 이름을 내부 패키지 이름으로 착각하지 마세요. 설치 여부를 확인한 뒤 데스크톱 애플리케이션 메뉴에서 Shadowrocket을 검색하세요.
AppImage에 실행 권한을 추가하고 실행하기
AppImage를 계속 사용할 예정이라면 먼저 관리하기 편한 사용자 홈 디렉터리로 옮긴 다음 해당 디렉터리에서 아래 명령어를 실행하세요. 첫 번째 명령어는 파일 소유자에게만 실행 권한을 추가하고, 두 번째 명령어는 현재 사용자 권한으로 실행합니다. 두 명령어 모두 sudo가 필요하지 않습니다.
chmod u+x "./Shadowrocket.AppImage"
"./Shadowrocket.AppImage"
- 터미널 창 유지: 파일을 두 번 클릭해도 반응이 없다면 터미널에서 실행해 오류 출력을 확인하세요. 먼저 구체적인 오류 메시지를 살펴보고 권한, 아키텍처, 실행 환경 중 무엇이 문제인지 판단합니다.
- 파일 실행과 메뉴 등록 구분: AppImage를 직접 실행해도 데스크톱 애플리케이션 메뉴에 등록되지는 않습니다. 메뉴 검색 결과에 나오지 않더라도 파일이 있는 디렉터리로 돌아가 같은 실행 명령어를 사용할 수 있습니다.
- 프로그램과 설정 구분: AppImage를 교체할 때는 실행 중인 프로그램을 먼저 종료하세요. 새 파일을 다운로드하고 실행 권한을 추가한 뒤 실행해 정상 동작을 확인합니다. 이전 AppImage를 삭제해도 프로그램 파일만 제거되며 사용자 디렉터리에 저장된 앱 설정까지 지워지는 것은 아닙니다.
설치 및 실행 중 자주 발생하는 오류
파일을 다운로드했는데 왜 찾을 수 없나요?
먼저 pwd와 ls -l을 실행해 터미널이 브라우저에 표시된 다운로드 위치에 있는지 확인하세요. 같은 파일을 여러 번 다운로드하면 이름에 번호가 추가될 수 있으며 대소문자도 디스크에 저장된 이름과 일치해야 합니다. 터미널에 ./와 파일 이름의 앞부분을 입력한 뒤 Tab 키로 자동 완성하면 입력 실수를 줄일 수 있습니다.
apt 또는 dnf에서 의존성 설치에 실패하면 어떻게 하나요?
누락된 의존성 이름과 버전 요구 사항, 현재 배포판을 먼저 기록하세요. apt에서 인덱스가 오래됐거나 의존성을 찾을 수 없다고 표시되면 sudo apt update를 실행해 볼 수 있습니다. dnf에서는 dnf repolist로 활성화된 소프트웨어 저장소를 확인하세요. 인덱스를 업데이트한 뒤에도 필요한 버전이 없다면 다운로드 페이지로 돌아가 패키지와 시스템의 호환성을 확인하세요. 의존성 확인을 강제로 건너뛰지 마세요.
실행 권한을 추가했는데도 Permission denied가 표시되는 이유는 무엇인가요?
먼저 ls -l로 소유자 권한에 x가 있는지 확인한 뒤 findmnt -T . -o TARGET,OPTIONS로 현재 디렉터리가 있는 마운트 지점을 확인하세요. 옵션에 noexec가 포함되어 있으면 파일에 실행 권한을 추가해도 직접 실행할 수 없습니다. 파일을 실행이 허용된 사용자 디렉터리로 옮긴 다음 권한을 다시 확인하고 실행하세요.
AppImage에서 FUSE 또는 libfuse.so.2가 없다고 표시되면 어떻게 하나요?
오류 메시지가 libfuse.so.2를 명확히 가리키는지 먼저 확인하세요. 해당 라이브러리가 필요하다면 현재 배포판의 소프트웨어 저장소에서 호환 패키지를 찾아 설치하세요. FUSE 3만 설치되어 있다고 FUSE 2 라이브러리도 제공되는 것은 아닙니다. 환경에서 AppImage에 필요한 마운트 작업을 허용하지 않고 다운로드 페이지에 호환되는 deb 또는 rpm이 있다면 해당 패키지 관리자를 이용해 설치할 수 있습니다.