공식 가이드 · 첫 설정

Shadowrocket 사용법

기존 설정을 가져오고 트래픽 경로를 선택한 뒤 연결을 확인하세요.

이 페이지는 iPhone과 iPad에서의 실제 사용 순서에 따라 구성했습니다. 먼저 서버 하나를 연결하고 확인한 다음 규칙이나 자동 연결 설정을 추가하세요. 처음부터 모든 옵션을 이해할 필요는 없습니다. 스크린샷은 App Store 공식 이미지로, 화면의 위치를 확인하는 데 참고하세요. 실제 메뉴 위치와 입력 항목은 현재 앱에 표시되는 내용을 기준으로 합니다.

진행 순서: Home → Add Server / Subscribe → Global Routing → 연결 스위치 → Connectivity Test. 예상한 결과가 나오지 않으면 다음 설정으로 넘어가지 말고 해당 단계부터 확인하세요.

단계 01 · 서버 목록에 서버 추가하기

Add Server와 Subscribe: 기존 접속 정보 추가

Shadowrocket을 열고 먼저 Home으로 이동해 아래쪽의 SERVER 그룹을 찾습니다. 서버 항목에는 원격 서버에 연결하는 데 필요한 정보가 저장됩니다. 구독은 여러 서버 정보를 받아오고 업데이트하는 출처입니다. 둘 다 Home에서 선택할 항목을 제공하지만 추가 방법은 다릅니다. 받은 정보가 개별 서버 설정인지, 서버 공유 정보인지, 구독 링크인지 먼저 확인하세요. 구독 URL을 Host에 입력하면 안 됩니다.

Add Server에 정보 직접 입력

Home에서 Add Server를 눌러 서버 편집 화면을 엽니다. 먼저 Type을 선택한 다음 해당 프로토콜에 필요한 항목을 입력하세요. Type에 따라 필요한 설정값이 달라질 수 있습니다. 오른쪽 공식 스크린샷은 Host, Port, Password, Method가 표시된 양식의 예시이며, 모든 프로토콜이 같은 항목을 사용하는 것은 아닙니다. 스크린샷의 빈칸을 전부 채우지 말고 보유한 서버 정보에 맞춰 입력하세요.

Host에는 서버 주소, Port에는 연결 포트를 입력합니다. Password, Method 및 기타 인증 항목은 받은 정보와 일치해야 합니다. TLS, Server Name, 전송 방식 또는 경로가 필요한 경우에도 원래 안내된 값대로 입력하세요. 프로토콜 이름이 비슷하다고 설정값을 서로 바꿔 쓸 수 있는 것은 아닙니다. 이름만 보고 옵션을 추측하지 마세요. 저장하기 전에 복사한 내용에 공백, 줄바꿈, 문장 부호가 섞이지 않았는지 확인하세요. 저장한 뒤 Home으로 돌아가 SERVER 그룹에 항목이 나타나는지 확인합니다.

QR 코드로 정보를 받았다면 Scan QR Code로 기존 접속 정보를 읽은 다음 인식된 Type, Host, Port를 확인하세요. Import from Cloud JSON은 별도의 가져오기 기능이며, 이 기능에 맞는 JSON 설정 파일을 이미 보유한 경우에만 사용합니다. 일반 구독 링크는 URL이라는 이유만으로 여기에 입력하면 안 됩니다. 가져오기에 성공해도 설정값을 입력한 것일 뿐이므로, 이후 서버 선택과 연결 단계가 필요합니다.

Subscribe로 구독 가져오기

구독 링크가 있다면 Config에서 Subscribe 항목을 찾아 화면 안내에 따라 구독 출처를 추가합니다. 현재 화면에서 구독 유형이 Add Server의 Type 안에 있다면 해당 메뉴에서 Subscribe를 선택해 입력하세요. 전체 링크를 구독 주소 입력란에 붙여 넣고 저장한 뒤 업데이트를 실행합니다. 가져오는 것은 본인이 이미 보유한 구독이며, 이 사이트에서 서버 정보를 제공하는 것은 아닙니다. 메뉴 위치가 다르면 화면에 표시된 Subscribe 문구와 주소 입력란의 용도를 기준으로 진행하세요.

업데이트가 끝나면 Home으로 돌아가 해당 그룹을 펼쳐 서버 항목이 나타나는지 확인합니다. 그룹 이름만 있고 서버가 없다면 가져오기가 완료된 것이 아닙니다. 링크 전체가 복사되었는지, 접속 권한이 유효한지, 업데이트 중 오류가 표시되었는지 확인하세요. 구독에 여러 항목이 포함될 수 있으므로 첫 확인에서는 설정이 명확한 서버 하나만 선택하세요. 그룹 전체를 한꺼번에 수정하지 마세요.

구독 업데이트는 보통 원격에서 제공하는 항목을 동기화하는 기능이며, 로컬 설정을 백업하는 기능은 아닙니다. 수동으로 변경한 이름이나 설정값은 다음 업데이트 때 달라질 수 있으니 원래 정보를 보관하고, 반복해서 삭제 후 다시 가져오지 마세요. 이 단계의 완료 기준은 Home에 선택할 수 있고 출처가 명확한 서버가 하나 이상 있는 것입니다. 구독, 서버, 규칙 파일의 차이는 용어 빠른 확인에서 볼 수 있습니다. 목록이 정상이라면 다음 단계에서 트래픽 처리 방식을 선택하세요.

Shadowrocket의 Add Server 화면. Type, Host, Port, Password, Method와 Scan QR Code 및 Import from Cloud JSON 항목이 표시됩니다.
Add Server: 먼저 Type을 선택한 뒤 해당 프로토콜에 실제로 필요한 항목을 확인하세요. 스크린샷의 항목 구성은 모든 프로토콜에 공통으로 적용되는 양식이 아닙니다.
단계 02 · 프록시를 사용할 트래픽 선택

Global Routing: Config, Proxy, Direct

서버 정보를 입력한 뒤 Home으로 돌아가 Global Routing을 눌러 현재 선택된 방식을 확인합니다. 이 설정은 트래픽 처리 방식을 정하며, 서버 비밀번호를 입력하거나 만료된 구독을 복구하는 기능은 아닙니다. ‘사용 가능한 서버가 있는지’와 ‘트래픽에 어떤 정책을 적용할지’를 구분해야 이후 테스트 결과를 제대로 판단할 수 있습니다.

  • Config: 현재 활성화된 규칙 파일에 따라 처리합니다. 요청마다 PROXY, DIRECT 또는 다른 지정된 정책으로 보낼 수 있으며, 기존 규칙 설정을 사용하는 경우에 적합합니다.
  • Proxy: 클라이언트가 처리하는 트래픽을 모두 프록시 정책으로 보냅니다. 프록시 경로를 임시로 확인할 때 사용할 수 있습니다. 선택한 서버와 관련 설정이 정상이어야 합니다.
  • Direct: 클라이언트가 처리하는 트래픽을 모두 직접 연결합니다. 현재 네트워크의 접속 상태를 확인할 때 사용할 수 있습니다. 서버를 선택해도 이 방식에서는 트래픽이 해당 서버를 거치지 않습니다.

용도가 분명한 규칙 파일이 있다면 Config를 선택하기 전에 Config로 이동해 해당 파일이 활성화되어 있는지 확인하세요. 파일을 열면 General, Rule, Hosts 등의 구역을 볼 수 있습니다. 공식 스크린샷은 설정 파일 편집 화면이며 Global Routing 방식 선택 화면이 아닙니다. 파일에 General 또는 Rule이 표시된다는 사실만으로 실제 트래픽 경로를 알 수는 없습니다. 경로는 설정 내용과 규칙 순서에 따라 달라집니다.

서버 구독과 규칙 파일은 용도가 다릅니다. 서버 구독은 주로 연결 정보를 제공하고, 규칙 파일은 요청의 매칭 및 전달 방식을 정합니다. 구독을 가져온 뒤 목록에 서버가 있다는 이유만으로 규칙 설정까지 완료되었다고 판단하지 마세요. 확인된 규칙 파일이 아직 없다면 Proxy를 사용해 연결을 한 번 확인한 다음, 서버가 작동하는 것을 확인하고 Config로 돌아가 라우팅을 점검할 수 있습니다. 테스트 중에는 현재 방식을 확인해 임시 설정을 최종 설정으로 착각하지 않도록 하세요.

규칙을 읽을 때는 먼저 매칭 조건을, 다음으로 적용할 정책을 확인하세요. 예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 도메인 접미사를 기준으로 매칭한 뒤 PROXY로 전달한다는 뜻입니다. 여기의 example.com은 문법 설명을 위한 예시 도메인일 뿐, 연결 서비스를 의미하지 않습니다. FINAL,DIRECT는 앞선 규칙에 매칭되지 않은 요청을 DIRECT로 전달하며, 보통 규칙의 마지막에 둡니다. PROXY가 보인다고 파일의 모든 요청이 프록시를 거친다고 판단하면 안 됩니다.

처음 설정할 때 DNS, Hosts, URL Rewrite, HTTPS Decryption을 한꺼번에 편집할 필요는 없습니다. 기존에 신뢰할 수 있는 설정은 그대로 두고 활성화된 파일이 예상한 것과 일치하는지 확인한 뒤 저장하고 Home으로 돌아가세요. 프로토콜 항목과 전송 설정에 대한 자세한 설명은 프로토콜 참고에서 확인할 수 있습니다. 이 페이지에서는 첫 연결에 필요한 선택만 다룹니다. 이 단계가 끝나면 현재 어떤 방식을 사용 중인지, 테스트 요청이 프록시와 직접 연결 중 어느 경로로 가야 하는지 설명할 수 있어야 합니다.

Shadowrocket의 Config 설정 파일 편집 화면. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 구역과 Add Rule이 표시됩니다.
Config 파일 편집 화면은 설정 내용을 확인하는 곳입니다. Global Routing 방식은 Home으로 돌아가 확인해야 합니다.
단계 03 · 서버를 선택한 뒤 연결하기

Home: 서버 선택 후 연결 스위치 켜기

가져오기와 Global Routing 설정을 마쳤다면 Home으로 돌아가 SERVER 그룹에서 사용할 서버를 선택합니다. 항목 편집 화면을 여는 것과 서버를 선택하는 것은 다릅니다. 서버 옆에 선택 원형이나 선택 표시가 나타나야 합니다. 그룹에 서버가 있다는 것만으로 실제 선택이 완료된 것은 아닙니다. 구독 그룹이 여러 개라면 다른 그룹의 오래된 서버를 선택하지 않았는지도 확인하세요.

이어서 Global Routing이 앞 단계에서 선택한 방식으로 유지되어 있는지 확인합니다. 문제가 없다면 Home 상단의 연결 스위치를 켭니다. 처음 연결할 때 시스템에서 Shadowrocket이 VPN 구성을 추가하도록 허용할지 물을 수 있습니다. 이는 Apple 시스템이 네트워크 연결 구성을 승인받는 절차입니다. 팝업에 표시된 앱 이름을 확인하고 시스템 안내에 따라 승인하세요. 기기에서 본인 인증을 요구할 수 있습니다. 승인이 완료되지 않았다면 해당 안내부터 처리한 뒤 앱의 상태를 확인하세요.

VPN 구성 승인은 구독 인증과 다릅니다. 시스템 승인은 클라이언트가 네트워크 터널을 만들도록 허용하고, 서버 인증 정보는 원격 서버가 연결을 받아들일지 결정합니다. 시스템 팝업에서 허용했다고 서버 설정이 올바른 것은 아니며, 서버 비밀번호가 맞더라도 기기 승인을 대신할 수 없습니다. 이전에 팝업을 취소했다면 스위치를 다시 켜고 현재 시스템 안내에 따라 진행하세요. 문제를 우회하려고 동일한 항목을 계속 추가하지 마세요.

승인 후 Home으로 돌아가 상단 상태가 Not Connected에서 연결 상태로 바뀌는지, 스위치가 켜진 상태로 유지되는지 확인합니다. 시스템의 VPN 표시는 참고 정보일 뿐, 실제 접속 성공을 확정하지는 않습니다. 스위치가 바로 꺼지거나 상태가 계속 바뀌거나 오류가 표시되면 내용을 기록하고 이 페이지의 문제 해결로 이동하세요. 여러 고급 설정을 동시에 바꾸지 마세요.

연결 중에는 기기에 다른 VPN 구성이 활성화되어 있는지, 자동 연결 설정이 연결 상태에 영향을 주고 있는지도 확인하세요. 처음 테스트할 때는 조건을 단순하게 유지하고 수동 스위치로 안정적인 연결을 먼저 만든 다음 On Demand를 설정하는 편이 좋습니다. 스위치가 켜졌다는 이유만으로 구독을 더 가져오지 마세요. 다음 단계의 Connectivity Test와 실제 접속을 완료해 해당 서버가 작동하는지 확인하세요.

iPad에서는 화면 너비에 따라 배치가 달라질 수 있지만 조작 순서는 같습니다. Home에서 서버를 선택하고 Global Routing을 확인한 다음 스위치를 켭니다. 이 단계의 완료 여부는 스크린샷과 위치가 일치하는지가 아니라 서버 선택, 승인 결과, 연결 상태를 기준으로 판단하세요.

Shadowrocket의 Home 화면. 상단에 Not Connected 상태와 연결 스위치가 있고, 아래에 Global Routing, Connectivity Test, SERVER 그룹, Add Server가 표시됩니다.
Home: SERVER에서 서버를 먼저 선택한 뒤 상단 스위치를 켭니다. Connectivity Test는 연결 후 추가 확인에 사용합니다.
단계 04 · 연결 상태와 실제 접속 결과 구분하기

Connectivity Test: 연결 및 라우팅 확인

연결 상태가 안정되면 Home에서 Connectivity Test를 누르고 결과가 나올 때까지 기다립니다. 테스트 결과는 현재 조건에서의 연결 가능성을 판단하는 데 도움이 되지만, 테스트에 사용된 대상과 방법만 확인합니다. 단일 테스트가 성공해도 모든 웹사이트와 앱이 정상적으로 작동한다는 뜻은 아닙니다. 테스트가 실패했다면 선택한 서버, 테스트 방식, 현재 네트워크를 함께 살펴보세요. 바로 클라이언트 자체의 문제라고 단정할 수 없습니다.

다음으로 브라우저를 열어 평소에 접속할 수 있는 페이지에 들어가 기기의 기본 네트워크 접속을 확인합니다. 그런 다음 현재 설정상 프록시를 거쳐야 하는 대상을 테스트하세요. Config를 사용한다면 직접 연결될 대상과 프록시를 거칠 대상을 각각 확인합니다. Proxy를 사용 중이라면 이번 테스트는 프록시 경로를 확인하는 것이므로 규칙이 예상대로 적용되었는지 판단하는 데 사용하지 마세요. Direct에서 접속에 성공해도 프록시 서버가 작동한다는 뜻은 아닙니다.

비교가 유효하도록 가능한 한 같은 네트워크, 같은 서버, 같은 대상을 유지하고 매번 한 가지 조건만 바꾸세요. 서버나 Global Routing을 변경한 뒤에는 다시 접속해 봅니다. 필요하면 기존 페이지를 닫고 다시 열어 기존 연결이나 캐시가 결과에 미치는 영향을 줄이세요. Wi-Fi와 셀룰러 네트워크, 서버, DNS, 규칙을 동시에 바꾸면 접속이 복구되어도 원인을 파악하기 어렵습니다.

라우팅을 확인하려면 클라이언트에서 제공하는 연결 기록이나 관련 로그를 살펴보고 요청이 매칭된 규칙과 정책을 확인하세요. 먼저 요청에 해당하는 도메인을 확인한 뒤 예상한 PROXY 또는 DIRECT로 전달되었는지 확인합니다. 페이지 로딩 속도, 기기의 VPN 표시, 특정 테스트 수치만으로 트래픽 경로를 확정할 수는 없습니다. 로그에 포함된 도메인과 방문 기록은 개인 정보일 수 있으므로 공유하기 전에 필요한 부분을 가리세요.

기본 접속은 되지만 특정 대상만 실패한다면 해당 대상의 규칙과 DNS를 먼저 확인하세요. 모든 접속이 실패한다면 서버와 현재 네트워크를 우선 점검합니다. 문제를 구체적인 단계로 나누면 전체 설정을 반복해서 바꾸는 것보다 원인을 찾기 쉽습니다. 다른 일반적인 문제는 자주 묻는 질문에서 확인할 수 있습니다. 특정 대상 하나의 문제를 해결하려고 가져오기 절차 전체를 다시 진행할 필요는 없습니다.

단계 05 · 한 번에 한 가지 조건만 변경

연결 실패: 네트워크, 설정값, 모드, 규칙 점검

스위치가 켜져 있는데 접속할 수 없다면 현재 설정과 오류 메시지를 보존하고 서버를 모두 삭제하지 마세요. 스위치가 켜진 상태로 유지되지 않는지, Connectivity Test가 실패하는지, 특정 페이지만 열리지 않는지 상황을 구체적으로 기록합니다. 문제가 Wi-Fi, 셀룰러 네트워크 또는 두 환경 모두에서 발생하는지도 확인하세요. 기록한 내용에 따라 점검을 시작할 단계를 정하고 불필요한 반복 작업을 줄일 수 있습니다.

네트워크와 서버 정보부터 확인

연결 스위치를 잠시 끄고 현재 네트워크에서 기본적인 접속이 가능한지 확인합니다. 기기 자체가 인터넷에 연결되지 않았다면 먼저 네트워크 로그인, 신호 또는 라우터 연결을 해결한 뒤 클라이언트로 돌아오세요. 기본 네트워크가 복구되면 기존 서버 하나를 다시 선택하고 Type, Host, Port 및 인증 정보를 확인합니다. TLS나 특정 전송 방식을 사용하는 서버라면 관련 항목도 빠짐없이 확인하세요. 주소와 포트만 확인하는 것으로는 충분하지 않습니다.

구독을 사용한다면 가장 최근 업데이트가 실제로 성공했는지, 서버가 현재 그룹에 남아 있는지 확인합니다. 구독 링크가 만료되었거나 이용 권한이 바뀌었다면 서비스 제공업체에 기존 구독 상태를 문의하세요. 클라이언트 구매 내역만으로 원격 서비스가 계속 유효하다고 판단할 수는 없습니다. 업데이트에 실패했다면 기존 항목을 유지한 채 오류를 확인하세요. 같은 출처의 그룹을 여러 개 만들면 현재 선택한 항목을 구분하기 어려워집니다.

Global Routing으로 문제 범위 좁히기

Config에서 접속에 실패한다면 같은 서버와 같은 대상을 유지한 채 Proxy로 잠시 전환해 다시 테스트합니다. Proxy에서는 접속되지만 Config에서 실패한다면 활성화된 설정 파일, 규칙 순서, 관련 정책을 우선 확인하세요. 두 방식 모두 실패하면 서버 설정과 원격 서버 연결 가능성을 계속 점검합니다. 이런 비교는 원인을 찾기 위한 방법일 뿐, 한 번의 결과만으로 특정 단계가 완전히 정상이라고 단정할 수 없습니다.

Direct에서는 특정 대상에 접속되지만 Proxy에서는 안 된다면 두 경로의 결과가 다른 것입니다. 직접 연결에 성공했다는 이유로 서버 테스트까지 성공했다고 판단하지 말고 프록시 경로를 점검하세요. 비교가 끝나면 원래 사용하려던 방식으로 되돌립니다. 규칙을 변경했다면 임시 문제 해결 설정이 일상 설정에 남지 않도록 변경 내용을 항목별로 기록하세요.

마지막으로 DNS, 설정, 진단 기록 확인

도메인 접속 실패는 DNS와 관련될 수 있지만 모든 연결 문제의 원인이 DNS인 것은 아닙니다. 활성 설정의 DNS가 예상한 설정에서 가져온 것인지, 최근 변경된 적이 있는지 먼저 확인한 뒤 오류 기록을 함께 살펴보세요. 출처를 모르는 주소를 여러 개 연달아 입력하지 마세요. 인증서 검증을 끄는 방식으로 인증 오류나 설정 오류를 해결하려고 하지 마세요.

Settings에서 Test Method, On Demand, Diagnostics와 Proxy, TCP, UDP 관련 설정을 찾을 수 있습니다. Diagnostics에서 현재 확인 가능한 진단 항목이나 기록을 살펴보고 실제 조작 시간과 오류를 대조하세요. Test Method를 변경했다면 변경 전후 결과의 의미가 달라질 수 있습니다. 수동 연결이 안정되기 전에는 On Demand를 함께 설정하지 마세요. 자동 연결 조건이 점검 결과에 영향을 줄 수 있습니다.

특정 네트워크나 요청 유형에서만 문제가 발생한다면 해당 조건을 기록한 뒤 프로토콜 참고에서 현재 프로토콜의 전송 및 설정 요구 사항을 확인하세요. 화면 용어가 불분명하면 용어 빠른 확인을 참고하세요. 모든 고급 스위치를 하나씩 바꾸는 것이 아니라, 기본 네트워크 → 서버와 구독 → Global Routing → DNS와 규칙 → 진단 기록 순서로 반복 가능한 점검을 진행합니다.

서비스 제공업체에 상황을 설명해야 한다면 필요한 오류 문구, 사용 중인 프로토콜 유형, 재현 조건만 전달하세요. 스크린샷을 보내기 전에 비밀번호, 전체 구독 주소, 인증 정보 및 기타 개인 자격 증명을 가리세요. 접속이 복구되면 Connectivity Test와 실제 접속을 다시 확인하고 최종적으로 작동한 서버와 방식을 기록합니다. 결과가 확인되면 첫 설정이 완료된 것입니다.

Shadowrocket의 Settings 화면. Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP, UDP 설정 항목이 표시됩니다.
Settings: 문제를 해결할 때는 관련 설정과 Diagnostics부터 확인하세요. 여러 옵션을 한 번에 바꾸지 마세요. On Demand는 수동 연결을 확인한 뒤 설정할 수 있습니다.