Keaのソースを表示

{{Lowercase title}}
[[Category:DHCP]]
[[en:Kea]]
{{Related articles start}}
{{Related|ネットワーク設定}}
{{Related|ネットワークツール}}
{{Related|dhcpcd}}
{{Related articles end}}

[https://www.isc.org/kea/ Kea] は、[https://www.isc.org/ Internet Systems Consortium (ISC)] によって開発されている最先端のDHCPサーバーです。
古い [https://www.isc.org/dhcp/ dhcpd] は [https://www.isc.org/blogs/isc-dhcp-eol/ サポートが終了しました]

== インストール ==

{{pkg|kea}} パッケージを[[インストール]]してください。
追加のドキュメントについては、{{pkg|kea-docs}}を[[インストール]]してください。
任意の依存パッケージは:
* {{pkg|krb5}} [[Kerberos]] のサポート
* {{pkg|mariadb}} データベースのバックエンド
* {{pkg|postgresql}} データベースのバックエンド
* [https://kea.readthedocs.io/en/latest/arm/shell.html Kea Shell] を使用するための {{pkg|python}}

== 設定 ==

設定ファイルは {{ic|/etc/kea}} にあります。 設定ファイルの記述には JSON を用います。
次の例にまだ含まれていない特別な設定に関しては、[https://kea.readthedocs.io/ Kea documentation] を参照してください。 

=== IPv4 DHCP ===

IPv4 DHCP を使用するには、設定ファイル {{ic|/etc/kea/kea-dhcp4.conf}} を記述し、 {{ic|kea-dhcp4.service}} を[[有効化]]して[[起動]]してください。

{{Tip|通常、プライベートネットワークでは、特別に予約されている以下の3つのサブネットのどれかを使用します。インターネット上のホストと衝突することはありません: 

* {{ic|192.168/16}} (サブネット {{ic|192.168.0.0}}, ネットマスク {{ic|255.255.0.0}})
* {{ic|172.16/12}} (サブネット {{ic|172.16.0.0}}, ネットマスク {{ic|255.240.0.0}})
* {{ic|10/8}} (大規模ネットワーク用; サブネット {{ic|10.0.0.0}}, ネットマスク {{ic|255.0.0.0}})

[[RFC:1918|RFC 1918]] も参照してください。
}}
Kea がリッスンしているインターフェイスには必ず静的 IP アドレスを割り当ててください。

==== 単一サブネット設定の例 ====

この例の仮定:

* ネットワークは {{ic|192.168.0.0/24}}
* DNS サーバーの IP は {{ic|192.168.0.1/24}}
* ゲートウェイの IP は {{ic|192.168.0.254/24}}
* DHCP サーバーのネットワークインターフェース {{ic|eth0}} の静的 IP は {{ic|192.168.0.253/24}}
* Kea は {{ic|192.168.0.100/24}} から {{ic|192.168.0.199/24}} までの IP を提供する

最小限の設定ファイル {{ic|/etc/kea/kea-dhcp4.conf}} は以下のようになります:

{{hc|/etc/kea/kea-dhcp4.conf|
{
    "Dhcp4": {
        "interfaces-config": {
            "interfaces": [ "eth0/192.168.0.253" ],
            "dhcp-socket-type": "raw"
        },

        "subnet4": [
            {
                "id": 1,
                "subnet": "192.168.0.0/24",
                "pools": [ { "pool": "192.168.0.100 - 192.168.0.199" } ],
                "option-data": [
                    {
                        "name": "routers",
                        "data": "192.168.0.254"
                    },
                    {
                        "name": "domain-name-servers",
                        "data": "192.168.0.1"
                    }
                ]
            }
        ]
    }
}
}}

==== 複数サブネット設定の例 ====

例に関する前提条件:

* ネットワークは次の通りです:
** ネットワーク 1: {{ic|192.168.0.0/24}} (標準の物理ネットワーク)
** ネットワーク 2: {{ic|192.168.1.0/24}} (仮想 VLAN ネットワーク)
* DNS サーバーは次の通りです:
** ネットワーク 1: 自身の DNS サーバーが IP {{ic|192.168.0.1}} にあります
** ネットワーク 2: 上流の Google DNS {{ic|8.8.8.8}} と {{ic|8.8.4.4}} を使用
* ゲートウェイは次の通りです:
** ネットワーク 1: {{ic|192.168.0.254/24}}
** ネットワーク 2: {{ic|192.168.1.254/24}}
* DHCP サーバーの静的 IP アドレスは次の通りです:
** ネットワーク 1: ネットワークインターフェース {{ic|eth0}} は {{ic|192.168.0.253}}
** ネットワーク 2: ネットワークインターフェース {{ic|eth0.100}} は {{ic|192.168.1.253}}
* Kea は次の IP アドレスを提供します:
** ネットワーク 1: {{ic|192.168.0.100/24}} から {{ic|192.168.0.199/24}} まで
** ネットワーク 2: {{ic|192.168.1.2/24}} から {{ic|192.168.1.252/24}} まで
* 静的 IP がいくつか定義されています:
** ネットワーク 1: 特別な電話が静的リース {{ic|192.168.0.10}} と {{ic|192.168.0.11}} を持っています
* IP 予約に関する問題をトラブルシュートするために、IPv4 の最大のデバッグログを有効にしたい

より複雑な設定ファイル {{ic|/etc/kea/kea-dhcp4.conf}} は次のようになります:

{{hc|/etc/kea/kea-dhcp4.conf|
{
    "Dhcp4": {
        "interfaces-config": {
            "interfaces": [ "eth0/192.168.0.253", "eth0.100/192.168.1.253" ],
            "dhcp-socket-type": "raw"
        },
        "loggers": [
          {
            "name": "kea-dhcp4",
            "severity": "DEBUG",
            "debuglevel": 99,
            "output_options": [
              {
                "output": "stdout"
              }
            ]
          }
        ],
        "subnet4": [
            {
                "id": 1,
                "subnet": "192.168.0.0/24",
                "interface": "eth0",
                "pools": [ { "pool": "192.168.0.100 - 192.168.0.199" } ],
                "option-data": [
                    {
                        "name": "routers",
                        "data": "192.168.0.254"
                    },
                    {
                        "name": "domain-name-servers",
                        "data": "192.168.0.1"
                    }
                ],
                "reservations": [
                {
                    "hostname": "phone1",
                    "hw-address": "1a:1b:1c:1d:1e:1f",
                    "ip-address": "192.168.0.10"
                },
                {
                    "hostname": "phone2",
                    "client-id": "01:11:22:33:44:55:66",
                    "ip-address": "192.168.0.11"
                }
            ]
            },
            {
                "id": 2,
                "subnet": "192.168.1.0/24",
                "interface": "eth0.100",
                "pools": [ { "pool": "192.168.1.2 - 192.168.1.252" } ],
                "option-data": [
                    {
                        "name": "routers",
                        "data": "192.168.1.254"
                    },
                    {
                        "name": "domain-name-servers",
                        "data": "8.8.8.8, 8.8.4.4"
                    }
                ]
            }
        ]
    }
}
}}

== 使用方法 ==

Kea には4つの [[systemd]] ユニットファイルが含まれています。

{| class="wikitable"
! ユニットファイル
! マニュアルページ
! 説明
|-
| kea-dhcp4.service
| {{man|8|kea-dhcp4}}
| [[Wikipedia:Dynamic Host Configuration Protocol|DHCPv4]] デーモン
|-
| kea-dhcp6.service
| {{man|8|kea-dhcp6}}
| [[wikipedia:dhcpv6|DHCPv6]] デーモン
|-
| kea-dhcp-ddns.service
| {{man|8|kea-dhcp-ddns}}
| [[dns]] デーモンを更新します
|-
| kea-ctrl-agent.service
| {{man|8|keactrl}}
| Kea サーバーを管理するための [[Wikipedia:REST|REST]] インターフェースの公開
|}

DHCPv4 の設定ファイルにエラーがないか確認するには、次のコマンドを実行します:

 # kea-dhcp4 -t /etc/kea/kea-dhcp4.conf

問題がなければ、次に {{ic|kea-dhcp4.service}} を [[有効化/起動]] します。