Shadowrocket
가져오기 및 연결 안내

Add Server / Subscribe: 추가 및 가져오기

Shadowrocket을 열고 Home 화면에 머문 채 연결 스위치를 꺼 둡니다. 다음으로 한 가지 입력 방식을 선택하세요. 구독 링크가 있다면 Subscribe를, 서버 주소와 포트 및 인증 정보가 있다면 Add Server에서 직접 입력합니다. 두 방식 모두 Home에 선택 가능한 서버를 표시하는 것이 목적이므로, 처음 연결할 때 두 작업을 모두 할 필요는 없습니다.

기존 구독 링크가 있는 경우: Subscribe에 URL 저장

Home 오른쪽 위의 더하기 버튼을 눌러 Add Server로 이동한 다음 Type 옵션에서 Subscribe를 선택합니다. 입력 화면으로 돌아오면 본인의 구독 링크 전체를 URL 항목에 붙여 넣으세요. 메모를 추가할 경우 알아보기 쉬운 이름을 사용하면 됩니다. 저장하기 전에 링크의 앞뒤와 쿼리 매개변수가 메신저나 복사 과정에서 잘리지 않았는지 확인하세요. 설명 문구, 공백, 줄바꿈이 링크에 포함되지 않도록 주의합니다.

저장한 뒤 Home으로 돌아와 구독 정보를 불러올 때까지 기다립니다. 구독 그룹과 그 안의 서버 항목이 표시되어야 선택 가능한 정보가 가져와진 것입니다. 그룹 이름만 있고 서버가 없다면 연결 스위치를 바로 켜지 마세요. 먼저 네트워크에서 구독 주소에 접속할 수 있는지 확인한 다음 링크가 유효한지 점검하세요. 구독 URL에 개인 접근 정보가 포함될 수 있으므로 전체 주소를 공개 스크린샷이나 문제 해결 기록에 남기지 마세요.

구독은 서버 정보를 일괄 제공하는 기능이며, 완전한 규칙 설정을 뜻하지는 않습니다. 가져오기가 끝난 뒤에도 다음 단계에서 Global Routing을 확인해야 합니다. 구독을 업데이트하면 목록이 바뀔 수 있으므로 첫 테스트에서는 선택한 항목의 이름을 기억해 두세요. 업데이트 후에도 해당 항목이 있는지 확인하면 목록 변경을 연결 스위치의 오류로 오해하지 않을 수 있습니다.

기존 서버 정보가 있는 경우: 프로토콜에 맞게 Add Server 입력

구독 없이 단일 서버 정보만 있는 경우에도 Home의 더하기 버튼을 눌러 Add Server로 이동한 뒤 Type에서 정보를 제공한 곳에 명시된 프로토콜을 선택합니다. 예를 들어 Shadowsocks, VMess, VLESS 또는 Trojan이 있습니다. 이어서 주소, 포트와 해당 프로토콜에 필요한 인증 정보를 각각 입력하세요. 화면에 표시되는 비밀번호, 식별자, 암호화 방식, 전송 옵션은 서로 바꿔 쓸 수 있는 항목이 아닙니다. 다른 프로토콜의 안내를 참고해 추측해서 입력하지 마세요.

주소에는 제공받은 호스트 이름이나 IP를 입력하고 웹 경로를 임의로 추가하지 마세요. 포트도 해당 서비스에 지정된 값을 사용해야 합니다. TLS, SNI 또는 전송 매개변수가 있다면 제공받은 정보를 그대로 대조해 확인하세요. 비워 두는 것과 특정 값을 입력하는 것은 결과가 다를 수 있습니다. 정보가 부족하면 여러 출처의 매개변수를 한 항목에 섞지 말고 본인이 이용하는 서비스 제공자에게 먼저 확인하세요.

저장한 뒤 Home으로 돌아와 항목 이름과 프로토콜이 예상한 내용과 일치하는지 확인합니다. 이 단계에서는 서버 매개변수를 여러 개 한꺼번에 수정하지 마세요. 목록에 항목이 보인다는 것은 정보가 저장되었다는 뜻일 뿐, 서버에 접속할 수 있다는 의미는 아닙니다. 다음으로 Global Routing에서 이번 연결의 경로를 정하고 연결 가능 여부를 확인하세요. 가져오기 형식에 관한 자세한 내용은 FAQ를 참고하세요.

Global Routing: 라우팅 모드 선택

서버가 Home에 표시되면 Global Routing을 찾아 엽니다. 이 메뉴는 요청을 처리하는 방식을 결정하며 서버 주소나 인증 정보를 수정하지는 않습니다. 처음 사용할 때는 세 가지 모드인 Config, Proxy, Direct의 차이를 확인하세요. 목적에 맞는 항목을 하나 선택한 뒤 Home으로 돌아와 연결을 진행합니다. 테스트도 하기 전에 모드를 반복해서 바꾸지 마세요.

Config: 현재 설정의 규칙에 따라 트래픽 분기

일상적인 규칙 분기가 필요하면 Config를 선택하세요. 그런 다음 Config 화면에서 현재 선택된 설정이 실제로 사용하려는 파일인지 확인합니다. 파일 목록에 있다는 사실만으로 선택된 것은 아닙니다. 설정에 따라 요청마다 서로 다른 정책을 지정할 수 있으므로 Config에서 웹페이지가 열렸는지만으로 기본 서버가 사용되었는지 판단할 수 없습니다.

아직 규칙 설정을 준비하지 않았다면 첫 테스트를 위해 긴 규칙을 급히 복사해 입력할 필요는 없습니다. 먼저 다음 항목인 Proxy를 사용해 서버와 연결 절차를 확인하고, 성공한 뒤 Config에서 트래픽 분기를 살펴보세요. 설정 파일 가져오기, 선택, 규칙 순서는 별도로 다룰 내용입니다. 자세한 내용은 문제 해결 설명서에서 확인할 수 있으며, 이 페이지의 절차를 진행하기 전에 복잡한 설정을 완료할 필요는 없습니다.

Proxy: 먼저 프록시 경로 확인

기존 서버가 작동하는지 처음 확인할 때는 규칙 분기가 판단에 미치는 영향을 줄이기 위해 Proxy를 선택할 수 있습니다. 여기서 Proxy는 Global Routing의 라우팅 모드를 뜻하며 서버를 새로 추가하는 메뉴가 아닙니다. Home에서 기존 서버를 선택한 다음 스위치를 켜야 합니다. Proxy를 선택해도 사용할 수 없는 연결이 자동으로 복구되는 것은 아니며, 기기의 모든 트래픽이 반드시 같은 방식으로 처리된다는 의미도 아닙니다.

Direct: 현재 네트워크와 비교

Direct는 프록시 서버를 거치지 않을 때의 접속 결과를 확인하는 모드입니다. Direct에서는 평소 사용하는 웹페이지가 열리지만 Proxy에서는 열리지 않는다면 서버와 프록시 경로를 우선 확인하세요. 두 모드 모두 실패한다면 기기의 Wi-Fi, 셀룰러 네트워크 또는 웹서비스 상태부터 점검합니다. Direct에서 인터넷에 접속할 수 있다고 해서 프록시 서버가 정상이라는 뜻은 아닙니다. 테스트가 끝나면 원래 사용하려던 모드로 다시 전환하세요.

선택한 뒤 현재 모드를 기억해 두세요. 이후 테스트 결과를 비교하려면 사용한 서버와 Global Routing 모드를 함께 기록해야 합니다. 스위치가 켜졌다는 사실만 기억하면 서버 문제와 트래픽 분기 문제를 구분하기 어렵습니다.

Home: 서버 선택 및 연결 스위치 켜기

Home으로 돌아와 서버 목록에서 방금 확인한 항목을 선택합니다. 서버 왼쪽의 원형 선택 영역을 누르고 선택 표시가 해당 항목에 나타나는지 확인하세요. 편집 화면에 들어간 것을 기본 서버가 바뀐 것으로 착각하지 마세요. 구독에 이름이 비슷한 항목이 여러 개 있다면 처음에는 하나만 선택해 테스트하세요. 작업할 때마다 서버를 바꾸면 어떤 변경 사항이 적용되었는지 알기 어렵습니다.

서버와 Global Routing을 확인한 뒤 Home 상단의 연결 스위치를 켭니다. 처음 사용할 때 시스템에서 VPN 구성 추가 확인 창이 표시될 수 있습니다. 안내에 따라 허용하고 기기에서 요구하는 인증 절차를 완료하세요. 이 허용은 시스템 네트워크 연결을 설정하기 위한 것으로 구독 가져오기가 완료되었다는 알림이 아닙니다. 취소하면 클라이언트로 돌아왔을 때 스위치가 켜진 상태로 유지되지 않을 수 있으므로 다시 연결을 시작하고 시스템 확인을 완료해야 합니다.

허용 절차를 마친 뒤 Shadowrocket으로 돌아와 스위치와 연결 상태가 유지되는지 확인합니다. 시스템 상태 막대나 제어 센터의 VPN 상태는 참고할 수 있지만, 시스템 연결 상태만 보여 줄 뿐 선택한 서버로 웹페이지에 접속할 수 있다는 것을 증명하지는 않습니다. 현재 설정을 유지한 채 다음 단계에서 Connectivity Test를 실행하세요. VPN 표시가 보인다고 확인 절차를 건너뛰지 마세요.

스위치를 켜자마자 다시 꺼지면 먼저 시스템 허용 절차가 완료되었는지, 기기에서 다른 VPN 연결이 작동 중인지 확인하세요. 학교나 회사에서 관리하는 기기에는 네트워크 설정 제한이 있을 수 있으므로 기기 관리 지침에 따라 처리하고 관리 설정을 반복해서 삭제하지 마세요. 현재 서버 정보를 수정해야 한다면 먼저 연결을 끄고 변경 사항을 저장한 뒤 다시 켜는 것이 좋습니다. 그래야 변경 전후 상태가 섞이지 않습니다.

iPad는 화면 공간이 넓어 일부 페이지가 분할 화면으로 표시될 수 있습니다. Home에서 서버를 선택하고 Global Routing에서 모드를 고른 뒤 상단 스위치로 연결하는 순서는 같습니다. 왼쪽에 목록이 계속 보인다고 같은 서버를 다시 추가하지 마세요. 이번에 사용할 항목을 확인한 다음 실제 통신을 점검합니다.

Connectivity Test: 연결 확인

연결을 켠 뒤 Home에서 Connectivity Test를 찾아 실행하고 현재 서버의 결과를 확인합니다. 테스트 결과가 돌아올 때까지 기다려야 합니다. 실행 직후 화면이 비어 있거나 진행 중인 상태를 바로 실패로 판단하지 마세요. 시간 초과가 표시되면 서버와 모드를 그대로 둔 채 한 번 더 테스트하세요. 계속 시간 초과가 발생할 때 다음 점검 단계로 넘어가고, 순간적인 상태만으로 결론 내리지 마세요.

Connectivity Test는 테스트 대상과의 연결 가능 여부를 확인합니다. 성공하면 해당 테스트에서 응답을 받았다는 뜻이지, 모든 웹사이트와 프로토콜 또는 지속적인 전송이 정상이라는 의미는 아닙니다. 표시된 시간도 실제 다운로드 속도를 나타내지 않습니다. 처음 사용할 때는 수치만 반복해서 비교하기보다 하나의 경로가 안정적으로 작동하는지 먼저 확인하세요.

브라우저에서 실제 요청 확인

Shadowrocket 연결을 켜 둔 채 브라우저로 전환해 평소 사용하며 서비스가 정상인지 확인할 수 있는 웹페이지를 엽니다. 이미 불러온 콘텐츠는 네트워크가 바뀐 뒤에도 캐시에서 표시될 수 있으므로 새 페이지를 열고 새로고침하세요. 그런 다음 다른 웹페이지에도 접속해 문제가 특정 사이트에만 있는지, 새 요청이 모두 실패하는지 확인합니다.

Config를 사용 중이라면 대상 요청이 예상한 대로 분기되는지도 확인하세요. 클라이언트의 요청 기록에서 대상 도메인과 적용된 정책을 대조할 수 있습니다. 규칙에 따라 웹페이지마다 다른 경로를 사용할 수 있으므로 한 페이지의 접속 성공으로 다른 경로까지 확인했다고 볼 수 없습니다. 기록을 확인하기 어렵다면 먼저 Proxy에서 같은 웹페이지를 다시 테스트한 뒤 Config로 돌아와 비교해 규칙 문제인지 좁혀 보세요.

재현에 필요한 최소 정보 기록

유효한 테스트 기록에는 선택한 서버, Global Routing 모드, Connectivity Test 결과, 실제 웹페이지의 로딩 여부가 포함되어야 합니다. 항목 메모와 결과는 기기에 기록해도 되지만 전체 구독 링크, 비밀번호, 인증 정보는 남기지 마세요. 나중에 문제를 점검할 때도 같은 웹페이지를 기준으로 삼아 테스트 대상 변경이 판단에 영향을 주지 않도록 합니다.

테스트가 정상이고 웹페이지도 예상대로 표시되면 첫 연결 절차를 마쳐도 됩니다. 이후 일상적인 트래픽 분기를 위해 Config로 전환할 경우에도 같은 방식으로 한 번 더 확인하세요. 한 번의 테스트 성공이 앞으로 점검할 필요가 없다는 보장은 아닙니다. 네트워크 환경, 구독 내용, 설정이 바뀌면 같은 순서로 다시 테스트하세요.

자주 발생하는 실패 원인: 한 번에 하나씩 확인

문제가 발생하면 모든 설정을 한꺼번에 초기화하지 말고, 가장 먼저 완료되지 않은 단계부터 다시 확인하세요. 목록이 비어 있으면 가져오기 문제, 스위치가 켜진 채 유지되지 않으면 연결 설정 문제, 테스트 시간 초과는 연결 가능성 문제입니다. 테스트에는 응답이 있지만 웹페이지가 열리지 않는다면 모드, DNS, 대상 서비스 문제를 구분해야 합니다. 아래 순서대로 점검하고 변경할 때마다 같은 테스트 대상으로 다시 확인하세요.

가져온 뒤 서버가 표시되지 않음: 입력값과 구독 응답 확인

Add Server로 돌아가 저장한 구독 항목의 Type이 Subscribe인지, URL이 온전한지, 매개변수 사이의 기호가 그대로 유지되었는지 확인하세요. 서비스 안내 페이지 주소를 구독 주소로 잘못 입력하면 저장에 성공해도 유효한 서버 목록을 가져오지 못합니다. 구독 정보를 받으려면 기기가 먼저 기본 네트워크에 연결되어 있어야 합니다. 일반 웹페이지가 열리는지 확인한 다음 구독 내용을 업데이트해 보세요.

링크가 만료되었거나 권한이 변경되었거나 예상과 다른 내용이 반환되면 본인이 이용하는 서비스 제공자에게 기존 링크의 상태를 확인하세요. 문제 해결을 위해 전체 URL을 공개 페이지에 붙여 넣거나 같은 그룹을 여러 개 만들지 마세요. 확인된 항목 하나를 저장하고 업데이트 결과를 살펴보는 편이 오류를 찾기 쉽습니다.

Connectivity Test가 계속 시간 초과됨: 서버 설정 확인

직접 입력한 항목은 주소, 포트, 인증 정보를 먼저 확인한 다음 프로토콜별 전송 설정을 점검하세요. 메모 이름만 보지 말고 원본 정보와 항목별로 대조해야 합니다. 메모가 같아도 다른 포트를 가리킬 수 있습니다. 기존 구독의 서버라면 한 번 업데이트한 뒤 목록에 있는 다른 서버를 선택해 비교해 보세요. 특정 서버만 계속 실패한다면 해당 항목의 서비스 상태를 우선 확인합니다.

현재 네트워크 환경도 확인하세요. Wi-Fi에서 셀룰러 네트워크로 바꾼 뒤 결과가 달라졌다면 네트워크 경로가 문제에 영향을 줄 수 있습니다. 다만 비교하려면 같은 서버, 모드, 테스트 대상을 유지해야 합니다. 근거 없이 프로토콜, 서버, DNS를 동시에 변경하면 성공하거나 실패해도 원인을 파악하기 어렵습니다.

테스트에는 응답이 있지만 웹페이지가 열리지 않음: 모드와 DNS 확인

먼저 Home으로 돌아가 Global Routing이 Direct에 잘못 설정되어 있지 않은지 확인하세요. Proxy에서는 접속되지만 Config에서 실패한다면 Config로 이동해 현재 파일이 맞는지 확인한 다음 대상 요청에 적용되는 규칙과 정책을 점검합니다. 이 경우 서버 비밀번호부터 바꿀 필요는 없습니다. 웹페이지 하나만 실패한다면 전체 연결이 작동하지 않는다고 판단하기 전에 해당 웹페이지 자체가 정상인지 확인하세요.

DNS는 비교 결과를 확보한 뒤 점검하세요. 먼저 현재 설정을 저장하고 Config의 DNS 설정을 살펴본 다음 예상한 해석 경로인지 확인합니다. 출처를 알 수 없는 주소를 복사해 전체 설정을 바꾸거나 시스템 네트워크와 클라이언트 설정을 동시에 수정하지 마세요. 도메인 해석, 규칙 순서, 네트워크 전환 문제는 DNS 문제 해결에서 자세히 확인할 수 있습니다.

이 페이지의 절차로도 연결이 복구되지 않으면 FAQ에서 증상별로 확인하거나 문제 해결 설명서의 단계별 절차를 참고하세요. 문제를 설명할 때는 기기 종류, 실패한 단계, Global Routing 옵션, 민감한 정보를 삭제한 오류 문구만 제공하세요. 기존 설정의 사본을 보관하면 이후 점검과 복구가 쉬워집니다.