Windscribeでは、Linux向けにグラフィカルアプリとコマンドラインアプリの2種類を提供しています。グラフィカルアプリにはデスクトップ環境が必要なため、ヘッドレス環境やターミナルのみのマシンではLinux CLIアプリをご利用ください。このガイドでは、インストール、ログイン、接続、そしてその他の設定を行う場所について説明します。
Linux CLIのコマンドはwindscribe-cliという名前(-cliサフィックス付き)を使用します。たとえばwindscribe-cli loginやwindscribe-cli connectのようになります。
GUIアプリとCLIアプリはどちらもWindscribeのダウンロードページから入手できます。Windscribeはオープンソースであり、ソースコードとリリース成果物はGitHubで公開されています。
ヘッドレス環境で使う場合は、お使いのディストリビューションとアーキテクチャに合ったLinux CLIビルドをダウンロードしてください。
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
VPNとファイアウォールが有効な間も、ローカルネットワーク上のデバイスからこのマシンにアクセスできるようにします。同じネットワークからヘッドレスマシンにSSH接続する場合は、この設定を有効にしてください:
[Connection] AllowLANTraffic=true
Windscribeサービスの起動時に、自動でVPNに接続します:
[Connection] Autoconnect=true
デフォルトでは、接続中のアプリは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.はWindscribeのドメインブロック機能です。ルールはCLIからは管理できません。代わりにMy Accountから設定します。カスタムルールの数はプランによって異なります:
問題が発生すると、CLIはエラーをターミナルに出力し、終了コードとして0ではなく1を返します。そのため、スクリプトから成功と失敗を判別できます。よく見られるメッセージをいくつか紹介します:
CLIが通信対象のバックグラウンドサービスを起動できませんでした。少し待ってから、もう一度コマンドを実行してください。それでも解決しない場合は、windscribe-helperサービスが実行中かどうかを確認してください。
コマンドの実行途中で、CLIとバックグラウンドサービスの接続が切断されました。多くの場合は一時的なものなので、コマンドを再実行してください。VPNが有効な状態でファイアウォールやLANの設定を変更した直後にも発生することがあるため、少し時間をおいてから再度お試しください。
ファイアウォールがAlways Onモードになっており、CLIからはオフにできません。このモードはデスクトップアプリで設定されるため、オフにする必要がある場合はそちらで変更してください。ヘッドレスマシンでは、以前にグラフィカルアプリのあるシステムでこの設定を有効にしていない限り、まず表示されません。
これは通常、ネットワークアダプターのセットアップに問題があることを示しています。原因を調べる間は、UDPやTCPなど別のプロトコルに切り替えると接続できることがよくあります:
windscribe-cli connect best udp
どれにも当てはまらない場合は、サポートチームが確認できるようにデバッグログを送信してください:
windscribe-cli logs send
CLIがサポートするコマンドの一覧と、それぞれの簡単な説明を表示するには、次を実行します:
windscribe-cli --help
手順を追った記事やよくある質問への回答をお探しなら、次はナレッジベースをご覧ください:windscribe.com/knowledge-base。
CLIアプリを削除する必要がある場合は、お使いのディストリビューションのパッケージマネージャーを使用してください。パッケージ名はwindscribe-cliです。
パッケージを削除します:
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
loginctl enable-linger <username>