ForestVPN CLI

계정 관리

사용자는 fvpn account register 명령으로 새 계정을 생성하거나, fvpn account login 명령으로 기존 계정에 로그인할 수 있습니다. 이 기능은 Firebase REST API를 기반으로 한 인증 로직을 통해 구현됩니다.

연결 상태 제어

fvpn state up 명령으로 선택한 위치에 연결을 시작하고, fvpn state down 명령으로 연결을 해제할 수 있습니다. 현재 연결 상태를 확인하려면 fvpn state 명령을 사용합니다.

위치 관리

fvpn location ls 명령으로 사용 가능한 서버 위치 목록을 확인하고, fvpn location set ${CITY} 명령으로 특정 도시의 서버를 선택할 수 있습니다. 위치 관리는 사용자가 지리적 선호도에 따라 최적의 연결을 선택하도록 돕습니다.

버전 확인

fvpn version 명령을 실행하면 현재 설치된 ForestVPN CLI의 버전 정보를 확인할 수 있습니다. 이는 소프트웨어 업데이트 여부를 판단하는 데 유용합니다.

Windows

Windows에서는 Chocolatey 패키지 관리자를 통해 설치할 수 있습니다. 공식 Chocolatey 패키지 ID는 chocolatey.fvpn이며, 해당 패키지를 통해 최신 버전의 ForestVPN CLI를 설치할 수 있습니다.

macOS

macOS에서는 Homebrew를 사용하여 설치할 수 있습니다. 안정 버전은 brew install forestvpn/stable/fvpn 명령으로, 베타 버전은 brew install forestvpn/beta/fvpn 명령으로 설치할 수 있습니다.

Linux (Debian/Ubuntu)

Debian 또는 Ubuntu 기반 시스템에서는 다음 명령을 순차적으로 실행하여 설치할 수 있습니다:
wget -q https://github.com/forestvpn/cli/releases/latest/download/fvpn_linux_amd64.deb && dpkg -i fvpn_linux_amd64.deb

Linux (Fedora)

Fedora 시스템에서는 다음 명령을 사용합니다:
wget -q https://github.com/forestvpn/cli/releases/latest/download/fvpn_linux_amd64.rpm && dnf install fvpn_linux_amd64.rpm

Linux (Alpine)

Alpine Linux에서는 다음 명령을 실행합니다:
wget -q https://github.com/forestvpn/cli/releases/latest/download/fvpn_linux_amd64.apk && apk add fvpn_linux_amd64.apk --allow-untrusted

Linux (일반 tar.gz)

다른 Linux 배포판에서는 tar.gz 아카이브를 다운로드하여 수동으로 설치할 수 있습니다:
wget -q https://github.com/forestvpn/cli/releases/latest/download/fvpn_linux_amd64.tar.gz && tar -xf fvpn_linux_amd64.tar.gz -C /usr/local/bin/

기본 사용법/명령어

ForestVPN CLI는 다음과 같은 기본 명령 구조를 따릅니다: fvpn [global options] command [command options] [arguments...]
전역 옵션으로는 --help 또는 -h를 사용하여 도움말을 볼 수 있습니다.
주요 명령어 그룹은 다음과 같습니다:
– account: 계정 등록 및 로그인 관리
– state: VPN 연결 상태 제어 (up/down)
– location: 서버 위치 목록 보기 및 설정
– version: 현재 버전 확인
– help, h: 명령어 목록 또는 특정 명령어 도움말 표시

사용 예시:
– 계정 등록: fvpn account register
– 기존 계정 로그인: fvpn account login
– 사용 가능한 위치 보기: fvpn location ls
– 위치 설정: fvpn location set ${CITY} (예: fvpn location set Tokyo)
– 연결 시작: fvpn state up
– 연결 해제: fvpn state down
– 버전 확인: fvpn version

의존성으로는 net-tools와 wireguard-tools가 필요하며, Linux 시스템에서는 이들 패키지가 미리 설치되어 있어야 정상 작동합니다.