Shadowrocket 공식 가이드

Shadowrocket Settings 설정 가이드

각 설정 항목의 적용 범위, 초기값, 확인 방법을 살펴봅니다. 처음 설정한다면 빠른 시작 가이드에서 가져오기, 연결, 확인 절차를 먼저 완료하세요. 이미 연결할 수 있고 특정 항목을 조정하려는 경우 아래 목차에서 필요한 내용을 바로 확인하면 됩니다.

iPhone / iPad 화면을 기준으로 설명합니다. 시스템 요구 사항은 App Store 페이지에 표시된 내용을 확인하세요. iPhone / iPad용은 App Store에서 $2.99에 한 번 결제하면 이용할 수 있습니다. Mac(Apple 실리콘 및 Intel) / Windows / Android / Linux용은 무료이며, 설치 파일은 사이트의 /dl/에서 받으세요. 다운로드 경로와 플랫폼별 설치 방법은 앱 다운로드를 확인하세요.

01 설정 기준

초기값과 Global Routing

초기값, 상속값, 현재값을 구분하세요

Shadowrocket을 열면 먼저 Home에 표시된 연결 상태와 선택된 서버, Global Routing 모드를 기록한 다음 Config에서 실제로 활성화된 설정을 확인하세요. 목록에 파일이 보인다는 것은 저장되어 있다는 뜻일 뿐, 현재 연결에 사용 중이라는 의미는 아닙니다. 마찬가지로 서버가 SERVER 목록에 있어도 모든 규칙이 해당 서버로 트래픽을 보내는 것은 아닙니다. 문제를 확인할 때는 이 항목들을 각각 기록하는 편이 단순히 “연결됨”만 적는 것보다 유용합니다.

이 가이드에서 ‘초기값’은 변경 전 화면에 표시되는 상태나, 필드가 설정되지 않았을 때 시스템과 활성 설정에 따라 결정되는 동작을 뜻합니다. 모든 기기에서 같은 숫자로 고정되는 값은 아닙니다. 구독 업데이트, 파일 변경, 이전 기기에서의 복원으로 기존 매개변수가 현재 환경에 적용될 수 있습니다. 화면에 기본값이 명확히 표시되지 않으면 빈칸이나 기존 상태를 유지하고 예시와 똑같이 하려고 숫자를 입력하지 마세요. 비교하려면 먼저 기존 값이 비어 있었는지 기록하세요. 같은 숫자를 직접 입력하는 것과 기본 동작을 그대로 상속하는 것은 항상 동일하지 않습니다.

세 가지 모드 선택 방법

화면 및 모드사용 상황이것만으로 판단할 수 없는 점
Config(설정)활성 파일을 확인한 뒤 평소에는 규칙에 따라 트래픽을 분기합니다.서버 목록만으로 개별 요청의 경로를 판단할 수 없습니다.
Proxy(프록시)현재 프록시로 같은 대상에 접속할 수 있는지 잠시 비교합니다.이 결과만으로 기존 라우팅 규칙이 잘못됐다고 판단할 수 없습니다.
Direct(직접 연결)현재 네트워크에서 대상에 직접 연결되는지 잠시 비교합니다.시스템 VPN 연결을 끄는 것과는 다릅니다.

평소 트래픽을 분기하려면 Config를 사용하는 것이 좋으며, 사용 가능한 설정이 있는지 먼저 확인하세요. 특정 사이트에 접속할 수 없다면 기존 모드에서 문제를 재현한 뒤 네트워크, 서버, 접속 대상을 그대로 둔 채 모드만 바꿔 다시 테스트하세요. Proxy는 되지만 Config가 안 된다면 규칙 매칭과 정책 경로를 확인하세요. 두 모드 모두 안 된다면 규칙부터 바꾸지 말고 프록시 경로가 사용 가능한지 확인하세요. Direct도 실패하면 대상 서비스, 네트워크 연결 또는 DNS 결과를 별도로 살펴보세요. 테스트가 끝나면 원래 모드로 되돌려 임시 변경이 이후 접속에 영향을 주지 않도록 하세요.

최소 규칙 예시와 되돌리기

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

이 예시는 규칙 순서를 설명하기 위한 것으로, 완성된 설정 파일이 아닙니다. 첫 번째 규칙은 example.com 및 하위 도메인과 일치하는 요청을 PROXY로 보내고, 두 번째 규칙은 앞선 규칙에 일치하지 않는 요청을 DIRECT로 보냅니다. 규칙은 위에서부터 확인하므로, 범위가 좁은 규칙은 이를 덮어쓸 수 있는 일반 규칙보다 앞에 두고 FINAL은 마지막 대안으로 남겨 두세요. 웹페이지는 이미지, 로그인, API 리소스를 위해 다른 도메인에도 요청할 수 있습니다. 기본 도메인이 예상대로 매칭되어도 페이지 전체가 하나의 규칙만 사용한다는 뜻은 아니므로, 실제로 실패한 요청을 기준으로 확인하세요.

수정하기 전에 복구 가능한 설정 사본을 보관하고, 복사본에서 규칙 하나만 바꾸세요. 저장한 뒤 해당 사본이 실제로 활성화됐는지 확인하고, 규칙과 일치해야 하는 대상과 일치하면 안 되는 대상을 각각 테스트하세요. 두 결과가 모두 바뀌었다면 활성 파일을 잘못 선택했거나 일반 규칙을 너무 앞에 배치했는지 확인하세요. 원격 설정은 업데이트 시 파일 내용을 덮어쓸 수 있습니다. 장기간 유지할 로컬 변경 사항은 별도 사본에 기록하고, 업데이트 후 기억에 의존해 다시 작성하지 마세요. 설정 파일의 다른 섹션은 .conf 설정 파일 섹션 안내를 확인하세요.

앱은 한 번 구매하는 제품이며, 서버나 회선 이용권을 포함하지 않습니다. 구독 및 서버 정보는 이용 중인 서비스 제공업체에서 받으세요. 이 가이드는 해당 정보를 이미 가지고 있다는 전제로 작성되었습니다. 문제를 확인할 때 비공개 주소, 인증 정보, 전체 구독 링크를 공개 기록에 남기지 마세요.

변경이 효과가 있었는지 확인하려면 같은 문제가 변경 전에는 한 번 발생하고 변경 후에는 사라지는지 확인해야 합니다. 모드를 바꾸면서 네트워크까지 바꿨다면 결과가 라우팅 변경 때문인지 기존 네트워크가 복구된 탓인지 알 수 없습니다. 필요하면 원래 값으로 되돌려 같은 현상이 다시 나타나는지 확인하세요. 안정적으로 재현되지 않는 문제라면 당시 상태를 기록하고, 우연히 한 번 성공한 결과를 새 기본 설정으로 삼지 마세요.

02 DNS

DNS: 조회 경로, 적용 범위, 대체 동작

어디서 조회하는지 확인한 뒤 사용할 주소를 정하세요

DNS는 도메인 이름을 연결에 필요한 주소로 변환합니다. 도메인이 조회됐다는 것은 결과를 얻었다는 뜻일 뿐, 해당 주소에 연결할 수 있거나 트래픽이 의도한 정책을 따르는 것을 보장하지 않습니다. 반대로 서버가 작동해도 업무 도메인 하나의 DNS 조회가 시간 초과되면 웹페이지가 열리지 않을 수 있습니다. 이럴 때는 같은 네트워크에서 정상인 사이트와 문제가 있는 대상을 비교하고, 오류가 DNS 조회, 연결, 앱 응답 중 어느 단계에서 발생하는지 확인하세요.

먼저 활성 설정의 [General]과 [Host]를 확인하세요. 앞 항목에는 DNS 매개변수가 지정될 수 있고, 뒤 항목에는 특정 도메인의 로컬 매핑이 설정될 수 있습니다. 도메인 하나에서만 문제가 발생하고 해당 도메인에 매핑이 설정되어 있다면 매핑이 여전히 유효한지 먼저 확인하세요. DNS를 바꿔도 매핑으로 정해진 결과는 달라지지 않을 수 있습니다. 적용 중인 재정의 설정이 없다면 현재 시스템이나 설정에서 사용하는 조회 방식을 시작점으로 유지하는 것이 좋습니다. 비워 둔다고 조회가 중단되는 것은 아니며, 특정 공용 DNS 서비스가 사용 중이라고 단정할 수도 없습니다.

시스템 DNS, 사용자 지정 DNS, 암호화 DNS

시스템 DNS는 네트워크에서 사용 가능한 DNS 서비스를 제공할 때 적합하며, 문제를 해결한 뒤 기준 상태로 돌아갈 때 우선 고려할 방법이기도 합니다. 회사나 학교 네트워크는 자체 DNS에서만 내부 도메인을 제공할 수 있습니다. 공용 도메인 하나를 해결하려고 모든 요청을 외부 DNS로 바꾸면 내부 사이트까지 작동하지 않을 수 있습니다. 마찬가지로 로그인 페이지가 필요한 Wi-Fi에서는 먼저 시스템 네트워크 인증을 완료한 다음 DNS 변경이 필요한지 판단하세요. 인증 전후의 DNS 및 연결 조건은 다르므로 한쪽에서의 테스트로 다른 쪽을 대신할 수 없습니다.

사용자 지정 DNS가 필요하다면 용도를 명확히 알고 현재 네트워크에서 접속할 수 있는 서비스를 사용하세요. DoH나 DoT 같은 암호화 DNS는 DNS 서비스까지의 조회 전송을 보호하지만, 모든 앱 트래픽을 프록시로 보내거나 응답으로 받은 모든 주소에 연결되도록 해 주지는 않습니다. DNS 서비스 주소가 도메인 이름이라면 그 서비스의 주소를 먼저 조회하고 연결할 수 있어야 합니다. DNS 주소, 암호화 방식, 라우팅 규칙을 한꺼번에 바꾸지 마세요. 문제가 생겼을 때 세 요소가 모두 달라지면 무엇이 시간 초과를 일으켰는지 알기 어렵습니다.

권장 설정: 네트워크가 정상이라면 현재 값을 유지하세요. 문제가 DNS 단계에서 발생한다고 확인되고 대체 서비스가 현재 네트워크의 공용 및 내부 도메인을 모두 처리할 수 있을 때만 별도 값을 지정하세요.

오류 범위에 따라 확인 방법 선택

앱 하나에서만 문제가 생긴다면 같은 기기의 다른 앱으로 같은 대상에 접속해 앱 자체의 캐시나 DNS 조회 방식이 원인인지 비교하세요. 브라우저가 자체 암호화 DNS를 사용하거나 기존 연결을 재사용할 수 있으므로 다른 앱에서 정상 작동한다는 사실만으로 시스템 DNS에 문제가 없다고 단정할 수는 없습니다. 테스트 전에 새 요청을 한 번 보내고 도메인과 시간을 기록하세요. 캐시된 페이지가 보인다는 사실을 현재 연결이 된다는 증거로 삼지 마세요.

같은 도메인이 Wi-Fi에서는 실패하지만 셀룰러에서는 정상이라면 설정을 그대로 두고 네트워크 연결만 바꿔 관찰하세요. 대상 주소가 반환됐는데 연결이 계속 지연된다면 DNS 오류로 단정하지 말고 해당 주소까지의 경로를 확인하세요. 한 대상이 IPv4와 IPv6 주소를 모두 제공할 수 있습니다. 한쪽 경로에 문제가 있으면 주소 계열과 연결 대체 방식이 다른 앱에서 결과가 다르게 나타날 수 있습니다. 실제로 확인할 수 있는 주소 유형과 오류를 기록하고, 특정 주소 계열을 끄는 방법을 모든 기기의 일반 설정으로 사용하지 마세요.

DNS를 바꾼 뒤 광범위한 문제가 시작됐다면 먼저 변경 전 설정으로 되돌리고, 같은 모드와 네트워크에서 공용 도메인 하나와 기존에 작동하던 내부 도메인 하나를 다시 테스트하세요. 임시 재정의 항목을 삭제하는 것과 다른 주소로 바꾸는 것은 다릅니다. 되돌릴 때는 원래의 상속 상태로 복구하세요. 네트워크를 전환한 뒤 잠시 정상으로 돌아와도 문제가 해결됐다는 뜻은 아닙니다. 연결이 새로 설정된 영향일 수 있습니다. 같은 유형의 요청이 다시 발생할 때까지 기다려 이전 캐시 결과나 기존 연결이 테스트에 영향을 주지 않았는지 확인하세요.

마지막으로 변경 사항이 설정 파일에 저장됐는지, 기기에서 직접 조작했는지 기록하세요. 파일에 저장된 설정은 파일 교체 시 사라질 수 있고, 기기별 설정은 파일을 다른 기기로 복사해도 따라가지 않을 수 있습니다. 구독을 업데이트한 뒤 같은 문제가 다시 생기면 서버 선택부터 다시 시작하지 말고 활성 파일의 DNS 설정부터 비교하세요.

03 연결 조건

On Demand: 연결 조건과 상시 연결

On Demand는 연결 시점을 제어하며 접속 경로를 정하지 않습니다

On Demand를 사용하면 시스템이 조건에 따라 VPN 연결을 시작할지 결정합니다. 이는 Global Routing과 별개의 설정입니다. 전자는 언제 연결할지 결정하고, 후자는 연결 후 트래픽을 처리하는 방식에 영향을 줍니다. 특정 네트워크를 연결 조건으로 지정해도 지정한 도메인이 자동으로 PROXY를 이용하는 것은 아닙니다. 프록시 규칙을 추가해도 시스템의 On Demand 연결 조건을 대신하지 않습니다. 문제를 진단하기 전에 ‘연결이 시작되지 않은 것’인지 ‘연결은 됐지만 대상에 접속할 수 없는 것’인지 구분하세요.

처음에는 수동 연결을 유지하는 것이 좋습니다. Home에서 연결을 시작해 일반 대상과 특정 정책이 필요한 대상이 모두 예상대로 작동하는지 확인한 다음 Settings에서 On Demand를 살펴보세요. 시스템 설정을 복원했거나 설정을 복사한 기기에는 이미 연결 조건이 있을 수 있으므로, 새 기기처럼 보인다고 기능이 꺼져 있다고 가정하지 마세요. 현재 설정과 시스템 VPN 상태를 확인하세요. 수동으로 연결을 끊은 뒤 다시 연결된다면 기본 스위치를 반복해서 끄기보다 조건이 여전히 충족되는지 먼저 확인하세요.

확실히 확인할 수 있는 단일 상황부터 시작하세요

예를 들어 특정 네트워크 환경에서만 자동으로 연결하고 싶은지 목표를 분명히 정하세요. 화면에서 관련 조건을 제공하면 조건 하나로 시작하고 나머지는 그대로 두세요. 연결되어야 하는 상황과 연결되지 않아야 하는 상황을 하나씩 기록한 다음 각각 네트워크를 전환해 테스트하세요. 새 환경에 진입하면 시스템의 네트워크 연결이 완료됐는지 먼저 확인하고 연결이 시작되는지 살펴보세요. 네트워크를 막 전환한 직후에는 시스템이 주소를 받는 중일 수 있으므로 몇 초 지연된 것만으로 조건 적용 실패라고 단정하지 마세요.

조건이 Wi-Fi 네트워크 이름과 관련 있다면 라우터 위치나 별칭이 아니라 기기에 현재 연결된 네트워크 이름을 확인하세요. 이름이 같은 네트워크라도 서로 다른 기기에서 제공할 수 있습니다. 네트워크 이름은 연결 조건 매칭에만 사용할 수 있으며 네트워크의 신뢰성을 판별하는 기준은 아닙니다. 한 장소에서 여러 연결 방식이 가능하다면 테스트할 때 기기가 실제로 예상한 네트워크에 연결되어 있는지 확인하세요. 셀룰러로 전환된 것을 Wi-Fi 조건이 적용된 것으로 오해하지 않도록 주의하세요.

제외 조건도 별도로 테스트하세요. VPN이 이미 연결된 상태에서 해당 네트워크에 들어간 뒤 연결 상태가 유지되는 것만으로는 그곳에서 자동으로 연결이 시작된다고 볼 수 없습니다. 제어 가능한 환경에서 명확한 초기 상태로 시작해 기존 연결의 유지와 시스템의 신규 연결을 구분하세요. 조건 목록에서 여러 항목을 지원한다면 하나씩 추가하고 추가할 때마다 앞에서 테스트한 두 상황을 다시 확인하세요. 이렇게 하면 모든 조건을 설정한 뒤 복구 방법을 찾기 어려워지는 대신 새 조건과 기존 조건의 중복을 일찍 발견할 수 있습니다.

자동 재연결, 공용 네트워크, 배터리 소모

공용 Wi-Fi에 접속할 때 시스템에서 인증 페이지를 먼저 열어야 한다면 자동 연결로 인해 ‘인증 전 상태’와 ‘프록시 연결 실패’가 동시에 발생할 수 있습니다. 원인을 찾으려면 On Demand를 잠시 중지하고 수동으로 연결을 끊은 뒤 네트워크 인증을 완료하고 수동으로 다시 연결하세요. 서비스 접속이 정상인지 확인한 다음 기존 조건을 복구해 다시 테스트하세요. 테스트가 끝나면 원래 스위치를 복원하고, 임시 네트워크 때문에 유효한 다른 조건을 영구 삭제하지 마세요.

상시 연결과 On Demand 중 무엇을 사용할지는 실제 네트워크 전환 빈도와 사용 습관에 따라 결정하세요. On Demand가 반드시 배터리를 절약하는 것은 아닙니다. 조건 경계 때문에 연결이 반복해서 끊겼다 다시 연결되면 연결 과정에서 전력 소모가 늘 수 있습니다. 비교할 때 설정과 주요 사용 상황을 동일하게 유지하고, 비슷한 시간대에 시스템 배터리 사용량과 재연결 횟수를 함께 살펴보세요. 짧은 관찰 한 번으로 결론 내리지 마세요. 자세한 비교 방법은 On Demand와 배터리 소모 문제 해결을 확인하세요.

수동으로 연결을 끊은 뒤 다시 자동 연결되면 먼저 On Demand 조건이 여전히 충족되는지 확인한 다음 스위치 조작, 네트워크 전환, 연결 문제를 구분하세요.

잠자기에서 깨어난 뒤나 네트워크를 전환한 뒤에만 문제가 생긴다면 전환 전후의 네트워크 유형과 시스템 VPN 상태를 기록하세요. 같은 상황을 수동 모드에서도 테스트하세요. 수동 연결도 실패하면 새 네트워크와 프록시 경로를 먼저 진단하고, On Demand에서만 실패할 때 연결 시점과 조건을 확인하세요.

04 연결 테스트

Ping과 Connectivity Test: 결과 해석

수치가 어떤 대상과 방식을 나타내는지 먼저 확인하세요

Ping과 Connectivity Test는 연결 상태를 확인하는 도구지만, 실제로 어느 구간을 테스트하는지는 테스트 유형과 대상에 따라 다릅니다. 서버 주소를 확인한 결과만으로 프록시 연결을 설정한 뒤 대상 사이트에 접속할 수 있다고 볼 수는 없습니다. 특정 경로로 테스트 주소에 접속할 수 있어도 그 경로에서 모든 서비스를 이용할 수 있다는 뜻은 아닙니다. 특히 테스트에 지연 시간만 표시된다면 이름만 보고 반드시 ICMP를 사용한다고 추측하지 마세요. 화면에 표시된 방식과 테스트 대상, 현재 네트워크를 확인한 뒤 수치를 해석하세요.

기본적으로 앱에서 제공하는 테스트 방식과 대상을 유지하고, 같은 조건에서 먼저 결과를 확인하세요. 다른 사람이 제시한 테스트 주소나 시간 초과 값을 그대로 입력할 필요는 없습니다. 대상 서비스 자체가 자주 시간 초과되거나 특정 네트워크에서만 접속된다면 서버 간 비교에 대상의 차이가 영향을 줍니다. 꼭 바꿔야 한다면 예상 경로에서 정상 응답하고 접근 권한이 있는 대상을 선택하세요. 테스트 대상도 DNS 조회를 거친다면 DNS 문제 역시 결과에 반영될 수 있으므로, 지연 시간 테스트라는 이유만으로 DNS를 원인에서 제외하지 마세요.

같은 조건으로 비교하고 한 번의 측정값으로 순위를 매기지 마세요

실제로 테스트할 때는 Wi-Fi 또는 셀룰러 중 한 가지 연결을 고정하고, 네트워크를 많이 사용하는 대용량 전송을 중지한 다음 선택한 서버와 모드를 기록하세요. 같은 대상을 몇 차례 간격을 두고 테스트해 계속 실패하는지, 간헐적으로 시간 초과되는지, 전반적으로 느린지 구분하세요. 기존 서버 두 개를 비교하려면 같은 대상, 같은 방식, 비슷한 시간대에 테스트하세요. 한 번 빠른 결과는 기존 연결을 재사용한 것일 수 있고, 한 번 느린 결과는 Wi-Fi 신호 변화 때문일 수도 있습니다. 측정값은 범위를 좁히는 데 도움이 되지만 설정을 선택하는 유일한 기준은 아닙니다.

화면에서 시간 초과 값을 조정할 수 있다면 우선 현재 값을 유지하세요. 로그나 실제 요청을 통해 더 기다렸을 때 완료되는 것을 확인했고 그 대기 시간이 실제 사용에 적합한 경우에만 조금씩 늘려 테스트하세요. 시간 초과를 늘리면 실패로 표시될 때까지 기다리는 시간만 달라질 뿐, 대상에 도달할 수 없는 문제를 해결하지는 않습니다. 너무 짧게 설정하면 정상적인 지연 변동을 연결 끊김으로 오인할 수 있습니다. 변경 전후 결과를 따로 기록하고 서로 다른 시간 초과 기준의 성공률을 그대로 비교하지 마세요.

지연 시간과 전송량도 구분해야 합니다. 지연 시간 테스트는 보통 적은 수의 요청을 사용하므로 장시간 전송의 안정성을 보여 주지 않습니다. 큰 페이지가 로딩 중간에 멈추거나 짧은 요청은 성공하지만 긴 연결이 자주 끊긴다면 지연 시간 결과를 참고 자료로만 남기고 같은 실제 사용 상황에서 다시 테스트하세요. 개인 정보가 포함된 업무용 링크나 매개변수가 있는 주소를 테스트 대상으로 사용하지 마세요. 개인정보가 없는 주소로 대부분의 연결 비교를 할 수 있습니다.

테스트 결과에서 실제 문제로 범위를 좁히기

테스트는 실패했지만 실제 서비스가 정상이라면 실패가 테스트 대상에만 나타나는지 확인하세요. 사용할 수 있는 설정을 진단 수치 하나 때문에 바꿀 필요는 없습니다. 테스트는 정상이지만 실제 서비스에 문제가 있다면 해당 서비스의 요청을 살펴보고 도메인이 조회되는지, 예상 규칙에 매칭되는지, 의도한 정책을 사용하는지 확인하세요. 웹페이지의 기본 문서는 열렸지만 로그인 API나 정적 리소스가 실패할 수 있습니다. 이때는 홈페이지 테스트만 반복하지 말고 실패한 요청을 찾아보세요.

같은 네트워크에서 사용 중인 모든 서버의 테스트가 동시에 실패하면 정상 작동이 확인된 직접 연결 대상에 접속해 로컬 네트워크부터 확인하세요. 가능하다면 서버와 설정은 그대로 둔 채 네트워크 연결 방식만 바꿔 다시 테스트하세요. 서버 하나에서만 문제가 생기면 서비스 제공업체에서 받은 주소, 포트, 프로토콜 매개변수가 여전히 맞는지 확인하세요. 잘 모르는 값을 임의로 입력하지 마세요. 일반적인 ‘시간 초과’만 기록하는 것보다 어느 단계에서 실패했는지 적는 편이 문제를 해결하는 데 유용합니다.

네 가지를 기록하는 것이 좋습니다. 네트워크 연결, 테스트 방식, 테스트 대상, 실제 서비스 결과입니다. 이 중 하나라도 빠지면 두 테스트의 수치를 직접 비교하기 어렵습니다.

이전 기준값이 없는 기기라면 정상 작동할 때 테스트 결과를 한 번 기록해 두세요. 나중에 간헐적인 문제가 생겼을 때 이 기록을 이용해 네트워크, 대상, 앱 설정 중 무엇이 달라졌는지 확인할 수 있습니다. 정상 설정을 더 낮은 지연 시간 수치를 얻으려고 자주 바꾸지 마세요.

05 요청 로그

Log: 시간순으로 DNS, 규칙, 연결 문제 찾기

짧게 기록하고 동작 하나만 재현하세요

Log는 특정 요청이 어느 단계에서 실패했는지 확인하는 데 적합하며, 설정 전체가 정상인지 평가하는 용도는 아닙니다. 평소에는 현재 로그 수준을 유지하는 것이 좋습니다. 문제 발생 시 기존 정보만으로 부족한 경우에 한해 화면에서 제공하는 옵션으로 상세 수준을 잠시 높이세요. 진단 전에 원래 수준을 기록하고 완료한 뒤 복원하세요. 상세 로그를 기본값으로 계속 사용하지 마세요. 기기마다 표시되는 필드가 다를 수 있으며, 특정 필드가 화면에 없다고 해당 단계가 발생하지 않았다는 뜻은 아닙니다.

시작하기 전에 현재 시간, 네트워크, 활성 설정, Global Routing 모드를 기록하세요. 불필요한 요청을 많이 만드는 앱 화면은 닫고 공개 페이지를 다시 여는 것처럼 반복하기 쉬운 동작 하나만 실행하세요. 실행 시각을 기록한 다음 로그에서 해당 시간대의 항목을 확인하세요. 재현 중에 구독을 업데이트하거나 서버를 바꾸거나 다른 앱을 새로고침하지 마세요. 같은 시간대에 여러 변화가 섞이면 어떤 로그가 문제와 직접 관련 있는지 알기 어렵습니다.

마지막 줄만 보지 말고 문제 발생 단계를 따라가세요

먼저 대상이 식별되는지 확인한 다음 DNS 조회 결과, 규칙 매칭, 정책 선택, 연결 오류의 단서를 살펴보세요. 로그에서 대상을 조회할 수 없다고 나오면 DNS와 로컬 매핑부터 확인하세요. 대상은 식별됐지만 정책이 예상과 다르다면 Config에서 활성 파일과 규칙 순서를 확인하세요. 예상한 프록시 경로로 들어갔는데 연결에 실패했다면 증상을 덮기 위해 규칙을 더 추가하기보다 경로에 도달할 수 있는지, 프로토콜 매개변수가 맞는지 확인하세요.

하나의 동작으로 여러 요청이 발생할 수 있습니다. 기본 문서뿐 아니라 이미지, 로그인 상태 확인, 기타 리소스도 요청됩니다. DIRECT 또는 REJECT 항목이 보인다고 바로 실패 원인이라고 단정할 수는 없습니다. 해당 항목의 대상이 실제로 실패한 리소스인지 확인하고 같은 동작을 다시 테스트하세요. 페이지 일부 기능만 이상하다면 메인 도메인과 비슷한 시각의 모든 로그를 문제로 취급하지 말고 어떤 항목이 누락됐는지 먼저 찾으세요.

문제를 재현한 뒤 새 로그가 없다면 먼저 앱이 캐시된 내용을 보여 줬거나 기존 연결을 재사용하는 등 새 요청이 실제로 발생했는지 확인하세요. 그런 다음 연결 상태, 현재 모드, 사용 가능한 로그 범위를 살펴보세요. 로그가 비어 있다는 사실만으로는 연결 미수립, 기록되지 않은 상태, 앱에서 새 요청을 보내지 않은 상태를 구분할 수 없습니다. 모든 기록을 지우고 상세 수준을 무작정 높이기보다 안정적으로 새 요청을 발생시키는 동작으로 비교하는 편이 문제를 찾기 쉽습니다.

두 로그를 비교할 때는 시간 순서와 각 조건을 함께 기록하세요. 첫 번째 로그에는 DNS 조회 실패가 표시되고 두 번째에는 연결 시간 초과가 나타나더라도 문제가 더 심해졌다고 단정할 필요는 없습니다. DNS 조회가 복구되어 두 번째에야 연결 단계까지 진행됐을 수 있습니다. 반대로 새 로그에 오류가 없다고 문제가 해결된 것도 아닙니다. 앱에서 예상한 작업이 완료되지 않았다면 실제 요청이 전송됐는지 확인해야 합니다.

공유 전에는 진단에 필요한 항목만 남기세요

로그에는 도메인, 전체 URL, 쿼리 매개변수, 내부 주소가 포함될 수 있으며 서버 이름이나 계정 관련 정보가 노출될 수도 있습니다. 다른 사람에게 문제를 보여 줄 때는 발생 시각, 모드, 오류 유형을 설명하는 데 필요한 최소한의 내용만 발췌하세요. 계정 식별자, 인증 정보, 구독 링크, 불필요한 주소는 가리세요. 원본 설정 전체를 그대로 붙여 넣지 마세요. 스크린샷도 주변 내용을 살펴 서버 이름이나 인접한 다른 요청이 함께 노출되지 않는지 확인하세요.

문제를 문의할 때는 “같은 Wi-Fi와 서버에서 Config 모드는 실패했지만 Proxy 모드는 정상이며, 실패한 요청이 특정 유형의 규칙에 매칭되는 것을 확인했다”처럼 작성할 수 있습니다. 이 기록은 재현 가능한 동작을 설명하므로 오류 한 줄만 올리는 것보다 유용합니다. 진단이 끝나면 로그 수준을 복원하세요. 나중에 비교할 기록을 보관한다면 필요한 정보만 남긴 비식별 요약으로 저장하세요. 흔한 상황과 용어는 각각 자주 묻는 질문과 용어 설명에서 확인할 수 있습니다.

로그의 정책명은 앱이 해당 요청을 어떻게 처리하려 했는지를 보여 줄 뿐, 원격 서버가 연결을 수락했거나 서비스 요청이 완료됐음을 증명하지는 않습니다. 실제 접속 결과와 함께 판단하세요.

문제가 한 번만 발생해 짧은 기간 안에 재현할 수 없다면 불완전한 기록만으로 설정을 여러 개 바꾸지 마세요. 기존 상태와 확인된 사실을 먼저 적어 두고 다음에 발생했을 때 네트워크와 실제 대상을 추가로 기록하세요. 그래야 두 번의 문제가 같은 유형인지 확인할 수 있습니다.

06 빠른 실행

Widget: 상태 표시와 빠른 조작

먼저 Home에서 안정적인 기준을 확인하세요

Widget은 연결 상태를 확인하거나 화면에서 제공하는 빠른 조작을 실행하는 데 유용하지만, 라우팅 설정, 파일 편집, 개별 요청 확인을 위한 곳은 아닙니다. 수동 연결을 검증하지 않았다면 위젯부터 추가할 필요는 없습니다. 먼저 Home에서 서버와 모드, 연결 결과를 확인하고 실제 서비스에 접속한 뒤 시스템에서 제공하는 위치에 빠른 실행 항목을 추가할지 결정하세요. 위젯 추가 가능 여부, 표시 정보, 직접 조작 가능 여부는 현재 기기의 시스템 화면에서 확인하세요.

처음에는 앱에서 직접 조작하고 위젯은 필요한 경우에만 추가하는 것이 좋습니다. 위젯은 앱을 사용하기 위한 필수 조건이 아닙니다. 추가하기 전에 용도를 정하세요. 연결 여부만 가끔 확인한다면 표시 정보가 적은 레이아웃을 우선 고려하고, 전환을 간편하게 하려면 시스템에서 허용하는 범위 내에서 필요한 조작을 지원하는 레이아웃을 선택하세요. 위젯을 추가해도 앱의 현재 설정은 바뀌지 않으며, 위젯이 잠시 보이지 않는다고 프록시 연결이 실패한 것도 아닙니다.

추가한 뒤 조작 한 번과 새로고침 한 번을 확인하세요

시스템의 위젯 목록에서 Shadowrocket을 찾아 사용할 수 있는 레이아웃을 선택하고 원하는 위치에 배치하세요. 시스템 목록에서 위젯이 보이지 않으면 앱을 한 번 열었는지, 해당 위치가 레이아웃을 지원하는지 확인하고 시스템의 위젯 추가 화면에 다시 들어가 살펴보세요. 위젯이 보이지 않는다는 이유로 DNS, 구독, 설정 파일을 초기화하지 마세요. 위젯 표시와 앱의 네트워크 요청은 서로 다른 영역입니다. 위젯을 추가할 수 없다고 앱이 작동하지 않는 것은 아닙니다.

테스트는 Home에 연결되지 않았다고 표시되는지 확인하는 등 분명한 초기 상태에서 시작해 사용 가능한 위젯 조작을 한 번 실행하세요. 앱을 여는 조작이라면 앱에서 상태를 확인하고, 연결 상태를 직접 바꾸는 조작이라면 시스템 상태가 갱신된 뒤 실제 서비스에 접속해 보세요. 상태가 갱신되기 전에 연속으로 누르지 마세요. 같은 조작이 반복되면 최종 상태가 다시 시작 상태로 돌아와 갱신이 느린 것인지 조작이 전달되지 않은 것인지 구분하기 어렵습니다.

반대 방향도 확인하세요. Home에서 연결 상태를 바꾼 뒤 위젯 표시가 함께 갱신되는지 확인합니다. 앱과 위젯의 표시가 다르면 앱의 현재 상태, 시스템 VPN 상태, 실제 접속 결과를 교차 확인하세요. 위젯 내용은 시스템 갱신 시점의 영향을 받을 수 있습니다. 상태 표시가 모든 서비스의 실시간 연결을 보장하는 것은 아닙니다. 연결됨으로 표시되는데 사이트에 접속할 수 없다면 위젯을 삭제하고 다시 설치하지 말고 라우팅과 요청 로그를 확인하세요.

자동 연결과 수동 조작을 구분하세요

위젯에서 연결을 끊지 못한 것처럼 보이면 On Demand가 활성화되어 있는지 확인하세요. 수동으로 연결을 끊은 뒤 조건이 충족되어 시스템이 다시 연결하면 최종 상태는 여전히 연결됨으로 표시될 수 있습니다. 위젯 동작을 확인하려면 조건을 기록하고 잠시 중지한 뒤 안정적인 네트워크에서 한 번 재현하세요. 완료한 다음 기존 값으로 복구하고 평소 사용하는 상황에서도 다시 테스트하세요. 이렇게 하면 조작이 적용되지 않은 것인지, 연결이 자동으로 다시 시작된 것인지, 상태 표시가 늦은 것인지 구분할 수 있습니다.

표시만 늦는다면 앱을 다시 열었을 때 바뀌는지 먼저 확인한 다음 위젯을 제거하고 다시 추가해 보세요. 이 조작은 시스템 위젯에만 해당하며 앱 안의 설정이나 계정 정보를 삭제할 필요는 없습니다. 레이아웃을 바꾼 뒤 필요한 빠른 실행 항목이 남아 있는지 확인하세요. 특히 연결 전환용 레이아웃과 요약 확인용 레이아웃은 같은 위치에 있다는 이유만으로 서로 대체할 수 있다고 보면 안 됩니다.

기기를 함께 사용하거나 화면을 자주 보여 준다면 미리보기에 서버 메모처럼 공개하지 않으려는 정보가 표시되는지 확인하세요. 간결한 레이아웃이 있다면 이를 사용하고, 없다면 Home에서 확인하세요. 새 기기로 옮길 때는 설정이 이전됐는지와 위젯을 다시 추가했는지 각각 확인해야 합니다. 한쪽이 됐다고 다른 쪽도 완료된 것은 아닙니다. 앱에서 수동 연결이 정상이라면 빠른 실행 항목은 나중에 설정해도 됩니다.

권장 확인 순서: Home 상태 → 시스템 VPN 상태 → 실제 접속 → Widget 표시. 먼저 어느 단계에서 불일치가 생기는지 찾은 뒤 변경할 항목을 정하세요.

07 기기 간 데이터

iCloud: 동기화, 복원, 적용 범위

동기화 범위를 확인하고 백업과 혼동하지 마세요

iPhone과 iPad 사이에서 설정을 정리할 때는 App Store 구매 항목 복원, iCloud 또는 파일에서 데이터 가져오기, 앱에서 설정을 선택하고 활성화하기를 구분하세요. 구매 기록으로 앱을 다시 받을 수는 있지만 새 기기에 같은 활성 설정이 자동으로 복사되는 것은 아닙니다. 파일을 iCloud에 저장해도 앱의 로컬 서버 목록, 활성 상태, 빠른 실행 항목, 기기별 스위치까지 모두 이전되는 것은 아닙니다. 각 항목을 따로 확인하세요.

기존 설정을 사용할 때는 먼저 Settings에서 이용 가능한 iCloud 관련 옵션을 살펴보고 시스템 계정, iCloud 권한, 네트워크 상태를 확인하세요. 새 기기에서 동기화가 반드시 활성화된다고 가정하지 말고, 파일이 보이지 않는다고 데이터가 사라졌다고 단정하지 마세요. 동기화를 켜기 전에 화면 설명에서 어떤 데이터가 포함되는지 확인하세요. 특정 항목의 동기화가 명확히 안내되지 않았다면 필요에 따라 대상 기기에서 다시 확인하세요. 특히 네트워크 환경에 따른 On Demand 조건, 시스템 권한, 위젯은 클라우드에 파일이 있다는 사실만으로 복원됐다고 볼 수 없습니다.

권장 설정은 사용 목적에 따라 다릅니다. 한 기기에서만 쓴다면 기존 상태를 유지해도 됩니다. 기기를 옮겨야 한다면 보존할 완전한 설정이 어느 기기에 있는지 먼저 확인하고 화면에서 제공하는 내보내기, 가져오기, 동기화 기능을 사용하세요. 중요한 자료는 별도로 복구할 수 있는 사본을 보관하세요. 동기화가 계속되면 삭제나 덮어쓰기까지 다른 기기에 반영될 수 있습니다. ‘다른 기기에서 파일이 보인다’와 ‘실수로 삭제해도 복구할 수 있다’는 같은 뜻이 아닙니다.

출처, 내용, 활성 상태를 항목별로 옮기세요

먼저 원본 기기의 활성 파일, 서버 선택, 모드를 기록하고 직접 수정한 설정과 서비스 제공업체에서 받은 구독을 구분하세요. 원본 설정에서 별도로 저장한 규칙 파일이나 원격 참조를 사용한다면 대상 기기에서도 해당 참조에 접근할 수 있는지 확인하세요. 기본 파일만 옮겼다고 모든 종속 항목까지 사용 가능한 것은 아닙니다. 마이그레이션 중에는 두 기기에서 같은 이름의 항목을 동시에 편집하지 마세요. 이름이 같아도 파일 내용과 가져온 시점은 다를 수 있습니다.

대상 기기에서 가져온 항목이 보이면 직접 추가한 규칙 하나, 명확한 기본 정책 하나, 올바른 서버 메모 하나처럼 쉽게 알아볼 수 있는 내용을 먼저 확인하세요. 화면에 Import from Cloud JSON이 표시되면 해당 메뉴에서 지원하는 형식의 데이터를 사용하세요. 임의의 .conf 파일 확장자를 바꿔 JSON으로 가져오지 마세요. 가져오기 메뉴마다 처리하는 데이터 범위가 다를 수 있습니다. 가져온 결과를 확인한 뒤 사용할 파일을 선택하고 마지막으로 Home으로 돌아가 수동 연결을 테스트하세요.

같은 이름의 파일이 충돌하면 ‘최근에 표시된 파일’을 원본 위에 덮어쓰지 말고 두 사본을 먼저 보관하세요. 활성 규칙, DNS 재정의, 종속 항목의 출처를 하나씩 비교한 뒤 필요한 파일을 대상 기기에서 활성화하세요. 연결을 확인하기 전에 자동 연결을 켜지 마세요. 필요한 공용 또는 내부 대상에 예상대로 접속한 다음 새 기기의 사용 상황에 맞춰 On Demand 조건을 조정하세요. 이전 기기의 임시 제외 조건을 그대로 가져오지 않도록 주의하세요.

테스트 항목 하나로 동기화가 작동하는지 확인하세요

동기화 방향이나 소요 시간을 확실히 모른다면 인증 정보가 없는 테스트 설정을 사용하세요. 한 기기에서 구분하기 쉬운 작은 변경을 하고 다른 기기에서 보이는지 기록합니다. 변경이 보이지 않으면 두 기기가 같은 계정을 사용하는지, 앱 권한이 허용됐는지, 해당 파일이 실제 동기화 범위에 포함되는지, 네트워크가 정상인지 먼저 확인하세요. 동기화를 재촉하려고 반복해서 로그인과 로그아웃을 하거나 실제 설정을 삭제하거나 양쪽 기기에서 동시에 수정하지 마세요.

서버 인증 정보나 비공개 구독 주소가 포함된 자료는 민감한 파일로 취급하세요. 직접 관리하는 계정과 기기 사이에서만 다루고 공개 공유 폴더에 설정을 올리지 마세요. 내보내기 전에 파일에 어떤 정보가 포함되는지 확인하세요. 가져오기를 마친 뒤 임시 사본을 남겼다면 보관 여부와 위치를 정하세요. 마이그레이션 결과가 안정될 때까지 원본 기기의 자료를 서둘러 정리하지 마세요. 규칙이 빠지거나 동기화로 덮어쓰여도 비교할 원본이 남아 있어야 합니다.

같은 계정에서 구매한 앱을 복원하는 것과 기존 설정을 가져와 활성화하는 것은 별도로 확인해야 합니다. 기기를 바꾼 뒤에는 자료를 먼저 확인한 다음 자동 연결 방식을 복원하세요.

대상 기기에 서버가 표시되는데 연결되지 않는다면 동기화 누락을 의심하기 전에 인증 정보, 현재 네트워크, 필요한 권한을 확인하세요. ‘파일이 보임’, ‘내용이 올바름’, ‘실제로 사용 가능함’을 구분해 기록하면 어느 단계로 돌아가야 하는지 알 수 있습니다.

08 로컬 수신

Proxy 포트: 수신 주소, 프로토콜, 사용 범위

원격 서버 포트, 로컬 포트, 라우팅 모드를 구분하세요

Add Server나 서버 상세 정보에서 입력하는 포트는 원격 서버가 연결을 받는 포트입니다. 프로토콜 매개변수와 함께 서비스 제공업체에서 확인하세요. 설정에 Proxy 수신 옵션이 있다면 그 포트는 이 기기에서 프록시 요청을 받는 위치이며, 여기에 연결할 앱이나 기기에서 사용합니다. Global Routing의 Proxy는 트래픽 처리 모드를 뜻합니다. 포트 설정이 아니며 원격 포트를 로컬 포트로 바꾸지도 않습니다. 세 항목 모두 프록시와 관련되어 보일 수 있으므로 문제를 확인할 때는 각각의 메뉴 위치를 구분하세요.

이 기기에서 시스템 VPN 연결만 사용할 경우 로컬 수신 설정은 그대로 두고 다른 기기용 연결 경로를 추가로 활성화하지 않는 것이 좋습니다. 명확한 필요가 없다면 고정 포트를 지정하거나 다른 곳의 예시 숫자를 그대로 사용하지 마세요. 현재 값은 화면 표시와 실제 수신 상태를 기준으로 확인하세요. 앱에서 특정 수신 유형을 표시하지 않는다면 해당 주소나 기본 포트가 있다고 가정하지 마세요. 보조 앱에서 프록시를 직접 지정해야 할 때만 필요한 수신 프로토콜, 주소, 포트를 확인하세요.

주소, 프로토콜, 포트를 함께 확인하세요

수신 주소가 127.0.0.1 같은 루프백 주소에만 연결되어 있다면 이 기기에서만 접속할 수 있습니다. 다른 기기에서 127.0.0.1을 입력하면 Shadowrocket이 실행 중인 기기가 아니라 그 기기 자체에 연결합니다. 이런 경우 즉시 연결이 거부되거나 계속 대기할 수 있습니다. 문제가 발생하면 먼저 양쪽이 같은 기기인지 확인한 뒤 수신 범위를 바꿀 필요가 있는지 판단하세요. 주소를 잘못 입력한 문제를 해결하려고 서비스를 모든 네트워크에 바로 공개하지 마세요.

포트 번호가 같아도 프로토콜이 같다는 뜻은 아닙니다. HTTP가 필요한 앱은 포트 번호만으로 SOCKS5만 지원하는 수신 지점에 연결할 수 없습니다. 마찬가지로 로컬 포트에 연결된다고 원격 서버나 실제 대상도 작동하는 것은 아닙니다. 요청을 보내는 쪽에서 화면에 표시된 프로토콜을 사용할 수 있는지 먼저 확인한 다음 비공개 매개변수가 없는 대상으로 테스트하세요. 기기에서 포트에 연결되는데 업무 요청이 실패한다면 포트 번호를 계속 바꾸지 말고 프로토콜 협상과 아웃바운드 정책을 확인하세요.

같은 기기의 다른 프로세스가 동일한 수신 주소와 포트를 사용하면 포트 충돌이 발생할 수 있습니다. 수신을 시작할 수 없다는 안내가 표시되거나 설정을 저장한 뒤 새 연결 지점에 접속할 수 없다면 기존 서비스가 해당 포트를 사용하는지 확인하세요. 변경이 꼭 필요하면 현재 사용 가능하고 권한이 있는 포트를 선택하고 기존 값을 기록한 뒤, 해당 포트에 의존하는 앱도 모두 업데이트하세요. 연결을 제공하는 쪽만 바꾸면 사용하는 쪽에는 이전 설정이 남아 프록시 문제처럼 보일 수 있지만 실제 원인은 기존 주소에 계속 연결하는 것입니다.

신뢰할 수 있는 범위에서만 기기 간 접속을 허용하세요

기기 간 접속이 꼭 필요하다면 앱이 해당 수신 방식을 명확히 지원하는지, 시스템 권한이 허용되는지, 네트워크에서 같은 LAN의 기기 간 통신을 허용하는지 먼저 확인하세요. 로컬 수신 연결을 공용 네트워크에 공개하거나 라우터의 포트 포워딩을 설정하지 마세요. 공용 Wi-Fi와 게스트 네트워크는 기기 간 통신을 차단할 수 있습니다. 두 기기에 같은 네트워크 이름이 표시되더라도 서로 접속할 수 있다는 뜻은 아닙니다. 네트워크 정책에서 통신을 허용하지 않는다면 허가된 환경을 사용하고 격리를 우회하려고 하지 마세요.

기기를 다른 네트워크로 옮기면 LAN 주소가 바뀔 수 있습니다. 기존 주소 형식이 올바르더라도 더 이상 이 기기를 가리키지 않을 수 있습니다. 기기 간 요청만 실패하고 이 기기에서는 정상이라면 연결하는 쪽에 현재 주소가 입력되어 있는지, 수신 범위와 네트워크 통신 권한이 적절한지 확인하세요. 앱에서 필요한 수준으로 접속 출처를 제한할 수 없다면 로컬 수신을 유지하거나 공유를 끄세요. 임시 테스트 설정을 일상적인 사용에 그대로 적용하지 마세요.

권장 순서: 로컬 수신 연결 확인 → 프로토콜 일치 확인 → 대상 요청 확인. 포트 변경으로 DNS 오류, 잘못된 규칙, 원격 서비스 문제를 해결할 수는 없습니다.

다른 기기로 테스트한 뒤 임시로 켠 수신 또는 공유 옵션을 끄고 연결하는 쪽에 저장된 기존 설정을 삭제하세요. 비공개 주소가 포함되지 않은 간단한 기록을 남겨 당시 프로토콜, 연결 범위, 실패 단계를 적어 두세요. 나중에 데스크톱이나 모바일 기기의 특정 앱에서만 오류가 발생하면 이 기록으로 해당 앱이 이 연결 지점에 의존하는지 확인한 뒤 설정과 실제 요청 중 어디를 살펴볼지 결정하세요.