# VilaNet CLI

VilaNet CLIは、Linux、macOS、Windows向けの公式コマンドラインクライアントです。ヘッドレスコンピューターやサーバーで使用する場合、またはグラフィカルアプリよりターミナルコマンドを使いたい場合に適しています。

通常のデスクトップ画面を使いたい場合は、代わりに[macOS版VilaNet](/ja/official-apps/macos/)、[Windows版](/ja/official-apps/windows/)、または[Linux版](/ja/official-apps/linux/)を使用してください。

> **詳しい技術資料が必要ですか？** プラットフォーム別のインストール、コマンドリファレンス、設定、トラブルシューティング、対話式サンプルについては、[詳細なVilaNet CLIガイド](https://cli.vilavpn.com/)を参照してください。このページは、多言語の安全な入門ガイドとして維持します。

## 始める前に

必要なもの：

- 有効なVilaVPNアカウント
- デバイス全体を対象とするTUN接続に必要な管理者権限
- お使いのOSとプロセッサに合ったパッケージ

現在確認済みのリリースは**1.2.9**です。[VilaNet CLI公式リリース](https://github.com/vilavpn/vilanet-cli/releases/tag/v1.2.9)からダウンロードしてください。

{% hint style="warning" %}
パスワードをコマンド、スクリーンショット、サポートメッセージに貼り付けないでください。`login`コマンドでは、シェル履歴に残らない方法でパスワードの入力を求められます。
{% endhint %}

## 1. 正しいパッケージを選ぶ

| システム | プロセッサ | パッケージ末尾 |
|---|---|---|
| Linux | Intel/AMD 64ビット | `linux_amd64.tar.gz` |
| Linux | ARM 64ビット | `linux_arm64.tar.gz` |
| Linux | ARMv7 | `linux_armv7.tar.gz` |
| macOS | Appleシリコン | `darwin_arm64.tar.gz` |
| macOS | Intel | `darwin_amd64.tar.gz` |
| Windows | Intel/AMD 64ビット | `windows_amd64.zip` |
| Windows | ARM 64ビット | `windows_arm64.zip` |

LinuxまたはmacOSで不明な場合は、`uname -m`を実行してください。`x86_64`はAMD64、`arm64`または`aarch64`はARM64を意味します。

## 2. インストールする

### Linux

ダウンロードしたアーカイブを展開し、バイナリをインストールします。

```bash
tar -xzf vilanet-cli_1.2.9_linux_amd64.tar.gz
sudo install -m 0755 vilanet-cli /usr/local/bin/
sudo setcap 'cap_net_admin,cap_net_bind_service+eip' /usr/local/bin/vilanet-cli
```

ダウンロードしたパッケージがARM64またはARMv7の場合は、`amd64`を`arm64`または`armv7`に置き換えてください。

### macOS

アーカイブを展開し、バイナリをインストールします。

```bash
tar -xzf vilanet-cli_1.2.9_darwin_arm64.tar.gz
sudo install -m 0755 vilanet-cli /usr/local/bin/
```

Intel Macでは`arm64`を`amd64`に置き換えてください。デバイス全体を対象とするTUNモードには`sudo`が必要ですが、ローカルのSOCKS専用接続には不要です。

### Windows

1. ZIPファイルを展開します。
2. Wintunは[Wintun公式サイト](https://www.wintun.net/)からのみダウンロードしてください。
3. プロセッサに合った`wintun.dll`を`vilanet-cli.exe`と同じフォルダーにコピーします。
4. PowerShellを管理者として開きます。
5. 展開したフォルダーに移動します。

最初のセットアップでは、VilaNetをフォアグラウンドで実行するのが簡単です。Windows Serviceのインストールは高度なオプションであり、初回接続には必要ありません。

## 3. インストールを確認する

LinuxまたはmacOSの場合：

```bash
vilanet-cli version
```

Windows PowerShellの場合：

```powershell
.\vilanet-cli.exe version
```

エラーではなくバージョンが表示されれば正常です。

## 4. ログインする

次を実行します。

```bash
vilanet-cli login --email you@example.com
```

プロンプトが表示されたらVilaVPNのパスワードを入力します。ログインに成功すると、暗号化された認証情報がこのデバイスに保存されます。通常の使用では`--insecure-store`を使用しないでください。

スクリーンショットには、実際のパスワードが入力されたパスワードプロンプトを掲載しません。

## 5. 利用可能なパッケージとサーバーを確認する

```bash
vilanet-cli list packages
vilanet-cli list servers
```

国を指定してサーバー一覧を絞り込むこともできます。例：

```bash
vilanet-cli list servers --country HK
```

利用できるサーバーは、有効なパッケージによって異なります。内部サーバー識別子を公開スクリーンショットに載せないでください。

## 6. 接続する

デバイス全体を接続するには、必要な権限を持つターミナルから次のコマンドを実行します。

```bash
vilanet-cli connect --country HK
```

macOSではTUN権限が必要な場合に`sudo`を追加してください。Windowsでは管理者権限で開いたPowerShellウィンドウから実行します。フォアグラウンドのコマンドは実行したままにし、停止するには`Ctrl+C`を押します。

LinuxまたはmacOSでTUNを使わず、ローカルSOCKS/HTTPプロキシを使用する場合：

```bash
vilanet-cli connect --no-tun --mixed 127.0.0.1:1080
```

## 7. VilaVPNが動作していることを確認する

Linux、macOS、Windowsでは、フォアグラウンドのターミナルを開いたままにして、接続プロセスが実行中であることを確認します。次にIP確認サイトを開き、公開IPが通常のISPのIPと異なることを確認してください。フォアグラウンドプロセスではCLI制御チャネルが公開されないため、この初回実行手順では`status --json`を確認コマンドとして使用できません。

対応するバックグラウンドデーモンを意図的に起動したLinuxおよびmacOSユーザーは、別のターミナルから`vilanet-cli status --json`を実行してデーモンを確認できます。Windows版1.2.9には、同等のバックグラウンドIPC制御プレーンはありません。

## 切断してログアウトする

LinuxまたはmacOSで、管理対象またはバックグラウンドの接続を停止するには次を実行します。

```bash
vilanet-cli disconnect
```

Windowsでは、フォアグラウンドのPowerShellウィンドウに戻り、`Ctrl+C`を押します。Windows版1.2.9では、`disconnect`、`status`、`switch`からこのフォアグラウンドプロセスを制御できません。

接続停止後に保存済みの認証情報を削除するには、次を実行します。

```bash
vilanet-cli logout
```

`logout`は、保存済みの認証情報とキャッシュされたアカウントデータを削除します。単に切断するだけなら、ログアウトする必要はありません。

## 問題が発生した場合

| 症状 | 対処方法 |
|---|---|
| `command not found` | バイナリが`PATH`に含まれるディレクトリにインストールされていることを確認するか、展開したフォルダーから実行します。 |
| 終了コード`2` | メールアドレスとパスワードを確認し、`login`をもう一度実行します。 |
| 終了コード`4` | 先にログインします。サービス側で繰り返しリクエストがレート制限された場合は、しばらく待ってから再試行します。 |
| 終了コード`5` | 必要な管理者権限で実行します。Linuxでは`setcap`の手順を繰り返します。 |
| WindowsでWintunエラーが表示される | 正しい公式`wintun.dll`が`vilanet-cli.exe`と同じフォルダーにあることを確認します。 |
| 接続済みだが通信できない | `vilanet-cli logs --follow`を実行してエラーを保存し、安全に切断してから、機密情報を除いた抜粋を添えてサポートに連絡します。 |

設定ディレクトリ全体を投稿しないでください。暗号化された認証情報、識別子、接続メタデータが含まれる場合があります。

## ガイドの確認状況

上記のコマンド、パッケージ、対応アーキテクチャはVilaNet CLI 1.2.9に対して確認済みです。このガイドには公式リリースページの実際のキャプチャを追加しました。各OSのクリーン環境での一連の動作確認は引き続き必要です。