웹 패널을 켤 때 왜 127.0.0.1이 기본 안전선인가요?
Clash 계열 코어는 데이터 패스를 여는 동시에 external-controller라는 RESTful 관리 API와 웹 대시보드 연결을 같은 포트에서 처리하는 경우가 많습니다. 프록시 사용자 입장에서는 “브라우저에서 노드만 바꾸면 돼서 편하다”가 전부인데, 공격자 입장에서는 여기가 정책·구독·실시간 연결 로그를 한꺼번에 만질 수 있는 제어 면입니다. 그래서 포트를 0.0.0.0이나 LAN IP 전체에 열어두면, 같은 Wi‑Fi의 휴대폰이나 IoT 기기, 심지어 잘못 포워딩된 공유기 규칙까지 타고 외부에서 스캔될 여지가 생깁니다.
127.0.0.1(루프백)에만 바인딩하면 소켓은 그 PC 안에서 끝납니다. 옆 방 노트북이나 TV 박스는 동일 SSID 안에 있어도 관리 포트에 직접 붙지 못합니다. 물론 악성 프로그램이 이미 그 PC에 침투했다면 로컬호스트도 위험하지만, “실수로 LAN 전체에 관리창을 연 상태”보다 훨씬 좁은 폭파면입니다. 이 글은 TUN·DNS 같은 데이터면 대신사전 전부를 설명하지 않고, 제어 면만 좁히고 Secret으로 잠그는 최소 절차에 집중합니다.
external-controller와 bind-address가 하는 일
실행 중인 클러스터 구성 YAML 안에는 보통 아래와 비슷한 줄이 있습니다.
external-controller: 127.0.0.1:9090— 관리 HTTP API가 듣는 주소·포트입니다. 앞부분이0.0.0.0이면 모든 인터페이스,::계열이면 IPv6까지 포함한 와이드 오픈일 수 있습니다.bind-address: 127.0.0.1— 일부 빌드에서는 별도 키로 전역 바인딩을 제한합니다. 문서·템플릿 둘 다 있는 경우 값이 서로 어긋나지 않게 맞추는 것이 안전합니다.
Clash Verge Rev는 GUI로 프로필을 편집하지만, 최종적으로는 Mihomo 등 코어가 이 YAML을 읽습니다. 한 줄이라도 LAN에 열려 있으면 그대로 노출이므로, 구독에서 내려받은 기본값이 0.0.0.0:9090이라면 반드시 덮어써야 합니다.
127.0.0.1:7890 등)는 “브라우저가 쓰는 데이터 포트”이고, external-controller는 “대시보드·스크립트가 코어를 조종하는 포트”입니다. 둘을 같은 숫자로 두지 말고, 방화벽 예외도 목적별로 나눠 생각하세요.Secret(토큰)은 왜 필수에 가깝나요?
바인딩을 실수로 넓혔거나, 로컬호스트를 악성 확장·다른 프로세스가 스캔하는 상황까지 막진 못합니다. 이때 마지막 방어선이 Authorization: Bearer 검증입니다. 설정 파일의 secret: 항목은 코어가 허용하는 토큰이며, 대시보드·자동화 스크립트·curl 모두 같은 문자열을 헤더에 실어야 401 없이 버전·프록시·규칙 API를 읽고 씁니다.
실무 팁은 세 가지입니다. 첫째, 구독 URL과 무관한 별도 긴 무작위 문자열을 쓰고 메모 대신 비밀번호 관리기에 넣습니다. 둘째, 스크린샷·로그에 헤더가 찍히지 않게 배포 자동화를 짭니다. 셋째, Secret을 바꾼 뒤 `Verge` 안의 웹 패널 캐시가 옛 토큰을 들고 있으면 로그인 실패로 보이니, 토큰 교체 후에는 UI도 함께 새로 고침합니다.
Clash Verge Rev에서 손대는 위치(개념 정리)
버전마다 메뉴 레이블은 조금씩 달라도 흐름은 같습니다. 활성 프로필의 Raw/편집 화면에서 YAML을 직접 수정하거나, 전역 설정의 Clash 필드를 통해 external-controller·secret·bind-address를 덮어씁니다. 어떤 경로를 쓰든 저장 후 실제 코어에 적용·재시작까지 끝내야 포트가 바뀝니다.
외부 웹 UI(예: 정적 대시보드)를 붙일 계획이라면, 그 페이지가 향하는 백엔드 URL을 http://127.0.0.1:9090 형태로 두고 Secret 입력칸에 동일 값을 넣습니다. LAN의 다른 PC에서 패널을 보고 싶다면, SSH 로컬 포트 포워딩이나 Zero Trust 터널처럼 전송층을 먼저 잠근 뒤에만 열고, 코어 자체를 0.0.0.0에 얹는 방법은 가급적 피합니다.
단계별: 루프백 고정 → Secret → 적용 → 검증
-
현재 값 스냅샷
Verge 로그나 프로필 편집기에서external-controller줄을 찾아 캡처해 둡니다. 이미0.0.0.0/::나 공인이 아닌 LAN IP가 앞에 붙어 있으면 이번 작업의 1순위 수정 대상입니다. -
127.0.0.1로 통일
예:external-controller: 127.0.0.1:9090. 템플릿에bind-address가 따로 있다면127.0.0.1로 맞춥니다. 포트 충돌이 나면 사용 중인 다른 도구·옛 코어 인스턴스를 종료하거나 유효한 빈 포트로 바꿉니다. -
Secret 생성·기입
secret: '<긴 무작위 문자열>'형태로 추가·교체합니다. YAML 문법상 따옴표 충돌을 피하려면 작은따옴표 블록이 안전한 편입니다. -
저장·적용·재시작
Verge에서 프로필 저장 후 코어 재시작 또는 적용 버튼을 눌러 실제 런타임 설정을 갱신합니다. 트레이 메뉴에 “서비스 모드”가 있다면 권한이 덜 빠진 상태인지도 함께 확인합니다. -
본기에서 API 확인
터미널에서curl -H "Authorization: Bearer YOUR_SECRET" http://127.0.0.1:9090/version처럼 호출해 JSON이 돌아오면 성공입니다. Secret을 빼면 401이 나와야 정상입니다. -
LAN 음영 테스트
스마트폰 같은 제2 기기에서http://노트북-LAN-IP:9090로 접속해 봅니다. 루프백 바인딩이 제대로면 타임아웃·연결 거절이 나와야 합니다. 만약 응답이 보인다면 아직0.0.0.0경로가 남았거나, 다른 프로세스가 같은 포트를 잡고 있을 수 있으니 다시 프로필 전체를 검색합니다.
RESTful 호출 패턴을 알아두면 재발검증이 빨라집니다
웹 패널이 내부적으로 쓰는 엔드포인트와 같은 계열을 curl로 직접 두드리면, UI 없이도 “토큰이 맞는지·포트가 살아 있는지”를 재현할 수 있습니다. 예시로 버전 확인(/version) 외에도 프록시 그룹 목록·현재 모드를 가져오는 읽기 전용 API가 있습니다. 운영 중 자동화를 붙일 때는 쓰기 권한이 있는 엔드포인트를 스크립트에만 한정하고, 로그에 Secret이 남지 않게 stdout 대신 환경 변수로 주입하는 습관을 들이세요.
한편 브라우저 확장이나 로컬 앱이 127.0.0.1:9090을 스캔한다는 보고가 가끔 있습니다. 그래서 Secret 없이 열어두면 “로컬이라 안전”이 아니라 같은 사용자 세션 안의 악성 코드에게는 열려 있는 API가 됩니다. 바인딩을 루프백으로 좁혀도 토큰은 여전히 의미가 있습니다.
자주 묻는 질문
가족이 같은 Wi‑Fi에서 패널을 보고 싶다면?
가장 안전한 형태는 PC 안에서만 패널을 열고, 원격은 OS가 제공하는 화면 공유나 SSH 포워딩으로 해결하는 것입니다. 굳이 external-controller를 LAN에 열어야 한다면, 별도 방화벽 ACL·강한 Secret·HTTPS 리버스 프록시·최소 출처 제한을 동시에 고려해야 하고 이는 본 문서 범위를 넘는 운영 과제입니다.
포트를 9090이 아니라도 되나요?
됩니다. 다만 대시보드·북마크·스크립트에 박아 둔 URL을 모두 같이 바꿔야 하고, 다른 개발 도구가 쓰는 포트와 겹치지 않게만 조정하면 됩니다.
구독 템플릿이 매번 0.0.0.0을 밀어 넣으면?
Verge의 오버라이드/머지 기능으로 external-controller와 secret을 항상 마지막에 덮어쓰기 하세요. 업데이트할 때마다 수동으로 고치는 것보다 실수가 적습니다.
정리: 제어 포트를 보이게 만들되, 폭을 스스로 정한다
한편, 일부 상용 VPN·프록시 앱은 대시보드를 예쁘게 감추는 대신 어떤 관리 포트가 열렸는지 사용자가 확인하기 어렵게 만드는 경우가 있습니다. 원클릭 연결은 편하지만, “LAN에 무엇이 드러나 있는지”를 텍스트 설정으로 적어 두기 어렵다면 사고 후 복기도 느려집니다.
Clash·Mihomo 계열은 external-controller와 Secret을 YAML에 명시할 수 있어, 방금처럼 루프백 바인딩과 토큰 검증을 같은 파일에서 끝까지 추적할 수 있습니다. GUI가 Verge든 다른 래퍼든, 코어가 받는 최종 값만 일치하면 되므로 자동화·감사에도 유리합니다.
클라이언트 출처를 한곳으로 맞춘 뒤 이 글 순서만 적용해도 관리 면은 크게 좁아집니다. 우선 본 사이트 클라이언트 다운로드 페이지에서 현재 OS 빌드를 받아 주세요.