Shadowrocket 사용법

보유한 정보의 종류를 먼저 확인한 뒤 추가 방법을 선택합니다. 서버 목록을 갱신하는 전체 링크라면 보통 Subscribe로 가져옵니다. 프로토콜, 주소, 포트, 인증 매개변수가 명시된 정보라면 서버 항목을 직접 입력합니다. 구독 링크와 설정 파일 링크는 용도가 다르므로 링크 모양만 보고 서로 바꿔 사용하면 안 됩니다. 종류를 판단하기 어렵다면 해당 정보를 제공할 때 함께 받은 설명을 먼저 확인하세요.

Add Server에서 직접 입력

Shadowrocket의 Home을 열고 SERVER 영역에서 Add Server를 탭합니다. 화면이 열리면 Type을 선택한 뒤 Host, Port와 해당 인증 항목을 입력합니다. Type에 따라 표시되는 항목이 달라집니다. 예를 들어 화면에 보이는 Password와 Method는 현재 선택한 Type에 해당하며, 모든 프로토콜에서 같은 항목을 사용하는 것은 아닙니다. 보유한 정보에 맞춰 각 항목을 입력하고, 빈칸을 채우려고 불필요한 내용을 추가하지 마세요.

Host에는 서버 도메인이나 주소를, Port에는 서버에서 안내한 포트 번호를 입력합니다. 웹 주소의 경로, 전체 구독 링크, 불필요한 공백을 Host에 넣지 않도록 주의하세요. 비밀번호, 암호화 방식 및 기타 프로토콜 매개변수는 기존 정보와 일치해야 합니다. 추측해서 입력하지 마세요. 필수 항목이 누락됐다면 정보를 제공한 곳에 확인한 뒤 입력을 계속하세요.

입력이 끝나면 화면의 저장 기능을 사용하고 Home으로 돌아갑니다. SERVER에 새 항목이 표시되는지, 이름이 본인의 기록과 일치하는지 확인한 뒤 해당 항목을 선택합니다. 사용할 수 있는 QR 코드가 있다면 Add Server에서 Scan QR Code로 가져올 수 있습니다. 저장하기 전에 인식된 내용을 확인하세요. Import from Cloud JSON은 해당 형식의 정보를 위한 기능이며 모든 링크에 사용할 수 있는 일반 가져오기 기능은 아닙니다.

Subscribe에서 전체 링크 가져오기

구독 링크가 있다면 Home에서 Add Server로 이동해 Type을 Subscribe로 선택하고, 화면의 항목에 전체 구독 주소를 입력한 뒤 알아보기 쉬운 메모를 설정합니다. 복사할 때 쿼리 매개변수를 포함한 전체 주소를 복사하세요. 특히 물음표 뒤의 내용을 빠뜨리지 않도록 주의합니다. 링크에 접근 정보가 포함될 수 있으므로 기기에서만 확인하고, 전체 주소를 공개 스크린샷이나 채팅 기록에 올리지 마세요.

저장한 뒤 Home으로 돌아가 구독을 불러올 때까지 기다립니다. 필요한 경우 해당 구독의 업데이트 기능을 사용하세요. 목록에 구독 이름만 남은 것이 아니라 서버 항목이 생성됐는지 확인합니다. 서버 항목이 없다면 링크가 로그인 페이지나 안내 페이지, 일반 웹페이지가 아니라 앱에서 해석할 수 있는 구독 내용을 반환하는지 확인하세요. 구독이 저장됐다는 것은 입력 정보가 기록됐다는 뜻일 뿐, 가져오기와 해석까지 성공했다는 뜻은 아닙니다.

이 단계가 끝나면 적어도 하나의 서버 항목을 명확히 선택할 수 있어야 합니다. 확인을 위해 원본 정보는 보관하되, 문제 해결 대신 같은 구독을 반복해서 추가하지 마세요. 다음으로 Global Routing을 선택합니다. 요청을 어떻게 처리할지 정해야 이어지는 연결 테스트 결과를 판단할 수 있습니다.

Home으로 돌아가 Global Routing을 탭하고 현재 선택된 모드를 확인합니다. 세 가지 모드는 Config(구성)/Proxy(프록시)/Direct(직접 연결)입니다. 각 모드는 요청을 처리하는 방식을 정하며 서버 프로토콜의 다른 이름이 아닙니다. 모드를 바꿔도 서버 매개변수가 채워지거나 이미 만료된 구독이 자동으로 복구되지는 않습니다.

Config 사용 전 현재 파일 확인

규칙에 따라 트래픽을 분기하려면 Config로 이동해 현재 사용 중인 설정 파일과 내용을 확인합니다. 공식 화면에는 설정 파일 편집 페이지의 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 섹션과 Rule 아래의 Add Rule이 표시됩니다. 첫 연결을 위해 이 섹션을 전부 수정할 필요는 없습니다. 확인된 내용은 그대로 두고 연결 매개변수 문제와 복잡한 설정 문제를 섞지 마세요.

구독은 주로 서버 목록을 가져오거나 업데이트하는 데 사용하고, Config는 규칙과 관련 설정을 관리합니다. 두 가지를 같은 내용으로 보면 안 됩니다. 구독을 성공적으로 가져온 뒤에도 현재 설정이 예상한 내용인지 확인해야 합니다. 출처와 용도를 모르는 Config는 항목이 많다는 이유만으로 활성화하지 마세요. 명확한 필요가 없다면 HTTPS Decryption도 변경하지 마세요.

아래 예시는 규칙을 읽는 방법을 설명할 뿐, 현재 설정을 그대로 대체하라는 뜻은 아닙니다. 첫 줄은 example.com과 하위 도메인을 PROXY로 처리하고, 둘째 줄은 지정된 로컬 네트워크 대역을 DIRECT로 처리합니다. 마지막 줄은 앞선 규칙과 일치하지 않은 요청을 처리합니다. 규칙 순서와 최종 처리 방식은 실제 결과에 영향을 줍니다.

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

첫 연결을 확인할 때는 선택한 모드를 먼저 기록합니다. 기존 규칙을 적용하려면 Config를 선택하고 설정 파일을 확인합니다. 서버 연결 문제만 분리해 확인하려면 잠시 Proxy로 비교 테스트할 수 있습니다. 테스트가 끝나면 평소 사용할 모드로 되돌려 임시 설정이 계속 유지되지 않도록 합니다. 규칙 매칭에 대한 자세한 내용은 시스템 사용법에서 확인하세요.

서버 추가와 모드 선택을 마쳤다면 Home으로 돌아갑니다. SERVER에서 사용할 서버를 탭하고 선택 표시가 올바른 항목에 있는지 확인합니다. 구독 그룹과 그룹 안의 서버는 서로 다른 항목입니다. 그룹 제목이 보인다고 해서 실제 연결 대상까지 선택된 것은 아닙니다. 비슷한 이름의 항목이 여러 개라면 먼저 메모로 구분하세요.

Home 상단의 연결 스위치를 탭합니다. 처음 연결할 때 시스템에서 VPN 구성을 추가하라는 메시지가 표시될 수 있습니다. 이는 앱이 시스템 네트워크 확장 기능을 통해 해당 트래픽을 처리하도록 하기 위한 절차입니다. 메시지가 현재 작업으로 인해 표시된 것인지 확인한 뒤 시스템 안내에 따라 권한을 허용하거나 기기 인증을 완료합니다. 시스템 권한을 허용해도 서버 인증, DNS 또는 규칙이 올바르다는 뜻은 아닙니다.

권한을 허용한 뒤 Shadowrocket으로 돌아와 상단에 Not Connected가 계속 표시되는지, 스위치가 켜져 있는지 확인합니다. 연결되지 않은 상태라면 권한 허용 절차가 끝났는지, 서버가 선택됐는지 확인한 뒤 다시 연결합니다. 상태를 확인하지 않은 채 스위치를 연달아 탭하지 마세요. 연결을 시작하는 동작인지 중지하는 동작인지 구분하기 어려워집니다.

스위치 상태와 실제 사용 가능 여부 구분

스위치가 켜져 있으면 앱의 연결 절차가 작동 중이라는 뜻이지만, 서버나 도메인 확인, 규칙 처리 문제로 대상 웹페이지가 열리지 않을 수 있습니다. 시스템에 VPN 상태가 표시된다고 해서 특정 요청이 선택한 서버를 거쳤다고 단정할 수도 없습니다. 다음 단계에서 실제 요청을 보내고 결과를 모드, 테스트, 기록과 함께 확인해야 합니다.

연결 직후 꺼지거나 곧 Not Connected로 바뀌면 현재 선택한 항목, 모드, 오류 메시지를 기록한 다음 오류 지점 확인으로 이동합니다. iPad에서는 화면 배치에 따라 항목이 다른 위치에 표시될 수 있습니다. 스크린샷 속 위치만 찾지 말고 Home, SERVER, Global Routing을 기준으로 확인하세요.

이 단계가 끝나면 당분간 네트워크 환경을 그대로 유지합니다. Wi‑Fi를 바꾸고 DNS를 수정하고 서버까지 교체하는 일을 동시에 하지 마세요. 조건을 고정하면 다음 단계의 테스트 결과를 해석하기 쉽습니다. 여러 조건을 한꺼번에 바꾸면 웹페이지가 다시 열려도 무엇이 효과가 있었는지 알기 어렵습니다.

문제가 발생하면 현재 설정을 유지하고 현상을 기록한 뒤 입력 정보부터 가까운 항목을 확인합니다. 한 번에 한 항목만 변경하고, 수정 후 같은 테스트와 웹 요청을 반복합니다. 개선되지 않으면 원래 값으로 되돌린 다음 다음 항목을 확인하세요. 이렇게 하면 문제 해결 과정에서 새 문제가 생기는 일을 줄일 수 있습니다.

구독을 읽을 수 없음: 링크와 응답 내용 확인

기존 구독의 편집 정보를 열어 링크가 완전한지, 앞뒤에 공백이 있는지, 설명 문구까지 잘못 복사했는지 확인합니다. 기본 네트워크에서 구독 주소에 접속할 수 있는지 확인하고, 오류가 요청 시간 초과인지, 인증 실패인지, 내용 해석 실패인지 살펴봅니다. 각각 네트워크 경로, 접근 자격 정보, 내용 형식과 관련된 문제이므로 모두 단순히 다시 업데이트하면 해결된다고 볼 수 없습니다.

응답 내용이 서버 목록이 아니라면 원래 정보를 제공한 곳에 링크의 용도와 유효 여부를 확인합니다. 같은 항목을 반복해서 추가해 재시도하지 말고, 전체 구독 주소를 공개 도움말 게시판에 올리지 마세요. 수정한 뒤 해당 구독만 업데이트하고 Home으로 돌아와 실제 서버 항목이 생성됐는지 확인합니다.

연결 실패: 서버와 모드 확인

직접 입력한 항목은 Type, Host, Port를 먼저 확인하고 인증 정보와 프로토콜 추가 매개변수를 살펴봅니다. 기존 구독으로 생성된 항목은 업데이트가 필요한지 먼저 확인하고, 의미를 모르는 상태에서 여러 항목을 한꺼번에 수정하지 마세요. 이어서 Home에서 선택한 서버와 Global Routing이 이번 테스트에 사용할 모드로 설정돼 있는지 확인합니다.

연결 상태는 안정적인데 특정 웹페이지가 실패한다면 앞 절의 Proxy와 Config 비교 결과를 활용해 원인을 좁힙니다. 특정 도메인에서만 문제가 발생하면 해당 도메인의 DNS 확인과 규칙 매칭을 먼저 살펴봅니다. 대부분의 요청이 실패한다면 서버 연결이나 현재 네트워크를 확인합니다. 변경 전에 원래 값을 기록해 비교 기준을 남겨 두세요.

DNS, Test Method, On Demand를 각각 확인

DNS가 의심된다면 도메인 접속에서만 문제가 발생하는지 먼저 확인하고, 현재 설정의 DNS 항목과 사용 가능한 진단 결과를 살펴봅니다. 임의로 입력한 DNS 주소를 만능 해결책으로 여기지 마세요. 도메인 확인, 서버 연결, 규칙 처리는 서로 관련되지만 별개의 단계입니다. 오류 메시지를 바탕으로 하나씩 원인을 찾으세요. 설정에 대한 자세한 내용은 Shadowrocket 시스템 사용법에서 확인할 수 있습니다.

Settings에서 Test Method를 열어 Connectivity Test에 사용되는 방법을 확인한 뒤 결과를 해석합니다. Settings에는 On Demand도 표시됩니다. 조건에 따라 연결을 설정하는 기능입니다. 직접 연결을 끈 뒤 다시 자동으로 연결되거나 네트워크 전환 후 상태가 달라진다면 설정된 조건을 확인하세요. 처음 수동으로 테스트할 때는 On Demand의 현재 상태를 확인하고 여러 조건을 동시에 추가하지 마세요.

TCP와 UDP의 작동 방식도 다를 수 있습니다. 웹페이지가 열려도 UDP에 의존하는 앱의 요청까지 정상이라는 뜻은 아닙니다. 서버와 프로토콜 매개변수가 실제 사용 목적을 지원하는지 확인하고 관련 기록을 함께 살펴보세요. 웹 접속이 가능하다는 이유만으로 다른 전송 경로의 문제를 배제하지 마세요.

필요한 진단 정보만 보관

문제를 더 자세히 확인해야 한다면 Settings의 Diagnostics를 사용해 오류 메시지, 발생 당시 네트워크 종류, 선택한 모드, 재현 절차를 기록합니다. Wi‑Fi와 셀룰러 네트워크를 비교할 때는 네트워크만 바꾼 뒤 같은 요청을 반복합니다. 결과에 차이가 있다면 네트워크 환경과 관련된 단서로 활용하고, 모든 설정을 바로 초기화하지 마세요.

진단 정보를 공유하기 전에 비밀번호, 구독 주소의 접근 매개변수, 불필요한 개인 요청 기록을 삭제합니다. 도움을 요청할 때는 어느 단계에서 어떤 모드를 사용했고 어떤 오류가 발생했는지, 무엇을 비교해 봤는지 설명하면 됩니다. 전체 연결 정보를 공개할 필요는 없습니다. 문제가 해결되면 평소 설정으로 되돌리고 중복 테스트 항목을 삭제한 뒤 정상 요청이 가능한지 다시 확인합니다.