Linux 설치 및 패키지 형식

1. 배포판과 아키텍처 확인

Shadowrocket Linux 패키지는 데스크톱 화면이 아니라 현재 시스템에 맞춰 선택해야 합니다. GNOME, KDE 같은 데스크톱 환경으로 deb와 rpm 중 어느 것을 쓸지 결정할 수는 없습니다. Ubuntu와 Fedora는 비슷한 데스크톱을 사용하더라도 패키지 관리 방식이 다릅니다. 터미널에서 아래 두 가지 읽기 전용 명령어를 실행해 배포판 정보와 시스템 아키텍처를 확인하세요.

cat /etc/os-release
uname -m

첫 번째 명령어의 출력에서 ID와 ID_LIKE를 확인하고, 배포판의 패키지 관리 안내도 참고하세요. 두 번째 명령어의 결과는 보통 x86_64 또는 aarch64입니다. 전자는 대개 다운로드 안내의 x64, 후자는 ARM64에 해당합니다. 패키지 형식과 아키텍처는 별개의 조건이므로 확장자가 같아도 CPU와 호환된다는 뜻은 아닙니다. 다운로드 페이지에 맞는 아키텍처가 없다면 다른 아키텍처용 패키지를 억지로 설치하지 마세요.

2. 설치 패키지 다운로드 및 준비

클라이언트 다운로드 페이지의 Linux 섹션에서 설치 패키지를 받고, 형식과 아키텍처를 확인한 뒤 저장하세요. 이 글에서는 제삼자 다운로드 주소를 사용하거나 터미널에서 원격 설치 스크립트를 내려받지 않습니다. 브라우저 다운로드가 완료되지 않았거나 파일 크기가 0이거나 임시 확장자가 남아 있다면 다운로드가 끝날 때까지 기다리세요.

1. 사용자 홈 디렉터리에 shadowrocket-install 폴더를 만드세요.
2. 이번에 선택한 설치 패키지 하나만 해당 폴더에 넣어 다른 프로그램이나 오래된 패키지가 섞이지 않도록 하세요.
3. 아래 명령어를 복사해 사용하기 쉽도록 deb 파일 이름을 shadowrocket-local.deb로, rpm 파일 이름을 shadowrocket-local.rpm로 바꾸세요. AppImage 저장 방법은 5절을 참고하세요.
4. 파일 이름만 바꾸고 확장자를 바꿔 형식을 변환하지 마세요. 이름을 바꿔도 파일 내부의 아키텍처와 의존성 요건은 달라지지 않습니다.

mkdir -p "$HOME/shadowrocket-install"
cd "$HOME/shadowrocket-install"
ls -lh

위 파일명은 사용자가 로컬에서 작업하기 편하도록 정한 이름이며, 이 사이트 설치 패키지의 원래 파일명이 아닙니다. 다운로드 당시 이름을 그대로 사용하려면 이후 명령어에서 파일 경로 전체를 실제 이름으로 바꾸세요. 경로에 공백이 있으면 영문 큰따옴표로 감싸세요. deb와 rpm 설치 절차를 모두 실행하지 마세요.

3. deb: apt로 로컬 파일 설치

Debian, Ubuntu 등 apt를 사용하는 시스템에서는 먼저 앞서 만든 폴더로 이동한 다음 로컬 deb 파일을 설치하세요. 명령어의 ./는 인수가 저장소의 패키지명이 아니라 현재 폴더에 있는 파일임을 나타냅니다. 설치에는 관리자 권한이 필요합니다. 의존성 패키지는 일반적으로 시스템에 설정된 저장소에서 가져오므로, 내려받을 의존성이 있다면 네트워크에 연결할 수 있어야 합니다.

cd "$HOME/shadowrocket-install"
sudo apt install ./shadowrocket-local.deb

1. apt가 표시하는 새로 설치·업그레이드·삭제 항목을 확인하세요. 이번 작업과 관련 없어 보이는 항목이 대량으로 삭제된다고 표시되면 먼저 취소하고, 그대로 진행하지 마세요.
2. 트랜잭션을 확인한 뒤 작업이 끝날 때까지 기다리세요. 터미널에 명령 프롬프트가 다시 표시되고 설치 오류가 없다면 데스크톱 앱 목록에서 Shadowrocket을 찾으세요.
3. 파일을 찾을 수 없다는 메시지가 나오면 pwd와 ls -lh를 실행해 디렉터리와 파일명을 먼저 확인하세요. 설치 명령어를 곧바로 바꾸지 마세요.
4. 아키텍처가 맞지 않는다는 메시지가 나오면 다운로드 페이지에서 아키텍처를 다시 확인하세요. 의존성을 충족할 수 없다는 메시지가 나오면 시스템 지원 범위, 저장소 설정, 의존성 이름을 확인하세요.

sudo apt update는 패키지 저장소 색인만 새로 고칩니다. 시스템 전체를 업그레이드하거나 Shadowrocket을 직접 설치하는 명령어가 아닙니다. 오류가 오래된 색인과 관련된 경우 먼저 이 명령어를 실행한 뒤 로컬 설치를 다시 시도할 수 있습니다. 시스템 버전에서 필요한 의존성을 제공하지 않는다면 색인을 반복해서 새로 고쳐도 실행 환경의 비호환성은 해결되지 않습니다.

4. rpm: dnf로 설치 트랜잭션 확인 및 실행

Fedora 등 dnf를 사용하는 시스템에서 로컬 파일을 설치하는 방식은 apt와 비슷하지만, 인수로 rpm 파일을 지정해야 합니다. dnf는 패키지 메타데이터를 바탕으로 아키텍처와 의존성을 확인하고 실행 예정인 트랜잭션을 표시합니다. 프로그램 파일을 업데이트하는 동안 이전 프로세스가 기존 파일을 사용하지 않도록 설치 전에 실행 중인 Shadowrocket을 종료하세요.

cd "$HOME/shadowrocket-install"
sudo dnf install ./shadowrocket-local.rpm

• 파일이 없다는 메시지가 표시되는 경우: 현재 디렉터리와 파일 확장자를 확인하고, deb 파일의 이름을 rpm으로 바꾸지는 않았는지 살펴보세요.
• 의존성 제공자를 찾을 수 없다는 메시지가 표시되는 경우: 누락된 항목을 기록하고 배포판 호환성과 저장소 상태를 확인하세요. 이름이 같은 시스템 라이브러리를 임의로 내려받아 기존 파일을 덮어쓰지 마세요.
• 패키지 충돌 메시지가 표시되는 경우: 다른 패키지 형식이나 이전 버전을 설치했는지 먼저 확인하세요. 시스템 패키지 관리자로 설치 항목을 살펴보고 시스템 디렉터리의 앱 파일을 직접 삭제하지 마세요.
• 트랜잭션이 취소된 경우: 취소 직전 메시지를 다시 읽고 사용자가 거부했는지, 권한 문제인지, 의존성 검사 실패인지 확인한 뒤 다음 단계를 결정하세요.

설치가 끝나면 데스크톱 앱 목록에서 프로그램을 여세요. 바로 앱 아이콘이 보이지 않는다면 앱 목록을 새로 고치거나 데스크톱 세션에 다시 로그인하세요. 아이콘이 보이지 않는다는 이유만으로 설치 실패라고 단정하지 마세요. 터미널에서 트랜잭션 실패가 명확히 보고되었다면 데스크톱 아이콘을 반복해서 누르지 말고 설치 오류부터 해결하세요.

5. AppImage: 실행 권한 설정 후 터미널에서 실행

AppImage는 보통 단일 파일로 저장해 실행하며, deb나 rpm처럼 같은 방식으로 시스템 설치 트랜잭션에 등록되지는 않습니다. 그렇다고 모든 Linux 환경에서 실행되는 것은 아닙니다. CPU 아키텍처, 기본 런타임 라이브러리, 그래픽 세션, 일부 빌드에 필요한 FUSE 메커니즘이 실행에 영향을 줄 수 있습니다. 이 형식을 선택하기 전에 다운로드 페이지의 안내를 확인하세요.

홈 디렉터리에 Applications 폴더를 만들고 다운로드가 끝난 AppImage를 그 안으로 옮긴 다음, 파일 관리자에서 이름을 Shadowrocket.AppImage로 바꾸세요. 이어서 아래 명령어를 실행하세요. chmod u+x는 파일 소유자에게 실행 권한을 추가할 뿐이며, 누구나 파일을 쓸 수 있게 설정할 필요는 없습니다.

mkdir -p "$HOME/Applications"
cd "$HOME/Applications"
chmod u+x ./Shadowrocket.AppImage
./Shadowrocket.AppImage

Permission denied가 표시되면 실행 권한뿐 아니라 파일이 저장된 파티션이 noexec로 마운트되었는지도 확인하세요. FUSE 관련 오류가 발생하면 현재 배포판의 문서에서 필요한 런타임 구성요소를 확인하세요. 배포판마다 구성요소 이름이 같다고 가정하면 안 됩니다. AppImage가 앱 메뉴에 자동으로 표시되지 않는다고 해서 파일이 손상된 것은 아닙니다.

6. 처음 실행: 설치와 연결을 따로 확인

메인 창이 열린다는 것은 프로그램의 시작 단계가 통과되었다는 뜻일 뿐입니다. 다음으로 사용자가 이미 보유한 서버나 구독을 설정해야 합니다. 이 사이트는 노드나 구독을 제공·판매·추천하지 않습니다. 첫 연결을 확인할 때는 현재 네트워크 연결을 유지하고 Home에서 가져온 설정을 살펴보세요. 주소, 포트, 인증 정보가 빠짐없이 입력되었는지 확인한 뒤 연결하세요. 테스트를 통과시키려고 포트 번호를 임의로 입력하지 마세요.

1. Home에서 사용자가 이미 보유한 설정을 가져오세요. 구독은 업데이트할 수 있는 설정 소스의 모음이며 설치 패키지에 포함되지 않습니다.
2. 현재 선택된 항목이 사용하려는 서버인지 확인해 만료된 항목을 잘못 선택하지 않도록 하세요.
3. Global Routing의 현재 모드를 확인한 다음 명확한 접근 테스트를 한 번 진행하세요. 모드를 바꾸기 전에 기존 설정을 기억해 두고 테스트 후 원래대로 되돌리세요.
4. 창은 정상적으로 열리지만 연결에 실패한다면 인증, 연결 시간 초과, 도메인 이름 확인, 규칙 일치 정보를 각각 살펴보세요. 이 단계에서는 설정부터 점검하고 바로 삭제 후 재설치하지 마세요.

7. 업데이트, 제거 및 자주 발생하는 오류

업데이트 전에 앱의 내보내기 기능으로 개인 설정을 백업하고 구독 인증 정보를 안전하게 보관하세요. deb·rpm의 패키지 관리자 등록 방식과 AppImage 파일 교체 방식은 서로 다릅니다. 이 사이트에서 새 패키지를 받더라도 시스템이 현재 실행 중인 프로세스를 자동으로 전환해 주지는 않습니다. 업데이트 후에는 이전 프로세스를 종료하고 프로그램을 다시 열어 설정이 유지되었는지 확인하세요.

• deb 업데이트: 아키텍처에 맞는 새 패키지를 다운로드한 뒤에도 로컬 apt install 방식으로 설치하세요. 패키지 관리자가 패키지 정보를 바탕으로 업그레이드 여부를 판단합니다.
• rpm 업데이트: 로컬 dnf install을 사용할 때 트랜잭션에서 의도한 업데이트로 인식했는지 확인하세요. 다운그레이드나 충돌 경고를 무시하지 마세요.
• AppImage 업데이트: 앱을 종료한 뒤 기존 파일을 새 파일로 바꾸고 실행 권한을 다시 확인하세요. 새로 다운로드한 파일에는 이전 파일의 실행 권한이 그대로 적용되지 않을 수 있습니다.
• 제거: deb·rpm은 시스템 소프트웨어 관리자로 정확한 패키지명을 확인한 뒤 제거하세요. AppImage는 종료한 다음 파일과 직접 만든 바로 가기를 삭제하면 됩니다. 개인 설정을 보존할지는 별도로 확인하세요. 프로그램을 제거해도 모든 사용자 데이터가 삭제되는 것은 아닙니다.