설치 전 확인: 클라이언트와 설정
1. iPhone 앱은 어디서 설치하나요?
먼저 클라이언트 다운로드 페이지에서 iOS 설치 경로를 확인한 다음, 선택한 클라이언트 안내에 따라 해당 스토어 페이지로 이동하세요. 설치 전에 앱 이름과 개발자, 지원되는 iOS 버전을 확인하세요. App Store 검색 결과는 계정의 국가 또는 지역에 따라 달라질 수 있습니다. 원하는 이름으로 검색되지 않는다고 해서 이름이 비슷한 앱을 같은 클라이언트로 여기지 마세요.
컴퓨터용 .exe 또는 .dmg 설치 파일은 iPhone에 설치할 수 없습니다. iOS 클라이언트는 데스크톱 버전과 이름이 다를 수도 있습니다. 이름에 “Clash”가 있는지만 보지 말고, 사용하려는 설정 형식을 지원하는지 확인해 선택하세요. 이미 구독을 이용 중이라면 어떤 iOS 클라이언트를 지원하는지 설정 제공자에게 먼저 문의한 뒤 설치할 앱을 결정하면 됩니다.
2. 클라이언트를 설치했는데 왜 바로 연결할 수 없나요?
클라이언트는 설정을 읽고, 아웃바운드를 선택해 기기의 관련 네트워크 요청을 처리합니다. 앱을 설치한다고 사용할 수 있는 원격 노드가 자동으로 생기는 것은 아닙니다. 일반적으로 클라이언트와 호환되는 설정과 연결 가능한 노드가 필요합니다. 구독은 설정을 가져오거나 업데이트하는 방법 중 하나입니다. 구독 URL은 노드 속도 측정 결과가 아니며, 구독에 포함된 모든 노드의 작동을 보장하지도 않습니다.
먼저 설정 제공자가 전달한 내용이 구독 URL인지, 가져올 수 있는 설정 파일인지, 단일 노드 링크인지 확인하세요. 유형에 따라 가져오기 메뉴가 다를 수 있습니다. 계정과 비밀번호만 있고 설정 안내가 없다면 임의로 프록시 포트를 입력하지 마세요. iPhone 클라이언트의 가져오기 절차는 Wi-Fi 설정에서 HTTP 프록시를 직접 지정하는 방법과도 다릅니다.
가져오기와 활성화: 설정 적용하기
3. 구독 링크는 어디에 붙여 넣나요?
클라이언트에서 ‘설정’ 또는 ‘Profiles’로 이동해 ‘추가’를 선택한 다음, ‘URL에서 가져오기’나 ‘구독’과 같은 메뉴를 찾으세요. 전체 주소를 붙여 넣고 저장하면 됩니다. 클라이언트마다 버튼 이름은 다르지만 URL은 설정 가져오기 메뉴에 입력해야 합니다. 브라우저 주소창이나 노드 이름 입력란에 붙여 넣으면 안 됩니다. 가져온 뒤 설정 목록으로 돌아가 해당 설정을 선택해 현재 설정으로 지정하세요.
- 제공자가 안내한 전체 URL을 복사하고, 맨 앞의
https://와 끝부분의 매개변수까지 빠짐없이 복사했는지 확인하세요. - 클라이언트의 설정 화면에서 URL 가져오기를 선택하세요. 이름 입력란이 있으면 알아보기 쉬운 이름을 입력하면 됩니다.
- 다운로드와 파싱이 끝날 때까지 기다리세요. 설정이 목록에 표시되면 현재 설정으로 지정하세요.
- 노드 또는 정책 그룹 화면으로 이동해 설정에서 제공하는 아웃바운드 선택지가 표시되는지 확인하세요.
상대방이 로컬 YAML 파일을 제공했다면 ‘파일에서 가져오기’ 또는 클라이언트가 지원하는 파일 공유 메뉴를 이용하세요. YAML 전체를 구독 URL인 것처럼 붙여 넣지 마세요. 처음 가져오는 경우 빠른 시작을 보며 단계별로 확인할 수 있습니다.
4. ‘다운로드 실패’ 또는 ‘설정 파싱 실패’가 표시되면 무엇부터 확인하나요?
먼저 어느 단계에서 실패했는지 구분하세요. 다운로드 실패는 클라이언트가 내용을 가져오지 못했다는 뜻입니다. Wi-Fi와 셀룰러 네트워크를 바꿔 보고, URL이 만료되었는지, 문자를 빠뜨리지 않았는지, 구독 서비스를 먼저 로그인하거나 갱신해야 하는지 확인하세요. 브라우저에 링크를 붙여 넣어 테스트할 때는 파일이 바로 다운로드될 수도 있습니다. 웹페이지가 열린다고 해서 클라이언트에 필요한 설정이 반환된다는 뜻은 아닙니다.
파싱 실패는 내용을 가져왔지만 예상한 형식으로 읽지 못했다는 뜻입니다. 로그인 페이지가 반환되거나, 구독 형식이 클라이언트와 호환되지 않거나, YAML을 직접 수정하면서 들여쓰기가 틀어진 경우가 흔합니다. YAML에서는 같은 단계의 항목에 같은 수의 공백을 사용하고, 탭으로 들여쓰기를 대신하지 마세요. 설정에 proxy-groups와 rules 등의 필드가 있다면 기술 문서에서 각각의 역할을 확인해 보세요. 형식이 확실하지 않다면 확장자를 반복해서 바꾸기보다 현재 클라이언트에 맞는 가져오기 주소를 설정 제공자에게 요청하는 편이 효과적입니다.
5. 연결 스위치를 눌러도 켜지지 않을 때 iPhone에서 어떤 권한을 확인해야 하나요?
처음 연결할 때 iOS에서 VPN 구성을 추가할지 묻는 시스템 권한 요청이 표시되는 경우가 많습니다. 사용 중인 클라이언트에서 표시된 요청인지 확인한 뒤 안내에 따라 허용하고, 기기 암호나 Face ID 인증을 완료하세요. 그런 다음 iPhone의 ‘설정’ → ‘일반’ → ‘VPN 및 기기 관리’ → ‘VPN’으로 이동해 해당 클라이언트의 구성이 표시되는지와 연결 상태를 확인하세요. 메뉴 이름은 iOS 버전에 따라 조금 다를 수 있지만, 시스템 설정의 VPN 상태를 기준으로 확인하면 됩니다.
스위치를 켜자마자 다시 꺼진다면 클라이언트로 돌아가 설정과 사용 가능한 노드가 선택되어 있는지 확인한 후 다시 연결하세요. 기기에서 다른 VPN이나 유사한 네트워크 확장 기능을 사용 중이라면 해당 연결을 끊고 다시 시도하세요. iOS에서는 시스템 네트워크를 처리하는 클라이언트 두 개가 동시에 정상 작동한다고 볼 수 없습니다. 학교나 회사에서 관리하는 기기는 관리 정책에 따라 VPN 구성 추가가 제한될 수 있으므로 기기 관리자에게 문의하세요.
연결 후 문제 해결: 증상별 확인 방법
6. ‘연결됨’으로 표시되는데 웹페이지가 열리지 않으면 어떻게 하나요?
‘연결됨’은 우선 시스템의 VPN 구성이 시작되었다는 뜻이지, 원격 노드까지 연결되었다는 뜻은 아닙니다. 다음 세 가지를 순서대로 테스트하세요. 먼저 평소 프록시 없이도 접속되는 웹사이트를 열어 보세요. 다음으로 클라이언트에서 설정에 포함된 다른 노드를 선택하세요. 마지막으로 Wi-Fi와 셀룰러 네트워크에서 각각 접속해 보세요. 한 번에 하나씩만 바꾸면 문제가 로컬 네트워크, 현재 노드, 설정 규칙 중 어디에 있는지 파악하기 쉽습니다.
- 모든 사이트가 열리지 않는 경우: 현재 설정과 선택된 노드, DNS 설정을 확인하고 다른 VPN과 충돌하는지 살펴보세요.
- 직접 연결되는 사이트는 열리지만 특정 사이트만 실패하는 경우: 노드를 바꿔 보고 해당 요청에 적용된 규칙과 정책 그룹을 확인하세요.
- 특정 Wi-Fi에서만 실패하는 경우: 셀룰러 네트워크로 바꿔 확인하고, 해당 Wi-Fi에서 웹 로그인 인증을 먼저 완료해야 하는지 살펴보세요.
클라이언트에서 연결 기록을 제공한다면 접속 시간에 해당하는 요청의 처리 경로를 확인하세요. 예를 들어 기록에 DIRECT가 표시되면 현재 설정에 따라 해당 요청이 직접 연결된 것입니다. 정책 그룹 이름이 표시되면 그 그룹에서 실제로 선택된 노드를 확인하세요. 구독 키가 포함된 전체 URL을 공개 게시판에 올리지 마세요.
7. 노드 목록은 표시되지만 지연 시간 측정에 실패합니다. 구독이 잘못된 건가요?
반드시 그렇지는 않습니다. 노드가 목록에 있다는 것은 설정을 읽었다는 뜻일 뿐입니다. 지연 시간 측정에는 테스트 대상, 현재 네트워크, 원격 연결 상태도 영향을 줍니다. 먼저 휴대전화의 기본 네트워크 연결이 정상인지 확인한 다음, 노드를 직접 바꾸고 실제 웹사이트 접속으로 교차 확인하세요. 여러 노드가 모두 실패하면 설정을 한 번 업데이트하고 구독 제공자가 장애를 공지했는지 확인하세요. 한 노드만 실패한다면 설정 전체를 바로 삭제하지 말고 먼저 다른 노드를 선택해 보세요.
지연 시간은 다운로드 속도가 아닙니다. 한 번 측정해 80ms가 나왔다면 해당 요청의 응답 시간이 약 80밀리초였다는 뜻일 뿐, 동영상이나 대용량 파일이 반드시 원활하게 다운로드된다는 의미는 아닙니다. 노드를 비교할 때는 같은 Wi-Fi와 같은 테스트 대상을 사용하세요. 셀룰러 네트워크와 Wi-Fi를 바꾼 뒤에는 이전 측정 결과를 그대로 비교하기 어렵습니다.
8. 규칙, 전역, 직접 연결 모드는 어떻게 선택하나요?
일상적인 사용에는 ‘규칙’ 모드를 선택하세요. 규칙 모드는 현재 설정의 rules를 순서대로 대조해 요청을 처리하고, 일치하는 요청을 해당 정책 그룹이나 아웃바운드로 전달합니다. 어떤 사이트가 직접 연결되고 어떤 사이트가 프록시를 사용하는지는 설정 내용에 따라 달라집니다. ‘전역’ 모드는 일반적으로 클라이언트가 처리하는 요청을 모두 선택한 프록시 아웃바운드로 전달합니다. 규칙 매칭 때문에 문제가 생겼는지 잠시 확인할 때 사용할 수 있습니다. ‘직접 연결’은 처리 대상 요청을 프록시 아웃바운드 없이 연결하므로 기본 네트워크가 정상인지 비교할 때 유용합니다.
특정 사이트를 점검할 때 잠시 ‘규칙’에서 ‘전역’으로 바꿔 테스트할 수 있습니다. 테스트가 끝나면 원래 모드로 되돌리세요. 전역에서는 접속되지만 규칙 모드에서 실패한다면 적용된 규칙과 정책 그룹을 추가로 확인해야 합니다. 이를 근거로 노드에 문제가 있다고 단정하지 마세요.
모드 이름이 같더라도 클라이언트마다 시스템 네트워크를 처리하는 범위가 완전히 같은 것은 아닙니다. iOS 클라이언트는 일반적으로 시스템 VPN 인터페이스를 사용해 트래픽을 처리합니다. 데스크톱 안내에 나오는 TUN 스위치, 시스템 프록시 포트, 7890 포트 설정을 iPhone에서 반드시 따라야 하는 단계로 여기지 마세요.
정기 관리: 설정 업데이트와 빠른 점검
9. 구독을 한 번 가져온 뒤에도 직접 업데이트해야 하나요?
업데이트 방식을 확인해야 합니다. 구독을 가져오면 클라이언트는 그 시점의 설정을 받습니다. 이후 제공자가 노드나 규칙을 변경해도 휴대전화에 바로 반영되지 않을 수 있습니다. 클라이언트의 ‘설정’ 또는 ‘Profiles’ 페이지에서 현재 구독을 찾아 ‘업데이트’를 선택한 뒤, 완료되면 노드 목록이 바뀌었는지 확인하세요. 일부 클라이언트는 자동 업데이트 주기를 제공하지만, 메뉴 위치와 백그라운드 실행 여부는 앱 구현에 따라 다릅니다. 업데이트 주기를 설정했다고 해서 앱을 열 때마다 업데이트가 성공한 것은 아닙니다.
업데이트 전에 현재 사용하는 설정과 노드를 기억해 두세요. 업데이트 후 정책 그룹 이름이 바뀌면 직접 선택했던 노드를 다시 지정해야 할 수 있습니다. 업데이트에 실패하면 기존 설정을 유지한 채 네트워크와 구독 유효 기간을 확인하세요. 로컬 파일을 직접 수정해도 원격 구독 내용이 자동으로 바뀌지는 않습니다. 개인 규칙을 계속 유지하려면 사용하는 클라이언트가 로컬 설정이나 오버라이드 기능을 어떻게 지원하는지 먼저 확인하세요.
10. 연결을 빠르게 복구하려면 어떤 순서로 확인하나요?
확인하기 쉬운 항목부터 살펴보고, 클라이언트 재설치와 설정 삭제, DNS 변경을 한꺼번에 하지 마세요. 먼저 연결을 끄고 현재 Wi-Fi나 셀룰러 네트워크에서 자주 쓰는 웹사이트가 열리는지 확인하세요. 다음으로 클라이언트에서 선택한 설정과 모드, 노드를 확인한 뒤 다시 연결하고 시스템 VPN 화면에서 상태를 확인하세요. 그래도 연결되지 않으면 다른 노드로 테스트한 다음 다른 네트워크에서도 확인하세요. 이렇게 하면 네트워크, 노드, 규칙 중 어느 항목에 문제가 있는지 대개 좁혀낼 수 있습니다.
- 기본 네트워크: 클라이언트 연결을 끊고 Wi-Fi나 셀룰러 네트워크 자체가 정상적으로 작동하는지 확인하세요.
- 설정 및 권한: 현재 Profile, 시스템 VPN 권한, 연결 상태를 확인하세요.
- 아웃바운드 선택: 정책 그룹에서 다른 노드를 선택하고 실제 웹페이지가 열리는지 확인하세요.
- 규칙 비교: 잠시 규칙과 전역 모드를 전환해 동일한 사이트의 접속 결과를 비교하세요.
- 구독 업데이트: 업데이트 결과와 제공자 상태를 확인해 만료된 노드 목록으로 계속 테스트하지 않도록 하세요.
설정 제공자에게 도움을 요청할 때는 iOS 버전, 클라이언트 이름과 버전, Wi-Fi 또는 셀룰러 네트워크 사용 여부, 오류 메시지 원문, 문제가 발생한 시간을 기록하세요. 스크린샷을 공유하기 전에는 구독 URL과 계정 정보, 개인 접속 기록을 가리세요. ‘연결이 안 돼요’라는 설명만 하는 것보다 이런 정보를 제공하면 문제를 파악하기 쉽고, 직접 점검한 과정을 다시 확인하는 데도 도움이 됩니다.