--- title: vpx 명령줄 nav_title: 명령줄 description: Windows, macOS, Linux, OpenWrt의 터미널에서 vpx 명령으로 12VPX NEO를 제어하는 방법을 설명합니다. 연결과 라우팅부터 라우터 제어, 지원팀에 보낼 보고서 수집까지 다룹니다. --- Windows, macOS, Linux, OpenWrt에서 12VPX NEO에는 `vpx` 명령이 함께 제공됩니다. 이 명령은 데스크톱 앱, 웹 인터페이스와 같은 백그라운드 서비스를 제어하므로, 한 곳에서 바꾼 내용은 다른 곳에도 나타납니다. 터미널을 닫아도 연결은 끊기지 않으며, `vpx disconnect`를 실행해야 끊깁니다. AUTOMATIC_TABLE_OF_CONTENTS ## 시작하기 `vpx --help`는 사용 중인 버전의 모든 명령을 보여 주고, `vpx --help`는 명령 하나를 설명합니다. Windows PowerShell에서 `vpx`만으로 실행되지 않으면 `vpx` 대신 `vpx.exe`를 입력하세요. 아래 예에서 `SERVER_ID`처럼 대문자로 쓴 부분은 실제 값으로 바꾸세요. 웹 주소와 비밀번호는 작은따옴표로 감싸세요. 일상적인 명령에는 관리자 권한이나 root 권한이 필요 없습니다. ## 자주 쓰는 명령 | 작업 | 명령 | | --- | --- | | 서비스 추가 | `vpx login 'SUBSCRIPTION_URL'` | | 서버 목록 보기 | `vpx servers`, `vpx servers --country JP` 또는 `vpx servers --search NAME` | | Automatic으로 연결 | `vpx connect` | | 특정 서버에 연결 | `vpx connect SERVER_ID` | | Automatic 지역 선택 | `vpx auto region jp`(`us`, `eu`, `jp`, `any` 또는 `favorites`) | | 서버 별표 표시 또는 해제 | `vpx favorite SERVER_ID` 또는 `vpx favorite SERVER_ID --remove` | | 연결 상태 보기 | `vpx status` | | 공인 IP 주소 보기 | `vpx ip --refresh` | | 연결 해제 | `vpx disconnect` | | 웹 인터페이스 열기 | `vpx open` | | 계정 보기 | `vpx account` | | 계정의 기기 목록 보기 | `vpx account-devices` | | 이 기기 로그아웃 | `vpx logout` | 설정 링크는 비공개 정보입니다. 입력한 명령은 셸 기록에 남을 수 있으므로, 여러 사람이 함께 쓰는 컴퓨터에서는 기록을 지우세요. ## 라우팅과 캡처 | 작업 | 명령 | | --- | --- | | 라우팅 모드 보기 또는 변경 | `vpx mode`, `vpx mode full`, `vpx mode china` 또는 `vpx mode ai` | | 수동 규칙 목록 보기 | `vpx rules list` | | 도메인과 그 아래 모든 이름을 직접 연결 | `vpx rules add general direct suffix example.com` | | 정확한 이름 하나를 VPX 서비스로 보내기 | `vpx rules add general tunnel exact www.example.com` | | 규칙 삭제 | `vpx rules remove RULE_ID`(ID는 `vpx rules list`에서 확인) | | Rocket 구성 추가 및 사용 | `vpx rocket add 'CONFIG_URL'` 실행 후 `vpx rocket list`, `vpx rocket use CONFIG_ID` | | Rocket 구성 사용 중지 | `vpx rocket off` | | AI 라우팅이 사이트를 어떻게 처리했는지 보기 | `vpx ai activity` 또는 `vpx ai explain example.com` | | 캡처 방식 변경 | `vpx capture tun`, `vpx capture tproxy` 또는 `vpx capture proxy-only` | 규칙은 `vpx rules add SCOPE ROUTE TYPE VALUE` 형식으로 씁니다. - **Scope**(적용 범위): `general`(모든 모드) 또는 `ai-only` - **Route**(경로): `direct` 또는 `tunnel`(VPX 서비스 경유) - **Type**(유형): `suffix`, `exact`, `keyword`, `cidr` 또는 `geoip` 각 선택이 하는 일은 [12VPX NEO의 라우팅](/ko/docs/12vpx-neo/routing)에서 설명합니다. ## 기타 설정 | 설정 | 명령 | | --- | --- | | 광고 차단 | `vpx ad-blocking`으로 확인, `vpx ad-blocking normal`(또는 `off`, `light`, `pro`)로 변경, `vpx ad-blocking refresh`로 목록 업데이트 | | Outbound Optimization | `vpx outbound-optimization`, `vpx outbound-optimization throughput` 또는 `vpx outbound-optimization latency` | | Restore Connection on Startup | `vpx restore-connection on`, `off` 또는 `status` | | DNS 유출 방지 | `vpx dns-leak on`, `off` 또는 `status` | | Kill Switch | `vpx kill-switch on`, `off` 또는 `status` | | Restore Internet | `vpx restore-internet` | | LAN Proxy Access | `vpx lan-proxy on`, `off` 또는 `status` | | Home Node | `vpx home-server enable`, `disable` 또는 `status` | | 컴퓨터 시간 | `vpx clock`, 다시 확인하려면 `vpx clock --refresh` | | 모든 설정 보기 | `vpx settings` | 각 설정은 [광고 차단, Kill Switch 및 기타 설정](/ko/docs/12vpx-neo/settings)에서 설명합니다. ## 라우터와 게이트웨이 OpenWrt와 Linux에서: | 작업 | 명령 | | --- | --- | | 네트워크에 Router Mode 켜기 | `vpx router enable --lan lan,guest` | | Router Mode 끄기 | `vpx router disable` | | Linux 게이트웨이의 LAN DNS | `vpx router dns`, `vpx router dns on` 또는 `vpx router dns off` | | 제외한 기기 목록 보기 | `vpx devices` | | 기기 제외 | `vpx devices add 192.168.1.50 'Living room TV'` | | 제외 해제 | `vpx devices remove 192.168.1.50` | `lan,guest`는 OpenWrt 네트워크 이름입니다. Linux에서는 네트워크 어댑터 이름을 사용하세요. [라우터용 12VPX NEO](/ko/docs/12vpx-neo/router)를 참고하세요. ## 다른 기기 제어 명령 앞에 기기 주소와 로그인 정보를 넣으세요. ```sh vpx --daemon http://192.168.1.1:9847 --user root --password 'ROUTER_PASSWORD' status ``` OpenWrt 라우터의 로그인 정보는 `root`와 라우터 자체 비밀번호입니다. 다른 컴퓨터라면 그 컴퓨터의 원격 제어 설정에서 정한 사용자 이름과 비밀번호입니다. 그 기기에 보내는 모든 명령에 같은 옵션을 붙이세요. 옵션이 없으면 `vpx`는 명령을 입력하는 컴퓨터를 제어합니다. [웹 인터페이스와 원격 제어](/ko/docs/12vpx-neo/remote-control)를 참고하세요. | 작업 | 명령 | | --- | --- | | 원격 제어 설정 보기 | `vpx listen` | | 이 컴퓨터의 원격 제어 켜기 | `vpx --user admin --password 'PASSWORD' listen INTERFACE` | | 원격 제어 끄기 | `vpx listen --disable` | | 원격 제어 비밀번호 지우기 | `vpx reset-password` | ## 업데이트 | 작업 | 명령 | | --- | --- | | 지금 업데이트 확인 | `vpx update --check` | | 다운로드한 업데이트 설치 | `vpx update` | | Stable 또는 Beta 업데이트 받기 | `vpx update --channel stable` 또는 `vpx update --channel beta` | | 버전 보기 | `vpx version` | OpenWrt에서는 대신 라우터의 패키지 관리자로 업데이트하세요. [OpenWrt에서 업데이트하기](/ko/docs/12vpx-neo/router#openwrt에서-업데이트하기)를 참고하세요. ## 문제가 생겼을 때 설정을 바꾸거나 다시 연결하기 전에 보고서를 저장하세요. ```sh vpx diagnostics > vpx-diagnostics.json ``` 이 보고서는 12VPX NEO가 이미 알고 있는 정보만 읽습니다. 아무것도 바꾸지 않으며, 설정 링크와 비밀번호는 포함하지 않습니다. 무엇을 하고 있었는지, 문제가 생긴 시각, 정확한 오류 메시지와 함께 지원팀에 보낼 수 있습니다. `vpx diagnostics --explain`은 인터넷에 연결되어 있지 않아도 문제 해결 가이드를 출력합니다. `vpx logs`는 최근 이벤트를 보여 주고, `vpx logs --follow`는 다시 시도하는 동안 새 이벤트를 계속 보여 줍니다. 로그에는 방문한 사이트의 이름이 들어 있을 수 있으므로 공유하기 전에 읽어 보세요. 터미널에서 지원팀에 연락하려면 `vpx support --help`를 참고하세요. 이 명령들은 실제로 메시지나 로그를 보냅니다. 다른 연락 방법은 [지원, 로그 및 계정](/ko/docs/12vpx-neo/support)에서 설명합니다. Windows에서는 `vpx repair-driver`로 [드라이버 복구](/ko/docs/12vpx-neo/settings#windows-드라이버-복구)를 실행할 수 있습니다.