Home에서 시작해 기존 정보를 가져오고 Global Routing을 선택한 다음, 실제 요청으로 연결 결과를 확인합니다.
iPhone / iPadAdd Server / Subscribe연결 및 문제 해결
아래 안내는 iPhone / iPad 사용 순서를 기준으로 합니다. 기기와 앱 업데이트에 따라 화면 배치는 달라질 수 있으므로 각 필드는 현재 앱에 표시되는 내용을 기준으로 입력하세요. 예시 스크린샷은 화면을 식별하기 위한 것이며, 표시된 값을 그대로 입력해야 한다는 뜻은 아닙니다.
STEP 01 / IMPORT
Add Server와 Subscribe: 기존 정보 가져오기
가져오기의 목적은 Home에 선택 가능한 서버 기록을 표시하는 것입니다. 기록이 나타났다고 해서 연결까지 완료된 것은 아닙니다.
Shadowrocket을 열고 Home으로 이동한 뒤 하단의 SERVER 그룹을 확인합니다. 처음 사용하는 경우 Add Server를 눌러 추가 화면으로 이동하세요. 이미 서버 기록이 있다면 여기서 계속 추가할 수도 있습니다. 다음으로 보유한 정보가 서버 목록을 불러오는 구독 링크인지, 주소·포트·인증 매개변수가 명시된 정보인지 확인합니다. 두 종류의 정보는 입력 경로가 다르므로 구독 링크 전체를 Host에 입력하면 안 됩니다.
구독 링크가 있는 경우: Subscribe 선택
Add Server에서 Type을 탭하고 Subscribe를 선택한 다음 구독 주소 입력 화면으로 돌아갑니다. 서비스 제공업체에서 받은 링크 전체를 URL 필드에 붙여넣고, 불필요한 공백이나 줄바꿈이 없는지 또는 메신저에서 일부가 잘리지 않았는지 확인하세요. 메모 필드가 있다면 용도를 구분하기 쉬운 이름을 입력할 수 있습니다. 메모는 기기에서 구분하기 위한 표시일 뿐, 링크에 포함된 인증 정보를 대신하지 않습니다.
저장한 뒤 Home으로 돌아가 목록을 불러올 때까지 기다린 다음 해당 그룹을 펼쳐 서버 기록을 확인합니다. 구독 이름만 표시되고 서버 항목이 없다면 연결 스위치를 반복해서 켜기보다 먼저 업데이트 결과를 확인하세요. 이후에는 앱에서 제공하는 업데이트 기능으로 해당 구독을 갱신하고, 완료 후 기록이 남아 있는지 살펴봅니다. 주소가 만료되었거나 서비스 이용 기간이 끝났거나 응답 형식이 맞지 않는 경우에는 기존 서비스 정보를 확인해야 합니다. 앱을 다시 구매해도 이런 문제는 해결되지 않습니다.
서버 매개변수가 있는 경우: Type에 맞춰 입력
직접 추가할 때는 먼저 Type에서 보유한 정보와 정확히 일치하는 프로토콜을 선택한 뒤 Host와 Port를 입력합니다. Host는 서버 주소이며 웹페이지 경로를 덧붙이지 않습니다. Port는 서버에서 지정한 포트이므로 프로토콜 이름만 보고 추측하지 마세요. 예를 들어 Shadowsocks는 Password와 Method도 정확히 확인해야 합니다. 다른 Type에서는 인증, TLS 또는 전송 관련 필드가 다르게 표시될 수 있으므로 해당 서버 정보에 따라 입력하고, 한 프로토콜의 필드를 다른 프로토콜에 적용하지 마세요.
화면 하단의 Scan QR Code로 기존 QR 코드를 읽을 수 있으며, Import from Cloud JSON은 해당 형식의 정보를 가져오는 기능입니다. QR 코드를 스캔한 뒤에도 Type, Host, Port 및 인증 필드를 확인하세요. QR 코드가 인식되었다고 매개변수가 반드시 유효한 것은 아닙니다. 시스템에서 카메라 권한을 요청하면 QR 코드 스캔을 사용할지에 따라 결정하세요. 직접 입력하는 경우 카메라 권한은 필요하지 않습니다.
저장하기 전에 입력 내용을 다시 확인한 뒤 Home으로 돌아와 기록 이름과 그룹을 살펴봅니다. 이후 단계를 진행할 때는 정보가 완전한 기록 하나를 먼저 선택하는 것이 좋습니다. 여러 정보를 한꺼번에 가져오면 어떤 항목을 사용 중인지 판단하기 어려울 수 있습니다. 이 단계에서는 Settings의 고급 매개변수를 변경하지 말고, 다음 단계에서 Global Routing과 구성 파일의 관계만 확인합니다.
Add Server: 먼저 Type을 선택하고 해당 프로토콜에 필요한 매개변수를 입력합니다. 하단에는 Scan QR Code와 Import from Cloud JSON이 있습니다.
STEP 02 / ROUTING
Global Routing: Config, Proxy, Direct
Global Routing은 요청의 라우팅 방식을 결정합니다. 서버 기록에는 연결 매개변수가, Config에는 규칙과 관련 설정이 담깁니다.
Home으로 돌아가 Global Routing을 탭해 현재 선택을 확인합니다. 이 튜토리얼에서는 세 가지 선택지를 Config(구성), Proxy(프록시), Direct(직접 연결)로 설명합니다. 먼저 현재 선택된 항목을 확인한 다음 변경하세요. 처음 열었을 때 특정 모드가 선택되어 있다고 가정하지 마세요. 일상적으로는 Config를 권장하지만, 현재 구성이 본인의 사용 목적에 적합한지 확인한 경우에 한합니다.
Config는 현재 적용 중인 파일의 규칙에 따라 요청 경로를 결정합니다. 사용 가능한 구성이 있다면 Config로 이동해 실제 선택된 파일을 확인한 뒤 편집 화면에서 General, Rule 등의 섹션을 살펴봅니다. Rule은 일반적으로 위에서 아래 순서로 일치 여부를 확인하며, 먼저 일치한 규칙이 정책을 결정합니다. FINAL은 앞선 규칙에 일치하지 않은 요청을 처리합니다. 파일 내용을 확인하는 것만으로는 해당 파일이 적용되는 것이 아니므로 목록으로 돌아가 선택 상태도 확인하세요.
Proxy는 요청을 프록시 경로로 보내며, 처음 확인할 때 잠시 비교 테스트하면 서버 연결 문제와 분할 라우팅 규칙 문제를 구분하는 데 도움이 됩니다. Proxy를 선택한다고 문제가 자동으로 해결되는 것은 아닙니다. Host, 인증 정보 또는 서비스 상태가 올바르지 않으면 Proxy에서도 연결에 실패할 수 있습니다. Direct는 직접 연결 경로를 확인할 때 사용할 수 있습니다. 이 모드에서 대상 요청이 직접 연결된 결과만으로는 프록시 서버가 적용되었다고 판단할 수 없습니다.
사용 가능한 구성이 있다면 다른 설정은 그대로 두고 Config에서 먼저 연결을 확인합니다. 서버 정보만 있고 현재 구성이 맞는지 확인되지 않았다면 Proxy로 명확한 연결 테스트를 한 번 진행한 뒤 Config를 정리할 수 있습니다. 첫 연결을 위해 URL Rewrite나 HTTPS Decryption을 동시에 활성화하지 마세요. 일반적인 연결의 필수 조건이 아니며 각각 적용 조건이 다릅니다.
아래 예시는 규칙 구조를 파악하기 위한 것으로, 처음 설정할 때 붙여넣을 필요는 없습니다. 첫 번째 줄은 지정된 도메인 접미사를 일치시키고 두 번째 줄은 최종 정책을 지정합니다. 예시에 포함된 도메인은 테스트 서비스가 아니며 연결 정보도 포함하지 않습니다.
DOMAIN-SUFFIX,example.com,DIRECT
FINAL,PROXY
규칙 편집, DNS 및 정책에 관한 자세한 내용은 Settings 및 구성 옵션 매뉴얼을 참조하세요. 이 튜토리얼에서는 현재 모드, 현재 구성, 선택한 서버를 확인하는 것만으로 충분합니다. 세 항목을 기록한 뒤 연결 단계로 넘어가면 문제 발생 시 같은 조건으로 재현할 수 있습니다.
Config: Rule에서 일치하는 항목을 확인합니다. 구성 파일 편집 화면과 Home의 Global Routing 선택은 서로 다른 위치의 작업입니다.
STEP 03 / CONNECTION
Home: 서버 선택 및 연결 시작
연결 스위치는 시스템 네트워크 확장을 켜고 끄는 기능입니다. 시스템 권한 승인과 서버 인증은 서로 다른 절차입니다.
Home으로 돌아가 SERVER 그룹에서 사용할 서버를 탭하고 선택 표시가 원하는 기록에 있는지 확인합니다. 그룹에 기록이 여러 개 있어도 표시 순서로 현재 사용 중인 서버를 판단하지 마세요. 이어서 Global Routing 표시가 앞 단계에서 확인한 내용과 같은지 살펴본 다음, 화면 상단의 Not Connected 옆에 있는 연결 스위치를 켭니다.
처음 연결할 때 시스템에서 VPN 구성을 추가하라는 안내가 표시될 수 있습니다. 이는 앱이 네트워크 연결 구성을 만들도록 허용하는 시스템 권한 절차이며, 앱을 다시 구매하라는 메시지나 구독 업데이트 알림이 아닙니다. 안내에 표시된 앱 이름을 읽고 현재 작업으로 인해 나타난 것이 맞는지 확인한 뒤 시스템 안내에 따라 승인하세요. 기기에 따라 암호 입력이나 시스템 인증이 필요할 수 있습니다. 승인 후 Shadowrocket으로 돌아와 상단 상태가 바뀌었는지 확인합니다.
취소를 선택하면 이 절차로 연결을 완료할 수 없습니다. 준비가 되면 스위치를 다시 켜 시스템 권한을 승인하세요. 조직에서 관리하는 기기는 구성 제한이 권한 승인에 영향을 줄 수 있으므로 기기 관리 지침을 따르세요. 서버 암호를 반복해서 변경하지 마세요. 시스템 권한을 승인했다는 것은 네트워크 확장을 실행할 조건이 갖춰졌다는 뜻일 뿐, 원격 서버가 정상적으로 응답한다는 의미는 아닙니다.
상태가 바뀌면 잠시 기다리며 바로 연결이 끊기지 않는지 확인한 뒤 다음 단계로 진행합니다. 연결 스위치가 켜져 있는 상태, 시스템에 VPN 표시가 나타나는 것, 대상 서비스에 정상적으로 접속하는 것은 서로 다른 결과입니다. 어느 하나만으로 전체 연결이 확인되는 것은 아닙니다. 스위치가 바로 꺼지면 안내 문구와 현재 모드를 기록하고, 진단 기록을 혼동하지 않도록 짧은 간격으로 스위치를 반복해서 켜고 끄지 마세요.
처음 수동으로 연결할 때는 On Demand를 추가로 설정하지 않는 것이 좋습니다. On Demand는 조건에 따라 연결을 시작하는 기능이지, 첫 연결에서 반드시 켜야 하는 설정이 아닙니다. 이미 자동 연결 조건을 설정했다면 상태를 먼저 기록하세요. 수동으로 꺼도 자동으로 다시 실행되어 스위치가 작동하지 않는다고 오해할 수 있습니다. 연결이 안정되고 확인까지 마친 뒤 자동화 동작을 별도로 설정하세요.
Home: 상단에서 연결 상태를 확인하고, 가운데에서 Global Routing과 Connectivity Test를 확인한 뒤, 아래 SERVER에서 서버를 선택합니다.
STEP 04 / VERIFICATION
Connectivity Test: 실제 요청 확인
테스트 결과와 실제 접속, 규칙 경로를 함께 확인해야 합니다. 소요 시간 하나만 비교해서는 안 됩니다.
연결 테스트 후 대상 서비스에 접속
Home에서 Connectivity Test를 탭하고 테스트가 끝날 때까지 기다린 뒤 성공 응답, 시간 초과 또는 기타 안내를 기록합니다. 결과는 테스트 방식과 대상, 현재 네트워크 환경에 따라 달라집니다. 한 번 테스트에 성공해도 모든 도메인과 프로토콜에 접속할 수 있다는 뜻은 아니며, 특정 테스트의 실패 여부도 실제 요청 결과와 함께 판단해야 합니다.
그다음 사용할 권한이 있는 대상 서비스에 접속해 페이지 새로고침 등 분명한 작업을 한 번 실행합니다. 이미 캐시된 내용만 확인하지 말고 필요하면 페이지를 새로고침하거나 대상 앱을 다시 여세요. 먼저 한 항목만 테스트하고 발생 시간과 오류 안내를 기록하면 연결 기록에서 해당 요청을 찾기 쉽습니다.
요청 경로도 확인
Config 모드에서 일부 요청이 DIRECT에 일치하는 것은 정상적인 라우팅 결과일 수 있으며 연결이 되지 않았다는 뜻은 아닙니다. 앱에서 제공하는 Log나 연결 기록을 열어 도메인, 일치한 규칙, 정책을 함께 확인하세요. 로그 위치와 표시 항목은 현재 앱을 기준으로 합니다. 요청에 예상과 다른 정책이 적용되었다면 먼저 현재 Config를 확인하고 서버부터 바꾸지 마세요.
비교가 필요하다면 Global Routing 항목만 변경해 Proxy에서 같은 대상을 다시 테스트한 뒤 원래 모드로 되돌립니다. Proxy에서는 접속되지만 Config 결과가 예상과 다르면 규칙과 이름 해석을 먼저 확인하세요. 두 모드 모두 실패하면 서버와 기본 네트워크를 점검합니다. 비교할 때 같은 대상과 네트워크를 유지해야 결과를 참고할 수 있습니다.
구독 목록에 표시되는 테스트 시간은 현재 테스트 조건에서 비교하기 위한 값입니다. 실제 다운로드 속도나 안정성을 보장하지 않습니다. 처음 연결을 확인한 뒤 사용 가능한 서버, Global Routing, 구성 파일 이름을 기록해 두세요. 이후 설정을 변경할 때 이 검증된 조건을 복구 기준으로 삼으면 문제 범위를 좁힐 수 있습니다.
STEP 05 / DIAGNOSTICS
Settings: 자주 발생하는 문제의 점검 순서
문제를 단계별로 파악한 뒤 설정을 변경하세요. 한 번에 한 항목만 바꾸고 다시 테스트한 다음 유지할지 되돌릴지 결정합니다.
기본 네트워크와 가져오기 결과부터 확인
기본 네트워크는 모든 연결의 전제 조건입니다. 먼저 연결 스위치를 끄고 현재 Wi-Fi 또는 셀룰러 네트워크에서 원래 직접 접속할 수 있던 서비스에 접속해 보세요. 여기서도 실패한다면 먼저 네트워크 연결 문제를 해결해야 합니다. 공용 Wi-Fi는 먼저 로그인해야 할 수 있으며, 로그인하지 않으면 구독 업데이트와 서버 연결 모두 영향을 받을 수 있습니다. 네트워크를 전환해 비교할 때는 전환 전후의 결과를 기록하고 서로 다른 네트워크에서 측정한 수치를 직접 비교하지 마세요.
SERVER에 선택할 기록이 없다면 아직 정보 가져오기 단계의 문제입니다. Subscribe 주소가 완전한지, 업데이트 오류가 있었는지, 기존 서비스 정보가 유효한지 다시 확인하세요. 목록은 있지만 특정 기록만 실패한다면 해당 기록을 열어 Type, Host, Port 및 인증 매개변수를 확인합니다. TLS나 전송 설정이 있다면 해당 필드도 점검하세요. 기기의 날짜와 시간이 크게 틀린 경우에는 인증서가 관련된 연결을 다시 테스트하기 전에 먼저 바로잡아야 합니다.
모드, 규칙, DNS 확인
연결 상태는 유지되지만 대상 서비스에 접속할 수 없다면 먼저 Direct가 선택되어 있지 않은지 확인합니다. Proxy와 Config의 결과가 다르면 현재 적용 중인 파일과 Rule의 순서를 살펴보고, 특히 너무 이른 단계에서 일치하는 규칙과 마지막의 FINAL을 확인하세요. 활성화되지 않은 파일만 편집한 뒤 다른 파일의 결과로 변경 사항의 효과를 판단하지 마세요.
DNS는 도메인 이름을 해석하는 기능입니다. 이름 해석 실패와 서버 핸드셰이크 실패는 서로 다른 문제입니다. 오류 안내나 기록이 이름 해석 단계의 문제를 가리킬 때만 현재 구성의 DNS 설정을 확인하세요. 온라인에서 찾은 주소를 한꺼번에 구성에 덮어쓰거나 DNS, 규칙, 서버를 동시에 변경하지 마세요. 기존 값을 보관하고 한 항목을 변경한 뒤 같은 대상을 다시 테스트하세요. 관련 필드와 권장 값은 옵션 매뉴얼의 DNS 및 진단 안내를 참조하세요.
마지막으로 테스트 방식과 자동 연결 확인
Settings에서 Test Method와 Diagnostics를 확인합니다. Test Method에 따라 테스트 결과의 의미가 달라지므로 서로 다른 방식으로 측정한 시간을 같은 지표로 비교하지 마세요. Diagnostics는 문제를 더 자세히 파악하는 데 사용합니다. 구체적인 메뉴 위치와 사용할 수 있는 도구는 현재 앱에 표시되는 내용을 기준으로 합니다. 진단 정보를 보관할 때는 발생 시간, 현재 네트워크, 선택한 모드, 오류 문구를 기록하면 됩니다. 전체 구성을 공개할 필요는 없습니다.
수동으로 연결을 끈 뒤 다시 연결하거나 네트워크 변경 후 예상과 다르게 동작한다면 On Demand의 실행 조건을 확인하세요. On Demand는 조건에 따라 연결을 시작할 수 있으므로 문제를 점검할 때 자동 실행과 수동 스위치 동작을 구분해야 합니다. Proxy, TCP, UDP 등의 섹션도 처음 사용할 때 반드시 조정해야 하는 항목은 아닙니다. 명확한 문제 원인이 없다면 현재 값을 유지하고, 기본값은 앱에 표시된 내용을 기준으로 합니다.
이용 중인 서비스 제공업체에 서버 상태를 문의할 때는 필요한 오류 정보만 전달하고 비밀번호, 구독 주소, 인증 식별 정보, QR 코드는 가리세요. 재현 가능한 실패 조건을 확인했다면 서버 시간 초과 및 연결 실패 점검 순서를 참조하세요. 설정의 의미와 값을 조정하려면 Settings 설정 항목 참고를 확인하고, 처음 설정하는 단계에서 모든 옵션을 한꺼번에 변경하지 마세요.
Settings: 문제에 따라 Test Method, On Demand, Diagnostics를 확인하세요. 다른 고급 매개변수는 첫 연결 때 반드시 변경할 필요가 없습니다.
CHECKPOINT / NEXT REFERENCE
시작 단계 완료 확인
선택 가능한 기록이 있고, 모드와 구성이 명확하며, 연결 상태가 유지되고, 실제 요청이 예상대로 처리되어야 전체적인 시작 확인이 완료됩니다.
이후에는 실제 필요에 따라 항목을 하나씩 조정하면 됩니다. 규칙 일치와 FINAL, DNS, On Demand, Log 등에 관한 자세한 내용은 옵션 매뉴얼에서 확인할 수 있습니다. 구매, 재설치, 구입 항목 복원은 앱 받기 페이지를 참조하세요.