Free VPN for Linux — FreeGuard CLI (no GUI client today)

Linux에서는 FreeGuard가 CLI 도구로만 제공됩니다. 현재 Linux GUI 클라이언트는 없습니다. 설치 스크립트, Homebrew를 통해 설치하거나 GitHub Releases에서 바이너리를 받을 수 있습니다. x86_64 및 arm64 배포판에서 작동합니다.

Linux 제공 현황: 현재는 CLI만 지원, GUI 없음

Linux용 제공물은 mihomo 코어를 기반으로 빌드된 Go 기반 명령줄 클라이언트입니다. 현재 Linux 데스크톱 GUI는 제공하지 않습니다. GUI가 필요하다면 Windows 또는 Mac 앱을 사용하세요.

FreeGuard의 Linux 클라이언트는 freeguard CLI이며, 주요 x86_64 및 arm64 Linux 배포판용 단일 바이너리로 배포됩니다. 로그인, 노드 선택, 연결, 라우팅 규칙, 자동 시작을 모두 터미널에서 처리합니다.

현재 Linux 데스크톱 GUI는 제공하지 않습니다. 데스크톱 UI가 필요하다면 FreeGuard Windows 또는 Mac 앱을 사용하세요.

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 항목은 없습니다.

Linux CLI에서 실제로 제공되는 기능

• 프로토콜: anytls, hysteria2, trojan — freeguard config를 통해 설정 가능
• 노드 선택: freeguard connect <alias>(예: freeguard connect la2, hk1) 또는 자동 “best node” 모드
• 라우팅 규칙: 사용자 지정 라우팅 규칙을 추가하고 목록화하는 freeguard rule 서브커맨드
• 자동 시작: freeguard autostart enable은 ~/.config/systemd/user/freeguard.service에 systemd user 서비스를 설치합니다(루트 데몬 불필요)
• 진단: freeguard doctor가 환경을 점검합니다
• 상태/모니터: 실시간 연결 정보를 위한 freeguard status 및 freeguard monitor

별도의 데스크톱 킬 스위치 토글과 앱별 분할 터널링은 CLI 명령으로 제공되지 않습니다.

시작하는 방법

1. 1단계: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh를 실행합니다
2. 2단계: freeguard init를 실행하고 무료 계정으로 로그인합니다
3. 3단계: freeguard connect를 실행합니다(또는 특정 노드에 대해 freeguard connect la2 등)

자주 묻는 질문

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

아니요. 현재 Linux용 제공물은 freeguard CLI뿐입니다. Linux에는 데스크톱 GUI가 없습니다. GUI가 필요하다면 Windows 또는 Mac 앱을 사용하세요.

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

공식 배포판 저장소에서는 불가능합니다. 설치 스크립트(install.sh), Homebrew를 사용하거나 GitHub Releases에서 바이너리를 다운로드하세요. 현재 apt, dnf, pacman 또는 AUR에는 제공하지 않습니다.

CLI는 헤드리스 서버와 Docker에서 작동하나요?

예. CLI는 GUI 의존성이 없는 단일 Go 바이너리입니다. 컨테이너가 TUN 장치를 생성하는 데 필요한 네트워크 권한을 갖추고 있다면, SSH 세션, 컨테이너 내부, 최소 베이스 이미지에서도 실행됩니다.

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

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

지원되는 아키텍처는 무엇인가요?

x86_64 및 arm64 Linux입니다. 두 아키텍처용 릴리스는 GitHub Releases에 게시되며 설치 스크립트를 통해 제공됩니다.

지원되는 Linux 배포판은 무엇인가요?

CLI가 단일의 자체 포함 바이너리로 제공되므로, 최근 커널이 있는 최신 Linux라면 모두 작동할 것으로 예상됩니다. 주로 Ubuntu와 Debian에서 테스트합니다.

Linux CLI는 데스크톱 앱과 같은 프로토콜을 지원하나요?

예. anytls, hysteria2, trojan 모두 CLI에서 지원되며, Windows 및 Mac 앱과 동일한 mihomo 코어를 사용합니다.

CLI를 어떻게 제거하나요?

설치 스크립트를 통해 설치한 경우 /usr/local/bin(또는 설치 접두사)에서 freeguard 바이너리를 제거하고 ~/.config/freeguard를 삭제하세요. Homebrew의 경우 brew uninstall freeguardvpn를 실행하세요. systemd user 서비스의 경우 먼저 freeguard autostart disable를 실행하세요.