LinuxでVPNを設定して使う方法（CLI・ヘッドレス環境）

Windscribeでは、Linux向けにグラフィカルアプリとコマンドラインアプリの2種類を提供しています。グラフィカルアプリにはデスクトップ環境が必要なため、ヘッドレス環境やターミナルのみのマシンでは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プランの月間上限を把握するのに便利です。覚えておくとよい表示が2つあります。Connectedの前にアスタリスクが付いている場合はトンネルのテストがまだ実行中であることを、ネットワーク干渉に関する注意が表示された場合はテストが調査すべき何かを検出したことを意味します。

ヘッドレスマシンで独立して確認するには、パブリックIPアドレスが変わったことをチェックします。接続の前後にIP確認サービスへ問い合わせれば、ブラウザなしで確認できます：

curl ifconfig.me

接続中に返されたアドレスが、実際の所在地ではなく選んだロケーションを示していれば、通信はトンネル経由で送出されています。私たちの言葉を鵜呑みにせず、ぜひご自身で確認してください。

DNSについても考えておく価値があります。デフォルトでは、接続中のDNSは当社のサーバー経由でルーティングされ、これによりR.O.B.E.R.T.のフィルタリングが適用されます。設定ファイルでカスタムDNSサーバーを指定している場合は、プロバイダーのDNSではなくそのサーバーがクエリを解決していることを確認してください。

ロケーションを変更する

windscribe-cli connectを単独で実行すると、最後に使用したロケーションに再接続するか、自動でロケーションが選ばれます。接続できるロケーションの一覧をすべて表示するには：

windscribe-cli locations

ロケーションはRegion - City - Nicknameの形式で表示されます。都市名、ニックネーム、地域名、または2文字の国コードのいずれでも接続できます。照合では大文字と小文字は区別されません。

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からは管理できません。代わりにMy Accountから設定します。カスタムルールの数はプランによって異なります：

• 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

よくある質問