Virtual Appliance を設定する

既存の仮想アプライアンスのキーをローテーションするには:

• 仮想アプライアンスを作成する: POST /accounts/{account_id}/magic/connectors に device.provision_license: true を付けます。応答に result.license_key が含まれます。
• ライセンスキーをローテーションする: PATCH /accounts/{account_id}/magic/connectors/{connector_id} に provision_license: true を付けます。以前のキーは直ちに取り消され、復元できません。
• 仮想アプライアンスを削除する: 同じ操作で、関連するライセンス済みデバイスも削除されます。

Terraform からも利用できます。

1. VMware イメージを入手する

https://assets.magic-wan-connector.cloudflare.com/stable/mconn.ova ↗ から Cloudflare One Virtual Appliance の OVA イメージをダウンロードします。仮想アプライアンスを登録するとき、ダッシュボードの Add an appliance > Virtual appliance ステップからもダウンロードできます。OVA イメージには、Cloudflare One Virtual Appliance 用の仮想マシン（VM）を適切な設定でインストール・構成するためのファイルが含まれます。詳細は VMware VM のドキュメント ↗ を参照してください。

このイメージは複数回デプロイでき、別の場所や同じ ESXi ホストに複数の Cloudflare One Virtual Appliance インスタンスを作れます。

作成したインスタンスごとにライセンスキーを 1 つ消費します。Connectors ページ からインスタンスごとにライセンスキーを生成します。たとえば Cloudflare One Virtual Appliance を 10 台デプロイする場合は、ライセンスキーを 10 個生成します。

2. VMware に Cloudflare One Virtual Appliance をデプロイする

次の手順は、十分なリソースのある VMware ESXi ハイパーバイザーがすでにインストールされている前提です。詳細は 前提条件 を参照してください。

1. VMware ESXi のセットアップ時に、Cloudflare One Virtual Appliance 用のポートグループを作成します。Networking > Port groups を開き、希望のネットワークトポロジ向けに vSwitch ポートグループや VLAN を用意します。たとえば、単純なデプロイでは次のようになります。
   • Cloudflare One Virtual Appliance が Internet にアクセスできる IP アドレス（静的または DHCP）を取得する WAN ポートグループ。
   • Cloudflare One Virtual Appliance がデフォルトルーター、場合によっては DHCP サーバーとして動く LAN ポートグループ。
   • Cloudflare One Virtual Appliance で使わない仮想インターフェイスを割り当てる null（未使用）ポートグループ。たとえば名前を Null port group、VLAN ID を 999 として作成できます。

2. ダウンロードした OVA イメージのファイルを展開します。例:

tar -xvf mconn.ova

ファイルを展開したフォルダーを控えておきます。VM 作成時にそのフォルダーを指定します。

3. Virtual Machines > Create/Register VM ウィザードを開き、Cloudflare One Virtual Appliance のデプロイを開始します。

4. Deploy a virtual machine from an OVF or OVA file > Next を選択します。

5. 仮想マシンにわかりやすい名前を付けます。

6. OVA イメージから展開したファイルをアップロードします。mconn.ovf、mconn.nvram、mconn.vmdk です。

7. OVA イメージから展開したファイルの保存先を選び、Next を選択します。

8. Networking mappings で、先に設定したポートグループに合わせてトポロジ用の割り当てを選びます。

   1. たとえば eno1 ポートを VM Network にマップして WAN を作り、eno2 を LAN0 にマップして LAN ポートにします。
   2. 使わないポートは null ポートグループに割り当てます。
   3. 構成を控えておきます。Cloudflare ダッシュボードでネットワークを設定するときに使います。

9. Disk provisioning で Thin を選びます。

10. デプロイウィザードを完了する前に、Power on automatically を無効にします。起動前にライセンスキーを設定するために重要です。

11. 生成したライセンスキーで仮想マシンを設定します。

    1. Cloudflare One Virtual Appliance の VM を選び、Settings を選択します。
    2. VM Options > Advanced > Edit Configuration を開きます。
    3. Add parameter を選び、ライセンスキーを追加します。最後のエントリまでスクロールします（VMware はここに新しいパラメーターを追加します）。次の 2 つのエントリを追加します。
       • Key: guestinfo.cloudflare.identity
       • Value <YOUR_LICENSE_KEY>

12. Save を選び、Cloudflare One Virtual Appliance の設定を完了します。
13. Cloudflare ダッシュボード でセットアップを続けます。

1. Cloudflare One Virtual Appliance スクリプトを入手する

Proxmox 用の Cloudflare One Virtual Appliance ヘルパースクリプトを Proxmox サーバーへダウンロードします。スクリプトは、Cloudflare One Virtual Appliance 向けの適切な設定で Proxmox 仮想マシンをセットアップします。システム要件の詳細は 前提条件 を参照してください。

スクリプトは複数回デプロイでき、別の場所や同じ Proxmox ホストに複数の Cloudflare One Virtual Appliance インスタンスを作れます。作成したインスタンスごとにライセンスキーを 1 つ消費します。Connectors ページ からインスタンスごとにライセンスキーを生成します。たとえば Cloudflare One Virtual Appliance を 10 台デプロイする場合は、ライセンスキーを 10 個生成します。

curl -OL https://assets.magic-wan-connector.cloudflare.com/stable/proxmox_mconn_vm.sh

2. Proxmox に Cloudflare One Virtual Appliance をデプロイする

次の手順は、十分なリソースのある Proxmox Virtual Environment がすでにインストールされている前提です。詳細は 前提条件 を参照してください。

1. Proxmox サーバーのターミナルで、昇格した権限でスクリプトを実行します。

bash ./proxmox_mconn_vm.sh

2. 新しい Cloudflare One Virtual Appliance を作成するか尋ねられます。進める場合は yes を選びます。
3. ライセンスキーを入力します。

スクリプトはデフォルト設定を適用し、Cloudflare One Virtual Appliance 用に仮想マシンを構成します。スクリプトが終わったら、環境に合わせて VM を調整します。新しい VM はすべてのネットワークインターフェイスカード（NIC）が同じブリッジ上にあり、最初の NIC だけがアクティブなリンクを持ちます。

4. 新しい VM の Hardware settings で、Cloudflare One Virtual Appliance に使う NIC を選びます。
5. ホストマシンの物理 NIC に対応するネットワークブリッジを選びます。このブリッジにより、仮想マシンのネットワークアダプターはホストの NIC 経由で通信し、物理ネットワークに直接つながっているように見えます。
6. （任意）必要に応じて VLAN 設定をします。

7. ハードウェア設定が Cloudflare One Virtual Appliance 実行の最小要件を満たしていることを確認します。必要なら RAM と CPU を変更します。
8. Cloudflare ダッシュボード でセットアップを続けます。

1. Cloudflare One Virtual Appliance スクリプトを入手する

libvirt/KVM 用の Cloudflare One Virtual Appliance ヘルパースクリプトをホストへダウンロードします。スクリプトは、Cloudflare One Virtual Appliance 向けの適切な設定で仮想マシンをデプロイします。システム要件の詳細は 前提条件 を参照してください。

デプロイは libvirt の利用を前提とします。仮想マシンマネージャーのグラフィカルインターフェイスは必須ではありません。VM は Debian または Ubuntu の ovmf パッケージにある OVMF_CODE.fd ファイルを使います。

スクリプトは複数回デプロイでき、別の場所や同じホストに複数の Cloudflare One Virtual Appliance インスタンスを作れます。作成したインスタンスごとにライセンスキーを 1 つ消費します。Connectors ページ からインスタンスごとにライセンスキーを生成します。たとえば Cloudflare One Virtual Appliance を 10 台デプロイする場合は、ライセンスキーを 10 個生成します。

curl -OL https://assets.magic-wan-connector.cloudflare.com/stable/libvirt_mconn_vm.sh

2. libvirt/KVM に Cloudflare One Virtual Appliance をデプロイする

次の手順は、十分なリソースのある libvirt がすでにインストールされている前提です。詳細は 前提条件 を参照してください。

1. ホストのターミナルで、昇格した権限でスクリプトを実行します。スクリプトは任意引数を 1 つ取り、VM の名前です。名前を指定しない場合、VM のデフォルトは vmconn です。

sudo bash ./libvirt_mconn_vm.sh

2. 求められたら VM の名前を入力します。この名前は VM 定義、ディスク名、nvram ファイル名に使われます。同じ名前がすでに存在する場合、スクリプトはエラーで終了するので、別の名前を使ってください。
3. VM ディスク用のストレージプールを選びます。
4. シリアルコンソールに加えてグラフィックスコンソールを有効にするか選びます。
5. ライセンスキーを入力します。

スクリプトは適切な設定で仮想マシンをデプロイします。NIC の名前は、各 NIC の定義済み PCI パスに基づきます。NIC の PCI パスを変えると機能が壊れます。NIC は default ネットワークソースで非アクティブ状態として設定されます。

6. 環境に合わせて NIC を設定します。WAN に関連付ける NIC は、接続の問題を避けるため macvtap デバイスとして設定します。
7. Cloudflare ダッシュボード でセットアップを続けます。

アカウントに anycast IP が複数設定されている場合（Cloudflare WAN（旧 Magic WAN）のオンボーディング時に設定）、Cloudflare One Virtual Appliance は WAN ポートあたり最大 2 本のトンネルを自動で作成します。信頼性とパフォーマンスが上がり、追加の設定は不要です。

1. WAN configuration で Create を選択します。広域ネットワーク（WAN） ↗ を 1 つ以上作成できます。複数の WAN を設定すると、複数の IPsec トンネル（WAN ポートあたり 1 本）が作成されます。Cloudflare One Virtual Appliance は同じ優先度の WAN 間でトラフィックを負荷分散できます。回路の 健全性 に応じたフェイルオーバーもできます。詳細は WAN 設定 を参照してください。
2. Interface name に WAN のわかりやすい名前を入力します。
3. Interface number は、VMware でセットアップした Virtual Appliance インスタンスの仮想ネットワークインターフェイスに対応させる必要があります。前の手順の例では、VMware で設定した eno1 ポートに対応するポート 1 を選びます。
4. VLAN ID に 0 から 4094 の数値を入力し、VLAN ID を指定します。
5. Priority で WAN の優先度を選びます。数値が小さいほど優先度が高くなります。Cloudflare の優先度計算は トラフィックステアリング を参照してください。
6. Health check rate でサイトのヘルスチェック頻度を設定します。選択肢は low、mid、high です。詳細は トンネルヘルスチェックの頻度を更新する を参照してください。
7. Addressing: DHCP を選びます。Cloudflare One Virtual Appliance の初回セットアップで、設定をマシンへダウンロードしてアクティベートするために必要です。ネットワーク環境で静的 IP アドレスが必要な場合は次のとおりです。
   1. セットアップの流れを続け、Cloudflare One Virtual Appliance をアクティベートします。
   2. 静的 IP アドレスの WAN を参照してください。静的 IP を選ぶ場合は、静的 IP とゲートウェイアドレスも指定します。
8. 完了したら Save を選択します。

API で POST リクエストを送り、WAN を作成します。

static_addressing オブジェクトは任意です。DHCP を使う場合は省略します。静的アドレッシングを使う場合、サイトが高可用性（HA）モードなら secondary_address パラメーターも追加します。

例:

curl https://api.cloudflare.com/client/v4/accounts/{account_id}/magic/sites/{site_id}/wans \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>" \
--header "Content-Type: application/json" \
--data '{
	"name": "<YOUR_WAN_NAME>",
	"physport": 1,
	"priority": 0,
	"vlan_tag": 0
}'

1. LAN configuration で Create を選択します。
2. Interface name に LAN のわかりやすい名前を入力します。
3. Interface number は、VMware でセットアップした Virtual Appliance インスタンスの仮想 LAN インターフェイスに対応させる必要があります。前の手順の例では、VMware で設定した eno2 ポートに対応するポート 2 を選びます。
4. VLAN ID で VLAN ID を指定し、仮想 LAN を作成します。
5. Static addressing > Static address で、Cloudflare One Virtual Appliance の LAN インターフェイスに IP アドレスを付けます。用途に合う場合は、次のオプションも有効にできます。
   • This is a DHCP server: Cloudflare One Virtual Appliance が DHCP サーバー の場合。
   • This is a DHCP relay: Cloudflare One Virtual Appliance が DHCP リレー の場合。
6. （任意）Directly attached subnet > Static NAT prefix に CIDR プレフィックスを入力し、NAT（ネットワークアドレス変換）を有効にします。ここに入力するプレフィックスは、Static addressing に入力したプレフィックスと同じサイズにしてください。たとえば、両方のネットワークのサブネットマスクが /24 で、192.168.100.0/24 と 10.10.100.0/24 です。
7. （任意）LAN にレイヤー 3 ルーター背後の追加サブネットがある場合は、Routed subnets の Add routed subnet を選び、追加します。
   • Prefix: L3 ルーター背後のサブネットの CIDR プレフィックスです。
   • Next hop: このサブネット向けのパケットを Cloudflare One Virtual Appliance が転送する L3 ルーターのアドレスです。
   • Static NAT prefix: 任意設定です。ルーテッドサブネットで NAT を有効にする場合、NAT のオーバーレイ側が使う「外部」プレフィックスを指定します。Prefix と同じサイズである必要があります。
     詳細は ルーテッドサブネット を参照してください。
8. Save を選択します。
9. Done を選び、設定を完了します。Cloudflare One Virtual Appliance が起動すると、トンネルと 静的ルート が自動で作成されます。

API で POST リクエストを送り、LAN を作成します。

例:

curl https://api.cloudflare.com/client/v4/accounts/{account_id}/magic/sites/{site_id}/lans \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>" \
--header "Content-Type: application/json" \
--data '{
	"name": "<YOUR_LAN_NAME>",
	"physport": 2,
	"static_addressing": {
		"address": "172.16.14.0/24"
	},
	"vlan_tag": 0
}'