공식 매뉴얼 / 첫 설정
Shadowrocket 구독 가져오기
와 첫 연결 방법
‘추가 → 모드 선택 → 연결 → 확인 → 문제 해결’ 순서로 진행하세요. 먼저 기존 연결 정보를 하나 준비해 테스트한 다음 규칙과 설정을 하나씩 살펴보세요.
아래에서는 영어 인터페이스 용어를 그대로 사용하고 괄호 안에 설명을 덧붙입니다. 이미지는 App Store 공식 스크린샷으로, 해당 화면을 찾는 데 참고할 수 있습니다. 표시되는 필드와 순서는 프로토콜, 기기 및 앱 인터페이스에 따라 다를 수 있으므로 실제 앱 화면을 기준으로 확인하세요.
단계 01 / 연결 항목 준비
Add Server / Subscribe: 서버 추가 또는 기존 구독 가져오기
먼저 보유한 정보가 구독 URL인지 서버 매개변수인지 확인하세요. 입력하는 위치가 다르므로 구독 주소를 Host 필드에 넣지 마세요.
구독 링크가 있는 경우: Subscribe 선택
Home에서 Add Server를 엽니다. 보통 오른쪽 상단의 추가 버튼이나 목록의 Add Server 항목을 누르면 됩니다. Type 목록을 열고 Subscribe를 선택하세요. 서버를 수동으로 입력할 때 사용하는 Host, Port 등의 필드가 아니라 구독용 필드가 표시되는지 확인합니다. 유형을 확인한 다음 보유한 전체 구독 링크를 URL에 입력하세요.
- 서비스 제공처에서 기존 구독의 원본 링크를 복사하세요. 앞뒤가 잘리지 않았는지 확인하고, 공백이나 줄바꿈 또는 채팅 메시지의 설명 문구가 섞이지 않도록 주의하세요.
- Subscribe 양식의 URL에 링크를 입력하고, 필요하면 알아보기 쉬운 메모를 추가한 뒤 화면 오른쪽 상단의 완료 또는 저장 버튼을 누르세요.
- Home으로 돌아와 구독 정보를 가져올 때까지 기다린 다음 해당 그룹에 서버 항목이 표시되는지 확인하세요. 그룹만 보이고 항목이 없다면 먼저 오류 안내가 있는지 확인하고, 같은 주소를 바로 다시 추가하지 마세요.
구독 링크에는 로그인 정보가 포함되는 경우가 많으므로 비밀번호처럼 안전하게 보관하세요. 전체 링크를 공개 페이지, 스크린샷 또는 진단 기록에 올리지 마세요. 이 페이지에서도 링크를 제출할 필요가 없습니다. 복사한 주소가 클라이언트가 읽을 수 있는 구독 URL이 아니라 웹페이지 주소라면 Safari에서 열리더라도 Subscribe로 가져올 수 있다는 뜻은 아닙니다.
서버 정보가 있는 경우: Type에 맞춰 입력
호스트, 포트 및 인증 정보가 있다면 Add Server에서 정보와 일치하는 Type을 먼저 선택하세요. 프로토콜마다 표시되는 필드가 다르므로 비밀번호 하나만 보고 유형을 추측해서는 안 됩니다. 공식 스크린샷의 양식을 예로 들면 Host에는 서버 주소, Port에는 포트 번호를 입력하고 Password와 Method는 원본 정보와 일치시켜야 합니다. 다른 유형에는 별도의 인증, 전송 또는 TLS 필드가 필요할 수 있습니다.
호스트 형식의 예로 example.com을 들 수 있습니다. 이는 도메인 형식을 보여 주는 예일 뿐, 연결 가능한 서버 주소가 아닙니다. 웹 경로가 포함된 전체 URL을 호스트 이름만 받는 필드에 입력하지 말고, 구독 링크의 매개변수를 나눠 서버 인증 정보로 사용하지도 마세요. 제공되지 않은 옵션은 우선 현재 값으로 두세요. 특정 매개변수가 필요하다면 보유한 서비스 정보의 출처에 확인하세요.
QR 코드가 있다면 Add Server에서 Scan QR Code를 사용할 수 있습니다. 스캔 후에도 Type과 서버 정보가 올바른지 확인하세요. Import from Cloud JSON은 해당 형식의 정보를 가져올 때 사용하는 기능이며, 임의의 구독 주소를 가져오는 범용 메뉴가 아닙니다. 저장한 뒤 Home으로 돌아가 항목이 표시되는지 확인하고 라우팅 모드를 선택하세요. ‘저장 완료’는 정보가 입력되었다는 뜻일 뿐, 연결이 확인된 것은 아닙니다.
단계 02 / 트래픽 처리 방식 선택
Global Routing: Config / Proxy / Direct
서버 항목은 ‘어디에 연결할지’를, Global Routing은 ‘각 연결을 어떻게 처리할지’를 정합니다. 두 항목을 각각 확인해야 합니다.
Home으로 돌아가 Global Routing을 눌러 현재 모드를 확인하세요. 먼저 기존 선택을 기록한 뒤 테스트 목적에 맞게 조정합니다. ‘구독을 가져왔다’는 것과 ‘분할 라우팅 규칙을 설정했다’는 것은 서로 다른 작업입니다. 구독은 보통 서버 항목을 업데이트하는 데 사용하며, Config의 구성 파일에는 규칙 등의 설정이 포함될 수 있습니다. 두 기능의 역할은 다릅니다.
- Config: 현재 선택된 구성의 규칙에 따라 트래픽 처리 방식을 결정합니다. 평소처럼 분할 라우팅을 사용할 때 선택하지만, 먼저 현재 어떤 구성이 선택되어 있는지와 대상 연결이 어떻게 처리될지 확인해야 합니다.
- Proxy: 선택한 Proxy를 통해 클라이언트가 처리하는 연결을 보냅니다. 처음 서버가 작동하는지 점검할 때는 규칙 분할에 따른 변수를 줄이기 위해 잠시 사용할 수 있지만, 서버 정보와 네트워크 확인을 대신하지는 않습니다.
- Direct: 원격 Proxy를 거치지 않고 직접 연결합니다. 기본 네트워크 상태를 비교할 때 적합하지만 원격 서버 연결 성공 여부를 판단하는 데 사용해서는 안 됩니다.
Config 사용 전 현재 구성을 확인하세요
Config 페이지를 열어 구성 파일 목록과 현재 선택된 항목을 확인하세요. 구성 파일을 편집하면 General, Rule, Hosts 등의 구역을 볼 수 있습니다. 오른쪽의 공식 스크린샷은 구성 편집 화면이며 Home의 Global Routing 선택 메뉴가 아닙니다. 파일을 열거나 편집하는 것만으로 해당 파일이 현재 구성으로 선택되는 것은 아닙니다. 목록으로 돌아와 선택 상태를 다시 확인하세요.
처음 설정할 때 Add Rule을 바로 열 필요는 없습니다. 신뢰할 수 있는 본인 정보 출처에서 받은 구성이 있다면 설명을 먼저 읽고 원본 파일을 보존하세요. 규칙은 보통 순서대로 일치 여부를 확인하므로 앞에서 일치한 결과가 트래픽 경로를 결정할 수 있습니다. 마지막 규칙 하나만 보고 모든 웹사이트가 같은 서버를 거친다고 단정하지 마세요.
예를 들어 DOMAIN-SUFFIX,example.com,PROXY는 해당 도메인 접미사에 PROXY 정책을 적용한다는 의미입니다. FINAL,PROXY는 앞선 규칙과 일치하지 않은 연결을 처리하는 데 사용됩니다. 이는 규칙의 의미를 설명하기 위한 예이며, 전체 구성을 교체하라는 뜻이 아닙니다. 규칙 키워드 설명은 용어집에서, Config와 Settings의 자세한 내용은 옵션 매뉴얼에서 확인하세요.
이 단계가 끝나면 현재 선택한 모드와 예상 결과를 설명할 수 있어야 합니다. 방금 추가한 서버만 확인하는 경우에는 먼저 Config 상태를 기록한 뒤 잠시 Proxy를 선택해도 됩니다. 확인을 마치면 필요에 따라 Config로 되돌리세요. 한 번에 조건 하나만 바꾸면 서버 문제와 규칙 문제를 구분하기 쉽습니다.
단계 03 / 시스템 연결 설정
Home: 서버를 선택한 뒤 연결 스위치 켜기
선택한 항목과 라우팅 모드를 먼저 확인한 다음 시스템 VPN 구성 승인을 진행하세요. 승인, 연결 설정 및 실제 접속은 각각 별개의 단계입니다.
Home으로 돌아가 SERVER 또는 구독 그룹에서 테스트할 항목을 선택하고 선택 표시가 대상 항목에 있는지 확인하세요. 목록에 서버가 보인다고 해서 현재 사용 중인 서버라는 뜻은 아닙니다. 여러 그룹을 가져온 경우 하나만 선택하고, 결과를 확인하는 동안에는 항목을 계속 바꾸지 마세요.
- Global Routing이 앞 단계의 테스트 계획과 일치하는지 확인한 다음 Home 상단의 연결 스위치를 켭니다. 연결되지 않은 상태에서는 상단에 Not Connected 등의 상태 메시지가 표시됩니다.
- 처음 연결을 요청하면 시스템에 VPN 구성 추가 안내가 표시될 수 있습니다. 방금 실행한 Shadowrocket 작업에서 나온 안내인지 확인하고 내용을 읽은 뒤 허용을 선택한 다음 시스템 안내에 따라 기기 인증을 완료하세요.
- 앱으로 돌아와 상단 상태와 스위치가 계속 켜져 있는지 확인하세요. 스위치가 곧바로 꺼지면 당시 오류 정보를 보존하고 이 페이지의 설정 및 문제 해결로 이동하세요. 승인을 계속 반복하지 마세요.
VPN 구성 승인을 완료하면 앱이 시스템 네트워크 확장을 통해 연결을 처리할 수 있습니다. 하지만 입력한 서버가 확인되었다는 뜻도, 특정 웹사이트에 접속할 수 있다는 뜻도 아닙니다. 앞서 허용하지 않았다면 연결 스위치를 다시 켤 때 표시되는 안내에 따라 진행하세요. 필요한 경우 시스템의 ‘설정 → 일반 → VPN 및 기기 관리’에서 관련 VPN 항목을 확인하세요. 시스템 버전에 따라 메뉴 이름이 다를 수 있으므로 현재 기기 화면을 기준으로 확인하세요.
시스템 설정을 확인할 때 다른 용도의 관리 구성을 함부로 삭제하지 마세요. 회사나 학교에서 관리하는 기기에서 VPN 구성 추가가 제한되어 있다면 앱의 서버 필드를 반복해서 수정하지 말고 기기 관리 정책을 먼저 확인하세요. 구성을 추가할 수 있는지와 원격 서비스를 사용할 수 있는지는 별개의 문제입니다.
연결 스위치가 켜진 상태를 유지하면 다음 단계에서 실제 접속을 확인하세요. 시스템 VPN 표시는 연결 상태만 나타낼 뿐, 어떤 규칙이 적용되었는지는 알려 주지 않습니다. 다른 VPN 연결이 작동 중이라면 현재 네트워크를 처리하는 연결이 무엇인지 먼저 확인한 뒤 Shadowrocket 상태를 판단하세요. 상태 표시줄 아이콘만으로 결론을 내리지 마세요.
단계 04 / 실제 결과 확인
Connectivity Test: 테스트 결과와 실제 접속을 함께 확인
연결을 켠 뒤 현재 Wi-Fi 또는 셀룰러 네트워크가 정상적으로 인터넷에 연결되는지 먼저 확인하세요. 웹 로그인 인증이 필요한 네트워크라면 먼저 인증을 완료한 다음 Shadowrocket으로 돌아오세요. 그렇지 않으면 구독 가져오기, 테스트, 웹페이지 접속 실패가 모두 같은 기본 네트워크 문제에서 비롯될 수 있으며 서버 정보가 잘못되었다고 단정할 수 없습니다.
앱 내 테스트를 먼저 실행한 뒤 대상 페이지 열기
- Home에서 Connectivity Test를 누르고 테스트가 끝날 때까지 기다린 다음 선택한 항목의 결과를 확인하세요. 테스트 중에는 서버를 바꾸거나 Global Routing을 수정하지 마세요.
- 결과의 의미가 불분명하면 Settings에서 Test Method를 확인하세요. 테스트 방식마다 확인하는 단계가 다릅니다. 모든 수치를 실제 웹페이지 속도로 해석하지 말고 현재 테스트 방식에 맞춰 결과를 살펴보세요.
- Safari를 열고 어떻게 처리되어야 하는지 명확히 알고 있는 대상 페이지에 접속해 새로고침하거나 새 페이지를 열어 보세요. 현재 모드를 고려해 결과를 판단하고 이미 로드된 캐시 페이지에만 의존하지 마세요.
테스트 결과가 있다는 것은 해당 테스트 조건에서 응답을 받았다는 뜻일 뿐, 전체 Proxy 연결, 도메인 이름 확인 또는 모든 웹사이트 요청이 정상적으로 완료된다는 뜻은 아닙니다. 반대로 한 가지 테스트가 실패했다고 해서 모든 사용 상황에서 서버를 사용할 수 없다고 단정할 수도 없습니다. 같은 테스트를 반복하기보다 테스트 방식과 실제 접속 결과, 오류 기록을 함께 확인하세요.
Config 사용 시 적용된 정책도 확인
현재 Config를 사용 중이라면 DIRECT로 처리될 것으로 예상되는 대상과 PROXY로 처리될 것으로 예상되는 대상을 각각 하나씩 확인하세요. 둘 다 열리더라도 같은 경로를 거쳤다는 뜻은 아닙니다. 추가 확인이 필요하면 앱에서 제공하는 연결 기록이나 Log를 살펴보고 대상 도메인, 일치한 규칙, 정책 결과를 함께 확인하세요. 표시되는 기록 항목은 현재 앱에서 제공하는 내용을 기준으로 합니다.
Proxy에서는 접속되지만 Config로 바꾸면 실패하는 경우 현재 구성, 규칙 순서, DNS 관련 설정을 먼저 확인하세요. 서버 정보를 전부 다시 입력할 필요는 없습니다. Proxy에서도 실패한다면 모드를 그대로 둔 채 선택한 서버, 매개변수, 기본 네트워크를 확인하세요. 이렇게 하면 원격 연결 실패와 분할 라우팅이 예상대로 작동하지 않는 문제를 나눠서 살펴볼 수 있습니다.
단계 05 / 실패 지점별 재확인
Settings: 기존 값을 유지하고 변수 하나씩 점검
가져오기, 승인, 연결, 접속 중 어느 단계에서 실패했는지 먼저 판단한 뒤 설정을 조정할지 결정하세요. 모든 스위치를 한꺼번에 켜지 마세요.
구독에 항목이 없으면 가져오기 과정부터 확인
Subscribe를 저장한 뒤 서버가 생성되지 않으면 URL이 완전한지, 현재 네트워크에서 구독 주소에 접속할 수 있는지, 기존 구독이 유효한지 먼저 확인하세요. 웹페이지는 열리지만 가져오기에 실패한다면 계정 관리 페이지가 아닌 구독 콘텐츠 주소를 받은 것이 맞는지도 확인해야 합니다. 서버 항목을 가져오지 못한 상태에서는 Global Routing을 바꿔도 구독 형식이나 인증 문제를 해결할 수 없습니다.
같은 URL을 계속 새로 추가해 해결하려 하지 마세요. 구분하기 어려운 중복 그룹이 생길 수 있습니다. 원본 정보를 보관하고 화면에 표시된 오류 유형을 기록하세요. 유효 기간이나 링크 형식을 확인해야 한다면 보유한 서비스 정보의 출처에 문의하세요. 구독을 삭제하고 다시 추가하기 전에는 직접 수정한 정보가 포함되어 있는지 확인하세요.
항목은 있지만 연결되지 않으면 정보와 승인을 확인
직접 추가한 항목은 Type, Host, Port 및 인증 정보를 하나씩 대조하세요. 복사할 때 공백이 들어갔는지, 대소문자가 다른지, 전송 또는 TLS 매개변수가 빠졌는지도 확인해야 합니다. 프로토콜마다 필요한 정보가 다르므로 다른 유형 양식의 기본값을 현재 서비스에 필요한 값으로 간주하지 마세요. 구독으로 생성된 항목이라면 여러 필드를 직접 덮어쓰기 전에 구독을 업데이트하고 정보를 확인해 보세요.
연결 스위치가 켜진 상태를 유지하지 못하면 시스템 VPN 구성 승인이 완료되었는지, 앱이 연결 오류를 표시하는지 먼저 구분하세요. 승인이 거부된 것과 서버가 연결을 거부한 것은 서로 다른 문제입니다. 관련 VPN 항목을 실수로 삭제했다면 Shadowrocket으로 돌아가 다시 연결을 시도하고 시스템 안내에 따라 승인하세요. 기기 관리 제한이 있는 경우 해당 정책을 따르세요.
연결은 켜졌지만 접속에 실패하면 규칙과 DNS 확인
먼저 Direct가 선택되어 있지 않은지 확인하고 Home에서 선택한 서버도 다시 확인하세요. 일부 도메인만 실패한다면 도메인과 오류 양상(이름 확인 실패, 연결 시간 초과, 페이지 리소스 일부 로드 실패 등)을 기록한 뒤 Config의 규칙 경로와 대조하세요. 웹페이지 하나가 열리지 않는다는 이유로 모든 DNS 옵션을 바꾸지 말고, 문제 해결을 위해 HTTPS Decryption을 함부로 켜지도 마세요.
DNS는 도메인 이름을 확인하는 방식을 결정하고 라우팅 규칙은 연결 처리 방식을 결정하므로 두 요소가 결과에 함께 영향을 줍니다. Config와 Proxy를 비교해야 한다면 기존 모드를 기록하고 같은 네트워크와 같은 대상으로 테스트한 다음 원래 값으로 되돌리세요. 원인을 파악할 수 있도록 테스트 중에는 한 번에 하나만 변경하세요. DNS, 규칙, 로그에 관한 자세한 내용은 옵션 매뉴얼에서 확인하세요.
Settings: 의미를 확인한 뒤 값을 변경
공식 스크린샷의 Settings에는 Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP, UDP 등의 메뉴가 있습니다. Test Method는 연결 테스트 결과를 해석하는 데 영향을 줍니다. On Demand는 조건에 따라 연결을 시작하는 기능이므로 수동 연결을 확인한 뒤 설정하는 것이 좋습니다. Today Widget은 빠른 접근 관련 설정이며 서버 연결을 복구하는 단계는 아닙니다.
Diagnostics는 문제 해결에 필요한 단서를 수집하는 데 사용할 수 있습니다. 다만 명확한 실패 작업 한 건을 중심으로 기록을 확인하세요. 작업 순서를 먼저 적고 문제를 다시 재현하면 여러 서버를 연속으로 전환한 뒤 마지막 안내만 남기는 일을 피할 수 있습니다. 기록을 공유하기 전에 전체 구독 링크, 비밀번호, 인증 정보 및 기타 개인정보를 삭제하세요. 이 안내에서는 해당 정보를 공개 제출하라고 요구하지 않습니다.
기존 서버 하나로 예상한 접속이 가능해지면 재현 가능한 설정을 유지하고 On Demand나 다른 편의 기능을 차례로 설정하세요. 다시 테스트할 때는 이 페이지의 확인 순서를 따르세요. 앱을 반복해서 삭제하거나 구성을 전부 다시 만들 필요는 없습니다. 구매, 승인 및 구독 업데이트에 관한 내용은 자주 묻는 질문에서, Subscribe, Config, PROXY, DIRECT의 차이는 용어집에서 확인하세요.
