タイプ: proxy

注釈

proxyデバイスタイプはコンテナ（NAT と非 NAT モード）と VM（NAT モードのみ）でサポートされます。 コンテナと VM の両方でホットプラグをサポートします。

プロキシデバイスにより、ホストとインスタンス間のネットワーク接続を転送できます。 この方法で、ホストのアドレスの一つに到達したトラフィックをインスタンス内のアドレスに転送したり、その逆でインスタンス内にアドレスを持ちホストを通して接続することができます。

NATモードでは、プロキシデバイスを TCP と UDP のプロキシに使用することができます。 NAT モードではない場合、Unix ソケット間のトラフィックをプロキシすることもできます（これはたとえば、コンテナからホストシステムへのグラフィカルな GUI やオーディオトラフィックを転送するのに便利です）。また、プロトコル間でもプロキシすることができます（たとえば、ホストシステム上に TCP リスナーを設置し、そのトラフィックをコンテナ内の Unix ソケットに転送することができます）。

利用できる接続タイプは次の通りです:

• tcp <-> tcp

• udp <-> udp

• unix <-> unix

• tcp <-> unix

• unix <-> tcp

• udp <-> tcp

• tcp <-> udp

• udp <-> unix

• unix <-> udp

proxyデバイスを追加するには、以下のコマンドを使用します:

incus config device add <instance_name> <device_name> proxy listen=<type>:<addr>:<port>[-<port>][,<port>] connect=<type>:<addr>:<port> bind=<host/instance_name>

NATモード

プロキシデバイスは NAT モード（nat=true）もサポートします。NAT モードではパケットは別の接続を通してプロキシされるのではなく NAT を使ってフォワードされます。 これはターゲットの送り先が HAProxy の PROXY プロトコル（非 NAT モードでプロキシデバイスを使う場合はこれはクライアントアドレスを渡す唯一の方法です）をサポートする必要なく、クライアントのアドレスを維持できるという利点があります。

しかし、NAT モードはインスタンスが稼働しているホストがゲートウェイの場合（たとえば incusbr0を使用しているケース）のみサポートされます。

NAT モードでサポートされる接続のタイプは以下の通りです:

• tcp <-> tcp

• udp <-> udp

プロキシデバイスをnat=trueに設定する際は、以下のようにターゲットのインスタンスが NIC デバイス上に静的 IP を持つようにする必要があります。

IPアドレスを指定する

インスタンス NIC に静的 IP を設定するには、以下のコマンドを使用します:

incus config device set <instance_name> <nic_name> ipv4.address=<ipv4_address> ipv6.address=<ipv6_address>

静的な IPv6 アドレスを設定するためには、親のマネージドネットワークはipv6.dhcp.statefulを有効にする必要があります。

IPv6 アドレスを設定する場合は以下のような角括弧の記法を使います。たとえば以下のようにします:

connect=tcp:[2001:db8::1]:80

connect のアドレスをワイルドカード（IPv4 では 0.0.0.0、IPv6 では[::]にします）に設定することで、接続アドレスをインスタンスの IP アドレスになるように指定できます。

注釈

listen のアドレスも非 NAT モードではワイルドカードのアドレスが使用できます。 しかし、NAT モードを使う際は Incus ホスト上の IP アドレスを指定する必要があります。

デバイスオプション

proxy デバイスには以下のデバイスオプションがあります:

キー	型	デフォルト値	必須	説明
bind	string	host	no	どちら側にバインドするか（host/instance）
connect	string	-	yes	接続するアドレスとポート（<type>:<addr>:<port>[-<port>][,<port>]）
gid	int	0	no	listenするUnixソケットの所有者のGID
listen	string	-	yes	バインドし、接続を待ち受けるアドレスとポート（<type>:<addr>:<port>[-<port>][,<port>]）
mode	int	0644	no	listenするUnixソケットのモード
nat	bool	false	no	NAT経由でプロキシを最適化するかどうか（インスタンスのNICが静的IPを持つ必要あり）
proxy_protocol	bool	false	no	送信者情報を送信するのに HAProxy の PROXY プロトコルを使用するかどうか
security.gid	int	0	no	特権を落とすGID
security.uid	int	0	no	特権を落とすUID
uid	int	0	no	listenするUnixソケットの所有者のUID