FreeGuard for Linux: Command-Line VPN with Rules and GeoIP Routing

Linux용 FreeGuard는 서버와 개발자를 위해 제작된 명령줄 클라이언트입니다. 자체 규칙이나 GeoIP를 통한 지역별 설정으로 트래픽을 라우팅하고, JSON 출력으로 스크립팅하며, systemd 사용자 서비스로 실행할 수 있습니다. x86_64 또는 arm64에서 명령 하나로 설치하세요.

Linux용 FreeGuard는 명령줄 클라이언트입니다

mihomo 코어를 설정해 주는 단일 Go 바이너리입니다. 그래픽 앱을 원한다면 Windows 또는 Mac용 FreeGuard를 사용하세요.

freeguard CLI는 터미널에서 로그인, 서버 선택, 연결, 라우팅 규칙 및 자동 시작을 처리합니다. x86_64 및 arm64 Linux용 단일 Go 바이너리로, mihomo 코어를 설정하므로 서버, 컨테이너, 최소 설치 환경은 물론 개발자용 노트북에도 적합합니다.

Linux 데스크톱 앱은 없습니다. 그래픽 인터페이스를 원한다면 FreeGuard Windows 또는 Mac 앱을 사용하세요.

원하는 방식으로 트래픽 라우팅하기: 규칙 및 GeoIP 지역 라우팅

직접 라우팅 규칙을 작성하거나 한 지역의 트래픽을 VPN을 거치지 않고 전송한 다음, 연결 후 라우팅 요약을 확인하세요.

• 기본 규칙 모드: 라우팅 규칙에 따라 어떤 트래픽을 VPN으로 보내고 어떤 트래픽을 직접 보낼지 결정하며, freeguard connect는 이해하기 쉬운 라우팅 요약을 출력합니다
• 사용자 지정 규칙: freeguard rule add DOMAIN example.com DIRECT는 규칙을 추가합니다. rule list, rule remove 및 rule import(URL 또는 파일에서 가져오기)로 나머지 규칙을 관리합니다
• GeoIP 지역 라우팅: freeguard config set geoip_region CN은 CN 또는 JP와 같은 한 지역의 트래픽을 직접 보내고 나머지는 모두 VPN을 통해 유지합니다
• TUN 모드: freeguard connect --tun을 사용하면 시스템의 모든 트래픽을 캡처합니다. 이 옵션을 사용하지 않으면 FreeGuard가 앱에서 사용할 수 있는 로컬 프록시를 제공합니다

Linux에 FreeGuard 설치

지원되는 설치 방법은 세 가지입니다: 당사의 설치 스크립트, Homebrew 또는 GitHub Releases. 공식 apt, dnf 또는 pacman 저장소는 없습니다.

설치 스크립트(권장):

curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh

Homebrew로 설치:

brew install planetlinkinc/tap/freeguardvpn

직접 바이너리: GitHub Releases에서 아키텍처에 맞는 릴리스를 다운로드하세요.

배포판 저장소를 통해 .deb, .rpm 또는 Arch 패키지를 배포하지 않으므로 apt install freeguard, dnf install freeguard 또는 pacman -S freeguard 명령은 사용할 수 없습니다.

추가 CLI 기능

• 프로토콜: anytls, hysteria2 및 trojan; 연결마다 하나를 선택하세요. 예: freeguard connect la2 anytls
• 서버 선택: 별칭으로 freeguard connect la2 또는 hk1을 사용하거나, 미국 최적 서버를 선택하려면 freeguard connect US를 사용하거나, 마지막 서버를 재사용하거나 최적 서버를 선택하려면 freeguard connect만 입력하세요
• 자동 시작: freeguard autostart enable은 ~/.config/systemd/user/freeguard.service에 systemd 사용자 서비스를 설치합니다(루트 데몬이 필요하지 않음)
• 진단: freeguard doctor가 환경을 확인합니다
• 상태 및 모니터링: freeguard status와 freeguard monitor는 실시간 연결 세부 정보를 표시합니다
• 스크립팅: 스크립트와 AI 에이전트가 읽을 수 있는 출력을 얻으려면 명령에 --json을 추가하세요

시작하는 방법

1. 1단계: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh을 실행하세요
2. 2단계: freeguard init을 실행하고 FreeGuard 계정으로 로그인하세요
3. 3단계: freeguard connect를 실행합니다(특정 서버를 사용하려면 freeguard connect la2 실행).

자주 묻는 질문

FreeGuard에는 Linux GUI 애플리케이션이 있나요?

아니요. Linux용 FreeGuard는 freeguard 명령줄 클라이언트입니다. 그래픽 인터페이스를 원한다면 Windows 또는 Mac 앱을 사용하세요.

Linux에서 일부 트래픽만 VPN을 통해 라우팅하려면 어떻게 하나요?

라우팅 규칙 또는 GeoIP 지역 라우팅을 사용하세요. freeguard rule add는 특정 도메인이나 IP 범위를 직접 연결하거나 VPN을 통해 보내며, freeguard config set geoip_region CN은 한 지역의 트래픽은 직접 보내고 나머지는 VPN을 통해 보냅니다.

Linux CLI는 무료인가요?

설치는 무료입니다. 연결하려면 FreeGuard 구독이 필요합니다. 요금제를 확인하려면 freeguard subscribe list를 실행하세요.

배포판의 패키지 관리자를 통해 FreeGuard를 설치할 수 있나요?

공식 배포판 저장소에서는 설치할 수 없습니다. 당사의 설치 스크립트 (install.sh), Homebrew 또는 GitHub Releases의 바이너리를 사용하세요. apt, dnf, pacman 또는 AUR에는 게시하지 않습니다.

헤드리스 서버와 Docker에서 CLI를 사용할 수 있나요?

네. CLI는 GUI 종속성이 없는 단일 Go 바이너리입니다. SSH를 통해, 컨테이너 내부에서, 그리고 최소 기본 이미지에서 실행할 수 있습니다. 단, 컨테이너에 TUN 장치를 생성하는 데 필요한 네트워크 권한이 있어야 합니다.

부팅 시 FreeGuard를 자동으로 시작할 수 있나요?

네. freeguard autostart enable은 ~/.config/systemd/user/freeguard.service에 systemd 사용자 서비스를 설치합니다. 이 서비스는 root 데몬이 아닌 사용자 계정으로 실행됩니다.

어떤 아키텍처와 배포판을 지원하나요?

x86_64 및 arm64 Linux. CLI는 mihomo 코어를 설정해 주는 단일 Go 바이너리이므로, 최신 커널을 사용하는 최신 배포판이라면 작동해야 합니다. 주로 Ubuntu와 Debian에서 테스트합니다.

Linux CLI는 데스크톱 앱과 동일한 프로토콜을 사용하나요?

예. anytls, hysteria2 및 trojan은 모두 Windows 및 Mac 앱에서 사용하는 것과 동일한 mihomo 코어를 기반으로 CLI에서 작동합니다.

CLI를 어떻게 제거하나요?

설치 스크립트를 사용했다면 /usr/local/bin(또는 ~/.local/bin)에서 freeguard 바이너리를 제거하고 ~/.freeguard를 삭제하세요. Homebrew를 사용했다면 brew uninstall freeguardvpn을 실행하세요. 자동 시작을 활성화했다면 먼저 freeguard autostart disable을 실행하세요.