Linux에서 VPN 설정하고 사용하는 방법 (CLI 및 헤드리스)

Windscribe는 Linux용 앱을 두 가지 제공해요. 그래픽 앱과 명령줄 앱이에요. 그래픽 앱은 데스크톱 환경이 필요하기 때문에 헤드리스 환경이나 터미널만 있는 머신에서는 Linux CLI 앱을 사용하세요. 이 가이드에서는 설치, 로그인, 연결 방법과 나머지 설정을 어디서 하는지 알려드릴게요.

Linux CLI 명령어는 windscribe-cli라는 이름(-cli 접미사)을 사용해요. 예를 들면 windscribe-cli login, windscribe-cli connect처럼요.

시작하기 전에

• Windscribe 계정. Windscribe 계정이 필요해요. Free 계정은 매월 2 GB의 데이터를 제공하고, 이메일 주소를 인증하면 매월 10 GB로 늘어나요. Free 계정은 무료 위치에 연결할 수 있어요. 유료 요금제인 Pro와 Build-a-Plan도 준비되어 있어요.
• 환경에 맞는 앱. Linux GUI 앱은 데스크톱 환경이 필요해서 터미널만 있는 헤드리스 환경에서는 실행되지 않아요. 서버와 헤드리스 머신에서는 Linux CLI 앱을 사용하세요.
• 지원되는 배포판. Windscribe는 여러 배포판용 Linux CLI 빌드를 제공해요. 다운로드 페이지에서 사용 중인 배포판과 아키텍처에 맞는 CLI 빌드를 내려받으세요.

다운로드 및 설치

GUI 앱과 CLI 앱 모두 Windscribe 다운로드 페이지에서 받을 수 있어요. Windscribe는 오픈 소스이며, 소스 코드와 릴리스 파일은 GitHub에 공개되어 있어요.

헤드리스 환경에서 사용하려면 배포판과 아키텍처에 맞는 Linux CLI 빌드를 내려받으세요.

Debian/Ubuntu

AMD64:

curl -L https://windscribe.com/install/desktop/linux_deb_x64_cli -o windscribe.deb
sudo apt install ./windscribe.deb

ARM64:

curl -L https://windscribe.com/install/desktop/linux_deb_arm64_cli -o windscribe.deb
sudo apt install ./windscribe.deb

기타 배포판

Fedora/CentOS, Arch, openSUSE용 Linux CLI 빌드는 다운로드 페이지에서 받을 수 있어요. 사용 중인 배포판용 빌드를 내려받은 뒤 해당 배포판의 패키지 관리자로 설치하세요.

로그인 및 연결

windscribe-cli 명령어는 일반 사용자 권한으로 실행하세요. sudo가 필요한 단계는 위의 패키지 설치뿐이에요.

Windscribe 계정으로 로그인하세요:

windscribe-cli login

VPN에 연결하세요:

windscribe-cli connect

연결 상태를 확인하세요:

windscribe-cli status

연결 확인하기

연결되고 나면 트래픽이 실제로 VPN을 통해 전달되고 있는지 확인해 보는 게 좋아요. 상태가 Connected로 표시되는 건 좋은 신호이지만, 그것만으로 증거가 되지는 않아요. 먼저 다음 명령어부터 실행해 보세요:

windscribe-cli status

status는 연결 상태와 도시뿐 아니라 프로토콜과 포트, 방화벽 상태, 데이터 사용량까지 알려줘요. 데이터 사용량은 Free 요금제의 월간 한도를 확인할 때 유용해요. 알아두면 좋은 표시가 두 가지 있어요. Connected 앞에 별표가 붙어 있으면 터널 테스트가 아직 진행 중이라는 뜻이고, 네트워크 간섭에 대한 안내가 나오면 테스트에서 살펴볼 만한 문제를 발견했다는 뜻이에요.

헤드리스 머신에서 별도로 확인하려면 공용 IP 주소가 바뀌었는지 보세요. 연결 전후에 조회 서비스에 요청을 보내면 브라우저 없이도 확인할 수 있어요:

curl ifconfig.me

연결된 상태에서 반환된 주소가 실제 위치가 아니라 선택한 위치를 가리킨다면 트래픽이 터널을 통해 나가고 있는 거예요. 저희 말을 그대로 믿기보다는 직접 확인해 보시는 편이 좋아요.

DNS도 한번 짚어볼 만해요. 기본적으로 연결된 동안에는 DNS가 저희 서버를 거치도록 되어 있고, 이를 통해 R.O.B.E.R.T. 필터링이 적용돼요. 설정 파일에서 사용자 지정 DNS 서버를 지정했다면, 통신사 DNS가 아니라 그 서버가 쿼리를 처리하고 있는지 확인하세요.

위치 변경하기

windscribe-cli connect만 단독으로 실행하면 마지막에 사용한 위치로 다시 연결되거나, 앱이 알아서 하나를 골라줘요. 연결할 수 있는 위치 전체 목록을 보려면:

windscribe-cli locations

위치는 Region - City - Nickname 형식으로 표시돼요. 도시 이름, 닉네임, 지역 이름, 두 자리 국가 코드 중 어느 것으로도 연결할 수 있어요. 대소문자는 구분하지 않아요.

windscribe-cli connect "Toronto"
windscribe-cli connect CA

지연 시간을 기준으로 앱이 서버를 골라주도록 하려면:

windscribe-cli connect best

고정한 IP를 포함해 즐겨찾기 위치를 보려면:

windscribe-cli locations fav

언제든 VPN 연결을 끊으려면:

windscribe-cli disconnect

프로토콜과 포트 변경하기

Linux CLI 앱은 WireGuard, UDP 및 TCP 모드의 OpenVPN, Stealth, WStunnel을 지원해요. IKEv2는 Windows와 macOS 앱에서는 쓸 수 있지만 Linux에서는 지원되지 않아요. Stealth와 WStunnel은 속도가 느린 편이라 주로 제한이 심한 네트워크에서 유용해요. 프로토콜을 바꾸려면 위치 뒤에 프로토콜 이름을 붙이세요:

windscribe-cli connect best wireguard
windscribe-cli connect "Toronto" stealth

프로토콜 이름은 대소문자를 구분하지 않아요. 특정 포트로 연결하려면 프로토콜 뒤에 콜론을 붙이고 포트를 적으세요:

windscribe-cli connect best udp:443

특정 프로토콜에서 사용할 수 있는 포트를 확인하려면:

windscribe-cli ports wireguard

사용할 수 없는 포트를 입력하면 앱은 해당 프로토콜의 기본 포트로 대신 연결해요.

방화벽 켜고 끄기

방화벽은 VPN 터널 밖으로 나가는 트래픽을 차단해서 연결이 끊겼을 때 정보 유출을 막아줘요. 켜거나 끄려면:

windscribe-cli firewall on
windscribe-cli firewall off

SSH로 관리하는 머신에서는 방화벽을 특히 조심하세요. 방화벽이 켜져 있는데 VPN이 연결되어 있지 않으면 다른 트래픽과 함께 SSH 세션까지 차단될 수 있어요. 로컬 네트워크로 접속한다면 아래의 AllowLANTraffic 옵션으로 로컬 트래픽을 허용할 수 있어요.

windscribe-cli logout으로 로그아웃하면 VPN 연결이 끊기고 방화벽도 꺼져요. 방화벽을 켜 둔 채로 로그아웃하려면:

windscribe-cli logout on

설정 파일에서 기능 구성하기

Linux CLI 앱은 다음 설정 파일에서 설정을 읽어와요:

~/.config/Windscribe/windscribe_cli.conf

이 파일의 값은 대소문자를 구분하며 허용된 값과 정확히 일치해야 해요. 값이 일치하지 않으면 앱은 기본값을 사용해요. 파일을 수정한 뒤에는 변경 사항을 적용하세요:

windscribe-cli preferences reload

LAN 트래픽 허용

VPN과 방화벽이 켜져 있는 동안에도 로컬 네트워크의 기기가 이 머신에 접근할 수 있게 해줘요. 같은 네트워크에서 헤드리스 머신에 SSH로 접속한다면 이 설정을 켜세요:

[Connection]
AllowLANTraffic=true

시작 시 자동 연결

Windscribe 서비스가 시작될 때 자동으로 VPN에 연결해요:

[Connection]
Autoconnect=true

사용자 지정 DNS

기본적으로 앱은 연결된 동안 Windscribe의 DNS를 사용하며, 이를 통해 R.O.B.E.R.T. 필터링이 적용돼요. 다른 DNS 서버를 쓰려면 모드를 Custom으로 바꾸고 업스트림을 지정하세요. 업스트림에는 일반 IP나 DNS-over-HTTPS/TLS URL을 넣을 수 있어요:

[Connection]
ConnectedDNSMode=Custom
ConnectedDNSUpstream1=1.1.1.1

스플릿 터널링

스플릿 터널링을 쓰면 특정 앱이나 네트워크 대역을 VPN 터널 안쪽 또는 바깥쪽으로 보낼 수 있어요. Exclude 모드는 목록에 적은 것만 빼고 나머지를 전부 VPN으로 보내요. Include 모드는 목록에 적은 것만 VPN으로 보내요:

[Connection]
SplitTunnelingEnabled=true
SplitTunnelingMode=Exclude
SplitTunnelingApps=/usr/bin/curl
SplitTunnelingRoutes=192.168.1.0/24

앱 항목은 실행 파일의 전체 경로이며 쉼표로 구분해요. 존재하지 않는 경로는 아무 알림 없이 건너뛰기 때문에, 앱이 예상대로 동작하지 않으면 경로를 다시 확인해 보세요.

프록시 게이트웨이

VPN 연결을 HTTP 또는 SOCKS 프록시 형태로 네트워크의 다른 기기와 공유할 수 있어요:

[Connection]
ShareProxyGatewayEnabled=true
ShareProxyGatewayMode=HTTP
ShareProxyGatewayPort=8888

ShareProxyGatewayMode를 HTTP 또는 SOCKS로 설정하고, 1024에서 65535 사이의 포트를 아무거나 고르세요.

사용할 수 있는 옵션 전체 목록은 Linux CLI 설정 파일 레퍼런스를 참고하세요.

유용한 기타 명령어

같은 서버에서 새 IP 주소를 받아요. 연결된 상태에서 일부 요금제에만 제공돼요:

windscribe-cli ip rotate

앱 업데이트를 확인하고 설치해요:

windscribe-cli update

디버그 로그를 Windscribe 지원팀에 보내요. 헤드리스 머신 문제를 해결할 때 유용해요:

windscribe-cli logs send

R.O.B.E.R.T.

R.O.B.E.R.T.는 Windscribe의 도메인 차단 기능이에요. 규칙은 CLI에서 관리하지 않고 내 계정 → 보안 → 사용자 지정 규칙에서 설정해요. 만들 수 있는 사용자 지정 규칙 개수는 요금제에 따라 달라요:

• Free: 사용자 지정 규칙 최대 3개
• Build-a-Plan: 사용자 지정 규칙 최대 10개
• Pro: 사용자 지정 규칙 최대 1000개

문제 해결

문제가 생기면 CLI가 터미널에 오류를 출력하고 종료 코드로 0 대신 1을 반환해요. 덕분에 스크립트에서 성공과 실패를 구분할 수 있어요. 비교적 자주 나오는 메시지 몇 가지를 소개할게요:

Aborting: app did not start in time

CLI가 통신 대상인 백그라운드 서비스를 시작하지 못했어요. 잠시 기다렸다가 명령어를 다시 실행해 보세요. 계속 같은 문제가 발생하면 windscribe-helper 서비스가 실행 중인지 확인하세요.

Aborting: IPC communication error

명령어를 실행하는 도중에 CLI와 백그라운드 서비스 사이의 연결이 끊겼어요. 대개 일시적인 문제라서 명령어를 다시 실행하면 돼요. VPN이 켜진 상태에서 방화벽이나 LAN 설정을 바꾼 직후에도 나타날 수 있으니, 잠시 기다렸다가 다시 시도해 보세요.

Firewall set to always on

방화벽이 Always On 모드라서 CLI에서는 끌 수 없어요. 이 모드는 데스크톱 앱에서 설정하므로, 꺼야 한다면 그쪽에서 변경해야 해요. 헤드리스 머신에서는 예전에 그래픽 앱이 있는 시스템에서 이 설정을 켜둔 경우가 아니라면 보기 힘든 메시지예요.

WireGuard adapter setup failed

보통 네트워크 어댑터 설정에 문제가 있다는 뜻이에요. 원인을 살펴보는 동안에는 UDP나 TCP 같은 다른 프로토콜로 바꾸면 연결되는 경우가 많아요:

windscribe-cli connect best udp

위 사례 중 어느 것에도 해당하지 않는다면, 지원팀이 살펴볼 수 있도록 디버그 로그를 보내주세요:

windscribe-cli logs send

도움 받기

CLI가 지원하는 명령어 전체 목록과 각 명령어의 간단한 설명을 보려면 다음을 실행하세요:

windscribe-cli --help

단계별 안내 문서와 자주 묻는 질문에 대한 답변은 지식 베이스에서 확인해 보세요: windscribe.com/knowledge-base.

제거하기

CLI 앱을 제거하려면 사용 중인 배포판의 패키지 관리자를 이용하세요. 패키지 이름은 windscribe-cli예요.

Debian/Ubuntu

패키지를 제거하세요:

sudo apt remove windscribe-cli

시스템 설정까지 함께 지우려면 purge를 대신 사용하세요:

sudo apt purge windscribe-cli

기타 배포판

Fedora/CentOS, Arch, openSUSE에서는 패키지 관리자로 windscribe-cli 패키지를 제거하세요. 예를 들면 dnf remove, pacman -R, zypper remove 같은 명령어예요.

개인 설정은 패키지 관리자가 건드리지 않는 별도의 설정 디렉터리에 저장돼요. 이 설정까지 지우려면 해당 디렉터리를 삭제하세요:

rm -r ~/.config/Windscribe

자주 묻는 질문