01 · Add Server / Subscribe: 기존 정보 추가

Shadowrocket을 열고 Home으로 이동합니다. 처음 사용하는 경우 목록에 서버 항목이 없을 수 있으며, 이는 아직 정보를 가져오지 않은 정상적인 상태입니다. 오른쪽 위의 더하기 버튼을 눌러 Add Server로 이동한 다음 보유한 정보에 따라 가져오기 방식을 선택합니다. 아래 방법 중 하나만 완료하면 됩니다. 시작하기 위해 같은 정보를 여러 번 추가할 필요는 없습니다.

기존 구독 링크: Subscribe 선택

Add Server의 Type에서 Subscribe를 선택하고 본인의 전체 구독 주소를 URL에 입력합니다. 알아보기 쉬운 이름을 지정한 뒤 저장합니다. 붙여넣을 때 주소 앞뒤에 공백, 줄바꿈 또는 설명 문구가 들어가지 않았는지 확인하세요. 주소의 물음표 뒤에 있는 매개변수는 삭제하지 마세요. 구독을 식별하는 데 사용될 수 있습니다. 저장한 뒤 업데이트가 끝날 때까지 기다리고 Home으로 돌아가 구독 그룹과 그 안의 서버 항목을 확인합니다.

구독 이름이 보인다고 서버 가져오기가 완료된 것은 아닙니다. 해당 그룹을 펼치거나 열어 선택할 수 있는 서버가 실제로 표시되는지 확인하세요. 그룹만 있고 항목이 없다면 연결 스위치를 켜기 전에 구독 업데이트 결과를 점검해야 합니다. 업데이트에 실패하면 원래 주소를 그대로 두고 유효한 구독인지, 현재 네트워크에서 해당 주소에 접속할 수 있는지 확인한 다음 서비스 제공자에게 Shadowrocket에 적합한 형식인지 문의하세요. 내용이 표시되도록 주소의 매개변수를 임의로 바꾸지 마세요.

기존 서버 한 개: 프로토콜에 맞게 입력

서버 매개변수를 받았다면 Add Server에서 먼저 정보와 일치하는 Type을 선택하고 주소, 포트, 인증 정보를 입력합니다. 프로토콜마다 표시되는 필드가 다릅니다. 예를 들어 일부 유형은 Password를, 다른 유형은 UUID를 사용하며 서로 바꿔 쓸 수 없습니다. 서버 주소, TLS 관련 이름, 전송 경로도 각각 용도가 다를 수 있으므로 원본 정보를 기준으로 하나씩 입력하세요. 비슷해 보이는 필드를 하나의 값으로 합치지 마세요. 프로토콜 필드의 자세한 의미는 프로토콜 기술 참고 자료에서 확인할 수 있습니다.

서비스 제공자가 제공한 QR 코드가 있다면 Home의 추가 메뉴에서 Scan QR Code를 사용하세요. 가져온 뒤에도 항목 상세 정보를 열어 유형과 주소를 확인해야 합니다. 스캔은 입력을 줄여줄 뿐, 정보가 여전히 유효하다는 것을 증명하지 않습니다. 저장한 뒤 Home으로 돌아가 사용할 서버를 선택하고 선택 상태인지 확인합니다. 여기까지는 정보를 앱에 입력한 단계입니다. 다음으로 어떤 연결을 처리할지 정해야 합니다.

02 · Global Routing: 연결 경로 설정

Home에서 Global Routing을 누르고 Config, Proxy 또는 Direct를 선택합니다. 이 세 가지는 연결 경로를 결정하며 서버 프로토콜이나 속도 등급을 뜻하지 않습니다. 처음 확인할 때는 현재 선택 사항을 기억해 두세요. 같은 서버도 설정에 따라 접속 결과가 달라질 수 있어 매개변수가 갑자기 작동하지 않는 것처럼 오해하기 쉽습니다.

Config: 기존 규칙에 따라 분기

일상적인 규칙 기반 분기에 Config를 선택합니다. 현재 활성화된 설정에 따라 연결을 처리하므로 선택하기 전에 Config로 이동해 사용할 수 있는 설정이 있고 원하는 설정이 선택되어 있는지 확인하세요. 규칙은 일반적으로 위에서 아래 순서로 일치 여부를 확인하고, 일치하면 해당 정책을 사용합니다. DIRECT는 직접 연결하고 PROXY는 프록시 정책으로 전달하며 REJECT는 연결을 거부합니다. 설정에서 정책 그룹을 사용하는 경우 그룹 안에서 실제로 어떤 항목이 선택되어 있는지도 확인해야 합니다. Home에서 특정 서버를 선택했다고 해서 모든 정책 그룹이 그 서버를 사용한다고 단정할 수는 없습니다.

현재 사용할 수 있는 본인 설정이 없다면 Config를 선택하는 것만으로 분기가 완료되었다고 생각하지 마세요. 먼저 다음 방법으로 서버를 확인한 뒤 설정을 정리하세요. 내용을 모르는 상태에서 기존 Config를 덮어쓰지 마세요. 기존 설정이 있다면 복사본을 보관하고 확인이 필요한 규칙만 수정하세요. Rule 일치 범위와 설정 복원에 관한 자세한 내용은 FAQ에서 확인할 수 있습니다.

Proxy와 Direct: 경로를 구분해 확인

Proxy는 선택한 서버가 실제 요청을 처리할 수 있는지 잠시 확인할 때 적합합니다. 일반적으로 앱이 처리하는 연결을 프록시 경로로 전달하므로 규칙과 서버 요인을 구분해 확인하기 쉽습니다. 다만 서버 사용 가능 여부는 주소, 매개변수, 네트워크에 따라 달라집니다. 확인이 끝난 뒤 규칙에 따라 사용하려면 Config로 돌아가 다시 확인하세요. Proxy 테스트 한 번으로 분기 설정이 올바르다고 판단하면 안 됩니다.

Direct는 앱이 처리하는 연결을 직접 연결 경로로 전송하며 프록시 서버가 작동하는지 확인하는 데 사용하지 않습니다. 네트워크의 기본 상태와 비교할 때 사용할 수 있지만, 변경 후에는 필요한 설정으로 되돌리는 것을 잊지 마세요. Global Routing을 선택한 뒤 Home으로 돌아가 서버 선택 상태를 다시 확인하고 첫 연결을 진행합니다.

03 · Home: 스위치를 켜고 VPN 구성 허용

Home으로 돌아와 선택한 서버와 Global Routing을 다시 확인한 다음 상단의 연결 스위치를 켭니다. 처음 연결할 때 iPhone/iPad에 시스템의 VPN 구성 추가 안내가 표시될 수 있습니다. 방금 실행한 Shadowrocket에서 시작된 작업인지 확인한 뒤 추가를 허용하고 기기 암호 또는 생체 인증으로 시스템 확인 절차를 완료합니다. 여기서 허용하는 것은 기기에 로컬 VPN 구성을 만드는 기능이며, 서버를 구매하거나 개통하는 것이 아닙니다.

허용한 뒤 Shadowrocket으로 돌아와 연결 스위치가 켜진 상태로 유지되는지, 앱에 연결됨으로 표시되는지 확인합니다. 시스템 설정에 VPN 상태가 표시되더라도 시스템 측의 연결 구성이 활성화되었다는 의미일 뿐 서버 사용 가능 여부를 알려주는 것은 아닙니다. 서버 비밀번호가 틀리거나 대상 도메인 확인에 문제가 있거나 규칙 경로가 예상과 다르면 연결 상태가 유지될 수도 있으므로 다음 절의 실제 접속 확인도 진행해야 합니다.

스위치를 켠 직후 다시 꺼지면 처음 표시된 시스템 안내를 취소했는지 먼저 확인하세요. 시스템 Settings를 열고 VPN을 검색해 해당 구성이 있는지, 기기에 관리 제한이 적용되어 있는지 확인할 수 있습니다. 학교나 회사에서 관리하는 기기라면 관리 요구 사항을 따르세요. 영향을 잘 모르는 상태에서 다른 VPN 구성이나 프로파일을 삭제하지 마세요. 이미 작동 중인 다른 VPN도 연결에 영향을 줄 수 있으므로 테스트 전에 어떤 구성이 현재 연결을 처리하는지 확인하세요.

처음 사용할 때는 수동 연결을 유지하고 On Demand를 바로 켜지 않는 것이 좋습니다. 자동 연결은 네트워크가 바뀐 뒤 연결을 다시 설정하므로 연결을 끈 상태와 비교하기 어려울 수 있습니다. 수동 확인을 마친 다음 On Demand의 적용 조건을 살펴보세요. 연결 중 스위치를 빠르게 반복해서 전환할 필요는 없습니다. 상태가 안정될 때까지 기다리고 오류가 표시되면 기록한 뒤 다음 단계로 진행하면 문제 원인을 더 잘 파악할 수 있습니다.

04 · Connectivity Test: 테스트 및 실제 접속 확인

먼저 Home에서 Connectivity Test를 사용해 서버 항목에 연결할 수 있는지 확인하고 선택한 항목의 결과를 살펴봅니다. 이 기능은 명백한 시간 초과를 빠르게 찾는 데 유용하지만 테스트 방식과 대상에 따라 결과가 달라질 수 있습니다. 표시된 수치 한 번으로 전체 사용 경험을 판단하거나, 한 번의 시간 초과로 모든 요청이 실패한다고 단정하지 마세요. 테스트가 끝나면 서버와 Global Routing을 그대로 둔 채 브라우저에서 실제 접속을 확인합니다.

평소 익숙하고 현재 정상 작동해야 하는 웹페이지를 열어 로딩되는지 확인한 다음 다른 사이트도 열어보세요. 한 페이지만 테스트하면 대상 사이트의 장애, 캐시된 내용 또는 로그인 상태가 판단에 영향을 줄 수 있습니다. 페이지가 열린 것만으로 프록시 경로를 확인한 것은 아닙니다. Global Routing과 현재 Config의 Rule을 함께 확인해 요청이 DIRECT와 PROXY 중 어느 경로를 사용해야 하는지 살펴보세요.

앱의 연결 기록에 요청 일치 정보가 제공되면 대상 도메인, 일치한 규칙, 정책을 확인할 수 있습니다. Config를 사용하는 경우 특정 사이트가 직접 연결되는 것이 규칙의 의도일 수 있습니다. 프록시를 거치지 않았다는 이유만으로 연결이 적용되지 않았다고 판단하지 마세요. 반대로 PROXY로 전달되어야 하는 요청이 예상대로 처리되지 않으면 서버 정보를 곧바로 바꾸기보다 규칙 순서, 설정 선택, 정책 그룹을 점검하세요.

결과를 명확하게 비교하려면 현재 설정, Connectivity Test 결과, 브라우저의 실제 요청 성공 여부를 기록하세요. 필요하면 Proxy로 한 번만 전환해 같은 대상을 다시 확인합니다. Proxy는 정상이지만 Config에서 문제가 생기면 규칙이나 정책 설정을 우선 확인하세요. 두 방식 모두 실패하면 서버 매개변수와 네트워크를 확인합니다. 재확인이 끝난 뒤 일상적으로 필요한 설정으로 되돌려 임시 진단 상태를 장기 설정으로 남기지 마세요.

마지막으로 브라우저에서 대상 페이지를 닫았다가 다시 열어 이전 캐시로 인한 오판 가능성을 줄입니다. 같은 페이지를 계속 새로고침해 모든 앱의 연결 상태를 추정하지 마세요. 앱마다 기존 연결을 유지할 수 있으므로 설정 변경을 확인하려면 새 요청을 보내야 할 수 있습니다. 무엇을 선택했고 요청이 어떤 경로를 거쳤으며 결과가 어땠는지 설명할 수 있다면 첫 확인을 마친 것입니다.

05 · 일반적인 실패 원인: 단계별로 확인하고 한 번에 하나씩 변경

연결에 실패하면 가장 먼저 예상과 달랐던 단계부터 확인합니다. 가져오기가 완료되지 않았다면 가져오기를 바로잡고, 서버 테스트가 계속 시간 초과되면 매개변수를 먼저 확인합니다. Config에서만 결과가 다르면 규칙을 확인하세요. 문제를 단계별로 나누면 이미 올바른 부분을 계속 바꾸어 하나의 오류를 여러 오류로 만드는 일을 줄일 수 있습니다.

Home에 선택할 서버가 없음: 구독에서 실제 항목이 생성되었는지, 업데이트 중 오류가 있었는지, 단일 서버 정보를 Subscribe에 잘못 입력했는지 확인합니다. 구독 이름만 보인다고 내용 해석까지 완료된 것은 아닙니다. 형식과 유효 상태는 본인의 서비스 제공자에게 확인하고 Global Routing은 아직 변경하지 마세요.
항목은 있지만 Connectivity Test가 시간 초과됨: 항목 상세 정보를 열어 주소, 포트, Password 또는 UUID, TLS 및 전송 매개변수를 하나씩 확인합니다. 대소문자, 경로 시작 부분의 슬래시, 복사 과정에서 빠진 끝부분도 살펴보세요. 흔히 쓰는 값일 것이라는 추측만으로 포트를 변경하지 말고 원본 정보를 따르세요.
테스트와 요청이 모두 실패함: 기기의 날짜, 시간, 시간대가 올바른지 확인하고 시스템 자동 설정을 켠 뒤 다시 시도합니다. 시간 오차는 인증서나 인증에 영향을 줄 수 있습니다. 이어서 가능하면 Wi-Fi와 셀룰러 네트워크에서 각각 테스트하되 한 번의 테스트 동안 서버와 매개변수는 그대로 유지하세요. 한 네트워크에서만 실패하면 네트워크 차이를 기록하고 전체 설정을 급히 다시 만들지 마세요.
연결 스위치가 켜진 상태로 유지되지 않음: 시스템 VPN 설정으로 돌아가 추가 권한과 현재 연결 구성을 확인하고 다른 VPN이 연결을 처리하는지 살펴봅니다. 시스템에 기기 관리 제한이 있다면 관리자에게 확인하세요. 영향을 이해하고 기존 구성을 보존할 수 있는 경우에만 충돌을 처리하고 인증서나 기기의 전체 네트워크 설정을 함부로 삭제하거나 재설정하지 마세요.
Proxy는 작동하지만 Config 결과가 예상과 다름: Config에서 올바른 파일이 활성화되어 있는지 확인하고 대상 요청과 일치한 Rule 및 해당 정책을 점검합니다. 먼저 일치하는 광범위한 규칙 때문에 뒤에 있는 세부 규칙이 적용되지 않을 수 있습니다. 정책 그룹이 사용할 수 없는 항목을 가리키면 서버 단독 테스트는 정상이더라도 실제 연결이 실패할 수 있습니다.
특정 웹페이지나 앱만 문제가 있음: 대상 서비스 장애, 도메인 확인 실패, 연결 경로 오류를 구분합니다. TLS 확인을 바로 끄거나 DNS를 광범위하게 변경하지 마세요. 문제가 발생한 도메인, 오류 메시지, 현재 네트워크, 경로 설정을 기록한 뒤 FAQ의 규칙 및 문제 해결 안내를 확인하고 증상에 맞춰 진행하세요.

항목을 하나 변경할 때마다 같은 확인 대상으로 돌아가 다시 테스트하고 결과가 달라졌는지 기록하세요. 서비스 제공자에게 문의할 때는 필요한 오류 상황, 프로토콜 유형, 민감 정보를 가린 매개변수만 전달하고 전체 구독 주소, 인증 정보, QR 코드는 공개하지 마세요. 프로토콜 필드가 다른 이유를 알아보려면 프로토콜 기술 참고 자료를 확인하세요. 처음 연결하기 전에 모든 프로토콜을 미리 공부할 필요는 없습니다.

완료 후에는 사용할 정보를 가져왔는지, 어떤 항목을 선택했는지, Global Routing을 어떻게 설정했는지, 테스트와 실제 접속 결과가 각각 어땠는지 기록해 두세요. 이후 구독을 업데이트하거나 Config를 조정할 때는 한 번에 한 단계만 변경하고 다시 확인합니다. 네트워크 환경이 바뀌더라도 마지막으로 성공한 상태부터 점검할 수 있습니다.

Shadowrocket 시작 가이드