01 / 인터페이스와 설정
페이지 메뉴와 라우팅 방식
먼저 용어가 표시된 위치를 확인하세요. 같은 Config라도 페이지 메뉴에 있을 때와 Global Routing 옵션에 있을 때 기능이 다릅니다.
- Home #
- 저장된 서버, 현재 선택 항목, 연결 화면을 확인하는 주요 페이지입니다. 목록에 서버 항목이 보인다는 것은 정보가 저장되었다는 뜻일 뿐, 연결이 완료되었다는 의미는 아닙니다. 연결 상태와 실제 접속 결과를 추가로 확인하세요.
- Global Routing #
- 현재 연결에 적용할 전역 라우팅 방식을 결정합니다. 자주 사용하는 옵션은 Config, Proxy, Direct이며, 각각 구성에 따른 처리, 프록시 연결, 직접 연결을 뜻합니다. 특정 규칙이 적용되지 않는 이유를 확인할 때는 규칙을 수정하기 전에 여기서 선택된 방식을 먼저 확인하세요.
- Config #
- Global Routing에서 Config는 현재 구성을 기준으로 트래픽을 처리한다는 뜻이며, 보통 이 모드에서 규칙을 확인합니다. 페이지 메뉴에서는 구성 파일을 관리하는 화면을 가리킵니다. 해당 페이지를 열기만 해서는 구성 파일이 선택되거나 활성화되지 않습니다.
- Proxy / Direct #
- Global Routing에서 Proxy는 클라이언트가 처리할 수 있는 트래픽을 프록시로 연결하고, Direct는 직접 연결합니다. 전역 라우팅 방식이며 서버 프로토콜 종류가 아닙니다. 규칙 끝에 대문자로 표시되는 PROXY, DIRECT 정책 이름과도 혼동하지 마세요.
- On Demand #
- 미리 설정한 네트워크 조건 등에 따라 필요할 때 연결하도록 설정해 반복적인 수동 조작을 줄입니다. 기존 구독의 유효성을 확인하거나 원격 서버의 사용 가능 여부를 보장하지는 않습니다. 조건 충족 여부, 연결 성립 여부, 대상 접속 가능 여부를 각각 확인하세요.
- Add Server #
- 서버 정보를 직접 입력하는 화면입니다. 먼저 올바른 프로토콜 종류를 선택한 다음 해당 항목을 입력하세요. 주소, 포트, 인증 정보, 전송 매개변수는 보유한 서버 정보를 기준으로 입력해야 합니다. 프로토콜 종류를 바꿔도 기존 매개변수가 자동으로 호환되지는 않습니다.
- Connectivity Test #
- 지정한 테스트 대상에 연결할 수 있는지 확인합니다. 결과는 테스트 방식, 네트워크 환경, 대상의 상태에 따라 달라집니다. 테스트에 성공해도 모든 웹사이트에 접속할 수 있는 것은 아니며, 실패했다고 구독이 만료된 것은 아닙니다. 실제 요청 결과와 연결 기록도 함께 확인하세요.
02 / 프로토콜
연결 유형과 매개변수 확인
프로토콜은 클라이언트와 서버가 정한 통신 방식입니다. 이름만으로 속도, 배터리 소모량, 안정성을 추측하지 말고 보유한 서비스의 유형과 매개변수에 맞추세요.
- Shadowsocks #
- 프록시 전달을 기반으로 하는 암호화 프로토콜입니다. 기본 매개변수는 서버 주소, 포트, 암호화 방식, 비밀번호입니다. 클라이언트와 서버의 암호화 방식이 일치해야 합니다. 인증 또는 연결 문제가 발생하면 테스트 시간만으로 원인을 추측하지 말고 먼저 입력 항목을 확인하세요.
- VMess #
- 인증 및 암호화 기능을 갖춘 프록시 프로토콜로, 구성에 사용자 식별 정보 등의 인증 항목이 포함되는 경우가 많습니다. 전송 방식과 추가 항목도 서버 설정과 일치해야 합니다. 주소와 사용자 식별 정보가 맞더라도 전송 계층 설정이 모두 올바른 것은 아닙니다.
- VLESS #
- 간결한 인증과 트래픽 전달에 중점을 둔 프록시 프로토콜로, 별도의 전송 또는 보안 메커니즘과 함께 사용하는 경우가 많습니다. VLESS라는 이름만으로 TLS 보호가 자동 적용되는 것은 아닙니다. 인증, 전송 방식, 보안 관련 항목을 각각 확인하세요.
- Trojan #
- 일반적으로 TLS와 함께 사용하는 프록시 프로토콜입니다. 비밀번호와 TLS 연결 조건이 모두 연결 성공 여부에 영향을 줍니다. 서버 이름, 인증서 유효성, 시스템 시간을 확인하세요. 인증서 검증을 끄는 것은 일반적인 문제 해결 방법으로 권장되지 않습니다.
- HTTP / SOCKS5 #
- 널리 쓰이는 두 가지 프록시 프로토콜로, 서버 주소와 포트, 필요한 경우 인증 정보를 지정해야 합니다. 이름만 보고 HTTP 프록시가 암호화 연결이라고 판단해서는 안 됩니다. SOCKS5의 UDP 지원 여부도 서버와 사용 환경에 따라 다르므로 프로토콜 종류만으로 단정할 수 없습니다.
- WireGuard #
- 키 기반 터널링 프로토콜입니다. 일반적인 매개변수로 인터페이스 주소, 피어 공개 키, Endpoint, AllowedIPs가 있습니다. AllowedIPs는 터널에서 사용할 주소 범위를 지정하는 항목으로 도메인 규칙과는 다릅니다. 개인 키는 민감한 정보이므로 문제 해결 과정에서 공개하지 마세요.
- Hysteria2 #
- QUIC 기반 프록시 프로토콜로, UDP 연결과 올바른 인증 및 TLS 매개변수가 필요합니다. 실제 성능은 패킷 손실, 서버 리소스, 네트워크 환경에 따라 달라집니다. 대역폭 관련 항목은 임의로 높이지 말고 서비스 정보와 실제 환경에 맞춰 입력하세요.
매개변수와 사용 상황을 비교하려면 프로토콜 안내를 확인하세요. 시스템 요구 사항은 App Store 페이지를 기준으로 확인하세요.
03 / 규칙 키워드와 정책
매칭 조건과 처리 결과
키워드는 ‘무엇을 매칭하는지’, 정책은 ‘어떻게 처리하는지’를 나타냅니다. 아래 규칙은 문법 설명용이며, example.com은 예시 도메인으로 실제 서비스와 관련이 없습니다.
- 규칙 #
- 매칭 조건을 처리 정책과 연결하는 구성 항목입니다. 예를 들어 특정 도메인을 PROXY로 전달할 수 있습니다. 규칙은 일반적으로 위에서 아래 순서로 매칭되므로, 앞쪽의 포괄적인 조건이 뒤쪽의 구체적인 조건보다 먼저 적용될 수 있습니다. 저장한 후 새 연결에서 실제로 어떤 규칙이 적용되는지 확인하세요.
- DOMAIN #
- 전체 도메인을 기준으로 매칭합니다. 예를 들어
DOMAIN,example.com,DIRECT는 해당 도메인에만 적용됩니다.www.example.com등의 하위 도메인은 자동으로 포함되지 않으며, 웹 페이지 경로나 내용도 기준으로 삼지 않습니다.
- DOMAIN-SUFFIX #
- 도메인 접미사 경계를 기준으로 매칭합니다.
example.com은 해당 도메인과 하위 도메인에 적용될 수 있습니다. 임의의 문자열 포함 여부를 기준으로 하지는 않으므로notexample.com은 이 도메인 접미사에 해당하지 않습니다. 웹사이트의 도메인 범위에 따라 규칙을 구성할 때 적합합니다.
- DOMAIN-KEYWORD #
- 도메인에 특정 문자열이 포함되어 있는지 확인합니다. 예를 들어
example이라는 키워드는 서로 다른 여러 도메인과 매칭될 수 있습니다. 일반적으로 DOMAIN이나 DOMAIN-SUFFIX보다 범위가 넓으므로 사용 전에 잘못 매칭될 가능성을 따져야 합니다. 같은 웹사이트의 도메인만 정확하게 지정하는 용도로 사용하지 마세요.
- GEOIP #
- IP 데이터베이스의 지역 정보를 기준으로 대상 IP를 매칭하며, 페이지 내용나 운영자 소재지를 판별하지는 않습니다. 결과는 데이터베이스와 대상 주소의 변경에 따라 달라질 수 있습니다. 도메인이 서로 다른 주소로 연결되면 같은 웹사이트도 매칭 결과가 달라질 수 있습니다.
- IP-CIDR / IP-CIDR6 #
- 각각 IPv4와 IPv6 주소 대역을 매칭합니다. 슬래시 뒤의 프리픽스 길이가 범위를 결정합니다. 예를 들어
192.168.0.0/16은 IPv4 대역 하나를 나타내며 단일 기기를 뜻하지 않습니다. 입력 전에 대상 범위를 확인해 넓은 대역에 잘못된 정책이 적용되지 않도록 하세요.
- FINAL #
- 앞선 규칙이 모두 매칭되지 않을 때 최종 처리 정책을 지정합니다. 예를 들어
FINAL,DIRECT와 같이 설정합니다. 일반적으로 규칙의 마지막에 두며, 기본 정책을 바꾸면 앞선 규칙에 포함되지 않는 모든 연결에 영향을 줍니다. 구체적인 규칙에 이미 매칭된 웹사이트 하나만 확인해서는 안 됩니다.
- PROXY / DIRECT / REJECT #
- 규칙에 지정하는 정책 이름으로, 각각 프록시 경로로 전달, 직접 연결, 연결 거부를 뜻합니다. PROXY가 실제로 어느 경로를 사용하는지는 현재 선택한 서버나 구성을 확인해야 합니다. REJECT는 매칭된 연결을 거부하는 기능이지 웹 페이지 요소를 삭제하는 기능이 아니므로, 페이지의 모든 콘텐츠가 제거되는 것은 아닙니다.
- DNS #
- 도메인을 IP 주소로 변환하는 메커니즘입니다. 변환 결과와 경로에 따라 규칙 판정 및 연결 상태가 달라질 수 있습니다. DNS를 변경해도 인증 오류나 서버 장애가 자동으로 해결되지는 않습니다. 문제를 확인할 때는 주소 변환 실패, 연결 실패, 예상과 다른 정책 적용을 각각 구분하세요.
04 / 구독 및 구성
가져오기, 업데이트, 테스트
서버 정보, 구독 주소, 구성 파일은 용도가 서로 다릅니다. 먼저 받은 정보의 종류를 확인한 다음 해당하는 메뉴를 선택하세요.
- Subscribe #
- 보유한 구독 주소를 통해 서버 항목을 가져오거나 업데이트하는 기능입니다. 구독 주소는 본인의 서비스 제공업체에서 받아야 합니다. 계정 식별 정보나 접근 인증 정보가 포함될 수 있으므로 구독 주소를 공개하지 마세요. 서버 항목을 가져와도 규칙 구성이 모두 함께 제공되는 것은 아닙니다.
- 서버 #
- 클라이언트가 연결하는 원격 엔드포인트 정보로, 주소, 포트, 프로토콜, 인증 매개변수가 포함되는 경우가 많습니다. 흔히 노드라고도 합니다. 목록에 표시된 이름은 식별을 위한 레이블일 뿐, 위치나 속도, 사용 가능 여부를 증명하지 않습니다. 매개변수를 확인한 뒤 실제 연결을 테스트하세요.
- 구성 파일 #
- 규칙과 DNS 등의 처리 설정을 담는 텍스트 구성으로, 주로 서버 항목을 제공하는 구독과 용도가 다릅니다. 가져오기 전에 내용과 출처를 확인하고, 가져온 뒤 현재 선택된 파일을 확인하세요. 파일을 저장하는 것만으로는 그 안의 규칙이 현재 연결에 적용되지 않습니다.
- 구독 업데이트 #
- 기존 구독 주소에 다시 요청해 서버 항목이나 매개변수를 새로 고칩니다. App Store에서 앱을 업데이트하거나 클라이언트를 다시 구입하는 것과는 다릅니다. 실패하면 먼저 주소가 여전히 유효한지, 요청이 성공했는지, 응답 내용을 인식할 수 있는지 확인하세요.
- 지연 시간 #
- 특정 테스트 조건에서 측정한 응답 시간이며, 의미는 테스트 대상과 방식에 따라 달라집니다. 지연 시간이 짧다고 대역폭이 높은 것은 아니며 모든 웹사이트에 접속할 수 있다는 뜻도 아닙니다. 비교할 때는 같은 네트워크, 대상, 테스트 방식을 사용해 조건이 다른 결과를 혼용하지 마세요.
- Scan QR Code #
- QR 코드에서 연결 정보를 읽어 가져오는 화면입니다. QR 코드에는 일반 텍스트나 사용할 수 없는 정보가 들어 있을 수도 있습니다. 스캔 후 인식된 프로토콜 종류, 주소, 매개변수가 모두 올바른지 확인하세요. 정보를 인식하고 저장했더라도 원격 연결이 검증된 것은 아닙니다.
05 / 시스템 권한과 계정
권한, 구입, 데이터 복원
시스템 연결 권한, App Store 구입 내역, iCloud 데이터 동기화는 서로 다른 절차입니다. 기기를 바꿀 때 각 항목을 따로 확인하고, 하나의 상태로 다른 항목을 판단하지 마세요.
- VPN 구성 #
- 처음 연결할 때 네트워크 확장 기능이 연결을 설정할 수 있도록 시스템에서 VPN 구성 추가를 요청할 수 있습니다. 허용하면 시스템 권한 설정이 완료된 것이며, 서버 인증과 실제 접속까지 성공했다는 뜻은 아닙니다. 거부하거나 삭제한 경우 클라이언트에서 다시 연결을 시작하고 시스템 안내를 확인하세요.
- Apple 계정 #
- App Store 구입 내역과 연결된 계정입니다. iCloud 동기화에 사용하는 계정과 용도를 구분하세요. 앱을 복원할 때는 App Store에 원래 구입한 계정으로 로그인했는지 먼저 확인해야 합니다. 시스템 요구 사항과 계정 지역에 따른 이용 가능 여부 및 구입 조건은 App Store 페이지를 기준으로 확인하세요.
- 구입 항목 #
- App Store에서 원래 계정의 구입 내역을 찾아 앱을 다시 다운로드하는 화면입니다. 메뉴 이름은 시스템 인터페이스에 따라 달라질 수 있습니다. 기기를 바꾸거나 앱을 다시 설치할 때는 원래 구입한 계정으로 Shadowrocket을 찾으세요. 앱을 복원해도 로컬에 저장된 모든 서버 정보가 자동으로 복원되지는 않습니다.
- iCloud 동기화 #
- 계정, 시스템 권한, 앱 설정 조건을 충족하면 지원되는 데이터를 동기화합니다. 전체 백업이나 App Store 구입 내역 복원과는 다릅니다. 기기를 바꾸기 전에 필요한 데이터를 실제로 복원할 수 있는지 확인하고, 인증 정보가 포함된 내보내기 파일은 안전하게 보관하세요.
- 일회성 구입 #
- 앱 자체의 구입 방식입니다. 가격과 구입 조건은 App Store 페이지를 기준으로 확인하세요. 클라이언트의 일회성 구입은 회선 요금제가 아니며, 연결하려면 보유한 구독 또는 서버 정보가 필요합니다. 구입 내역 복원과 연결 매개변수 복원은 별도로 진행해야 합니다.