서론: 외부 컨트롤러란 무엇인가
Clash Verge Rev의 외부 컨트롤러(External Controller)는 다른 프로그램이나 브라우저 기반 Web 대시보드에서 Clash의 상태와 설정을 관리할 수 있도록 해 주는 기능입니다. Windows에서 이 기능을 활성화하면 현재 연결된 노드, 프록시 모드, 규칙 적용 결과, 메모리 사용량 등을 한눈에 확인할 수 있습니다. 설정 파일을 직접 열지 않고도 대시보드에서 노드를 변경하거나 연결 상태를 점검할 수 있다는 점이 가장 큰 장점입니다.
처음 사용하는 분들이 가장 자주 실수하는 부분은 외부 컨트롤러 주소와 포트, 그리고 Secret을 서로 다르게 입력하는 것입니다. 주소가 올바르더라도 포트가 틀리면 연결할 수 없으며, Secret이 설정되어 있는데 대시보드에 입력하지 않으면 인증 오류가 발생합니다. 반대로 외부 컨트롤러를 인터넷 전체에 공개하면 다른 사람이 Clash를 제어할 수 있으므로 보안 설정도 반드시 함께 확인해야 합니다.
이 가이드의 목표
Windows용 Clash Verge Rev에서 외부 컨트롤러를 활성화하고, 주소·포트·Secret을 입력한 뒤 Web 대시보드 연결 상태까지 확인하는 전체 과정을 설명합니다.
1설정 전 준비 사항 확인
설정을 시작하기 전에 Clash Verge Rev가 정상적으로 실행되는지 먼저 확인하세요. 시스템 트레이에 Clash 아이콘이 표시되고, 프로필 또는 설정 화면을 열 수 있어야 합니다. 프로그램이 실행되지 않거나 즉시 종료된다면 외부 컨트롤러를 설정하기 전에 앱을 최신 안정 버전으로 다시 설치하는 것이 좋습니다.
- Windows 권한: 방화벽 알림이 표시되면 개인 네트워크에서 Clash Verge Rev의 통신을 허용하세요. 공용 네트워크에서의 허용은 필요한 경우에만 선택합니다.
- 관리자 권한: 외부 컨트롤러 자체에는 항상 관리자 권한이 필요한 것은 아니지만, TUN 모드나 시스템 네트워크 설정을 함께 사용하는 경우 권한이 필요할 수 있습니다.
- 사용 중인 포트: 다른 프로그램이 같은 포트를 사용하고 있지 않은지 확인하세요. 이미 점유된 포트는 컨트롤러가 정상적으로 시작되지 않는 원인이 됩니다.
- 대시보드 준비: Clash Verge Rev에 내장된 Web 대시보드를 사용하거나, 호환되는 외부 대시보드 주소를 준비합니다.
많은 설치 환경에서 외부 컨트롤러 주소는 127.0.0.1 또는 localhost로 표시되며, 포트는 제품 버전에 따라 달라질 수 있습니다. 아래 값은 예시일 뿐이므로 실제 화면에 표시된 값을 우선 사용하세요.
※ 포트와 Secret은 모든 Windows 환경에서 동일하지 않습니다. 임의로 복사하지 말고 Clash Verge Rev의 현재 설정을 확인하세요.
2외부 컨트롤러 활성화하기
Clash Verge Rev를 실행한 뒤 왼쪽 메뉴에서 설정 또는 일반 설정에 해당하는 항목을 엽니다. 버전에 따라 메뉴 이름이나 배치가 조금 다를 수 있지만, External Controller, 외부 컨트롤러, Controller와 같은 문구가 있는 설정을 찾으면 됩니다. 이 항목은 프록시 노드 목록을 보여 주는 화면과 별개로, API 서버의 수신 주소와 인증 토큰을 관리하는 영역입니다.
- Clash Verge Rev를 실행하고 메인 창을 엽니다.
- 설정 화면에서 외부 컨트롤러 관련 항목을 찾습니다.
- 주소 입력란에
127.0.0.1을 입력합니다. 로컬 컴퓨터에서만 대시보드를 사용할 때 가장 안전한 값입니다. - 사용하지 않는 포트를 지정합니다. 예를 들어
9090을 입력할 수 있지만, 실제 사용 가능 여부를 확인해야 합니다. - Secret 입력란에 충분히 긴 임의의 문자열을 입력합니다.
- 저장, 적용 또는 재시작 버튼을 눌러 설정을 반영합니다.
보안에 유의하세요
0.0.0.0을 입력하면 같은 네트워크의 다른 기기에서 컨트롤러에 접근할 가능성이 커집니다. 원격 관리가 꼭 필요하지 않다면 주소는 127.0.0.1로 유지하세요. Secret은 다른 사람에게 공유하거나 공개 저장소에 올리지 마세요.
주소를 localhost로 입력해도 대부분의 경우 동일하게 작동하지만, 일부 대시보드나 보안 프로그램은 이름 해석 과정에서 다르게 동작할 수 있습니다. 문제를 줄이려면 로컬 전용 설정에서는 127.0.0.1을 사용하는 편이 명확합니다. IPv6 환경을 특별히 사용하는 경우가 아니라면 ::1이나 IPv6 와일드카드 주소를 처음부터 선택할 필요는 없습니다.
3Web 대시보드에 연결하기
외부 컨트롤러를 저장한 뒤에는 Web 대시보드에서 API 주소를 등록해야 합니다. 대시보드가 Clash Verge Rev와 같은 컴퓨터에서 열리는지, 별도의 브라우저 탭이나 다른 기기에서 열리는지에 따라 입력할 주소가 달라질 수 있습니다. 같은 Windows PC에서 사용하는 경우 일반적으로 다음처럼 입력합니다.
대시보드에 별도의 주소 입력란이 있다면 프로토콜을 포함한 전체 주소를 입력하세요. 일부 화면에서는 주소와 포트를 따로 입력하므로 주소에는 127.0.0.1, 포트에는 9090만 넣으면 됩니다. Secret 앞뒤에 공백이 들어가면 인증이 실패할 수 있으므로 복사한 뒤 불필요한 공백을 삭제하는 것이 좋습니다.
연결 결과 확인
- 대시보드가 로딩되고 현재 모드가 표시되면 기본 연결에 성공한 것입니다.
- 프록시 그룹과 노드 목록이 나타나면 컨트롤러가 Clash의 상태 정보를 정상적으로 읽고 있는 것입니다.
- 대시보드에서 모드를 변경했을 때 Clash Verge Rev의 메인 화면도 함께 바뀌는지 확인하세요.
- 대시보드에 연결됨으로 표시되더라도 노드 변경이 되지 않는다면 읽기 권한 또는 API 호환성 문제를 점검해야 합니다.
정상 연결 기준
대시보드가 열리고, Secret 인증이 통과하며, 현재 모드와 프록시 그룹이 표시되고, 노드 선택 결과가 Clash Verge Rev에 즉시 반영되면 외부 컨트롤러 설정이 완료된 것입니다.
4주소와 접근 방식 선택하기
외부 컨트롤러 주소는 사용 목적에 따라 선택해야 합니다. 단순히 Windows PC에서 관리할 때는 로컬 주소가 가장 안전하고 문제도 적습니다. 반면 휴대폰이나 다른 컴퓨터에서 관리하려면 네트워크 주소가 필요하지만, 그만큼 방화벽과 인증 설정을 신중하게 구성해야 합니다.
| 사용 목적 | 권장 주소 | 특징 |
|---|---|---|
| 같은 Windows PC에서 관리 | 127.0.0.1 |
외부 접근을 차단해 가장 안전함 |
| 같은 공유기의 다른 기기에서 관리 | Windows의 사설 IP | 방화벽 규칙과 강력한 Secret 필요 |
| 인터넷을 통한 원격 관리 | 직접 공개하지 않음 | VPN 또는 안전한 터널 사용 권장 |
Windows의 사설 IP를 확인하려면 명령 프롬프트에서 다음 명령을 실행할 수 있습니다.
출력 결과의 IPv4 Address가 예를 들어 192.168.1.25로 표시된다면 같은 네트워크의 다른 기기에서 해당 주소와 컨트롤러 포트를 조합해 접근할 수 있습니다. 그러나 Windows Defender 방화벽이 연결을 차단할 수 있으므로, 필요한 경우에만 특정 개인 네트워크와 특정 포트에 한해 허용 규칙을 추가하세요. 공용 Wi-Fi에서 컨트롤러 포트를 열어 두는 것은 피해야 합니다.
5연결 오류 해결과 최종 점검
대시보드가 연결되지 않을 때는 한 번에 여러 설정을 바꾸기보다 주소, 포트, Secret을 순서대로 확인하는 것이 효율적입니다. 다음 표를 기준으로 원인을 좁혀 보세요.
| 증상 | 가능한 원인 | 해결 방법 |
|---|---|---|
| 연결 거부 | 컨트롤러가 꺼져 있거나 포트가 틀림 | Clash Verge Rev를 재시작하고 주소와 포트를 다시 확인 |
| 인증 실패 | Secret 불일치 또는 공백 포함 | Secret을 다시 복사하고 앞뒤 공백을 제거 |
| 화면은 열리지만 목록이 없음 | 대시보드와 코어의 API 호환성 문제 | 내장 대시보드 또는 Mihomo 호환 대시보드 사용 |
| 다른 기기에서만 접속 불가 | 127.0.0.1 사용 또는 Windows 방화벽 차단 | 사설 IP와 개인 네트워크 방화벽 규칙을 점검 |
설정이 적용되지 않는다면 Clash Verge Rev를 완전히 종료한 뒤 다시 실행해 보세요. 시스템 트레이에 남아 있는 프로세스 때문에 이전 설정이 계속 유지되는 경우가 있습니다. 그래도 해결되지 않으면 외부 컨트롤러 포트를 다른 값으로 변경하고, 대시보드의 저장된 연결 정보를 삭제한 후 새로 등록하세요.
- Secret이 짧거나 추측하기 쉬운 단어로 되어 있지 않은지 확인합니다.
- 외부 접근이 필요하지 않다면 주소가
127.0.0.1인지 확인합니다. - 사용하지 않는 포트는 방화벽에서 허용하지 않습니다.
- 대시보드 사용을 마친 뒤에는 브라우저에 저장된 Secret을 삭제하거나 로그아웃합니다.
- Clash Verge Rev 업데이트 후 주소, 포트, 인증 방식이 유지되는지 다시 확인합니다.
외부 컨트롤러는 단순한 상태 표시 기능이 아니라 Clash의 모드와 노드를 변경할 수 있는 관리 인터페이스입니다. 따라서 연결이 잘된다는 사실만 확인하지 말고, 실제로 필요한 기기에서만 접근 가능하도록 범위를 제한해야 합니다. 로컬 관리가 목적이라면 127.0.0.1과 강력한 Secret 조합이 가장 좋은 출발점입니다.
이제 Windows의 Clash Verge Rev에서 주소, 포트, Secret을 올바르게 설정하고 Web 대시보드 연결 상태까지 직접 확인할 수 있습니다. 설정 변경 후에는 대시보드의 노드 선택 결과와 Clash 메인 화면의 상태가 일치하는지 최종적으로 확인하세요.