Linux 데스크톱을 사용하는 컴퓨터에서 먼저 배포판과 프로세서 아키텍처를 확인하세요. Debian과 Ubuntu에서는 시스템에 맞는 deb를, Fedora에서는 시스템에 맞는 rpm을 우선 선택합니다. 패키지 관리자로 등록하지 않으려면 시스템이 실행 조건을 충족하는 경우 AppImage를 사용할 수 있습니다. 아래에서 설치 또는 실행 방법과 의존성 오류, 실행 권한 문제, 연결 문제를 구분하는 방법을 설명합니다.
설치 패키지 선택: 배포판과 아키텍처 확인
Shadowrocket을 실행할 컴퓨터에서 터미널을 여세요. 가상 머신을 사용한다면 호스트가 아니라 가상 머신 안에서 명령을 실행해야 합니다. 첫 번째 명령은 시스템 이름과 배포판 식별 정보를 표시하고, 두 번째 명령은 현재 시스템이 보고하는 머신 아키텍처를 표시합니다.
grep -E '^(PRETTY_NAME|ID|ID_LIKE)=' /etc/os-release
uname -m
| 시스템 또는 사용 목적 | 우선 확인할 형식 | 설치 전 확인 사항 |
|---|---|---|
| Debian、Ubuntu | deb | 현재 배포판에 맞는 패키지인지, 필요한 의존성을 현재 저장소에서 받을 수 있는지 확인 |
| Fedora 등 DNF를 사용하는 배포판 | rpm | 현재 시스템에 맞는 패키지인지 확인하세요. 확장자가 같아도 서로 다른 배포판에서 함께 사용할 수 있는 것은 아닙니다. |
| 프로그램을 시스템 패키지 관리자에 등록하지 않으려는 경우 | AppImage | 패키지 아키텍처가 일치하고, 파일 위치에서 실행할 수 있으며, 시스템이 실행 조건을 충족하는지 확인 |
x86_64는 deb의 아키텍처 표기에서 보통 amd64로 표시되며, aarch64는 보통 arm64에 해당합니다. 이는 아키텍처 명칭 간의 대응 관계일 뿐, 다운로드 페이지에서 모든 아키텍처용 빌드를 제공한다는 뜻은 아닙니다. Linux 다운로드 섹션에 실제로 표시되어 있고 시스템에 맞는 패키지를 선택하세요. 다른 아키텍처의 패키지만 있다면 파일 이름을 바꾸거나 강제 설치하지 마세요. ID_LIKE는 배포판 계열을 알려주는 값이며 호환성 안내를 대신할 수 없습니다.
deb·rpm 설치 또는 AppImage 실행
아래 명령은 Bash를 기준으로 합니다. 먼저 파일 관리자에서 다운로드한 파일을 찾은 다음 해당 코드 블록을 실행하세요. 터미널에 입력하라는 메시지가 나타나면 /로 시작하는 전체 파일 경로를 붙여 넣으세요. 경로에 따옴표를 직접 추가할 필요는 없습니다. 세 가지 형식 중 하나만 선택하면 되며, 차례로 모두 실행할 필요는 없습니다.
설치 패키지 찾기
브라우저의 다운로드 목록을 열고 해당 항목에서 파일이 저장된 폴더를 여세요. 다운로드가 완료되었는지 확인하고 실제 설치 패키지와 임시 다운로드 파일을 구분하세요. 파일 관리자에서 제공하는 경로 복사 기능을 사용하면 확장자를 빠뜨리거나 아키텍처만 다른 동명 파일을 잘못 선택하는 일을 피할 수 있습니다.
APT로 deb 설치
apt install은 로컬 deb 파일 경로를 받아 설치하며, 설정된 저장소에서 의존성을 보완하려고 시도합니다. 트랜잭션 요약에서 추가·업그레이드·삭제 항목을 확인한 뒤 진행하세요. 설치 목적과 무관한 항목이 대량으로 삭제될 예정이라면 먼저 취소하세요.read -r -p 'deb 파일의 전체 경로를 입력하세요: ' pkg sudo apt install -- "$pkg"DNF로 rpm 설치
dnf install은 로컬 rpm 파일을 읽고 활성화된 저장소에서 의존성을 해결합니다. 자동 확인 옵션은 추가하지 말고, DNF가 실행하려는 트랜잭션을 먼저 확인하세요. 충돌이 발생하면 오류에 표시된 패키지 이름을 기록하고, 의존성 검사를 건너뛰는 방식으로 설치하지 마세요.read -r -p 'rpm 파일의 전체 경로를 입력하세요: ' pkg sudo dnf install -- "$pkg"AppImage 실행
본인이 소유하고 프로그램 실행이 허용된 디렉터리에 파일을 두세요. 일반 사용자 권한으로 실행 비트를 추가한 뒤 시작하면 됩니다. AppImage 파일 자체가 실행 파일입니다. 터미널에서 오류가 발생하면 출력을 보관하고
sudo로 다시 시도하지 마세요.read -r -p 'AppImage 파일의 전체 경로를 입력하세요: ' pkg chmod +x -- "$pkg" && "$pkg"창 열림 확인
deb 또는 rpm 설치가 완료되면 데스크톱 앱 목록에서 Shadowrocket을 검색하세요. AppImage는 저장한 위치에서 실행하며 메뉴 항목이 자동으로 추가되지 않을 수 있습니다. 창이 열리면 설치 또는 실행 단계가 완료된 것입니다. 노드와 구독은 이용 중인 서비스 제공업체에서 받으세요. 네트워크 테스트는 설정을 마친 뒤 진행하세요.
설치 후 실행·업데이트·삭제
설치 형식에 따라 프로그램 파일을 관리하는 주체가 달라집니다. 문제를 진단하기 전에 패키지 관리자로 설치한 프로그램인지, 별도로 저장한 AppImage인지 확인하세요. 두 방법을 모두 시도했다면 실행 중인 창을 먼저 닫고 명확한 실행 경로에서 다시 시작하세요. 그래야 이전 파일의 동작을 새 패키지의 문제로 오인하지 않습니다.
deb / rpm
- 설치 기록
- 시스템 패키지 관리자에 등록됨
- 패키지 이름 확인
- 로컬 파일은
dpkg-deb -f "$pkg" Package또는rpm -qp --queryformat '%{NAME}\n' "$pkg"로 확인하세요. - 업데이트 방법
- 로컬 패키지를 설치해도 업데이트 저장소가 설정되는 것은 아닙니다. 직접 업데이트할 때는 현재 시스템에 맞는 새 패키지를 사용하세요.
- 삭제 방법
sudo apt remove또는sudo dnf remove뒤에 확인한 패키지 이름을 입력하고, 트랜잭션을 확인한 후 실행하세요.
삭제할 때는 다운로드 파일 이름이 아니라 패키지 이름을 사용하세요. 다운로드 패키지를 지워도 설치된 프로그램은 제거되지 않습니다.
AppImage
- 실행 경로
- 실행 권한이 설정된 AppImage 파일
- 파일 위치
- 실행이 허용된 개인 디렉터리에 보관하고, 정리될 수 있는 임시 디렉터리에 장기간 두지 마세요.
- 업데이트 방법
- 기존 프로그램을 닫고 새 파일에 실행 권한을 부여하세요. 새 파일이 정상적으로 열리는지 확인한 뒤 기존 파일을 정리하세요.
- 삭제 방법
- 프로그램을 닫은 뒤 AppImage 파일을 삭제하세요. 바로 가기를 직접 만들었다면 이전 실행 항목도 삭제하세요.
실행 파일을 삭제해도 개인 설정은 삭제되지 않습니다. 패키지를 바꿔 문제를 진단할 때는 조건을 두 가지씩 바꾸지 않도록 설정을 먼저 보존하세요.
자주 발생하는 설치 오류: 터미널 메시지로 원인 찾기
APT에서 파일을 처리할 수 없다고 표시되면 무엇부터 확인해야 하나요?
입력한 값이 파일의 전체 경로인지, 브라우저의 다운로드 주소가 아닌지 먼저 확인하세요. 방금 입력한 경로를 pkg에 그대로 둔 상태에서 file -- "$pkg"로 파일 형식을 확인합니다. 결과가 HTML 문서라면 deb가 아니라 웹페이지 내용을 받은 것입니다. 다운로드 페이지로 돌아가 다시 받으세요. 확장자만 바꿔서는 해결되지 않습니다.
아키텍처 불일치 또는 Exec format error가 표시되면 어떻게 하나요?
uname -m을 다시 실행해 다운로드 항목의 아키텍처 표기를 확인하세요. deb는 dpkg-deb -f "$pkg" Architecture로 패키지 헤더를, rpm은 rpm -qp --queryformat '%{ARCH}\n' "$pkg"로 확인할 수 있습니다. 아키텍처를 잘못 선택했다면 올바른 패키지를 다시 받으세요. 아키텍처가 일치한다면 파일 형식과 다운로드 완료 여부를 확인하세요.
의존성이 없다고 나옵니다. 저장소를 바꿔야 하나요?
오류에서 처음 충족되지 않은 의존성 이름과 조건을 기록하고, 설치 패키지가 현재 배포판에 맞는지 확인하세요. Debian 또는 Ubuntu에서는 sudo apt update를 실행해 저장소 색인을 새로 고칠 수 있습니다. DNF에서는 dnf repolist --enabled로 활성화된 저장소를 확인하세요. 현재 배포판의 정상적인 저장소로 의존성을 해결할 수 없다면 다른 배포판의 저장소를 섞어 사용하지 마세요.
AppImage에 실행 권한을 줬는데도 Permission denied가 표시되는 이유는 무엇인가요?
ls -l -- "$pkg"로 현재 사용자가 파일을 실행할 수 있는지 확인한 다음, findmnt -no OPTIONS --target "$pkg"로 해당 파일 시스템의 마운트 옵션을 확인하세요. noexec가 표시되면 파일을 실행이 허용된 개인 디렉터리로 옮기고 경로를 갱신한 뒤 다시 시도하세요. 단일 앱 때문에 디스크 전체의 마운트 정책을 변경하지 마세요.
AppImage에서 libfuse.so.2가 없다고 표시됩니다. 시스템에 FUSE가 설치되어 있다면 어떻게 하나요?
이 오류는 FUSE 2 사용자 공간 라이브러리를 가리킵니다. FUSE 3이 설치되어 있어도 시스템에 libfuse.so.2가 있다는 뜻은 아닙니다. 현재 배포판의 저장소에서 해당 라이브러리를 제공하는 호환 패키지를 찾고, 설치 트랜잭션이 기존 시스템 구성 요소를 삭제하지 않는지 확인하세요. 호환 패키지가 없다면 다운로드 페이지에 표시된 패키지 중 현재 시스템에 맞는 deb 또는 rpm을 우선 사용하세요.
창은 열리지만 웹페이지에 연결되지 않음: 라우팅 문제와 설치 문제 구분
창이 정상적으로 열리면 네트워크를 확인하기 위해 재설치하지 마세요. 먼저 일반 네트워크 연결에서 동일한 테스트 웹페이지가 열리는지 확인한 다음, 현재 클라이언트의 Global Routing을 확인하세요. 아래 비교는 해당 옵션이 인터페이스에 표시되는 경우에 적용됩니다. 설정을 전환할 때는 테스트 웹페이지와 다른 설정을 그대로 유지하세요.
Config
권장현재 설정된 규칙에 따라 정책을 선택합니다. 테스트할 때는 프록시 규칙과 일치하는 것으로 확인된 주소 하나와 직접 연결될 것으로 예상되는 주소 하나를 선택하세요. 직접 연결 주소만 열리는 것으로는 프록시 경로가 작동하는지 판단할 수 없습니다.
적합한 경우: 설정을 마친 뒤 프록시 규칙과 직접 연결 규칙을 각각 확인할 때.
Direct
클라이언트가 처리하는 트래픽을 프록시 경로를 거치지 않고 직접 연결합니다. 같은 주소가 Direct에서는 열리고 Config에서는 실패한다면 설치 패키지 형식이 아니라 일치하는 규칙과 선택한 정책을 확인하세요. 테스트가 끝나면 원래 라우팅 옵션으로 되돌리세요.
적합한 경우: 같은 테스트 주소로 직접 연결 결과를 비교할 때.