Add Server: 서버 추가 및 구독 가져오기
Shadowrocket을 연 다음 먼저 Home 화면에 머물고, 상단 연결 스위치는 아직 켜지 마세요. 아래의 SERVER 영역에서 항목이 있는지 확인합니다. 기존 항목이 있다면 어떤 정보에서 가져온 것인지 먼저 확인하세요. 목록이 비어 있다면 보유한 정보를 바탕으로 수동 추가 또는 구독 가져오기를 선택합니다. 두 방법 중 알맞은 하나만 사용하면 되며, 같은 정보를 중복으로 추가할 필요는 없습니다.
서버 하나를 수동으로 입력
Home에서 Add Server를 탭해 추가 화면으로 이동합니다. 먼저 Type을 열고 보유한 서버 정보에 맞는 프로토콜 유형을 선택합니다. Type에 따라 이후 표시되는 필드가 달라지므로, 모든 내용을 입력한 뒤 유형을 바꾸지 마세요. 서버 이름만 보고 프로토콜을 추측해서도 안 됩니다.
이어서 Host와 Port를 입력합니다. Host에는 서버 주소를, Port에는 포트 번호를 입력합니다. 프로토콜 접두사, 경로, 쿼리 매개변수가 포함된 전체 구독 링크를 Host에 넣지 마세요. 현재 Type에 Password, Method 등의 필드가 표시되면 원본 정보에 따라 각각 입력하고 대소문자와 앞뒤 공백에 유의합니다. 프로토콜마다 인증 필드가 다르므로 스크린샷에 표시된 필드가 모든 Type에 공통으로 필요한 것은 아닙니다.
내용을 확인한 뒤 화면의 저장 기능을 사용하고 Home으로 돌아갑니다. SERVER에 추가한 항목이 표시되는지 확인한 다음 탭하여 현재 항목으로 선택합니다. 저장한 뒤 항목을 찾을 수 없다면 즉시 다시 입력하지 말고 저장이 완료되었는지 먼저 확인하세요.
기존 구독 링크 사용
마찬가지로 Add Server에서 시작해 Type에서 Subscribe를 선택한 다음, 보유한 전체 구독 링크를 해당 URL 입력란에 붙여넣습니다. 붙여넣은 뒤 처음부터 끝까지 확인하세요. 특히 메신저에 함께 표시된 안내 문구, 줄바꿈, 따옴표, 마지막 문장 부호가 섞이지 않았는지 살펴봅니다. 링크의 인증 매개변수를 임의로 삭제하면 안 됩니다.
저장하고 가져오기가 완료될 때까지 기다린 후 Home으로 돌아와 해당 그룹과 항목을 확인합니다. 구독은 서버 정보 묶음을 관리하며 Config의 규칙 구성 파일과는 다릅니다. 목록에 항목이 생겼다는 것은 가져오기 단계의 결과일 뿐입니다. 계속해서 모드를 선택하고 연결을 확인해야 합니다. 나중에 정보를 새로 고치려면 해당 구독의 관리 기능에서 업데이트하세요. 같은 링크를 반복해서 추가해 여러 그룹을 만들지 않도록 합니다.
해당 QR 코드가 있다면 Scan QR Code를 사용하고 인식 결과를 확인할 수 있습니다. Import from Cloud JSON은 해당 형식의 정보에만 사용하며, 임의의 구독 링크를 대신 가져오는 기능이 아닙니다. 어떤 가져오기 방식을 사용하든 먼저 정보 유형을 확인한 뒤 알맞은 기능을 선택하세요. 스크린샷은 서버 주소, 계정 또는 비밀번호의 출처가 될 수 없습니다.
이 단계의 완료 기준: Home의 SERVER에 보유한 정보에 해당하는 항목이 있고 서버 하나를 선택할 수 있어야 합니다. 파싱 실패 안내가 표시되거나 목록이 비어 있다면 먼저 단계 05의 가져오기 문제 해결을 확인하세요. 링크 형식 문제를 해결하기 위해 Global Routing을 바꾸지 마세요.
Global Routing: Config, Proxy 또는 Direct 선택
서버를 추가한 다음 Home으로 돌아와 Global Routing을 탭합니다. 여기서는 클라이언트가 전달받은 트래픽을 처리하는 방식을 정합니다. 서버 매개변수를 수정하거나 규칙 파일을 만들어 주는 기능은 아닙니다. 세 가지 모드는 설정(Config), 프록시(Proxy), 직접 연결(Direct)입니다. 테스트 결과를 해석할 수 있도록 현재 선택한 항목을 먼저 파악하세요.
일상적으로 규칙 사용: 설정(Config)
설정(Config)은 현재 구성 파일의 규칙에 따라 요청을 처리합니다. 하단의 Config로 이동해 현재 사용 중인 구성을 확인하고 내용을 살펴봅니다. 구성 편집 화면에는 General, Rule, Hosts, URL Rewrite, HTTPS Decryption 등의 섹션이 표시됩니다. 각 섹션의 용도는 서로 다르므로 첫 연결을 위해 모든 항목을 수정할 필요는 없습니다.
먼저 Rule을 확인합니다. 규칙은 보통 순서대로 일치 여부를 확인하며, 일치한 뒤 적용되는 정책은 PROXY, DIRECT 또는 REJECT일 수 있습니다. 예를 들어 다음 행은 해당 도메인 접미사에 PROXY를 사용한다는 의미입니다. 문법 예시일 뿐 완전한 구성 파일이 아니며 서버 정보도 포함하지 않습니다.
DOMAIN-SUFFIX,example.com,PROXY
완성된 규칙 구성이 있다면 해당 파일을 먼저 선택한 후 Home으로 돌아와 Global Routing을 설정(Config)으로 지정합니다. 구독만 가져왔다고 규칙 파일까지 바뀌는 것은 아닙니다. 편집 화면에 Add Rule이 보인다는 이유로 규칙을 반복해서 추가하지 마세요. 기존 규칙이 대상 요청에 이미 적용되는지 먼저 확인합니다.
임시 비교: 프록시(Proxy)와 직접 연결(Direct)
프록시(Proxy)는 전체 프록시 방식으로 비교 테스트할 때 사용하며, 규칙 선택과 관련된 문제인지 확인하는 데 도움이 됩니다. 다만 현재 서버와 해당 매개변수가 정상 작동해야 합니다. 특정 대상에 반드시 접속할 수 있다는 보장은 없으며 비밀번호, 포트 또는 TLS 필드를 수정하지도 않습니다.
직접 연결(Direct)은 직접 연결 방식으로 비교할 때 사용합니다. 이 모드에서 대상이 열리더라도 현재 네트워크에서 해당 대상에 직접 접속할 수 있다는 의미일 뿐, 프록시 서버가 정상이라는 뜻은 아닙니다. 비교를 마친 후에는 Global Routing을 원래 사용할 예정이던 설정(Config)으로 되돌려 임시 테스트 상태를 일상 설정으로 사용하지 않도록 합니다.
첫 연결을 확인할 때 HTTPS Decryption을 켜거나 인증서를 설치할 필요는 없습니다. 기존 구성에 필요한 설정은 유지하고 “서버가 작동하는지”와 “규칙이 일치하는지”를 나누어 확인하세요. 프로토콜 필드와 설정 선택에 대해 더 알아보려면 프로토콜 자세히 보기를 확인하세요. 테스트만을 위해 서버와 맞지 않는 Type으로 바꾸지 마세요.
Home: 상단 연결 스위치 켜기
모드를 선택한 다음 Home으로 돌아와 SERVER에서 현재 선택된 항목을 다시 확인합니다. 구독에 여러 항목이 있다면 가져오기 완료와 서버 선택은 별개의 단계입니다. 이번 테스트에 사용할 항목을 분명히 선택해 서로 다른 항목의 결과를 혼동하지 않도록 합니다.
Home 상단의 연결 스위치를 탭합니다. 처음 연결할 때 iPhone / iPad에 VPN 구성 추가를 요청하는 시스템 안내가 표시될 수 있습니다. 안내가 Shadowrocket에서 표시된 것인지 확인하고 시스템 절차에 따라 허용한 다음 클라이언트로 돌아옵니다. 시스템에서 기기 인증을 요청하면 절차를 완료하세요. 이 단계에서 허용하는 것은 기기의 네트워크 구성 권한이며, 회선 서비스를 구매하거나 활성화하는 것이 아닙니다.
Home으로 돌아와 상단 상태가 여전히 Not Connected인지 확인합니다. 스위치를 켠 직후 꺼지거나 시스템 권한 승인이 완료되지 않았다면 먼저 권한 및 연결 설정 문제를 해결하세요. 이를 특정 웹사이트의 규칙 일치 실패로 판단하면 안 됩니다. 구성을 이미 허용한 기기에서는 매번 같은 안내가 표시되지 않을 수 있습니다.
기기에서 네트워크를 제어하는 다른 VPN 구성이 활성화되어 있다면 테스트에 실제로 어떤 구성이 사용되는지 먼저 확인하세요. 조직에서 관리하는 기기는 VPN 설정이 제한될 수 있습니다. 이러한 제한은 기기 관리자에게 확인해야 하며, 구성을 반복해서 삭제해 우회하려고 해서는 안 됩니다.
연결 상태가 바뀌면 다음 단계에서 실제 요청을 확인합니다. 시스템에 VPN 상태가 표시되거나 클라이언트 스위치가 켜져 있다는 것만으로는 원격 인증 성공, DNS 정상 작동 또는 모든 규칙이 예상대로 적용되었음을 증명할 수 없습니다.
이 단계의 완료 기준: 시스템 권한 승인 절차를 완료하고 Home 상태가 Not Connected에 머물지 않아야 합니다. 상태는 정상인데 페이지가 열리지 않는다면 현재 서버를 그대로 유지하고 다음 단계에서 구체적인 결과를 확인하세요.
Connectivity Test: 예상대로 작동하는지 확인
Home에서 Connectivity Test를 탭하고 이번 테스트가 끝날 때까지 기다립니다. 테스트 결과는 사용한 테스트 방법, 대상 및 현재 네트워크에 따라 달라질 수 있으므로 참고 자료로 활용하세요. 한 번 성공했다고 모든 앱이 정상 작동한다고 판단하지 마세요. 먼저 테스트가 완료되었는지 또는 시간 초과되었는지 기록한 다음 실제 사용 상황을 확인합니다.
- 실제로 접속해야 하는 페이지를 엽니다. 브라우저에서 새 요청을 보내고 이미 캐시된 페이지에만 의존하지 마세요. 특정 페이지만 실패한다면 클라이언트 전체를 재설정하기 전에 해당 대상이 정상인지 확인합니다.
- 테스트 당시의 Global Routing을 확인합니다. 설정(Config)에서는 규칙에 따라 요청이 DIRECT로 처리될 수 있습니다. 페이지가 열려도 반드시 PROXY를 사용했다는 뜻은 아닙니다. 프록시(Proxy)와 직접 연결(Direct)의 비교 결과도 각각 기록합니다.
- 요청 기록에서 처리 경로를 확인합니다. 앱에서 확인할 수 있는 요청 기록에서 방금 접속한 도메인을 찾아 일치한 규칙과 정책을 확인합니다. 기록은 새 요청이 발생해야 표시됩니다. 기록이 없다면 연결이 켜져 있는지, 요청을 새로 보냈는지 먼저 확인합니다.
- 일상 설정으로 되돌린 후 다시 테스트합니다. 문제 해결을 위해 모드를 임시로 바꿨다면 설정(Config)으로 복원하고 같은 대상을 다시 테스트해 모드에 따라 문제가 달라지는지 확인합니다.
예를 들어 설정(Config)에서 특정 로컬 대상이 DIRECT로 처리되는 것은 규칙이 정상 적용된 결과일 수 있습니다. REJECT가 적용된 요청은 서버에 연결할 수 없다고 단정하기보다 해당 규칙이 의도한 사용 방식에 맞는지 확인해야 합니다. 프록시(Proxy)에서는 접속할 수 있지만 설정(Config)에서는 안 된다면 현재 구성과 규칙 순서를 먼저 확인하세요.
비교 테스트 중에는 같은 서버, 같은 대상 및 같은 네트워크 연결을 유지하고 한 번에 조건 하나만 바꾸세요. 서버를 바꾸고 Wi-Fi를 변경하고 DNS까지 동시에 수정하면 현상은 달라질 수 있지만 실제 원인을 파악하기 어렵습니다. 확인을 마친 뒤 연결을 한 번 껐다가 다시 켜서 저장된 설정이 적용되었는지, 아직 적용되지 않은 편집 내용이 아닌지 확인할 수 있습니다.
이제 연결 상태, 실제 접속 결과 및 규칙 기록이 서로 일치한다면 첫 설정이 완료된 것입니다. 자동 연결이나 세부 규칙 조정은 이후에 진행하세요. 설정을 완성하기 위해 모든 옵션을 켤 필요는 없습니다.
Settings: 일반적인 실패 원인과 확인 순서
문제 해결을 시작할 때 먼저 현상을 구체적으로 설명합니다. 구독을 저장할 수 없는지, SERVER가 비어 있는지, 테스트 시간이 초과되는지, 스위치가 자동으로 꺼지는지, 연결 후 일부 요청만 실패하는지 확인하세요. 현상에 따라 확인할 위치가 다릅니다. 다음 순서대로 확인하면 모든 정보를 처음부터 삭제하고 다시 설정할 필요가 없습니다.
구독 가져오기 실패 또는 목록이 비어 있음
구독 항목으로 돌아가 전체 URL을 확인합니다. Host에 붙여넣지 않았는지, 일반 웹페이지 주소를 구독 주소로 사용하지 않았는지 확인하세요. 보유한 구독이 아직 유효한지, 현재 네트워크에서 해당 주소에 요청을 보낼 수 있는지도 확인합니다. 업데이트 요청에서 인식할 수 있는 내용을 받지 못했다면 Global Routing을 바꿔도 원격 서버가 반환한 형식은 수정되지 않습니다. 자세한 확인 방법은 구독 파싱 실패 또는 빈 목록 안내를 참고하세요.
항목은 있지만 테스트 실패
현재 선택된 항목을 먼저 확인한 다음 해당 항목의 편집 화면에서 Type, Host, Port 및 인증 필드를 확인합니다. TLS 또는 추가 매개변수가 필요한 유형은 원본 정보를 하나씩 대조하고, 경험에 따라 임의로 값을 입력하지 마세요. 비밀번호, UUID, 키 등의 필드는 용도가 다르므로 서로 대신 사용할 수 없습니다. 계속 실패한다면 구성을 유지한 상태에서 Wi-Fi와 셀룰러 네트워크를 각각 테스트하고 네트워크에 따라 현상이 달라지는지 기록하세요.
테스트 결과와 실제 접속 결과가 다름
Settings에서 Test Method를 확인합니다. 테스트 방식에 따라 측정 대상이 다르므로 한 방식의 실패만으로 모든 실제 요청이 실패한다고 판단할 수 없습니다. 하나의 방식을 고정해 비교한 다음 브라우저 요청 및 규칙 기록을 함께 확인하세요. 목록의 테스트 결과 하나만 보고 서버를 연속해서 바꾸지 마세요.
연결 후 일부 요청만 문제 발생
Global Routing으로 돌아가 프록시(Proxy)를 잠시 비교 테스트에 사용합니다. 설정(Config)에서만 문제가 발생한다면 현재 선택된 Config, Rule에서 먼저 일치하는 항목 및 최종 정책을 먼저 확인하세요. 도메인 확인 오류라면 구성의 DNS 관련 설정을 확인합니다. 모든 필드를 동시에 바꾸지 마세요. Proxy, TCP, UDP 관련 옵션을 확인할 때도 문제가 해당 트래픽 유형과 관련 있는지 먼저 확인해야 합니다.
자동 재연결 및 On Demand
직접 연결을 끈 후 다시 연결되는 경우 Settings에서 On Demand를 확인합니다. 설정된 조건에 따라 연결을 시작하는 기능이며 서버 정보가 올바른지 확인해 주지는 않습니다. 처음 문제를 해결할 때 기존 조건을 기록해 두세요. 해당 조건이 수동 비교를 방해한다면 테스트 중 잠시 비활성화하고, 테스트가 끝나면 필요에 따라 다시 설정합니다. 수동 연결이 정상 작동하는 것을 확인한 후 On Demand를 설정하면 트리거 조건과 서버 문제를 함께 점검하지 않아도 됩니다.
추가 확인을 위해 기록할 정보
Settings에서 Diagnostics 관련 항목을 확인하고, 문제가 발생했을 때 사용한 네트워크, Global Routing 모드, 프로토콜 Type, 특정 대상에만 영향을 주는지 및 구체적인 오류 문구를 기록할 수 있습니다. 진단 정보를 공유하기 전에 구독 링크의 인증 매개변수, 비밀번호, 키 및 개인 네트워크 주소를 가리세요. 전체 구독 링크에는 접근 권한이 포함될 수 있으므로 공개 스크린샷에 올리지 마세요.
원본 정보가 만료되었거나 원격 서버에서 인증을 거부했다면 기존 서비스를 제공한 곳에 상태를 확인하세요. 클라이언트를 다시 설치해도 원격 권한이 복구되지는 않습니다. 다시 설정하려면 이 페이지의 추가 및 가져오기 단계로 돌아가세요. 프로토콜 필드의 의미와 선택 기준은 프로토콜 자세히 보기에서 확인할 수 있습니다. 모든 설정을 한 번에 바꾸기보다 “어느 단계에서 실패했는지”를 구체적으로 설명하는 편이 원인을 찾기 쉽습니다.