PandaVPN CLI명령줄 클라이언트

개발자, 고급 사용자 및 자동화 테스트 워크플로를 위해 설계되었습니다. 터미널에서 로그인, 노드 새로고침, VPN 모드 전환, Kill Switch 구성, 연결 및 로그 진단을 완료할 수 있습니다.

Windows 및 macOS 설치 프로그램은 백그라운드 서비스를 자동 등록합니다. Linux 사용자는 명령줄에서 systemd 서비스를 수동으로 설치할 수 있습니다.

panda@terminal
panda>mode pandavpn globalpanda>connect[Success] Connected to <NODE_ID>.panda>doctor[OK] Runtime healthy.

적합한 CLI 버전 선택

운영 체제와 프로세서 아키텍처에 맞는 PandaVPN CLI를 다운로드한 후, 해당 빠른 시작 단계에 따라 설치, 로그인, 노드 새로고침, 모드 전환, 연결 및 진단을 완료하세요.

macOS

버전: 2.1.1업데이트:

시스템 안내

macOS 사용자용. 설치 프로그램이 필요한 권한 요청, 백그라운드 daemon 설치 및 시작을 자동으로 처리합니다.

다운로드

새로운 기능

  • 1. Automatic, PandaVPN, WireGuard 모드 간 전환을 개선하여 연결을 더욱 원활하게 했습니다.
  • 2. 트래픽 라우팅과 로컬 네트워크 설정을 개선하여 불필요한 재연결을 줄였습니다.
  • 3. 지원되는 IPv4 및 IPv6 연결에 VPN 출구 IP 주소 정보를 추가했습니다.
  • 4. 연결 복구 기능과 전반적인 네트워크 신뢰성을 향상했습니다.
릴리스 노트 보기 →

설치 안내

  1. 아키텍처에 맞는 .pkg 설치 프로그램을 다운로드합니다.
  2. 설치 프로그램을 더블클릭하고 안내에 따라 설치합니다.
  3. 설치 프로그램이 백그라운드 daemon을 자동 설치하고 시작합니다.
  4. 설치 후 Terminal을 열어 panda 명령을 사용합니다.

빠른 시작

# 1. 도움말 보기
panda help

# 2. 로그인
panda login

# 3. 노드 목록 새로고침
panda node refresh

# 4. PandaVPN 글로벌 모드 설정
panda mode pandavpn global

# 5. Kill Switch 활성화(선택)
panda kill-switch on

# 6. 한 번에 연결
panda connect

# 7. 진단 상태 확인
panda doctor

# 8. 네트워크 구성 오류 복구
panda repair

Linux

버전: 2.1.1업데이트:

시스템 안내

Linux 사용자용. CLI 바이너리를 제공하며 백그라운드 systemd 서비스는 수동 설치가 필요합니다.

다운로드

새로운 기능

  • 1. Automatic, PandaVPN, WireGuard 모드 간 전환을 개선하여 연결을 더욱 원활하게 했습니다.
  • 2. 트래픽 라우팅과 로컬 네트워크 설정을 개선하여 불필요한 재연결을 줄였습니다.
  • 3. 지원되는 IPv4 및 IPv6 연결에 VPN 출구 IP 주소 정보를 추가했습니다.
  • 4. 연결 복구 기능과 전반적인 네트워크 신뢰성을 향상했습니다.
릴리스 노트 보기 →

설치 안내

  1. 아키텍처에 맞는 Linux CLI 파일을 다운로드합니다.
  2. 압축을 풀거나 시스템 실행 경로에 배치합니다.
  3. sudo panda service install을 실행하여 백그라운드 systemd 서비스를 설치합니다.
  4. 설치 후 panda 명령으로 로그인, 노드 새로고침, 연결 및 진단을 수행합니다.

빠른 시작

# 1. 백그라운드 서비스 설치
sudo panda service install

# 2. 도움말 보기
panda help

# 3. 로그인
panda login

# 4. 노드 목록 새로고침
panda node refresh

# 5. PandaVPN 글로벌 모드 설정
panda mode pandavpn global

# 6. Kill Switch 활성화(선택)
sudo panda kill-switch on

# 7. 한 번에 연결
panda connect

# 8. 진단 상태 확인
panda doctor

# 9. 네트워크 구성 오류 복구
panda repair

Windows

버전: 2.1.1업데이트:

시스템 안내

Windows 사용자용. 설치 프로그램이 관리자 권한을 자동 요청하고 PandaVPN CLI 백그라운드 Windows Service를 등록합니다.

새로운 기능

  • 1. Automatic, PandaVPN, WireGuard 모드 간 전환을 개선하여 연결을 더욱 원활하게 했습니다.
  • 2. 트래픽 라우팅과 로컬 네트워크 설정을 개선하여 불필요한 재연결을 줄였습니다.
  • 3. 지원되는 IPv4 및 IPv6 연결에 VPN 출구 IP 주소 정보를 추가했습니다.
  • 4. 연결 복구 기능과 전반적인 네트워크 신뢰성을 향상했습니다.
릴리스 노트 보기 →

설치 안내

  1. 아키텍처에 맞는 Windows 설치 프로그램을 다운로드합니다.
  2. 설치 프로그램을 더블클릭하고 안내에 따라 설치합니다.
  3. 설치 프로그램이 관리자 권한을 자동 요청하고 백그라운드 Windows Service를 등록합니다.
  4. 설치 후 PowerShell 또는 Terminal을 열어 panda 명령을 사용합니다.

빠른 시작

# 1. 도움말 보기
panda help

# 2. 로그인
panda login

# 3. 노드 목록 새로고침
panda node refresh

# 4. PandaVPN 글로벌 모드 설정
panda mode pandavpn global

# 5. Kill Switch 활성화(선택)
panda kill-switch on

# 6. 한 번에 연결
panda connect

# 7. 진단 상태 확인
panda doctor

# 8. 네트워크 구성 오류 복구
panda repair

먼저 panda help를 실행해 지원되는 명령을 확인하세요. 대화형 모드에서는 인수 없이 panda를 실행하고 Tab으로 명령을 자동 완성할 수 있습니다. routes, DNS, system proxy 또는 Kill Switch 상태가 예기치 않게 변경되거나 사라진 경우 panda repair를 실행해 Panda가 관리하는 네트워크 구성을 복원하세요.

고급 네트워크 시나리오를 위해

스마트 연결 및 런타임 지원

권장 연결 방식을 자동으로 선택하고 필요 시 fallback합니다. 사용 가능한 환경에서 PandaVPN 및 WireGuard runtime을 지원합니다.

라우팅, DNS 및 유출 방지

전역 라우팅, GFWList, direct-region, proxy-region, 사용자 지정 분류 규칙, DNS 정책, fake-IP DNS, LAN 액세스 제어가 포함된 엄격한 Kill Switch를 제어합니다.

자동화 준비된 진단

JSON 출력과 doctor, status, trace, watch, log 등 에이전트 친화적 명령으로 문제 해결, 모니터링 및 VPN 워크플로 자동화가 가능합니다.

자주 묻는 질문

Panda CLI와 데스크톱 클라이언트의 차이점은 무엇인가요?

PandaVPN CLI는 자동화 테스트, 원격 문제 해결, 스크립트를 이용한 연결에 더 적합합니다.

Panda Desktop과 PandaVPN CLI는 동일한 PandaVPN daemon을 제어하는 두 가지 인터페이스이며 동일한 연결 상태를 공유하므로 함께 사용할 수 있습니다.

Panda-Qt 또는 이전 Linux AppImage와 같은 구형 데스크톱 앱을 PandaVPN CLI와 동시에 실행하지 마세요. 네트워크 설정 충돌이 발생할 수 있습니다.

설치 후 시스템 수준 권한이 필요한 이유는?

TUN 인터페이스 생성, 시스템 DNS 변경, Kill Switch 등 고급 보호 기능에는 시스템 수준 권한이 필요하므로 해당 플랫폼 daemon / service가 백그라운드에서 실행됩니다.

Kill Switch를 proxy 모드와 함께 사용할 수 없는 이유는?

Kill Switch는 TUN 터널을 통한 트래픽만 허용하고 나머지를 차단하도록 설계되었습니다. standalone proxy 모드에는 TUN 인터페이스가 없으므로 둘은 상호 배타적입니다. pandavpn 또는 wireguard 모드로 전환하여 Kill Switch를 사용하세요.