공식 매뉴얼 · 설정 항목 안내

Shadowrocket 설정 매뉴얼

iPhone / iPad 인터페이스를 기준으로 설명합니다. 아직 기존 구독이나 서버 정보를 가져오지 않았다면 먼저 사용 안내에 따라 최초 연결을 완료하세요. 특정 설정의 적용 시점이나 변경 후 확인·복구 방법은 이 페이지의 목차에서 찾아볼 수 있습니다. 다른 플랫폼에서는 각 클라이언트에 표시되는 옵션을 기준으로 확인하세요.

설정 기준 확인
현재 값을 기록하고 적용 범위를 구분하세요
변경 및 확인
한 번에 한 항목만 바꾸고 같은 요청으로 다시 확인하세요
복구
이번에 변경한 항목부터 되돌린 후 범위를 넓혀 점검하세요
01 설정 기준 확인

Settings와 적용 범위

설정을 바꾸기 전에 세 가지를 구분하세요. 연결이 이미 수립되었는지, 새 요청에 어떤 라우팅 방식을 적용할지, 설정이 현재 구성 파일을 따르는지 아니면 클라이언트 전체에 적용되는지 확인합니다. 먼저 Home에서 연결 상태와 Global Routing을 살펴보고, Config에서 활성화된 파일을 확인한 다음 Settings에서 해당 항목을 찾으세요. 파일 이름이 목록에 보인다고 활성화된 것은 아니며, 파일을 편집했다고 현재 요청이 반드시 그 파일을 거치는 것도 아닙니다. 로그인은 되지만 일부 콘텐츠가 로드되지 않는다면 실패한 동작을 구체적으로 기록하세요. 페이지 전체의 현상을 하나의 요청 결과로 간주하지 마세요.

기본값의 출처와 복구 기준 기록

이 매뉴얼에서는 출고 시 기본값, 구성 파일에 지정된 값, 기기에서 현재 사용하는 값을 구분합니다. 처음 표시되는 값은 가져온 구성, 시스템 권한 또는 복원된 데이터의 영향을 받았을 수 있습니다. 입력란을 비워도 기능이 꺼지는 것이 아니라 다른 출처의 설정을 따를 수 있습니다. 확인 가능한 공통 기본값이 없는 항목은 각 장에서 반복 가능한 테스트 기준을 제시하며, 권장값을 기본값이라고 단정하지 않습니다. 공란, 자동 설정, 직접 입력값을 포함해 변경 전에 실제로 표시되던 상태를 기록해 두세요. 잘 작동하는 것처럼 보이는 숫자만 기억해서는 안 됩니다.

Global Routing의 세 가지 모드

모드처리 방식확인에 적합한 상황
Config (구성)활성화된 구성의 규칙에 따라 요청을 매칭합니다.특정 대상이 예상한 규칙에 매칭되는지 확인합니다.
Proxy (프록시)클라이언트의 프록시 대상 트래픽을 프록시로 처리합니다.같은 네트워크에서 프록시를 사용할 때 접속되는지 확인합니다.
Direct (직접 연결)클라이언트가 처리하는 트래픽을 대상에 직접 연결합니다.같은 대상이 직접 연결 경로에서 작동하는지 확인합니다.

Direct는 연결을 끊는 모드가 아닙니다. 비교 테스트 중에는 클라이언트 연결을 유지하고 두 모드에서 각각 새 요청을 보내세요. 클라이언트 개입 전후를 비교해야 한다면 연결 해제 테스트를 별도로 진행합니다. 앱이 기존 연결을 재사용하거나 캐시된 내용을 표시할 수 있습니다. 모드를 바꾼 뒤에는 새 탭을 열거나 해당 기능을 다시 실행하고, Log에 새 기록이 남는지 확인하세요. 점검이 끝나면 평소 사용하는 모드로 되돌리세요. 테스트 후 모드가 그대로 남으면 규칙 파일이 올바르더라도 규칙이 적용되지 않을 수 있습니다.

복사본으로 규칙과 최종 처리 확인

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

복구할 수 있는 복사본에 테스트 규칙을 추가하고, 그 위에 더 넓은 범위의 매칭 조건이 있는지 확인한 뒤 최종 처리 규칙보다 뒤에 놓이지 않았는지 살펴보세요. 패널에 표시된 동작이 PROXY라면 실제로 선택된 서버도 확인해야 합니다. 규칙에 매칭되었다는 것은 출구가 선택되었다는 뜻일 뿐, 서버 연결이 성공했다는 뜻은 아닙니다. Log의 대상이 주소창의 도메인과 다르면 주 요청, 로그인 리디렉션, 페이지에 포함된 리소스 중 무엇이 실패했는지 먼저 구분하세요. 잘못된 대상에 예외 규칙을 추가하지 않도록 주의합니다. 파일 각 부분의 역할은 구성 파일 구조 안내에서 확인할 수 있습니다.

문제를 진단할 때는 동작 시간, 네트워크 유형, 활성화된 파일과 모드를 먼저 기록하세요. 값을 임시로 바꾼 뒤 바로 다시 확인하고, 설명할 만한 차이가 없으면 원래 값으로 복구한 다음 다른 항목을 점검합니다. 이렇게 하면 네트워크 전환 후 문제가 사라졌을 때 설정 변경의 효과인지 기존 네트워크 조건이 사라진 결과인지 구분하기 쉽습니다. 같은 결과를 다시 재현할 수 없다면 당시 조건을 기록하고, 우연히 한 번 정상화된 것을 지속적인 해결로 간주하지 마세요.

02 도메인 이름 해석

DNS: 출처, 대체 동작 및 확인

DNS는 도메인 이름을 클라이언트나 다음 홉에서 사용할 수 있는 주소로 변환합니다. 연결 스위치가 켜져 있거나 Ping에 결과가 나왔다고 해서 특정 웹사이트의 도메인 해석까지 정상이라는 뜻은 아닙니다. 도메인 해석 오류가 보이면 모든 대상에서 실패하는지, 특정 도메인이나 일부 내부망 이름 또는 최근 주소가 바뀐 서비스에서만 실패하는지 구분하세요. 구체적인 도메인과 발생한 네트워크를 기록한 뒤 현재 사용하는 Config에 해석 방식이 지정되어 있는지 확인합니다. Settings에 선택 항목이 보인다는 이유만으로 각 요청이 어떤 DNS 출처를 사용하는지 판단할 수는 없습니다.

출처부터 확인하고 공란만으로 결과를 단정하지 않기

활성화된 파일의 [General]과 [Host]를 확인하세요. 앞부분에서 DNS 서비스를 지정할 수 있고, 뒷부분에서는 특정 이름을 고정 주소에 연결할 수 있습니다. 이런 매핑은 대체 DNS가 아니며 대상 주소가 바뀌어도 자동으로 갱신되지 않습니다. 웹사이트 이전 후 일부 이름만 예전 주소로 연결된다면 매핑과 캐시부터 확인하세요. 가져온 파일에 원래 없던 지정값이 포함되었을 수도 있습니다. 시스템 DNS 설정, 구성 파일의 지정값, 앱에 표시된 값이 함께 존재하는 경우 입력 순서만으로 최종 우선순위를 추측하지 마세요. 실제 요청 기록, 도메인 응답, 항목별 변경 전후를 함께 비교해야 합니다.

평소에는 기존 DNS 설정을 기준으로 시작하는 것이 좋습니다. 가정이나 사무실 네트워크에서 로컬 기기에 접속할 때는 해당 네트워크가 제공하는 DNS를 우선 유지하세요. 공용 DNS 서비스는 내부망 이름을 확인하지 못하는 경우가 많습니다. 직접 확인한 DNS 서비스로 바꾸려면 현재 네트워크에서 연결할 수 있는지 확인하고, 클라이언트가 실제로 지원하는 입력 형식에 맞춰 설정하세요. 암호화 DNS를 선택한 경우 서비스 주소와 암호화 방식, 인증서에 사용된 이름이 일치해야 합니다. 일부 서비스는 주소 자체를 먼저 해석해야 할 수도 있습니다. 암호화 DNS로 바꾸는 것이 접속 문제를 해결한다는 보장은 없으며, 일반 설정을 확인하기 위해 인증서 오류 무시를 사용하지 마세요.

두 대상을 테스트하고 조건은 하나만 바꾸기

  1. 현재 네트워크, 서버, Global Routing을 그대로 유지하세요. 정상적으로 접속되는 일반 대상 하나를 비교 대상으로 고르고, 실패하는 대상 하나를 선택해 각각 새 요청을 보냅니다. 주소가 반환되는지, 이어서 연결 오류가 발생하는지, 조회 오류와 연결 오류가 각각 어느 대상에 해당하는지 기록하세요.
  2. 구성 파일 복사본에서만 DNS 설정을 바꾸고 [Host] 항목을 삭제하거나 분할 규칙을 동시에 수정하지 마세요. 같은 순서로 두 대상을 다시 확인합니다. 요청이 서로 다른 라우팅 경로로 들어갔다면 먼저 경로 차이를 파악한 다음 DNS 결과를 평가하세요. 내부망 대상만 영향을 받는다면 원래 DNS 설정으로 되돌린 뒤 문제가 재현되는 네트워크에서 다시 확인하세요.
  3. 여전히 이전 주소를 사용하는 것처럼 보이면 앱이 기존 연결을 재사용하는지 확인하세요. 테스트 세션을 새로 만들고 필요하면 이름 캐시가 만료될 때까지 기다린 뒤 다시 비교합니다. 테스트가 끝나면 활성화된 파일과 기존 값을 복구해 테스트 설정이 다음번 일상적인 기준으로 오인되지 않도록 하세요.

대체 DNS 사용 성공과 이후 단계 실패 구분

DNS 서비스를 여러 개 설정해도 입력 순서대로만 작동한다고 보장할 수는 없습니다. 설정에 따라 재시도, 대체 또는 병렬 조회가 이루어질 수 있으며, 다른 서비스에서 해석이 성공했을 수도 있습니다. 특정 서비스의 사용 가능 여부는 복구 가능한 테스트 복사본에서 단독으로 확인하세요. 최종 페이지가 열리는지만을 유일한 증거로 삼지 마세요. DNS 서비스를 바꾼 뒤 도메인 주소는 얻었지만 연결되지 않는다면 규칙 동작, 주소 계열, 연결 또는 인증서를 확인하세요. 계속 DNS만 바꾸면 더 중요한 단서를 놓칠 수 있습니다.

도메인의 첫 페이지는 열리지만 로그인이나 이미지가 실패한다면 리디렉션 이후의 도메인과 리소스 도메인을 확인하세요. 이들 도메인은 서로 다른 방식으로 해석되거나 다른 경로에 매칭될 수 있습니다. 도메인 대신 IP 주소로 접속하면 인증서 확인과 서버 식별 조건이 달라지는 경우가 많으므로, 이것만으로 DNS 문제라고 결론 내릴 수 없습니다. 문제가 간헐적으로 발생한다면 네트워크 전환 후에만 나타나는지, 같은 조건에서 다시 관찰할 수 있는지 기록하세요. 이런 기록은 몇 장의 성공 화면보다 On Demand 트리거 기록과 비교하기에 유용합니다.

03 자동 연결

On Demand: 트리거 조건과 종료

On Demand는 시스템이 조건에 따라 언제 연결을 시도할지 결정합니다. 요청을 PROXY로 보낼지 DIRECT로 보낼지 선택하거나 서버 사용 가능 여부를 확인하는 기능은 아닙니다. 먼저 Home에서 수동으로 연결하고 실제 접속이 되는지 확인한 뒤 On Demand를 테스트하세요. 수동 연결부터 실패하면 자동 연결도 같은 실패 경로를 반복하므로 트리거 조건이 잘못된 것으로 오해하기 쉽습니다.

현재 스위치 상태와 트리거 조건을 따로 기록

테스트는 On Demand를 끄고 수동 연결을 사용하는 상태에서 시작하는 것이 좋습니다. 단, 꺼진 상태가 모든 기기의 기본 설정이라고 단정해서는 안 됩니다. 시스템 복원, 기기 관리 설정, 기존 설정에 따라 기기별 상태가 다를 수 있습니다. 켜기 전에 스위치 상태와 화면에 표시된 네트워크 조건 및 예외를 기록하세요. 시스템에서 Shadowrocket에 해당 VPN 구성을 사용할 권한을 부여했는지도 확인합니다. 조직에서 관리하는 기기라면 일부 설정이 제한될 수 있으므로 관리 지침에 따라 확인하고, 같은 화면을 만들기 위해 다른 구성을 제거하지 마세요.

사용 상황을 확인 가능한 문장으로 정리하세요. 예를 들면 “지정된 Wi-Fi에서는 수동으로 조작하고 자동 연결하지 않으며, 네트워크에서 벗어난 뒤 조건에 따라 연결을 시도하는지 확인한다”와 같이 적을 수 있습니다. 실제로 필요한 네트워크 상황 하나부터 시작하고 규칙은 가능한 한 적게 유지하세요. 화면에서 네트워크 유형이나 Wi-Fi 이름 조건을 제공한다면 실제 항목을 기준으로 선택합니다. 시스템은 라우터의 외관이나 물리적 위치가 아니라 현재 연결 조건을 인식합니다. 이름이 비슷하거나 같은 이름의 네트워크가 여러 곳에 있거나 기기가 다른 네트워크를 자동으로 선택하면 예상과 다르게 조건이 매칭될 수 있습니다.

조건 충족, 미충족 및 복구를 각각 확인

  1. 수동 연결이 확인된 네트워크에서 필요한 조건을 활성화하세요. 조건을 충족하는 환경으로 이동해 새 요청을 보내고 전환 전후의 연결 상태를 비교합니다. 변화가 시작된 시간과 실제 사용 중인 네트워크를 기록해 전환이 끝나기 전 상태를 최종 결과로 오인하지 않도록 하세요.
  2. 조건을 충족하지 않는 네트워크에서도 반대 사례를 확인하세요. 새로운 자동 연결 시도가 있었는지 살펴보면서 기존 연결이 계속 유지된 것과 시스템이 새 연결을 시작한 것을 구분합니다. 조건이 충족되지 않았다고 해서 이미 수립된 연결을 자동으로 끊는 것은 아닐 수 있습니다.
  3. 테스트가 끝나면 먼저 On Demand를 끄고 Home에서 수동으로 연결을 해제한 다음 같은 대상에 다시 접속해 보세요. 해제 후 다시 연결된다면 트리거 설정이 실제로 꺼졌는지, 시스템에 표시된 활성 연결이 Shadowrocket의 연결인지 확인합니다. 현재 테스트와 관련된 설정만 조작하세요.

자동 연결은 시도됐지만 서비스가 작동하지 않음

화면에 연결 시도가 표시되면 트리거 범위를 계속 넓히기보다 요청 시점에 서버에 연결할 수 있었는지 먼저 확인하세요. 공용 Wi-Fi에서는 브라우저에서 먼저 접속 확인을 완료해야 할 수 있습니다. 모바일 네트워크가 복구된 직후에는 신호가 표시되어도 대상에 접속할 수 없는 경우가 있습니다. On Demand를 잠시 끄고 현재 네트워크의 일반적인 연결 절차를 따른 다음 수동 연결을 확인하세요. 성공하면 동일한 트리거 조건으로 다시 테스트합니다. 수동 연결도 되지 않으면 네트워크, DNS와 기존 서버 설정부터 점검하세요.

화면 잠금 후, 앱을 다시 열었을 때 또는 네트워크 전환 중에만 나타나는 현상은 각 동작을 따로 테스트하세요. 시간상 먼저 일어난 일을 설정의 원인으로 단정하지 마세요. 새 요청이 있었는지, 기존 연결은 종료되었는지, 화면이 다시 표시될 때의 상태가 시스템 상태와 일치하는지 기록합니다. 기기마다 결과가 다르면 전체 구성을 복사하기보다 시스템 연결 설정과 관리 제한을 먼저 비교하세요. 자동 연결을 일상적인 방식으로 복구하려면 자주 사용하는 네트워크에서 진입 조건과 종료 조건을 각각 한 번 확인한 뒤 예외를 하나씩 추가하세요. 매번 새 변경은 한 가지만 적용해 확인합니다.

04 연결 상태 테스트

Ping: 테스트 방법, 시간 초과 및 결과 해석

Ping이나 Connectivity Test 결과는 선택한 조건에서 이번 테스트가 어떻게 동작했는지를 보여줄 뿐, 모든 앱이 해당 경로로 접속할 수 있거나 평소 다운로드 속도가 빠르다는 뜻은 아닙니다. 먼저 기기에서 실제로 제공하는 테스트 방식을 확인한 뒤 결과를 해석하세요. 테스트에 따라 서버 주소 응답, 포트 연결 또는 지정 대상에 대한 앱 수준 요청을 확인할 수 있습니다. 모두 밀리초로 표시되더라도 측정 시작점과 끝점이 다르면 수치를 한 순위표로 비교할 수 없습니다.

테스트 방식, 대상 및 대기 시간을 구분

관찰 결과확인할 수 있는 내용이 결과만으로 판단할 수 없는 내용
포트 연결 가능이번에는 대상과 해당 전송 연결을 수립할 수 있었습니다.프록시 프로토콜 설정이 올바르거나 서비스 웹사이트에 접속할 수 있다는 점.
테스트 요청에 응답이번 테스트 조건에서 해당 대상이 응답했습니다.다른 도메인, 프로토콜 또는 더 긴 연결도 정상이라는 점.
이번 테스트 시간 초과대기 시간이 끝날 때까지 이 항목에서 기대한 응답을 받지 못했습니다.서버가 중지되었거나 문제가 반드시 서버 측에서 발생했다는 점.

기본 확인은 기기에 실제 표시된 테스트 방식, 대상 주소와 시간 초과 설정을 기준으로 합니다. 일부 화면은 테스트 실행만 제공하고 개별 매개변수는 표시하지 않을 수 있으므로 내부 동작 방식을 추측하지 마세요. 테스트 주소를 수정할 수 있다면 사용 권한이 있고 응답이 안정적이며 로그인이 필요 없는 대상을 선택하세요. 로그인 확인이 필요하거나 접속 확인 페이지로 이동하거나 세션 정보가 필요한 주소는 장기 기준으로 적합하지 않습니다. 특별한 이유가 없다면 기존 시간 초과 설정을 유지하세요. 네트워크 변동이 실제로 있고 화면에서 조정할 수 있다면 한 번만 대기 시간을 늘려 기존 결과가 대기 시간에 영향을 받았는지 확인할 수 있습니다. 더 오래 기다리는 것을 연결 속도가 빨라진 것으로 표현하지 마세요.

비교 가능한 기록 만들기

  1. 같은 기기를 사용하고 현재 네트워크, 테스트 방식과 대상을 고정하세요. 이미 보유한 서버 하나를 따로 테스트하고 성공, 시간 초과 또는 구체적인 오류를 기록합니다. 성공했을 때의 최솟값만 적어 두지 마세요. 설정을 바꾸기 전에 기존 결과를 표시해 두면 복구 후 변화가 지속되는지 확인하기 쉽습니다.
  2. 같은 조건으로 몇 차례 다시 테스트하고 지속적인 실패, 간헐적인 실패, 성공까지 걸리는 시간의 변동을 구분해 기록하세요. 여러 서버를 한꺼번에 테스트하면 기기 네트워크 부하와 서버 응답이 모두 달라질 수 있습니다. 한 가지 문제를 분석할 때는 일괄 테스트를 중단한 뒤 의심되는 항목만 다시 확인하세요.
  3. Home으로 돌아가 실제 요청을 한 번 보내고 해당 요청의 Global Routing과 Log를 확인하세요. 테스트는 정상이지만 서비스가 실패한다면 규칙 경로, 도메인 해석, 프로토콜 협상, 서비스 응답을 차례로 구분합니다. 테스트 결과만으로 실제 서비스 장애를 부정하지 마세요.

Ping 설정을 더 조정하지 말아야 할 때

포트 연결은 빠른데 서비스에 계속 접속할 수 없다면 기존 서버 정보의 주소, 포트, 프로토콜과 해당 인증 매개변수를 먼저 확인하세요. 포트가 열려 있다고 해서 그 포트에서 선택한 프로토콜에 맞는 서비스가 제공된다는 뜻은 아닙니다. 직접 연결 테스트와 프록시를 통한 접속은 서로 다른 경로일 수 있습니다. Wi-Fi에서 모바일 네트워크로 바꿔야 정상화된다면 지연 시간 설정이 문제를 해결했다고 하지 말고 네트워크 비교 결과로 기록하세요. 원래 네트워크로 돌아가 같은 조건을 재현해야 차이가 지속되는지 판단할 수 있습니다.

서비스는 정상이고 테스트만 실패한다면 테스트 주소가 현재 네트워크와 테스트 방식에 적합한지 먼저 확인하세요. 일부 네트워크는 실제 서비스는 허용하면서 다른 종류의 테스트에는 응답하지 않을 수 있습니다. 반대로 간단한 테스트가 성공해도 장시간 연결 중 끊기는 문제가 숨겨질 수 있습니다. 간헐적인 문제라면 시간 초과 값을 계속 높이기보다 재현에 필요한 네트워크, 동작과 시간을 기록하는 것이 유용합니다. 설정 변경 전후를 비교할 때는 같은 방식과 대상, 비슷한 네트워크 조건에서 얻은 결과만 함께 비교하세요. 조건이 다르면 각각 따로 기록하고 수치를 직접 비교하지 마세요.

05 요청 진단

Log: 시간순으로 실패 단계 찾기

Log를 사용하면 특정 동작에서 어디에 접속했고, 어떤 경로를 선택했으며, 어느 단계에서 멈췄는지 확인할 수 있습니다. 먼저 특정 페이지를 열거나 앱에서 같은 기능을 누르는 것처럼 반복할 수 있는 동작 하나로 문제를 좁히세요. 대략적인 시간을 기록하고 테스트와 관계없는 새로고침을 중단한 뒤 요청을 한 번 보냅니다. 하나의 동작이 로그인 서비스, 리소스 서비스, 실제 서비스에 동시에 접속할 수 있습니다. 로그에 마지막으로 나타난 오류를 주 요청의 실패로 바로 간주하면 우연히 발생한 백그라운드 요청을 원인으로 오해하기 쉽습니다.

현재 Log 수준에서 시작

먼저 현재 표시된 기록 수준을 기준으로 확인하세요. 기존 기록만으로 DNS 조회, 매칭, 연결 단계를 구분하기 어렵고 화면에 더 자세한 옵션이 제공될 때만 짧은 시간 동안 상세 수준을 높입니다. 테스트 전에 원래 수준을 기억해 두고 끝나면 복구해 진단과 무관한 기록이 계속 쌓이지 않도록 하세요. 전후 비교를 보존하려면 테스트 시간을 기록해 관찰 구간을 구분하면 됩니다. 전체 기록을 먼저 지울 필요는 없습니다. 오래된 기록이 필요하지 않다고 확실할 때만 화면의 삭제 기능을 사용하세요.

단계별로 확인하고 이전 단계의 성공을 전체 성공으로 간주하지 않기

  1. 먼저 대상을 찾으세요. 시간과 도메인으로 범위를 좁힌 뒤 로그에 표시된 실제 대상이 실패한 기능과 일치하는지 확인합니다. 리소스 요청만 실패하고 주 요청은 성공했다면 해당 리소스를 별도로 점검하세요. 예상한 항목이 없다면 앱이 실제로 새 요청을 보냈는지, 로컬 캐시를 읽은 것은 아닌지 확인합니다.
  2. 다음으로 경로를 살펴보세요. DIRECT 또는 PROXY가 보이면 현재 Global Routing과 활성화된 파일을 함께 고려해 결과를 해석합니다. 규칙 매칭으로 특정 경로에 들어갔다면 앞선 항목에서 먼저 매칭되었는지, FINAL에 매칭되었는지 확인하세요. 파일의 마지막 줄만 보고 실제 경로를 추측하지 마세요.
  3. 마지막으로 종료된 위치를 확인하세요. DNS 오류, 연결 거부, 연결 시간 초과, 프로토콜 인증 실패, 서비스 응답 오류는 각각 점검할 항목이 다릅니다. 일부 경로에서는 다른 쪽에서 DNS 조회가 이루어질 수 있어 로컬 기록에 전체 과정이 표시되지 않을 수 있습니다. 확인되지 않은 내용은 관찰하지 못했다고 표시하고 존재하지 않는 증거를 지어내지 마세요.

예를 들어 페이지의 텍스트는 표시되지만 이미지가 계속 실패한다면 두 요청에서 실제로 사용된 도메인, 선택된 경로와 종료 위치를 비교하세요. 이미지 요청이 예상보다 범위가 넓은 규칙에 매칭되었다면 복사본에서 해당 매칭 관계만 바꾸고 전후를 비교할 수 있습니다. 예상한 경로가 선택되었는데 대상이 연결을 거부한다면 포트와 실제 서비스를 확인해야 합니다. DNS 단계에서 문제가 발생했다고 확인된 경우에만 DNS 설정을 다시 살펴보세요. 프록시, DNS, 규칙을 한꺼번에 바꾸지 마세요.

기록이 없거나 공유해야 할 때

대상 기록을 전혀 찾을 수 없다면 올바른 시간 구간을 보고 있는지, 기기 시각과 기록 시간이 어긋나지 않았는지 먼저 확인하세요. 이어서 Home의 연결 상태와 이번 동작을 수행한 앱을 비교해 실제 네트워크 요청이 발생했는지 살펴봅니다. 기록 수준, 필터 또는 트래픽 처리 범위에 따라 현재 화면에 표시되지 않을 수 있습니다. 관찰 방법이 유효한지 확인하려면 재현 가능한 것으로 알려진 대상을 사용한 뒤 문제 대상을 비교하세요. 항목이 보이지 않는다는 것은 현재 화면에 해당 정보가 없다는 뜻일 뿐, 요청이 발생하지 않았음을 단독으로 입증하지는 않습니다.

동료에게 검토를 요청할 때는 “네트워크를 고정하고 같은 파일과 모드를 유지한 채 새 요청을 보낸다”처럼 재현 단계를 작성하고 예상 결과와 실제 결과를 함께 적으세요. 진행 중 어떤 항목만 변경했는지, 기존 값으로 복구했을 때 문제가 다시 나타나는지도 설명합니다. 그래야 일시적인 오류와 반복 가능한 설정 차이를 구분할 수 있습니다. 작업이 끝나면 기록 수준을 복구하고 진단을 위해 임시로 만든 연결을 해제한 다음 로그 확인을 위해 추가 설정을 켜둔 것은 없는지 살펴보세요.

06 시스템 진입점

Widget: 상태 표시와 조작 범위

Widget은 정보를 확인하거나 작업을 실행하는 시스템 진입점이며 별도의 구성 시스템은 아닙니다. 사용할 수 있는 크기, 위치와 동작은 기기와 시스템, 해당 기기의 Shadowrocket에서 제공하는 항목에 따라 달라집니다. 현재 연결 상태와 Global Routing을 확인할 때는 Home으로 돌아가 확인하세요. Widget 표시는 시스템 새로고침 시점의 영향을 받을 수 있으므로 실시간 로그나 앱 내부 상태를 매 순간 그대로 보여주는 화면으로 간주하면 안 됩니다.

Widget을 추가하지 않은 상태에서 시작

Widget 추가 여부는 시스템 레이아웃에 따라 달라지며 기기를 복원하면 이전 레이아웃이 돌아올 수도 있습니다. 빠른 진입이 필요하지 않다면 현재 시스템 레이아웃을 그대로 사용해도 앱 내 연결에는 영향이 없습니다. 사용할 경우 Shadowrocket이 정상적으로 열리고 최초 연결에 필요한 시스템 확인을 완료했는지 먼저 확인하세요. 그런 다음 시스템이 지원하는 Widget 추가 화면에서 Shadowrocket을 검색하고 시스템에 표시되는 크기와 위치를 선택합니다. 다른 기기의 화면을 보고 이 기기에도 같은 옵션이 있다고 판단하지 마세요. 시스템에서 Widget을 추가하거나 제거하는 것은 Config를 변경하는 작업이 아닙니다.

레이아웃을 선택하기 전에 용도를 정하세요. 홈 화면에서 평소 연결 상태만 확인할지, 시스템이 지원하는 위치에서 빠른 조작도 할지 결정합니다. 크기에 따라 표시 정보가 다를 수 있습니다. 상태만 확인한다면 추가 항목 때문에 더 큰 공간을 차지할 필요는 없습니다. 다른 사람이 기기를 사용하거나 공공장소에서 화면이 보일 수 있다면 실제로 어떤 정보가 표시되는지 확인한 뒤 눈에 잘 띄는 위치에 둘지 결정하세요. 먼저 하나만 추가해 상태를 비교하고, 새로고침 시점 차이로 두 Widget을 잘못 해석하지 않도록 다른 위치는 확인 후 추가하세요.

한 번 비교해 표시와 동작 구분

  1. Home을 열어 연결 상태, 현재 Global Routing과 선택된 서버를 기록하세요. 시스템에서 Widget이 있는 위치로 돌아가 먼저 누르지 말고 표시 내용이 방금 확인한 상태와 일치하는지 살펴봅니다. 앱 내부 상태보다 늦게 반영되면 새 연결 실패가 아니라 표시 시점의 차이로 보세요.
  2. 현재 Widget에 조작 기능이 있다면 한 번만 실행하세요. Home으로 돌아가 예상한 동작이 실제로 발생했는지 확인한 뒤 실제 요청을 보내 테스트합니다. 시스템 확인 창이 나타나면 계속할지 안내를 먼저 확인하고 새로고침을 강제하려고 반복해서 누르지 마세요.
  3. 수동 연결과 On Demand 활성화 상태에서 각각 비교 테스트를 한 번씩 진행하세요. 수동으로 연결을 해제한 뒤 자동으로 다시 연결된다면 트리거 조건과 종료를 참고해 시스템 동작을 확인하세요. Widget에 표시된 문구의 순서만으로 어느 진입점이 연결을 시작했는지 판단할 수 없습니다.

진입점이 없거나 표시가 늦거나 동작하지 않음

시스템에서 Shadowrocket을 검색할 수 없다면 앱을 열어 기본 설정을 완료했는지 확인한 다음 시스템의 추가 목록으로 돌아가 현재 Widget을 제공하는지 살펴보세요. 앱은 정상적으로 동작하지만 연결 전환 직후 시스템 상태만 잠시 다르면 시스템이 새로고침될 때까지 기다리거나 앱으로 돌아가 확인하세요. 표시 지연을 해결하려고 구성을 복원하거나 서버를 바꾸지 마세요. 여러 번 비교해도 갱신되지 않으면 해당 Widget만 제거한 뒤 시스템 목록에서 다시 추가해 기존 인스턴스에서만 문제가 발생하는지 확인할 수 있습니다.

눌렀을 때 연결은 바뀌지 않고 앱만 열린다면 해당 진입점이 직접 조작을 지원하는지, 시스템에서 잠금 해제나 추가 확인을 요구하는지 살펴보세요. Home에서는 수동 연결이 되고 실제 트래픽도 정상이라면 Widget 단계에서 계속 점검하면 됩니다. 수동 연결도 실패하는 경우에만 DNS, 서버 또는 규칙을 확인하세요. Widget을 사용하지 않는다면 시스템 레이아웃에서 제거한 뒤 Home에서 평소 설정이 그대로인지 확인합니다. Widget 제거는 연결 해제나 On Demand 끄기를 뜻하지 않습니다. 두 항목은 각각 따로 확인해야 합니다.

07 데이터 동기화

iCloud 동기화: 범위, 충돌 및 복구

iCloud 동기화는 기능을 지원하는 기기 사이에서 클라이언트가 지정한 데이터를 동기화합니다. 모든 구성, 구독 상태, 시스템 권한과 실행 중인 연결까지 동일해진다고 단정하지 마세요. 새 기기에 항목이 동기화된 뒤에도 활성화된 Config, 현재 Global Routing, 시스템 연결 허가를 확인해야 합니다. 읽을 수 있는 구성 파일 하나만 옮기려는 경우에는 앱에서 실제로 제공하는 내보내기 범위를 먼저 확인하세요. 파일 하나를 옮기기 위해 지속적인 동기화를 켤 필요는 없습니다.

시스템, 클라이언트, 데이터 범위 세 가지 확인

각 기기가 같은 iCloud 계정으로 로그인되어 있는지 확인하고, 시스템 설정에서 해당 앱의 iCloud 사용을 허용했는지 살펴보세요. 마지막으로 Shadowrocket에 표시된 동기화 상태와 지원 범위를 확인합니다. 시스템이 앱의 iCloud 접근을 허용해도 클라이언트가 동기화를 시작한 것은 아닙니다. 클라이언트에 동기화 옵션이 있어도 모든 데이터가 대상에 포함되는 것은 아닙니다. 두 기기에 실제로 표시된 상태를 기준으로 판단하세요. 한 기기만 동기화할 필요가 없다면 현재 설정을 유지해도 됩니다. 처음 테스트할 때는 데이터가 완전한 기기 하나를 기준으로 삼고 양쪽에서 동시에 자료를 정리하지 마세요.

iCloud 동기화와 App Store에서 구입한 앱을 다시 받는 것은 서로 다른 작업입니다. 전자는 앱 데이터와 클라우드 상태에 관한 것이고, 후자는 계정의 앱 구입 기록에 관한 것입니다. 앱을 다시 설치할 수 있다고 해서 로컬 구성 파일이나 가져온 데이터까지 복구된 것은 아닙니다. 새 기기의 시스템 연결 권한도 실제 안내에 따라 확인해야 하며 이전 기기에서 그대로 복사될 것이라고 기대하지 마세요. 획득 방법은 다운로드 페이지의 구입 항목 복원 안내에서 앱 획득과 데이터 이전을 구분한 뒤 동기화 상태를 확인하세요.

활성화 전에 백업하고 처음에는 항목 하나만 확인

  1. 데이터가 가장 완전한 기기를 정하고 클라이언트가 실제로 제공하는 방법으로 보관할 구성 파일의 복사본을 저장하세요. 내보내기에 포함되지 않는 항목도 기록합니다. 구성을 내보낼 수 있다고 해서 모든 상태를 내보낼 수 있는 것은 아닙니다. 파일에 자신의 서버 또는 구독 정보가 포함되어 있다면 직접 관리하는 위치에 보관하고 비교를 위해 공개 디렉터리에 올리지 마세요.
  2. 다른 기기에서 동시에 편집하지 않도록 한 뒤 양쪽의 시스템 및 앱 옵션을 각각 확인하세요. 인증 정보가 없고 구별하기 쉬운 테스트 구성 복사본을 선택해 해당 데이터 유형이 동기화 범위에 포함된다면 그 항목 하나만 나타나는지 확인합니다. 결과를 확인하기 전에 동기화 시작 여부를 판단하려고 기존 파일을 삭제하지 마세요.
  3. 대상 기기에 테스트 복사본이 도착하면 파일 내용과 활성화 상태를 비교하고 수동으로 활성화해야 하는지 확인하세요. 이어서 같은 대상으로 실제 접속을 테스트합니다. 이름만 같고 내용이 다르면 두 복사본을 모두 보존하고 성급하게 교체하거나 동기화를 반복해서 켜지 마세요.

같은 이름의 파일, 동기화 지연 및 실수로 삭제

이름이 같다고 같은 항목은 아니며 목록 순서만으로 최신 파일을 판단할 수도 없습니다. 충돌이 발생하면 양쪽의 편집을 잠시 멈추고 보관할 후보 파일을 각각 저장한 뒤 실제 내용을 비교하세요. 특히 [General]과 [Rule]을 확인합니다. 동기화가 진행되지 않는 것처럼 보인다면 먼저 시스템 접근 허용 여부, 네트워크 연결, 클라우드 저장 공간, 테스트 데이터가 확인된 동기화 범위에 속하는지 살펴보세요. 첫 단계부터 계정에서 반복적으로 로그아웃하거나 앱을 삭제하거나 클라우드 데이터를 지우지 마세요. 원래 상태를 확인하기가 더 어려워질 수 있습니다.

이전 상태로 돌아가야 한다면 변경이 아직 반영 중일 수 있는 두 기기를 번갈아 수정하지 말고 변경 전에 저장한 파일을 기준으로 하세요. 먼저 한 기기에서 로컬 기준 상태를 만들고 파일을 다시 활성화해 정상 작동하는지 확인한 뒤 동기화를 계속할지 결정합니다. 마지막으로 기기 간 동기화가 확인된 데이터와 수동 확인이 필요한 항목을 기록하세요. 다음 기기 교체 때 이 목록에 따라 확인하고, 지난번에 항목 하나가 나타났다는 이유로 모든 데이터가 복구된 것으로 간주하지 마세요.

08 로컬 프록시 진입점

Proxy 포트: 수신 범위와 최소 설정

Proxy 포트가 로컬 프록시 설정에 표시된다면 다른 앱이 이 기기의 프록시 진입점에 연결할 때 사용하는 포트입니다. 가져온 서버가 원격에서 사용하는 포트도 아니고 Global Routing의 Proxy 모드도 아닙니다. 먼저 실제로 수동 프록시 입력이 필요한 앱이 있는지 확인하세요. 기기에서 Shadowrocket을 정상적으로 사용할 뿐이라면 Home 연결을 위해 추가 수신 진입점을 열 필요가 없습니다. 로컬 포트를 바꿔도 이미 실패한 원격 연결은 복구되지 않습니다.

프로토콜, 바인딩 주소, 포트 확인

현재 플랫폼에서 해당 설정을 제공하는지 먼저 확인한 뒤 표시된 로컬 프록시 프로토콜, 실제 수신 범위와 포트를 살펴보세요. HTTP와 SOCKS5는 서로 다른 접속 방식입니다. 사용하는 쪽에서 프로토콜을 잘못 설정하면 포트에 연결되어도 요청을 정상적으로 완료하지 못할 수 있습니다. 기본 포트 번호는 화면에 표시된 값을 기준으로 확인하고 원격 서버 항목에서 역으로 추측하지 마세요. 다른 기기와 숫자를 맞추려고 변경할 필요도 없습니다. 변경해야 한다면 클라이언트에서 명확히 지원하고 다른 프로그램이 사용 중이 아닌 포트를 선택한 뒤 해당 진입점을 사용하는 앱의 설정도 함께 수정하세요.

같은 기기에서 사용할 때는 가급적 로컬 루프백 범위에서만 연결할 수 있도록 설정하고, 사용하는 앱에서도 같은 주소 계열을 입력하세요. 화면에서 이 기기 외의 장치가 접근하도록 허용하고 테스트 네트워크와 접근 범위를 제어할 수 있을 때만 명확한 용도로 LAN 사용을 일시적으로 활성화합니다. 공용 또는 공유 네트워크에서는 수신 범위를 넓히지 마세요. 라우터에서 이 진입점의 포트를 공용 인터넷으로 전달하거나 테스트를 위해 시스템 보호 기능을 끄지 마세요. 필요한 바인딩 제어를 화면에서 제공하지 않는다면 범위를 확인할 수 있는 방식을 사용하고 주소를 추측해서 입력하지 마세요.

실패 단계별로 원인을 좁히기

증상먼저 확인할 항목
같은 기기에서 진입점에 연결할 수 없음수신이 시작되었는지, 주소 계열이 일치하는지, 포트가 올바르며 다른 곳에서 사용 중이지 않은지 확인합니다.
포트에 연결되지만 요청 실패사용 앱의 프로토콜과 수신 프로토콜이 일치하는지 확인한 뒤 대상 요청이 Log에 나타나는지 살펴봅니다.
같은 기기에서는 정상이고 다른 기기에서는 실패수신 범위, 두 기기의 네트워크, LAN 격리 정책을 확인합니다.

같은 기기에서 취소할 수 있는 테스트를 한 번 진행하세요. 수동 프록시를 명확히 지원하는 앱 하나에서 기존 설정을 기록하고 확인된 프로토콜, 수신 주소와 포트를 입력한 뒤 새 요청을 한 번 보냅니다. 연결할 수 없다면 원격 포트를 바꾸지 말고 진입점이 열려 있는지부터 확인하세요. 진입점에는 도달했지만 요청이 실패하면 Log에 테스트 시간과 일치하는 대상이 나타나는지 살펴봅니다. 요청이 클라이언트에 들어온 것을 확인한 뒤에야 규칙 경로, DNS, 원격 프로토콜 문제를 구분합니다. 진입점 연결과 대상 접속은 서로 별개의 확인 과정입니다.

같은 기기에서 사용하는 루프백 주소는 다른 기기에서 이 진입점에 접근할 때 사용할 수 없습니다. 다른 기기는 해당 주소를 자기 자신의 로컬 주소로 해석하기 때문입니다. 승인된 LAN 사용이 필요하다면 현재 네트워크에서 수신 기기가 사용하는 실제 주소와 두 기기가 게스트 네트워크 또는 조직 정책으로 격리되어 있는지 확인하세요. 네트워크가 바뀌면 이전 주소가 더 이상 유효하지 않을 수 있습니다. 이로 인한 실패를 서버 설정 문제로 판단하지 마세요. 관리되는 네트워크에서는 해당 사용 정책을 따르고 접근 범위를 넓혀 제한을 우회하지 마세요.

이 매뉴얼은 iPhone / iPad 인터페이스를 기준으로 설명합니다. Mac(Apple 실리콘 및 Intel), Windows, Android, Linux에서 같은 옵션을 제공하는지는 해당 클라이언트에서 확인하세요. 획득 방법은 두 가지입니다. iPhone / iPad 버전은 App Store에서 받을 수 있으며 미국 스토어 가격은 $2.99 일회성 결제입니다. 시스템 요구 사항은 App Store 페이지 표기를 기준으로 합니다. Mac / Windows / Android / Linux 버전은 무료이며 설치 파일은 이 사이트에서 배포합니다. 클라이언트의 일회성 구매는 회선 요금제와 별개입니다. 이 사이트는 노드나 구독을 제공·판매·추천하지 않습니다. 연결과 테스트에는 이미 보유한 정보를 사용하세요. 플랫폼별 설치 경로와 시스템 안내는 클라이언트 다운로드에서 확인할 수 있습니다.