Windows, macOS, Linux, OpenWrt에서 12VPX NEO에는 vpx 명령이 함께 제공됩니다. 이 명령은 데스크톱 앱, 웹 인터페이스와 같은 백그라운드 서비스를 제어하므로, 한 곳에서 바꾼 내용은 다른 곳에도 나타납니다. 터미널을 닫아도 연결은 끊기지 않으며, vpx disconnect를 실행해야 끊깁니다.
목차
시작하기
vpx --help는 사용 중인 버전의 모든 명령을 보여 주고, vpx <command> --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의 라우팅에서 설명합니다.
기타 설정
| 설정 | 명령 |
|---|---|
| 광고 차단 | 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 및 기타 설정에서 설명합니다.
라우터와 게이트웨이
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를 참고하세요.
다른 기기 제어
명령 앞에 기기 주소와 로그인 정보를 넣으세요.
vpx --daemon http://192.168.1.1:9847 --user root --password 'ROUTER_PASSWORD' status
OpenWrt 라우터의 로그인 정보는 root와 라우터 자체 비밀번호입니다. 다른 컴퓨터라면 그 컴퓨터의 원격 제어 설정에서 정한 사용자 이름과 비밀번호입니다. 그 기기에 보내는 모든 명령에 같은 옵션을 붙이세요. 옵션이 없으면 vpx는 명령을 입력하는 컴퓨터를 제어합니다. 웹 인터페이스와 원격 제어를 참고하세요.
| 작업 | 명령 |
|---|---|
| 원격 제어 설정 보기 | 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에서 업데이트하기를 참고하세요.
문제가 생겼을 때
설정을 바꾸거나 다시 연결하기 전에 보고서를 저장하세요.
vpx diagnostics > vpx-diagnostics.json
이 보고서는 12VPX NEO가 이미 알고 있는 정보만 읽습니다. 아무것도 바꾸지 않으며, 설정 링크와 비밀번호는 포함하지 않습니다. 무엇을 하고 있었는지, 문제가 생긴 시각, 정확한 오류 메시지와 함께 지원팀에 보낼 수 있습니다. vpx diagnostics --explain은 인터넷에 연결되어 있지 않아도 문제 해결 가이드를 출력합니다.
vpx logs는 최근 이벤트를 보여 주고, vpx logs --follow는 다시 시도하는 동안 새 이벤트를 계속 보여 줍니다. 로그에는 방문한 사이트의 이름이 들어 있을 수 있으므로 공유하기 전에 읽어 보세요.
터미널에서 지원팀에 연락하려면 vpx support --help를 참고하세요. 이 명령들은 실제로 메시지나 로그를 보냅니다. 다른 연락 방법은 지원, 로그 및 계정에서 설명합니다.
Windows에서는 vpx repair-driver로 드라이버 복구를 실행할 수 있습니다.