1. 공통 준비 사항
어떤 플랫폼이든 사용 가능한 Clash 환경을 구축하는 과정은 네 단계로 나눌 수 있습니다: 클라이언트를 선택해 다운로드하기, 구독 가져오기, 프록시 모드 선택하기, 프록시를 켜고 확인하기. 플랫폼 간 차이는 설치 방식과 시스템이 트래픽을 넘겨받는 방식에 집중되며, 큰 흐름은 동일합니다. 이 장에서는 플랫폼 공통으로 알아야 할 세 가지를 먼저 정리하고, 이후 각 플랫폼 장에서는 반복하지 않습니다.
클라이언트 고르는 법
본 사이트 다운로드 페이지에 정리된 클라이언트는 플랫폼별로 아래와 같이 구분됩니다. 전 플랫폼에서 우선 추천은 Clash Plus입니다. 지원 범위가 가장 넓고 인터페이스가 통일되어 있어 기기를 바꿔도 다시 배울 필요가 없습니다. 대안 클라이언트마다 강점이 다르며, 자세한 기능 차이는 비교 리뷰에서 확인할 수 있습니다.
| 플랫폼 | 우선 추천 | 대안 | 다운로드 |
|---|---|---|---|
| Windows | Clash Plus | Clash Verge Rev, FlClash, Clash Nyanpasu | Windows 다운로드 |
| macOS | Clash Plus | Clash Verge Rev, FlClash | macOS 다운로드 |
| Android | Clash Plus | Clash Meta for Android, FlClash, Surfboard | Android 다운로드 |
| iOS | Clash Plus(App Store) | — | iOS 다운로드 |
| Linux | Clash Verge Rev | FlClash, mihomo 코어 | Linux 다운로드 |
Clash for Windows와 ClashX Meta는 이미 유지 보수가 종료되었습니다. 다운로드 페이지에는 아카이브 링크를 남겨 두었지만 새 기기에는 권장하지 않습니다. 코어 버전이 옛 버전에 머물러 있어 새로운 규칙 유형과 프로토콜 기능을 사용할 수 없기 때문입니다.
구독 링크 준비하기
구독 링크는 https 주소이며, 프록시 서비스 제공자가 사용자 패널에서 발급합니다. 클라이언트는 이 주소를 주기적으로 방문해 노드 목록과 분기 설정을 받아옵니다. 설치를 시작하기 전에 이 링크를 통째로 클립보드에 복사해 두세요. 두 가지를 혼동하지 마세요: 구독 링크는 완전한 설정 하나를 가리키며 가져오면 노드 그룹이 생성됩니다. 반면 프로토콜 이름으로 시작하는 단일 노드 공유 텍스트는 노드 하나만 설명하며 가져오는 방식이 다르므로 섞어 쓸 수 없습니다.
구독 링크는 계정 자격 증명과 같습니다. 이 링크를 가진 사람은 누구나 그 안의 노드 트래픽을 사용할 수 있습니다. 공개 그룹에 올리거나 스크린샷에 담지 마세요. 유출되었다면 서비스 제공자 패널에서 즉시 재발급하세요.
먼저 알아둘 세 가지 개념
시스템 프록시와 TUN 모드. 시스템 프록시는 "HTTP/SOCKS 프록시 주소를 로컬 포트로 지정"하는 설정을 운영체제 네트워크 설정에 써넣는 방식으로, 브라우저와 시스템 설정을 따르는 대부분의 앱이 이를 따라갑니다. 다만 명령줄 도구나 일부 게임, 시스템 설정을 읽지 않는 프로그램은 이를 우회합니다. TUN 모드는 가상 네트워크 카드를 만들어 네트워크 계층에서 모든 트래픽을 넘겨받으며, 커버리지가 완전한 대신 더 높은 시스템 권한이 필요합니다. 일상적인 웹 서핑에는 시스템 프록시로 충분하고, 트래픽을 전부 넘겨받아야 할 때만 TUN을 켜세요.
규칙, 전역, 직접 연결. 규칙 모드는 설정 파일의 분기 규칙을 순서대로 매칭해 일치하면 해당 정책에 따라 프록시 또는 직접 연결로 보내며, 일상적으로 권장되는 모드입니다. 전역 모드는 모든 트래픽이 같은 프록시 출구를 통하며, 규칙이 제대로 작동하지 않을 때 임시 대응에 적합합니다. 직접 연결 모드는 어떤 트래픽도 프록시하지 않으며 대조 점검용입니다. 세 모드 모두 모든 클라이언트에서 한 번의 클릭으로 전환할 수 있습니다.
로컬 포트. Clash는 기본적으로 로컬 7890 포트에서 통합 프록시(HTTP와 SOCKS를 같은 포트에서)를 제공하며, 이는 설정 파일의 mixed-port에 해당합니다. 시스템 프록시나 프록시 주소를 직접 지정해야 하는 도구에는 모두 127.0.0.1:7890을 입력합니다. 이 포트가 다른 프로그램에 이미 사용 중이면 클라이언트가 시작에 실패하거나 프록시가 연결되지 않는데, 포트를 바꾸는 방법은 8장을 참고하세요.
2. Windows
다운로드와 설치
다운로드 페이지 Windows 섹션에서 설치 파일을 받으세요. Clash Plus를 우선 추천하며, x64 아키텍처가 대부분의 기기를 지원합니다. 설치 파일을 실행하면 Windows SmartScreen이 "이 PC를 보호했습니다" 알림을 띄울 수 있는데, 이는 배포량이 적은 설치 파일에 대한 시스템 기본 차단이므로 "추가 정보"를 클릭한 뒤 "실행"을 누르면 계속 진행됩니다. 설치 경로는 기본값을 유지하는 것이 좋습니다. 한글이나 공백이 포함된 깊은 경로로 바꾸면 코어 시작 오류가 발생하는 경우가 있으니 굳이 위험을 감수할 필요는 없습니다.
구독 가져오기
처음 실행한 뒤 구독(또는 "설정") 페이지로 이동해 준비한 구독 링크를 입력창에 붙여넣고 가져오기를 클릭하세요. 클라이언트가 설정을 다운로드하고 해석하며, 성공하면 프록시 페이지에 노드 그룹과 노드 목록이 나타납니다. 가져온 뒤 목록이 비어 있거나 오류가 뜨면 먼저 브라우저로 구독 링크를 직접 열어 내용이 반환되는지 확인한 뒤, 구독 오류 점검 목록을 항목별로 확인하세요.
시스템 프록시와 TUN
클라이언트에서 "시스템 프록시" 스위치를 켜면 Clash가 127.0.0.1:7890을 Windows의 인터넷 프록시 설정에 써넣어 브라우저에서 즉시 적용됩니다. TUN 모드를 켜려면 조건이 하나 더 필요합니다: 가상 네트워크 카드 생성에는 관리자 권한이 필요합니다. Clash Verge Rev는 설정에서 먼저 "서비스 모드"를 설치하는 방식을 씁니다. 시스템과 함께 실행되는 백그라운드 서비스를 설치한 뒤에야 TUN 스위치를 사용할 수 있고, 이후로는 매번 수동으로 권한을 올릴 필요가 없습니다. Clash Plus는 TUN을 처음 켤 때 한 번 권한을 요청합니다. TUN을 켠 뒤에는 시스템 프록시 스위치를 꺼도 되며, 두 가지를 동시에 켜둘 필요는 없습니다.
Windows 고유 문제
- 포트 충돌. Thunder(迅雷)나 개발 디버깅 도구가 7890 근처 포트를 자주 점유합니다. 클라이언트 로그에
bind: address already in use가 나타나면 설정이나 클라이언트 설정에서mixed-port를 7897처럼 비어 있는 포트로 바꾸세요. - 자동 시작. 클라이언트 설정에서 "부팅 시 시작"을 켜면 됩니다. 부팅과 동시에 TUN 모드로 진입하고 싶다면 먼저 서비스 모드를 설치해 두어야 합니다. 그렇지 않으면 자동 시작 후 TUN이 권한 부족으로 조용히 실패합니다.
- 보안 소프트웨어 오탐. 프록시 코어는 네트워크 트래픽을 전달하는 방식으로 동작하기 때문에 일부 백신 소프트웨어가 이를 의심스러운 것으로 표시하고 코어 파일을 격리하는데, 클라이언트가 코어 시작 실패를 계속 알리는 형태로 나타납니다. 설치 디렉터리를 신뢰 영역에 추가하면 됩니다. 코어 mihomo의 소스 코드는 공개되어 있어 누구나 확인할 수 있습니다.
- UWP 앱이 프록시를 타지 않음. 스토어 앱은 기본적으로 시스템에 의해 로컬 루프백 주소 접근이 차단되어 127.0.0.1의 프록시 포트에 연결할 수 없습니다. 일부 클라이언트는 "UWP 루프백 예외" 도구를 제공하니 프록시가 필요한 스토어 앱을 체크하면 됩니다. 또는 TUN 모드로 바꿔서 이 제한을 우회할 수 있습니다.
3. macOS
올바른 칩 아키텍처 선택
macOS 설치 파일은 Apple Silicon(M 시리즈 칩)과 Intel 두 버전으로 나뉩니다. 자신의 기기가 어떤 것인지 모르면 왼쪽 위 Apple 메뉴 → "이 Mac에 관하여"를 클릭해 "칩" 항목이 Apple M으로 시작하면 Apple Silicon 패키지를, Intel이라고 적혀 있으면 Intel 패키지를 선택하세요. 다운로드 페이지 macOS 섹션에는 두 아키텍처마다 별도의 버튼이 있습니다. 아키텍처를 잘못 선택하면 실행이 안 되거나 변환 실행으로 성능이 떨어집니다.
첫 실행과 Gatekeeper
브라우저에서 받은 dmg를 설치하고 처음 열 때 macOS가 "Apple에서 확인할 수 없기 때문에 열 수 없음" 같은 경고를 띄울 수 있습니다. 처리 방법은 두 가지입니다: Finder에서 앱 아이콘을 마우스 오른쪽 버튼으로 클릭해 "열기"를 선택한 뒤 팝업에서 다시 "열기"를 누르거나, 시스템 설정 → 개인정보 보호 및 보안으로 가서 페이지 하단에 차단된 앱을 찾아 "그래도 열기"를 클릭하는 방법입니다. "앱이 손상되었습니다"라는 알림이 뜨면 다운로드 파일에 격리 표시가 붙은 것이므로 터미널에서 다음 명령으로 제거하면 됩니다(경로는 실제 앱 이름으로 바꾸세요):
xattr -dr com.apple.quarantine /Applications/Clash\ Plus.app
구독 가져오기와 시스템 프록시
구독 가져오기 흐름은 Windows와 동일합니다: 구독 페이지에서 링크를 붙여넣고 가져오기를 눌러 노드 목록이 나타나는지 확인하세요. "시스템 프록시"를 켜면 클라이언트가 시스템 인터페이스를 통해 HTTP, HTTPS, SOCKS 프록시를 현재 활성 네트워크 서비스(Wi-Fi 또는 유선)에 써넣으며, 정상 종료 시 자동으로 원래대로 복원됩니다. 클라이언트가 비정상적으로 종료되면 프록시 설정이 남아 인터넷 연결이 끊길 수 있는데, 시스템 설정 → 네트워크 → 현재 네트워크의 "세부 정보" → "프록시"에서 각 프록시 프로토콜의 체크를 해제해 직접 정리할 수 있습니다.
TUN, 자동 시작 및 기타 주의점
macOS에서 TUN을 켜려면 시스템 권한이 필요합니다. 클라이언트가 특권 구성 요소나 시스템 확장 프로그램 설치를 안내하며, 이 과정에서 관리자 비밀번호 입력을 요구하는데 정상적인 절차이며 한 번 권한을 부여하면 계속 유효합니다. 클라이언트 설정에서 자동 시작을 켜면 시스템 "로그인 항목"에 등록되며, 시스템 설정 → 일반 → 로그인 항목에서 확인할 수 있습니다. 그 외에 두 가지를 기억하세요: 시스템 프록시는 현재 네트워크 서비스에만 적용되므로 다른 네트워크 카드로 바꾼 후에는 스위치 상태를 다시 확인해야 하고, ClashX Meta는 유지 보수가 종료되어 새 클라이언트를 실행할 수 없는 구형 기기에서만 권장하며 새 기기에는 반드시 Clash Plus나 Clash Verge Rev를 선택하세요.
macOS는 대형 시스템 업데이트가 있을 때마다 클라이언트를 다시 열어 특권 구성 요소가 여전히 유효한지 확인하는 것이 좋습니다. TUN이 실행되지 않으면 서비스 구성 요소를 재설치하면 대체로 복구됩니다.
4. Android
다운로드와 설치
다운로드 페이지 Android 섹션에서 APK를 받으세요. 최근 몇 년의 주력 기종은 arm64 버전을 선택하면 됩니다. 구형 기기나 TV 박스는 armv7 아키텍처일 수 있는데, arm64 패키지를 설치하면 호환되지 않는다는 알림이 뜨므로 arm 버전으로 바꾸세요. 브라우저에서 받은 APK를 처음 설치할 때 시스템이 "알 수 없는 앱 설치 허용" 권한을 요구하는데, 안내에 따라 브라우저나 파일 관리자에 한 번 허용해 주면 됩니다. 이는 스토어 외 설치에 대한 Android 표준 절차입니다.
구독 가져오기
Android 클라이언트는 대체로 세 가지 가져오기 방식을 지원합니다: 구독 링크 직접 붙여넣기, QR 코드 스캔, 클립보드에서 자동 인식. 설정 페이지에서 새 구독을 만들고 링크를 붙여넣은 뒤 저장 및 업데이트를 누르면, 목록에 노드 그룹이 나타나며 성공합니다. 모바일 네트워크에서는 첫 구독 업데이트가 간헐적으로 타임아웃될 수 있으니 Wi-Fi로 바꿔 한 번 더 시도해 보고 판단하세요.
VPN 작동 방식과 앱별 프록시
Android 클라이언트는 시스템의 VpnService 인터페이스를 통해 트래픽을 넘겨받으며 root 권한이 필요 없습니다. 처음 연결을 누르면 시스템이 "연결 요청" 권한 창을 띄우는데, 확인하면 상태 표시줄에 열쇠 아이콘이 나타나며 가상 전용 네트워크 터널이 구축되었음을 의미합니다. 이는 데스크톱의 TUN 모드와 동등한 효과로, 모든 앱의 트래픽이 기본적으로 Clash를 통해 분기됩니다. 더 세밀한 제어가 필요하면 "앱별 프록시" 기능을 사용하세요. 허용 목록 모드에서는 체크한 앱만 프록시를 타고, 제외 목록 모드에서는 체크한 앱이 직접 연결됩니다. 은행이나 결제 앱은 제외 목록에 넣어 위험 통제 시스템의 오탐을 피하는 것이 좋습니다.
백그라운드 유지
Android에서 가장 흔한 문제는 설정이 아니라 프로세스가 종료되는 것입니다: 잠금 화면 상태가 얼마간 지속되면 프록시가 끊기고 알림이 사라집니다. 처리 순서는 다음과 같습니다: 시스템 설정의 배터리 항목에서 클라이언트를 "제한 없음"으로 설정하거나 배터리 최적화 화이트리스트에 추가하고, 국산 커스텀 시스템(MIUI, EMUI, ColorOS 등)에서는 자동 실행 관리에서도 허용해야 하며, 최근 실행 목록 카드에서 앱을 잠가 두어야 합니다. 이 세 단계를 마치면 대부분의 기종에서 안정적으로 상주할 수 있습니다.
시스템이 백그라운드 프로세스를 종료했는지 간단히 확인하는 방법: 연결이 끊긴 뒤 알림 창을 열어 보고 클라이언트의 상주 알림도 함께 사라졌다면 시스템이 프로세스를 회수한 것으로 거의 확정할 수 있으니, 설정을 바꾸는 대신 위 세 단계를 처리하세요.
5. iOS
App Store에서 설치
iOS 플랫폼에서는 App Store를 통해 Clash Plus를 설치합니다. 검색하거나 다운로드 페이지 iOS 섹션의 스토어 링크로 바로 이동할 수 있습니다. 이 앱의 공식 웹사이트는 clashplus.io이며, 버전 업데이트 안내와 기능 문서는 공식 사이트를 기준으로 합니다. iPhone과 iPad는 같은 앱을 사용하며 화면이 자동으로 맞춰집니다.
구독 가져오기와 첫 연결
앱을 연 뒤 구독 페이지에서 링크를 붙여넣어 가져오는 과정은 다른 플랫폼과 동일합니다. 처음 연결을 누르면 iOS가 "VPN 구성 추가 요청"이라는 시스템 창을 띄우는데, 이는 NetworkExtension 프레임워크의 표준 권한 요청 절차입니다. "허용"을 누르고 비밀번호나 Face ID로 한 번 확인하면 시스템 설정에 해당 VPN 구성 항목이 나타납니다. 이후 연결과 해제는 앱 안에서 한 번의 클릭으로 끝나며, 시스템 설정 → VPN에서도 현재 상태를 확인할 수 있습니다.
iOS 고유 주의점
- 설정 규모. iOS는 네트워크 확장 프로세스에 할당하는 메모리가 제한적이라 노드 수가 매우 많거나 규칙 세트가 큰 구독은 로딩이 느려질 수 있습니다. 이런 경우 먼저 구독을 간소화하거나 서비스 제공자에게 경량 버전 설정을 요청하는 것이 좋으며, 재설치를 반복하는 것은 도움이 되지 않습니다.
- 네트워크 전환. Wi-Fi와 모바일 데이터를 전환할 때 터널이 자동으로 재구축되며 1~2초의 짧은 끊김이 발생할 수 있는데 정상적인 현상입니다.
- 필요 시 연결. 앱 안에서 부팅 및 네트워크 연결 시 자동 연결을 켤 수 있으며, 시스템의 필요 시 연결 규칙에 의존해 동작합니다. 켜두면 매번 앱을 수동으로 열 필요가 없습니다.
6. Linux와 서버
데스크톱 배포판 설치
데스크톱 Linux에서는 Clash Verge Rev를 우선 추천하며, 다운로드 페이지 Linux 섹션에서 deb와 rpm 두 형식을 제공합니다. FlClash도 대안으로 사용할 수 있습니다. Debian/Ubuntu 계열에서는 apt로 로컬 패키지를 설치하면 의존성을 자동으로 처리합니다:
sudo apt install ./clash-verge-rev_amd64.deb
Fedora 계열은 sudo dnf install ./clash-verge-rev_x86_64.rpm에 대응합니다. 설치가 끝나면 앱 메뉴에서 실행하며, 구독 가져오기 절차는 다른 데스크톱 플랫폼과 동일합니다.
시스템 프록시와 환경 변수
GNOME과 KDE 모두 그래픽 방식의 시스템 프록시 설정이 있으며, 클라이언트의 "시스템 프록시" 스위치를 켜면 여기에 값을 써넣어 브라우저와 대부분의 데스크톱 앱이 이를 따릅니다. 하지만 Linux에서는 많은 작업이 터미널에서 이루어지고, 터미널 프로그램은 데스크톱 설정이 아니라 환경 변수를 읽습니다. 현재 터미널 세션만 임시로 프록시를 타게 하려면:
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export all_proxy=socks5://127.0.0.1:7890
계속 유지해야 한다면 이 줄들을 셸 설정 파일에 넣거나 alias로 만들어 필요할 때 켜고 끄면 됩니다. git, curl, wget 같은 도구는 이 변수들을 따르지만, 일부 도구(예: 몇몇 컨테이너 런타임)는 자체 프록시 설정 항목이 있어 따로 지정해야 합니다.
TUN 권한
Linux에서 TUN 장치를 생성하려면 CAP_NET_ADMIN 권한이 필요합니다. 그래픽 클라이언트는 보통 권한 요청 버튼을 제공하며 내부적으로 pkexec를 통해 권한을 올립니다. 코어 바이너리를 직접 실행하는 경우 setcap으로 한 번 권한을 부여하면 이후 root 없이도 TUN을 켤 수 있습니다:
sudo setcap 'cap_net_admin,cap_net_bind_service=+ep' /usr/local/bin/mihomo
데스크톱 환경 없이 mihomo 코어 직접 실행
서버, 소프트 라우터, NAS에는 그래픽 인터페이스가 없어 mihomo 코어를 직접 실행하는 것이 표준 방법입니다. 다운로드 페이지 코어 섹션에서 각 아키텍처의 바이너리를 제공합니다. 일반적인 디렉터리 구성은 설정을 /etc/mihomo/config.yaml에, 코어 바이너리를 /usr/local/bin/mihomo에 두고 systemd 서비스를 작성해 시스템과 함께 실행하는 방식입니다:
[Unit]
Description=mihomo daemon
After=network.target
[Service]
Type=simple
ExecStart=/usr/local/bin/mihomo -d /etc/mihomo
Restart=on-failure
[Install]
WantedBy=multi-user.target
/etc/systemd/system/mihomo.service로 저장한 뒤 활성화합니다:
sudo systemctl daemon-reload
sudo systemctl enable --now mihomo
이후 systemctl status mihomo로 실행 상태를 확인하고, journalctl -u mihomo -f로 로그를 추적합니다. 코어를 처음 실행하면 GeoIP와 GeoSite 데이터베이스를 자동으로 다운로드하는데, 서버 네트워크가 외부와 연결되지 않는 경우 데이터 파일을 수동으로 설정 디렉터리에 넣어야 하며, 그렇지 않으면 규칙 매칭이 작동하지 않습니다.
7. 확인과 일상 관리
프록시가 실제로 작동하는지 확인하기
프록시를 켠 뒤 느낌으로 판단하지 말고 두 가지 증거로 교차 확인하세요. 첫째, 브라우저로 임의의 IP 조회 사이트에 접속해 출구 IP가 노드가 있는 지역으로 표시되는지 확인하면 브라우저 트래픽이 프록시를 탔다는 뜻입니다. 둘째, 명령줄에서 프록시 포트로 직접 요청을 보내 응답 헤더를 받을 수 있는지 확인합니다:
curl -x http://127.0.0.1:7890 -I https://www.example.com
HTTP/2 200 같은 상태 줄이 반환되면 프록시 경로가 정상적으로 작동한다는 뜻입니다. 데스크톱 클라이언트의 연결 패널도 살펴볼 가치가 있습니다. 각 연결이 어떤 규칙과 출구 정책에 걸렸는지 실시간으로 나열되므로 "특정 앱이 실제로 프록시를 타는지"를 판단하는 가장 직접적인 근거입니다. 더 완전한 첫 연결 확인 절차는 첫 연결 확인 가이드를 참고하세요.
구독 업데이트와 GeoIP 데이터
노드 정보는 서비스 제공자의 조정에 따라 바뀌므로 구독은 정기적으로 업데이트해야 합니다. 각 클라이언트는 자동 업데이트 주기를 설정할 수 있으며, 보통 24시간에 한 번이면 충분합니다. 또 다른 관리 대상은 GeoIP와 GeoSite 데이터베이스로, 규칙의 GEOIP,CN, GEOSITE 같은 항목들이 여기에 전적으로 의존합니다. 데이터베이스가 오래되면 일부 도메인과 IP의 분류가 잘못될 수 있으며, 특정 사이트의 분기가 이상하게 동작하는 형태로 나타납니다. 클라이언트 설정에는 보통 "GeoIP 데이터베이스 업데이트" 항목이 있으니 몇 달에 한 번 수동으로 눌러주면 됩니다.
로그와 문제 해결 순서
문제가 생기면 로그 수준을 info에서 debug로 임시로 바꾸면 정보량이 훨씬 늘어납니다. 권장하는 점검 순서는 세 단계입니다: 먼저 노드 목록에서 지연 시간 테스트로 노드 자체가 사용 가능한지 확인하고, 다음으로 연결 패널에서 대상 도메인이 예상한 규칙에 걸렸는지 확인하고, 마지막으로 DNS를 의심해 브라우저 시크릿 창을 열어 다시 시도하면서 로컬 캐시의 간섭을 배제합니다. 순서를 건너뛰고 확인하면 단순한 문제가 복잡해지기 쉽습니다. 속도 측정 값을 읽는 법과 노드 선택 방법은 노드 선택 가이드를 참고하세요.
8. 설정 관련 자주 묻는 질문
설정 파일은 어떤 모양인가
Clash의 설정은 YAML 파일이며, 구독으로 받아오는 것도 이 형식입니다. 일상적으로 손으로 작성할 필요는 없지만 핵심 필드를 이해해 두면 문제 해결에 큰 도움이 됩니다. 간단한 골격은 다음과 같습니다:
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- 223.5.5.5
- 119.29.29.29
mixed-port는 로컬 통합 프록시 포트이고, allow-lan은 같은 네트워크의 다른 기기가 이 기기의 프록시를 사용할 수 있는지를 결정하며, mode는 규칙/전역/직접 연결 세 모드에 대응하고, dns 항목은 도메인 해석 동작을 제어합니다. 구독 설정에는 이외에도 proxies(노드), proxy-groups(정책 그룹), rules(분기 규칙) 세 가지 큰 항목이 포함됩니다.
YAML 파싱 오류
설정을 수동으로 수정한 뒤 클라이언트가 "설정 파싱 실패"를 알리면 대부분 YAML 형식 문제입니다. 세 가지를 확인하세요: 들여쓰기는 공백을 사용해야 하며(보통 2칸), Tab이 섞이면 즉시 오류가 발생합니다. 키 이름의 콜론 뒤에는 공백이 하나 있어야 합니다. 값에 콜론이나 井자 같은 특수 문자가 포함되면 값 전체를 인용부호로 감싸야 합니다. 설정을 수정하기 전에 원본 파일을 백업해 두는 것이 가장 저렴한 보험입니다.
Fake-IP 관련 이상
설정의 enhanced-mode: fake-ip는 DNS가 Fake-IP 모드를 사용한다는 뜻입니다: 클라이언트가 먼저 예약된 대역의 가상 주소를 반환해 연결 수립을 빠르게 하고, 실제 해석은 프록시 경로에서 이루어집니다. DNS 유출을 줄이고 첫 패킷 속도를 높이지만, 실제 IP에 의존하는 일부 상황—같은 네트워크 내 기기 탐색, 일부 게임 플랫폼 로그인 등—에서는 이상이 발생할 수 있으며, 관련 도메인을 fake-ip-filter 목록에 추가해야 합니다. 원리와 전체 적용 시나리오 목록은 Fake-IP 모드 상세 설명을 참고하세요.
사용자 정의 규칙이 적용되지 않음
구독 위에 자신만의 분기 규칙을 추가할 때는 한 가지 원칙을 기억하세요: 규칙은 위에서 아래로 매칭되며 일치하면 즉시 멈춥니다. 사용자 정의 항목이 더 광범위한 와일드카드 규칙 뒤에 놓이면 절대 적용될 차례가 오지 않습니다. 정확한 도메인 규칙은 GEOIP, MATCH 같은 최종 처리 규칙보다 앞에 배치해야 합니다. 각 규칙 유형의 문법과 배치 순서에 대한 제안은 규칙 문법과 우선순위 해설을 참고하세요.
구독 업데이트 실패
업데이트를 누르면 계속 돌다가 오류가 나면 네 단계로 점검하세요: 이 기기의 네트워크가 정상인지, 구독 링크를 브라우저에서 직접 열 수 있는지, 반환된 내용이 올바른 설정 형식인지, 클라이언트가 "프록시를 통해 구독 업데이트"로 설정되어 있는데 연결이 끊긴 상태인지. 항목별로 스스로 점검할 수 있는 전체 목록은 구독 오류 점검 단계에 정리했습니다. 그 외 자잘한 문제는 자주 묻는 질문 페이지에서 기초 지식, 설치 설정, 사용 팁, 문제 해결 네 가지로 계속 정리하고 있습니다.
이 페이지는 클라이언트 생태계 변화에 맞춰 계속 수정됩니다. 설치 파일은 항상 다운로드 페이지에서 받으세요. 처음 시작한다면 시작 가이드를 따라 단계별로 진행하면 됩니다.