공식 매뉴얼 · 사용 가이드

Shadowrocket 구독 가져오기 및 연결 가이드

iPhone / iPad 화면을 기준으로 항목 추가, 모드 선택, 연결 및 확인을 차례로 진행합니다. 기존 연결을 먼저 정상 작동시킨 다음 규칙과 자동 연결 조건을 점검합니다.

Add Server Global Routing Connectivity Test

가져오기 → 연결 경로 확인 → 결과 검증

단계 01

Add Server: 서버 추가 또는 구독 가져오기

보유한 정보가 단일 서버 매개변수인지, QR 코드인지, 업데이트 가능한 구독 주소인지 먼저 구분한 뒤 한 가지 방법을 선택합니다.

기존 구독 링크가 있는 경우: Subscribe 선택

Shadowrocket의 Home을 열고 SERVER 영역에서 Add Server를 찾아 추가 페이지로 이동합니다. Type을 열어 Subscribe를 선택한 다음 본인의 전체 구독 주소를 해당 주소 입력란에 붙여 넣습니다. 저장하기 전에 주소의 시작부터 끝까지 확인하고, 복사 과정에서 공백·줄바꿈·설명 문구가 포함되지 않았는지 특히 살펴봅니다. 구독 주소에는 인증 정보가 포함될 수 있습니다. 무작위 문자열처럼 보이는 부분도 수정하지 말고, 일반 웹페이지 주소를 구독 링크로 사용하지 마세요.

입력이 끝나면 오른쪽 위 저장 버튼을 누르고 Home으로 돌아가 구독 항목에서 제공하는 업데이트 동작을 실행합니다. 업데이트가 완료되면 SERVER 목록에 구독에서 가져온 서버 항목이 표시됩니다. 구독 이름은 그룹이나 업데이트 경로일 뿐, 사용할 서버가 이미 선택되었다는 뜻은 아닙니다. 펼쳐진 목록에서 구체적인 항목을 선택해야 합니다. 저장 후 목록이 비어 있다면 주소 전체가 입력되었는지, 현재 네트워크에서 구독을 가져올 수 있는지, 구독이 여전히 유효한지 먼저 확인하세요. 같은 주소를 바로 반복해서 추가하지 마세요.

단일 서버 정보가 있는 경우: Type에 맞춰 필드 입력

서버 주소, 포트 및 인증 정보가 있다면 Add Server에서 해당하는 Type을 선택합니다. 프로토콜마다 표시되는 필드가 다르므로 Host와 Port가 모두 있다고 해서 서로 같은 방식으로 입력하면 안 됩니다. 예를 들어 Shadowsocks 유형에서는 Host에 서버 주소, Port에 서버가 지정한 포트, Password와 Method에 서버와 동일한 값을 입력합니다. Host에 웹 경로를 덧붙이지 말고, 서버 표시 이름을 주소란에 입력하지 마세요. 다른 유형에 표시되는 인증 및 전송 필드도 본인이 보유한 정보에 따라 각각 입력합니다.

저장한 뒤 Home으로 돌아가 새 항목의 이름과 주소가 예상한 값인지 확인합니다. 표시 이름은 용도를 구분하기 위한 것으로, 이름을 바꿔도 연결 매개변수는 변경되지 않습니다. 서비스 제공업체가 여러 프로토콜 정보를 제공했다면 하나의 완전한 정보 세트를 선택해 입력하세요. 한 세트의 포트와 다른 세트의 인증 필드를 섞지 마세요. Type을 확신할 수 없다면 원래 구성 안내를 확인한 뒤 진행해 필드를 반복 입력하는 방식으로 오류를 덮지 않도록 합니다.

기존 QR 코드가 있는 경우: Scan QR Code 사용

Add Server 페이지에서 Scan QR Code를 사용할 수 있습니다. 처음 카메라를 호출할 때 시스템 안내에 따라 카메라 권한을 허용하고, 스캔 후에도 해석된 Type과 서버 필드를 확인한 다음 저장합니다. QR 코드는 본인의 구성 정보에서 가져와야 하며 일반 텍스트 링크처럼 인증 정보를 포함할 수 있습니다. Import from Cloud JSON은 구조화된 가져오기 경로이며, 임의의 구독 URL을 붙여 넣는 위치가 아닙니다. 한 가지 가져오기 방법을 마치면 다음 단계로 이동하면 됩니다. 같은 서버를 다시 스캔하거나 수동으로 입력할 필요는 없습니다.

다음 단계로 이동하기 전: Home의 SERVER에 구체적인 서버 항목이 있고, 사용할 항목을 구분할 수 있어야 합니다.

Shadowrocket 서버 추가 페이지. Type, Host, Port, Password, Method 및 QR 코드 가져오기 항목 표시
Add Server 공식 스크린샷. Type에 따라 필드가 달라지므로 본인의 서버 정보에 맞게 입력합니다.
단계 02

Global Routing: 트래픽 처리 모드 선택

서버는 사용할 수 있는 프록시 연결을 결정하고, Global Routing은 트래픽 처리 방식을 결정하므로 각각 확인해야 합니다.

가져오기가 끝나면 Home으로 돌아가 Global Routing을 엽니다. 처음 사용할 때는 자주 쓰는 세 가지 모드인 Config / Proxy / Direct를 구분합니다. 옵션 이름만 보고 연결 성공 여부를 판단하지 마세요. 모드를 선택하는 것은 처리 방식을 설정하는 단계일 뿐이며, 서버를 선택하고 연결 스위치를 켜야 합니다. 문제를 확인하는 동안 원래 모드를 기억해 두고, 테스트를 위해 임시 변경했다면 이후 복원하세요. 테스트용 설정을 장기 설정으로 사용하지 않도록 주의합니다.

Config: 선택한 구성 파일에 따라 처리

Config는 현재 구성 파일의 규칙을 기준으로 요청의 경로를 판단합니다. 하단의 Config 페이지로 이동해 필요한 구성 파일을 가져와 선택했는지 확인합니다. 파일이 목록에 저장되어 있는 것만으로 현재 구성에 적용되었다고 볼 수는 없습니다. 구성 파일을 열면 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 등의 섹션을 확인할 수 있습니다. 처음 사용할 때는 파일과 규칙의 출처가 본인의 용도에 맞는지 확인하는 것만으로 충분합니다. 연결을 위해 모든 고급 기능을 한꺼번에 켜지 마세요.

Rule의 규칙은 일반적으로 순서대로 일치 여부를 확인하므로, 더 구체적인 조건과 기본 처리 조건의 위치가 결과에 영향을 줍니다. PROXY, DIRECT, REJECT는 처리 경로이지 서버 이름이 아닙니다. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 해당 도메인 접미사와 일치하는 요청에 프록시 정책을 사용한다는 뜻이고, FINAL,DIRECT는 앞에서 일치하지 않은 요청을 DIRECT로 보냅니다. 여기의 도메인은 문법 설명용이며 본인의 구성에 추가할 필요가 없습니다. 기존 구성을 사용한다면 규칙을 그대로 둔 채 요청 기록에서 실제로 일치한 항목을 확인하세요.

Proxy와 Direct: 비교 확인에 사용

Proxy는 선택한 서버의 프록시 연결이 정상인지 확인하는 데 사용할 수 있어 서버 문제와 Config의 분기 문제를 구분하기 쉽습니다. Direct는 요청을 직접 연결하므로 현재 네트워크 자체가 작동하는지 비교할 때 적합합니다. Direct를 선택했다고 프록시 서버가 검증된 것은 아닙니다. 세 가지 모드의 결과를 혼동하지 마세요. Proxy에서 접속할 수 있어도 Config의 규칙 순서가 올바르다는 뜻은 아니며, Direct에서 웹페이지가 열려도 구독에 있는 서버를 사용할 수 있다는 의미는 아닙니다.

먼저 필요한 모드로 연결 테스트를 진행하세요. Config에서만 문제가 발생하면 전체 구성을 바로 삭제하지 말고 현재 파일, 관련 규칙 및 실제로 일치한 정책을 확인합니다. 프로토콜 필드의 의미와 선택 기준은 프로토콜 참고 자료에서 확인할 수 있습니다. 규칙에 관한 자세한 질문은 FAQ를 참고하세요. 이 페이지에서는 첫 연결에 필요한 작업 순서를 설명합니다.

다음 단계로 이동하기 전: 현재 Global Routing 선택 항목을 알고 있어야 합니다. Config를 사용하는 경우 현재 구성 파일도 확인합니다.

Shadowrocket 구성 파일 편집 페이지. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 및 Add Rule 표시
Config 공식 스크린샷. 여기에서 구성 내용을 확인하며, Global Routing 모드 메뉴는 Home에 있습니다.
단계 03

Home: 서버를 선택하고 연결 켜기

항목을 선택하고 상단 스위치를 켠 다음 시스템 권한과 연결 상태를 확인합니다.

Home으로 돌아가 SERVER 목록에서 사용할 서버를 선택하고, 구독 그룹만 펼쳐 둔 것이 아니라 구체적인 서버가 선택되었는지 확인합니다. 첫 테스트에서는 같은 서버를 유지하는 것이 좋습니다. 모드를 바꾸면서 항목까지 변경하면 이후 어떤 변경이 영향을 주었는지 판단하기 어렵습니다. 목록이 길다면 본인이 저장한 이름을 기준으로 항목을 구분하세요. 이름이 비슷하다고 매개변수도 같다고 단정하지 마세요.

Global Routing을 확인한 다음 Home 상단의 Not Connected 표시 근처에 있는 연결 스위치를 켭니다. 처음 연결할 때 시스템에서 VPN 구성을 추가하도록 허용할지 묻는 메시지가 표시될 수 있습니다. 이는 클라이언트가 기기의 네트워크 트래픽을 처리하는 데 필요한 시스템 권한입니다. 현재 작업으로 인해 표시된 요청인지 확인한 뒤 허용하고, 시스템 안내에 따라 기기 인증을 완료합니다. 권한을 거부하면 서버 항목이 목록에 있어도 연결을 계속할 수 없을 수 있습니다. 다시 시도하고 시스템의 VPN 구성 상태를 확인하세요.

Shadowrocket으로 돌아와 상단 상태가 Not Connected에서 바뀌었는지, 스위치가 켜진 상태를 유지하는지 확인합니다. 시스템 VPN 표시는 구성이 활성화되었음을 보여주는 보조 정보일 수 있지만, 대상 웹사이트에 접속할 수 있다는 증거는 아닙니다. 표시가 나타났다고 바로 스위치를 반복해서 껐다 켜지 말고, 상태가 안정되기 전에 서버를 계속 바꾸지 마세요. 스위치가 바로 꺼지거나 연결이 계속되지 않으면 현재 매개변수를 유지한 채 이 페이지의 실패 지점 점검으로 이동해 권한 문제와 서버 연결 문제를 구분합니다.

테스트 중에는 다른 VPN 연결이 시스템 네트워크 경로를 사용 중인지도 확인합니다. 필요한 경우 다른 연결을 먼저 끊고 Home으로 돌아가 다시 시도합니다. 이전에 On Demand를 켰다면 수동으로 연결을 끊은 뒤에도 조건에 따라 다시 연결될 수 있어 스위치가 반응하지 않는 것처럼 보일 수 있습니다. 문제를 점검하는 동안 기존 설정을 기록하고 관련 자동 연결 조건을 잠시 끈 뒤, 수동 연결 확인을 마치면 복원합니다.

연결에 성공하면 우선 구성 파일을 변경하지 마세요. 이어서 Connectivity Test와 실제 접속을 확인해 같은 서버와 같은 모드로 비교할 수 있는 결과를 만듭니다. 항목 저장, 항목 선택, 연결 켜기는 서로 다른 작업입니다. 한 단계라도 빠지면 “목록에는 서버가 있지만 실제로 사용하지 않는” 상태가 될 수 있습니다.

다음 단계로 이동하기 전: 서버 선택, 모드 선택 및 연결 상태를 모두 확인하고, 이번 테스트에 영향을 주는 다른 연결이 없어야 합니다.

Shadowrocket Home 페이지. Not Connected 스위치, Global Routing, Connectivity Test, SERVER 및 Add Server 표시
Home 공식 스크린샷에는 작업 메뉴가 표시되어 있습니다. 이미지 속 Not Connected는 스크린샷 상태이며 연결 성공 사례가 아닙니다.
단계 04

Connectivity Test: 연결 및 규칙 결과 확인

“테스트 응답”, “웹페이지 접속”, “정책이 예상대로 적용됨”을 각각 확인해 하나의 결과만으로 판단하지 않도록 합니다.

먼저 테스트한 다음 실제 요청 확인

Home에서 Connectivity Test를 누르고 이번 테스트가 끝날 때까지 기다립니다. 테스트 결과는 선택한 테스트 방법에 따른 연결 상태를 살펴보기 위한 것이며, 모든 앱·도메인·전송 방식이 정상이라는 뜻은 아닙니다. 두 번의 결과를 비교해야 한다면 Test Method와 네트워크 환경을 동일하게 유지합니다. 테스트 방법마다 결과의 의미가 다르므로 수치를 그대로 비교하는 것은 적절하지 않으며, 하나의 테스트 결과만으로 서버의 장기적인 상태를 판단해서는 안 됩니다.

그다음 브라우저를 열어 확인할 페이지에 접속하고, 필요한 경우 새로고침합니다. 이전에 열어 둔 페이지가 보이는 것만으로는 신뢰할 수 있는 근거가 되지 않습니다. 페이지 내용이 캐시에서 표시되었을 수 있기 때문입니다. 예상 경로가 DIRECT인 일반 요청과 PROXY인 요청을 각각 확인해 구성 목적에 맞는지 살펴볼 수 있습니다. 확인 대상은 실제로 접속해야 하는 콘텐츠를 선택하세요. 특정 대상에 일시적으로 접속할 수 없다면 다른 대상을 비교해 대상 사이트 자체의 문제인지 먼저 구분합니다.

Data에서 실제 정책 비교

클라이언트로 돌아와 Data에서 확인할 수 있는 요청 기록을 살펴봅니다. 방금 접속한 도메인을 찾아 기록에 표시된 규칙이나 정책 정보를 기준으로 요청이 PROXY, DIRECT, REJECT 중 어디로 처리되었는지 판단합니다. 예상한 기록이 보이지 않으면 앱이 계속 연결되어 있는지, 페이지에서 새 요청이 발생했는지, 확인 중인 기록 범위가 맞는지 먼저 확인합니다. 버전에 따라 표시 세부 사항이 다를 수 있으므로 현재 화면에 표시되는 필드를 기준으로 판단하세요. 특정 필드가 보이지 않는다는 이유만으로 네트워크 오류라고 단정하지 마세요.

요청이 실제로 DIRECT로 처리되었는데 PROXY를 예상했다면 Global Routing이 여전히 Config인지, 현재 규칙이 DIRECT와 일치한 이유가 무엇인지 먼저 확인합니다. 반대로 요청이 PROXY로 처리되었는데도 접속할 수 없다면 같은 도메인 규칙을 계속 추가하지 말고 선택한 서버, 관련 전송 매개변수 또는 대상에 접근할 수 있는지 확인합니다. 문제를 “예상한 정책과 일치하지 않음” 또는 “정책은 일치했지만 연결 실패”로 구분할 수 있으면 다음 점검 범위를 크게 줄일 수 있습니다.

이번에 사용한 네트워크, 서버 이름, Global Routing 및 구체적인 증상을 기록하면 충분합니다. 전체 구독 주소나 비밀번호를 공개할 필요는 없습니다. 테스트가 끝나면 임시로 선택한 Proxy 또는 Direct를 일상적으로 사용할 모드로 복원한 뒤 실제 접속을 다시 확인합니다. 이렇게 하면 연결뿐 아니라 최종 설정도 확인할 수 있어 테스트 후 일상적인 용도와 맞지 않는 모드가 그대로 남는 일을 방지합니다.

완료 기준: 연결 스위치가 켜진 상태를 유지하고, 실제 요청이 완료되며, 분기가 필요한 요청이 예상한 정책과 일치해야 합니다.

단계 05

Settings: 실패 지점별로 차례대로 점검

한 번에 하나의 변수만 변경하고 다시 테스트한 뒤 다음 단계로 진행합니다. 직접 확인할 수 있는 정보부터 점검하고 고급 설정은 나중에 살펴봅니다.

구독이 비어 있거나 업데이트에 실패하는 경우

먼저 구독 주소 전체가 붙여 넣어졌는지, Subscribe에 해당하는 주소 입력란에 입력했는지, 현재 네트워크에서 구독을 가져올 수 있는지 확인합니다. 서버가 이미 있지만 업데이트에 실패한 경우와 처음 가져올 때부터 항목이 없는 경우는 다릅니다. 전자는 기존 항목과 구성을 유지하고, 후자는 주소와 구독 형식을 중점적으로 확인합니다. 업데이트하려고 같은 구독을 반복해서 추가하지 말고, 백업 없이 모든 항목을 먼저 삭제하지 마세요. 필요한 경우 본인의 서비스 제공업체에 구독 상태를 확인하되 전체 주소를 공개된 토론 공간에 올리지 마세요.

연결 스위치가 켜진 상태를 유지하지 못하는 경우

처음 요청된 VPN 권한을 완료했는지 확인한 다음 기기 시스템의 VPN 구성과 실행 중인 다른 연결을 점검합니다. 시스템 안내가 표시되면 내용을 먼저 읽고 연속해서 같은 작업을 반복하지 마세요. 서버 매개변수가 잘못되어도 연결에 실패할 수 있습니다. 이 경우 Add Server에서 해당 항목의 편집 페이지를 열어 Type, Host, Port 및 인증 필드를 하나씩 비교합니다. 비슷한 서버 이름, 같은 도메인, 저장에 성공한 입력 양식은 매개변수 확인을 대신할 수 없습니다.

연결은 되었지만 웹페이지가 열리지 않는 경우

먼저 현재 Wi-Fi 또는 셀룰러 네트워크 자체가 정상인지 테스트한 다음 Proxy와 Config의 결과를 비교합니다. Proxy는 정상인데 Config에 문제가 있으면 현재 구성 파일과 규칙 일치 여부를 확인합니다. 둘 다 실패하면 서버 정보와 서버 사용 가능 여부를 먼저 점검합니다. 특정 도메인만 실패하는 경우 모든 DNS 설정을 바로 바꾸지 말고 Data 기록을 참고해 DNS와 대상 요청을 확인합니다. 프로토콜 필드를 자세히 알아보려면 프로토콜 참고 자료에서 사용 중인 Type을 확인해 관련 없는 필드를 반복해서 변경하지 않도록 합니다.

테스트가 실패하거나 연결을 끊은 뒤 다시 연결되는 경우

Settings에서 Test Method를 확인하고 현재 테스트 방법을 파악한 뒤 Home으로 돌아가 Connectivity Test를 다시 실행합니다. 테스트 응답은 있지만 웹페이지가 실패하면 실제 요청을 기준으로 계속 점검합니다. 테스트는 실패했지만 웹페이지에 접속할 수 있다면 전체 연결이 사용할 수 없다고 판단하지 말고 테스트 대상과 방법을 먼저 구분합니다. 네트워크를 바꾼 뒤 연결 상태가 자동으로 달라지면 On Demand의 트리거 조건과 순서를 확인합니다. 관련 조건을 잠시 끄고 수동으로 비교한 다음 필요한 자동 연결 설정을 복원합니다.

Settings의 Diagnostics를 사용하면 문제를 더 자세히 확인할 수 있지만, 진단 출력에는 도메인·주소·구성 정보가 포함될 수 있습니다. 공유하기 전에 민감한 내용을 확인하고 삭제하세요. Proxy, TCP, UDP 등 여러 설정을 동시에 변경하지 마세요. 기존 값을 보존하고 구체적인 증상을 확인한 다음 해당하는 항목만 조정합니다. 일반적인 연결 확인을 위해 HTTPS Decryption을 켜거나 인증서를 설치할 필요는 없습니다. 처음 사용하는 과정에 추가 변수를 만들지 마세요.

문제가 계속되면 “어느 단계에서 실패했는지, 어떤 모드를 사용했는지, 현재 네트워크 유형은 무엇인지, 테스트와 실제 접속 결과가 각각 어땠는지”를 정리한 뒤 FAQ의 가져오기·규칙·문제 해결 안내를 확인합니다. 단순히 “작동하지 않는다”고 설명하는 것보다 이런 정보가 있으면 구성, 시스템 권한, 네트워크 및 서버 문제를 구분하는 데 도움이 되며 불필요한 재설치와 반복 가져오기를 줄일 수 있습니다.

Shadowrocket Settings 페이지. Language, Test Method, On Demand, Diagnostics, Proxy, TCP 및 UDP 설정 메뉴 표시
Settings 공식 스크린샷. Test Method와 On Demand를 먼저 확인한 뒤 구체적인 문제에 따라 진단 메뉴를 살펴봅니다.
Shadowrocket 모든 플랫폼 다운로드