「Kea」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
タグ: 転送先変更
(同期)
 
(2人の利用者による、間の2版が非表示)
1行目: 1行目:
  +
{{Lowercase title}}
#REDIRECT [[ネットワーク設定#サーバ]]
 
  +
[[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}} を [[有効化/起動]] します。

2025年2月26日 (水) 07:13時点における最新版

関連記事

Kea は、Internet Systems Consortium (ISC) によって開発されている最先端のDHCPサーバーです。 古い dhcpdサポートが終了しました

インストール

kea パッケージをインストールしてください。 追加のドキュメントについては、kea-docsインストールしてください。 任意の依存パッケージは:

設定

設定ファイルは /etc/kea にあります。 設定ファイルの記述には JSON を用います。 次の例にまだ含まれていない特別な設定に関しては、Kea documentation を参照してください。

IPv4 DHCP

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

ヒント: 通常、プライベートネットワークでは、特別に予約されている以下の3つのサブネットのどれかを使用します。インターネット上のホストと衝突することはありません:
  • 192.168/16 (サブネット 192.168.0.0, ネットマスク 255.255.0.0)
  • 172.16/12 (サブネット 172.16.0.0, ネットマスク 255.240.0.0)
  • 10/8 (大規模ネットワーク用; サブネット 10.0.0.0, ネットマスク 255.0.0.0)

RFC 1918 も参照してください。

Kea がリッスンしているインターフェイスには必ず静的 IP アドレスを割り当ててください。

単一サブネット設定の例

この例の仮定:

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

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

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

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

/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 ユニットファイルが含まれています。

ユニットファイル マニュアルページ 説明
kea-dhcp4.service kea-dhcp4(8) DHCPv4 デーモン
kea-dhcp6.service kea-dhcp6(8) DHCPv6 デーモン
kea-dhcp-ddns.service kea-dhcp-ddns(8) dns デーモンを更新します
kea-ctrl-agent.service keactrl(8) Kea サーバーを管理するための REST インターフェースの公開

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

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

問題がなければ、次に kea-dhcp4.service有効化/起動 します。