공식 가이드 / 첫 설정

Shadowrocket 빠른 시작

서버 추가부터 트래픽 분리 확인까지 안내합니다. 순서대로 진행하고 각 단계의 결과를 확인한 후 다음 단계로 넘어가세요.

단계 01 / 서버 준비

서버 추가 또는 구독 가져오기

Shadowrocket을 열고 하단의 Home으로 이동합니다. 먼저 가지고 있는 정보가 어떤 종류인지 확인하세요. 구독 링크 하나로 여러 서버 정보를 가져오는 경우가 많고, 단일 서버 정보에는 프로토콜, 주소, 포트, 인증 매개변수가 각각 제공됩니다. 두 방법 중 하나를 선택하면 됩니다. 서버를 수동으로 추가한 뒤 같은 항목을 구독으로 다시 가져올 필요는 없습니다.

수동 추가: Type을 선택한 다음 필드 입력

Home 오른쪽 위의 더하기 버튼을 누르고 Add Server로 이동합니다. 먼저 제공된 정보에 명시된 프로토콜을 Type에서 선택합니다. 프로토콜에 따라 표시되는 필드가 달라집니다. Shadowsocks를 예로 들면 Host에는 서버 도메인 또는 IP 주소를, Port에는 포트 번호를 입력합니다. 그런 다음 Password를 입력하고 Method에서 서비스 제공업체가 지정한 방식을 선택합니다. 주소와 포트는 각각 입력하고, URL 접두사나 경로, 포트까지 Host에 함께 붙여 넣지 마세요. 매개변수를 복사한 후 앞뒤에 공백이나 줄 바꿈이 추가되지 않았는지 확인합니다.

각 필드가 원본 정보와 일치하는지 확인한 뒤 저장하고 Home으로 돌아가 SERVER 아래에 항목이 표시되는지 확인합니다. 주소와 포트만 있고 Type이나 인증 매개변수를 모른다면 서비스 제공업체에 먼저 확인하세요. 다른 프로토콜의 예시 값을 사용해 누락된 항목을 채우지 마세요. 오른쪽 화면의 Scan QR Code와 Import from Cloud JSON은 다른 가져오기 방법입니다. 직접 입력할 때는 이용하지 않아도 됩니다.

구독으로 가져오기: 저장 후 SERVER 확인

구독 링크를 받았다면 Home에서 더하기 버튼을 누르고 Add Server의 Type에서 Subscribe를 선택합니다. 전체 링크를 URL 필드에 붙여 넣고 저장합니다. 링크에 포함된 경로와 쿼리 매개변수는 그대로 유지하고, 서비스 제공업체의 로그인 페이지 주소로 바꾸지 마세요. Home으로 돌아가 구독이 로드될 때까지 기다린 다음 SERVER에서 해당 그룹을 찾아 항목이 있는지 확인합니다. 구독 링크에는 접근 정보가 포함될 수 있으므로 스크린샷이나 로그와 함께 공개적으로 전송하지 마세요.

선택할 수 있는 서버가 표시되면 Global Routing 설정을 진행합니다. 그룹 이름만 있고 서버가 없다면 먼저 가져오기 문제를 해결하세요. 연결 스위치를 반복해서 켰다 꺼도 비어 있는 그룹에 항목이 자동으로 추가되지는 않습니다.

Shadowrocket의 Add Server 화면. Type, Host, Port, Password, Method 필드와 하단의 가져오기 메뉴 두 개가 표시됩니다
Add Server: 먼저 Type을 확인한 다음 프로토콜에 맞는 필드를 입력합니다.

단계 02 / 트래픽 처리 방식 지정

Global Routing 모드 선택

Home에서 Global Routing을 누릅니다. 이 설정은 클라이언트가 연결을 처리한 뒤 트래픽을 어떻게 다룰지 정합니다. 서버를 추가하거나 SERVER에서 선택한 항목을 바꾸는 설정은 아닙니다. 대상에 따라 프록시 또는 직접 연결을 다르게 적용하려면 일반적으로 구성(Config)을 선택하고, 사용할 구성 파일이 적절한지 확인하세요.

  • 구성(Config): 현재 구성 파일의 규칙에 따라 처리 방식을 선택합니다. 대상에 따라 프록시와 직접 연결을 각각 사용할 수 있으므로 모든 요청이 같은 경로를 거칠 필요는 없습니다.
  • 프록시(Proxy): 클라이언트가 처리하는 트래픽을 프록시로 보냅니다. 처음 문제를 점검할 때 잠시 이 모드로 전환해 선택한 서버가 테스트 대상에 연결할 수 있는지 확인한 다음 원래 모드로 돌아갈 수 있습니다.
  • 직접 연결(Direct): 클라이언트가 처리하는 트래픽을 선택한 프록시 서버를 거치지 않고 직접 연결합니다. 비교 테스트에 적합하지만 Home의 연결 스위치를 끄는 것과는 다릅니다.

구성(Config)을 사용하기 전에 현재 파일 확인

Global Routing의 Config는 모드이며, 하단의 Config는 구성 파일을 관리하는 페이지입니다. 구성 모드를 선택한 다음 하단의 Config에서 현재 활성화된 파일을 확인합니다. 편집 화면에는 General, Rule, Hosts 등의 섹션이 표시됩니다. 처음 연결할 때는 현재 파일을 확인하고, 테스트 대상에 적용될 처리 방식을 Rule에서 살펴보면 됩니다. 임시로 규칙을 바꾸려고 Add Rule을 누를 필요는 없습니다.

처음 연결을 확인할 때 규칙과 서버를 동시에 변경하지 마세요. 두 가지를 함께 바꾸면 대상에 다시 연결되더라도 어느 변경이 효과가 있었는지 판단하기 어렵습니다. 모드를 선택한 뒤 Home으로 돌아가 Global Routing에 선택한 값이 표시되는지 확인하고 연결을 시작합니다.

Shadowrocket의 Config 구성 파일 편집 화면. General, Rule, Hosts, URL Rewrite, HTTPS Decryption 섹션과 Add Rule이 표시됩니다
Config: 스크린샷은 구성 파일 편집 화면입니다. 모드는 Home의 Global Routing에서 선택합니다.

단계 03 / 연결 설정

Home에서 연결 스위치 켜기

Home으로 돌아가 SERVER에서 방금 추가한 서버를 선택합니다. 구독을 가져온 경우 먼저 해당 그룹으로 이동한 다음 구체적인 항목 하나를 선택하세요. 목록에 서버가 있다고 해서 테스트할 서버가 선택된 것은 아닙니다. 조작하기 전에 항목 이름을 기억해 두면 문제가 생겼을 때 같은 항목으로 다시 테스트할 수 있습니다.

Home 상단의 Not Connected 옆에 있는 스위치를 누릅니다. 처음 연결할 때 시스템에서 Shadowrocket의 VPN 구성 추가를 허용할지 물어볼 수 있습니다. 방금 스위치를 누른 후 Shadowrocket에서 요청한 것인지 확인하고 허용하세요. 시스템에서 기기 인증을 요구하면 안내에 따라 기기에서 완료합니다. 이 단계는 시스템이 클라이언트의 연결을 허용하도록 하는 과정이며, 시스템 팝업에 구독 링크나 서버 비밀번호를 입력할 필요는 없습니다.

인증이 끝나면 Home으로 돌아가 상태가 업데이트될 때까지 기다립니다. 상단의 Not Connected가 Connected로 바뀌면 Global Routing이 두 번째 단계에서 선택한 모드인지 확인합니다. 다른 VPN이 이미 작동 중이라면 해당 앱에서 연결을 끊은 다음 Shadowrocket으로 돌아와 다시 시도하세요. 다른 연결 상태를 이번 테스트 결과로 잘못 판단하지 않도록 하기 위한 조치입니다. 테스트를 위해 기기에 이미 있는 VPN 구성을 임의로 삭제하지 마세요.

앞서 허용하지 않았다면 Home에서 스위치를 다시 켜 시스템 알림이 다시 표시되는지 확인합니다. 스위치를 켠 직후 다시 꺼진다면 계속 누르지 마세요. 팝업이 있었는지, 허용했는지, 서버 선택 전후 어느 시점에 스위치가 꺼졌는지 기록하고 다섯 번째 단계에 따라 원인을 점검합니다. Connected가 표시되더라도 클라이언트가 연결을 설정했다는 것만 확인된 상태입니다. 서버를 사용할 수 있는지, 특정 대상에 예상한 방식이 적용되는지는 다음 단계에서 각각 확인해야 합니다.

Shadowrocket의 Home 화면. 상단에 Not Connected 스위치, 가운데에 Global Routing과 Connectivity Test, 하단에 SERVER 그룹과 Add Server가 표시됩니다
Home: 먼저 SERVER에서 항목을 선택한 다음 상단의 연결 스위치를 조작합니다.

단계 04 / 실제 접속 확인

Connectivity Test와 실제 요청을 함께 확인

세 번째 단계와 같은 네트워크, 서버, Global Routing 모드를 유지합니다. Home에서 Connectivity Test를 누르고 이번 테스트 결과가 나올 때까지 기다린 다음, 결과가 방금 선택한 서버에 해당하는지 확인합니다. 결과가 표시되면 해당 항목이 현재 테스트 방법에서 응답했다는 뜻입니다. 모든 웹사이트에 정상적으로 접속할 수 있다는 의미는 아닙니다. 반대로 한 번 시간 초과가 발생했다고 연결이 끊겼다고 단정할 수도 없습니다. 테스트 대상 자체가 응답하지 않았을 수 있습니다.

현재 모드에 맞춰 테스트 대상 선택

구성(Config)을 선택했다면 브라우저에서 잘 알고 있는 대상 두 곳을 각각 엽니다. 하나는 현재 규칙에 따라 프록시를 사용해야 하고, 다른 하나는 직접 연결해야 하는 대상이어야 합니다. 비교할 때는 규칙이 실제로 일치하는 도메인을 기준으로 합니다. 하나의 페이지가 다른 도메인에 콘텐츠를 요청할 수도 있으므로 페이지가 열린다는 사실만으로 모든 요청이 같은 정책을 따랐다고 볼 수는 없습니다. 캐시된 콘텐츠를 새 연결의 결과로 착각하지 않도록 페이지를 새로고침할 수 있습니다. 특정 대상에 프록시로 접속할 수 있는지만 확인하려면 같은 서버를 유지한 채 프록시(Proxy)로 잠시 전환해 재시도한 다음 구성(Config)으로 돌아갑니다.

직접 연결(Direct)을 선택했다면 현재 결과는 대상에 직접 연결할 수 있는지 확인하는 데만 사용하며, 프록시가 성공했다는 근거로 사용하지 않습니다. 테스트가 끝나면 Home으로 돌아가 스위치와 모드가 평소 사용 방식에 맞는지 확인합니다. Connectivity Test에 응답이 있고 실제 대상에도 접속할 수 있지만 어떤 규칙이 적용되었는지 확인하기 어렵다면 사용 설명서의 규칙 및 연결 확인 섹션을 살펴보세요. 이 문제를 해결하기 위해 구독을 다시 설정할 필요는 없습니다.

단계 05 / 문제 발생 단계 찾기

일반적인 연결 문제를 상황별로 점검

SERVER에 항목이 없음: 먼저 가져오기 확인

구독 그룹이 비어 있다면 붙여 넣은 링크가 완전한지, Type에서 Subscribe를 선택했는지 먼저 확인한 다음 기기가 인터넷에 연결되어 있는지 확인합니다. 링크가 최신이라고 확인했는데 새로고침 후에도 항목이 없다면 서비스 제공업체에 링크가 유효한지, 반환된 내용이 클라이언트에서 사용할 수 있는 형식인지 문의하세요. 수동으로 추가한 항목이 보이지 않으면 Add Server로 돌아가 필수 필드가 모두 입력되었는지, 저장을 완료했는지 확인합니다. 구체적인 서버가 표시된 다음에 연결 모드를 확인하면 됩니다.

스위치가 꺼지거나 자동으로 다시 연결됨: 권한과 자동 연결 구분

시스템의 VPN 구성 확인을 완료하지 못했다면 Home에서 연결을 다시 시작합니다. VPN 권한은 허용했지만 수동으로 연결을 끊은 후 다시 자동 연결된다면 Settings에서 On Demand가 활성화되어 있는지 확인합니다. 한 번 수동 연결만으로 비교하려면 먼저 현재 설정을 기록한 다음 On Demand를 잠시 비활성화하고 Home으로 돌아가 다시 시도하세요. 점검이 끝나면 필요에 따라 원래 설정으로 되돌립니다.

연결되었지만 테스트 실패: 실패 범위부터 구분

먼저 일반적인 네트워크 접속이 정상인지 확인하고 Home에서 선택한 서버와 현재 모드를 점검합니다. Connectivity Test만 시간 초과되고 실제 접속은 정상이라면 Settings에서 Test Method를 확인하세요. 서로 다른 테스트 방법의 결과를 바로 비교하지 않도록 합니다. 테스트와 실제 접속이 모두 실패하면 가능할 때 이미 보유한 다른 서버를 선택해 같은 모드와 대상으로 다시 테스트합니다. 한 번에 한 항목만 변경해 특정 항목에서만 실패하는지, 다른 항목으로 바꾸어도 같은 현상이 나타나는지 확인합니다.

특정 대상 하나만 접속할 수 없고 같은 서버가 프록시(Proxy)에서는 작동하지만 구성(Config)으로 돌아오면 작동하지 않는다면 현재 구성 파일과 Rule의 일치 순서를 먼저 확인합니다. 문제가 계속되면 Settings에서 Diagnostics를 확인하고 기록한 발생 시간 및 상황과 비교합니다. 권한, 가져오기, 라우팅에 관한 자세한 점검 방법은 문제 해결을 참고하세요.

Shadowrocket의 Settings 화면. Language, Test Method, Today Widget, On Demand, Diagnostics, Proxy, TCP, UDP 항목이 나열되어 있습니다
Settings: 상황에 따라 Test Method, On Demand 또는 Diagnostics를 확인합니다.