Servidor Kea DHCP

host reservations

sudo apt update && sudo apt upgrade -y
sudo apt install kea
root@server:/etc/kea# ls -l
total 68
-rw-r----- 1 root _kea     8 Jun 25 18:15 kea-api-password
-rw-r--r-- 1 root root  5697 Mar 25 10:23 kea-ctrl-agent.conf
-rw-r--r-- 1 root root  3025 Mar 25 10:23 kea-dhcp-ddns.conf
-rw-r--r-- 1 root root 23850 Mar 25 10:23 kea-dhcp4.conf
-rw-r--r-- 1 root root 21099 Mar 25 10:23 kea-dhcp6.conf
drwxr-xr-x 2 root root  4096 Jun 25 18:15 radius
root@server:/etc/kea# 
sudo dpkg-reconfigure kea-ctrl-agent
sudo nano /etc/kea/kea-api-password
sudo ufw allow bootps
{
"Dhcp4": {
    "interfaces-config": {
        "interfaces": [ ]
    },
    "control-socket": {
        "socket-type": "unix",
        "socket-name": "kea4-ctrl-socket"
    },
    "lease-database": {
        "type": "memfile",
        "lfc-interval": 3600
    },
    "expired-leases-processing": {
        "reclaim-timer-wait-time": 10,
        "flush-reclaimed-timer-wait-time": 25,
        "hold-reclaimed-time": 3600,
        "max-reclaim-leases": 100,
        "max-reclaim-time": 250,
        "unwarned-reclaim-cycles": 5
    },
    "renew-timer": 900,
    "rebind-timer": 1800,
    "valid-lifetime": 3600,
    "option-data": [
        {
            "name": "domain-name-servers",
            "data": "192.0.2.1, 192.0.2.2"
        },
        {
            "code": 15,
            "data": "example.org"
        },
        {
            "name": "domain-search",
            "data": "mydomain.example.com, example.com"
        },
        {
            "name": "boot-file-name",
            "data": "EST5EDT4\\,M3.2.0/02:00\\,M11.1.0/02:00"
        },
        {
            "name": "default-ip-ttl",
            "data": "0xf0"
        }
    ],
    "client-classes": [
        {
            "name": "voip",
            "test": "substring(option[60].hex,0,6) == 'Aastra'",
            "next-server": "192.0.2.254",
            "server-hostname": "hal9000",
            "boot-file-name": "/dev/null"
        }
    ],
    "subnet4": [
        {
            "id": 1,
            "subnet": "192.0.2.0/24",
            "pools": [ { "pool": "192.0.2.1 - 192.0.2.200" } ],
            "option-data": [
                {
                    "name": "routers",
                    "data": "192.0.2.1"
                }
            ],
            "reservations": [
                {
                    "hw-address": "1a:1b:1c:1d:1e:1f",
                    "ip-address": "192.0.2.201"
                },
                {
                    "client-id": "01:11:22:33:44:55:66",
                    "ip-address": "192.0.2.202",
                    "hostname": "special-snowflake"
                },
                {
                    "duid": "01:02:03:04:05",
                    "ip-address": "192.0.2.203",
                    "option-data": [ {
                        "name": "domain-name-servers",
                        "data": "10.1.1.202, 10.1.1.203"
                    } ]
                },
                {
                    "client-id": "01:12:23:34:45:56:67",
                    "ip-address": "192.0.2.204",
                    "option-data": [
                        {
                            "name": "vivso-suboptions",
                            "data": "4491"
                        },
                        {
                            "name": "tftp-servers",
                            "space": "vendor-4491",
                            "data": "10.1.1.202, 10.1.1.203"
                        }
                    ]
                },
                {
                    "client-id": "01:0a:0b:0c:0d:0e:0f",
                    "ip-address": "192.0.2.205",
                    "next-server": "192.0.2.1",
                    "server-hostname": "hal9000",
                    "boot-file-name": "/dev/null"
                },
                {
                    "flex-id": "'s0mEVaLue'",
                    "ip-address": "192.0.2.206"
                }
            ]
        }
    ],
    "loggers": [
    {
        "name": "kea-dhcp4",
        "output-options": [
            {
                "output": "stdout",
                "pattern": "%-5p %m\n",
            }
        ],
        "severity": "INFO",
        "debuglevel": 0
    }
  ]
}
}
{
    "Dhcp4": {
        "interfaces-config": {
            "interfaces": ["eth0"]
        },
        "control-socket": {
            "socket-type": "unix",
            "socket-name": "/run/kea/kea4-ctrl-socket"
        },
        "lease-database": {
            "type": "memfile",
            "lfc-interval": 3600
        },
        "valid-lifetime": 600,
        "max-valid-lifetime": 7200,
        "subnet4": [{
            "id": 1,
            "subnet": "192.168.1.0/24",
            "pools": [{
                "pool": "192.168.1.150 - 192.168.1.200"
            }],
            "option-data": [
                {
                    "name": "routers",
                    "data": "192.168.1.254"
                },
                {
                    "name": "domain-name-servers",
                    "data": "192.168.1.1, 192.168.1.2"
                },
                {
                    "name": "domain-name",
                    "data": "exemple.local"
                }
            ]
        }]
    }
}
{
"Dhcp4": {
    "interfaces-config": {
        # especifica les interfícies de xarxa d'escolta
        "interfaces": [ "enp0s3" ]
    },
    # configuració per a lloguers caducats (els següents són els valors per defecte)
    "expired-leases-processing": {
        "reclaim-timer-wait-time": 10,
        "flush-reclaimed-timer-wait-time": 25,
        "hold-reclaimed-time": 3600,
        "max-reclaim-leases": 100,
        "max-reclaim-time": 250,
        "unwarned-reclaim-cycles": 5
    },
    # Temporitzador T1 que controla quan el client comença els processos de renovació (segons)
    "renew-timer": 900,
    # Temporitzador T2 que controla quan el client inicia els processos de reenllaç (segons)
    "rebind-timer": 1800,
    # quant de temps són vàlides les adreces (lloguers) proporcionades pel servidor (segons)
    "valid-lifetime": 3600,
    "option-data": [
        {
            # especifica el teu servidor DNS 
            # per especificar diverses entrades, separa-les amb comes
            "name": "domain-name-servers",
            "data": "10.0.2.10"
        },
        {
            # especifica el teu nom de domini
            "name": "domain-name",
            "data": "thos.local"
        },
        {
            # especifica la teve base de cerca de domini
            # per especificar diverses entrades, separa-les amb comes
            "name": "domain-search",
            "data": "thos.local"
        }
    ],
    "subnet4": [
        {
            "id": 1,
            # especifica la subxarxa on s'utilitza el DHCP
            "subnet": "10.0.2.0/24",
            # especifica el rang d'adreces IP que es llogaran
            "pools": [ { "pool": "10.0.2.100 - 10.0.2.200" } ],
            "option-data": [
                {
                    # especifica la porta d'enllaç
                    "name": "routers",
                    "data": "10.0.2.1"
                }
            ]
        }
    ],
    # configuració de registre
    "loggers": [
    {
        "name": "kea-dhcp4",
        "output_options": [
            {
                "output": "/var/log/kea/kea-dhcp4.log"
            }
        ],
        "severity": "INFO",
        "debuglevel": 0
    }
  ]
}
}
"interfaces-config": {
    "interfaces": ["enp0s3"]
}
"interfaces": ["*"]
"lease-database": {
    "type": "memfile",
    "lfc-interval": 3600
}
"lease-database": {
    "type": "mysql",
    "host": "localhost",
    "name": "kea",
    "user": "kea",
    "password": "contrasenya_segura"
}
"valid-lifetime": 600,
"max-valid-lifetime": 7200
"subnet4": [{
    "id": 1,
    "subnet": "10.0.2.0/24",
    "pools": [{
        "pool": "10.0.2.100 - 192.168.1.200"
    }]
}]
"option-data": [
    {
        "name": "routers",
        "data": "10.0.2.1"
    },
    {
        "name": "domain-name-servers",
        "data": "10.0.2.10, 10.0.2.11
    },
    {
        "name": "domain-name",
        "data": "thos.local"
    }
]
"reservations": [
    {
        "hw-address": "aa:bb:cc:dd:ee:ff",
        "ip-address": "10.0.2.150",
        "hostname": "impressora-oficina"
    }
]
sudo cat /var/lib/kea/kea-leases4.csv
address,hwaddr,client_id,valid_lifetime,expire,subnet_id,fqdn_fwd,fqdn_rev,hostname,state,user_context,pool_id
10.0.2.100,00:0c:29:e5:f5:43,01:00:0c:29:e5:f5:43,3600,1777029931,1,0,0,rx-0.thos.local.,0,,0
10.0.2.101,52:54:00:d1:7f:bd,ff:56:50:4d:98:00:02:00:00:ab:11:b3:df:a8:ce:66:2b:f0:1e,3600,1777030048,1,0,0,ubuntu,0,,0
sudo systemctl status kea-dhcp4-server
sudo systemctl status kea-dhcp6-server
sudo systemctl status kea-ctrl-agent
sudo systemctl status kea-dhcp-ddns-server
sudo systemctl restart kea-dhcp4-server
sudo systemctl stop kea-dhcp4-server
sudo systemctl start kea-dhcp4-server
sudo kea-shell --host 127.0.0.1 --port 8000 \
  --auth-user kea-api \
  --auth-password-file /etc/kea/kea-api-password \
  --service dhcp4 config-reload
[ { "arguments": { "hash": "F4BB02E0CC1B1F54004168FCF2DE952CF6E1F76D3B98D13167D3C0DC485F3257" }, "result": 0, "text": "Configuration successful." } ]
sudo journalctl -u kea-dhcp4-server
sudo journalctl -u kea-dhcp4-server -f   # en temps real
DHCP4_DYNAMIC_RECONFIGURATION_SUCCESS dynamic server reconfiguration
succeeded with file: /etc/kea/kea-dhcp4.conf
{
    "Dhcp6": {
        "interfaces-config": {
            "interfaces": ["eth0"]
        },
        "lease-database": {
            "type": "memfile",
            "lfc-interval": 3600
        },
        "preferred-lifetime": 3000,
        "valid-lifetime": 4000,
        "subnet6": [{
            "id": 1,
            "subnet": "2001:db8:1::/64",
            "pools": [{
                "pool": "2001:db8:1::1 - 2001:db8:1::ffff"
            }]
        }]
    }
}
sudo apt install curl apt-transport-https ca-certificates gnupg
sudo apt install postgresql postgresql-contrib
sudo systemctl enable --now postgresql
curl -1sLf 'https://dl.cloudsmith.io/public/isc/stork/setup.deb.sh' | sudo bash
Executing the  setup script for the 'isc/stork' repository ...

   OK: Checking for required executable 'curl' ...
   OK: Checking for required executable 'apt-get' ...
   OK: Detecting your OS distribution and release using system methods ...
 ^^^^: ... Detected/provided for your OS/distribution, version and architecture:
 >>>>:
 >>>>: ... distro=ubuntu  version=26.04  codename=resolute  arch=x86_64  
 >>>>:
   OK: Checking for apt dependency 'apt-transport-https' ...
   OK: Checking for apt dependency 'ca-certificates' ...
   OK: Checking for apt dependency 'gnupg' ...
   OK: Checking for apt signed-by key support ...
   OK: Importing 'isc/stork' repository GPG keys ...
   OK: Checking if upstream install config is OK ...
   OK: Installing 'isc/stork' repository via apt ...
   OK: Updating apt repository metadata cache ...
   OK: The repository has been installed successfully - You're ready to rock!
sudo apt install isc-stork-server
sudo -u postgres stork-tool db-create --db-name stork --db-user stork-server
INFO[2026-06-26 04:49:25]       connection.go:44    Checking connection to database              
INFO[2026-06-26 04:49:25]       connection.go:109   Connected to database /var/run/postgresql/.s.PGSQL.5432 
INFO[2026-06-26 04:49:25]       connection.go:44    Checking connection to database              
INFO[2026-06-26 04:49:25]       connection.go:109   Connected to database /var/run/postgresql/.s.PGSQL.5432 
INFO[2026-06-26 04:49:25]             main.go:100   Created database and user for the server with the following credentials  database_name="stork" password="yWRvhBrI7uyFV+diGQJD2w4nBoqXyvKc" user="stork-server"
sudo nano /etc/stork/server.env
STORK_DATABASE_NAME=stork
STORK_DATABASE_USER_NAME=stork-server
STORK_DATABASE_PASSWORD=yWRvhBrI7uyFV+diGQJD2w4nBoqXyvKc # canvia'l pel teu
sudo systemctl enable --now isc-stork-server
sudo systemctl status isc-stork-server
● isc-stork-server.service - ISC Stork Server
     Loaded: loaded (/usr/lib/systemd/system/isc-stork-server.service; enabled; preset: enabled)
     Active: active (running) since Fri 2026-06-26 04:57:43 UTC; 8s ago
 Invocation: 9bbc954afc7b443299c299a2155c1209
       Docs: man:stork-server(8)
   Main PID: 4842 (stork-server)
      Tasks: 7 (limit: 1718)
     Memory: 25.7M (peak: 25.7M)
        CPU: 169ms
     CGroup: /system.slice/isc-stork-server.service
             └─4842 /usr/bin/stork-server
http://<ip-del-servidor>:8080
sudo apt install isc-stork-agent
sudo su stork-agent -s /bin/sh -c 'stork-agent register \
   --server-url http://<IP_SERVIDOR>:<PORT_SERVIDOR> \
   --agent-host <IP_SERVIDOR> \
   --agent-port <PORT_AGENT> \
   --non-interactive'
sudo su stork-agent -s /bin/sh -c 'stork-agent register --server-url http://10.0.2.10:8080 --agent-host 10.0.2.10 --agent-port 8081 --non-interactive'
INFO[2026-06-28 12:59:10]     register.go:93    There are no agent certificates - they will be generated. 
INFO[2026-06-28 12:59:10]     register.go:450   ========================================================================= 
INFO[2026-06-28 12:59:10]     register.go:451   AGENT TOKEN: D1C2D0BEDCF542C63C8FA00E160B12AC5C3EA469B545020BBEAE9E240135 
INFO[2026-06-28 12:59:10]     register.go:452   ========================================================================= 
INFO[2026-06-28 12:59:10]     register.go:455   Authorize the machine in the Stork web UI    
INFO[2026-06-28 12:59:10]     register.go:468   Try to register agent in Stork Server        
INFO[2026-06-28 12:59:10]     register.go:274   Machine registered                           
INFO[2026-06-28 12:59:10]     register.go:346   Stored agent-signed cert and CA cert         
INFO[2026-06-28 12:59:10]         main.go:317   Registration completed successfully
sudo nano /etc/stork/agent.env
STORK_AGENT_PORT=8081
sudo systemctl enable --now isc-stork-agent
sudo apt update && sudo apt upgrade -y
sudo apt install curl apt-transport-https ca-certificates gnupg
curl -1sLf 'https://dl.cloudsmith.io/public/isc/stork/setup.deb.sh' | sudo bash
sudo apt install isc-stork-agent
sudo su stork-agent -s /bin/sh -c 'stork-agent register \
   --server-url http://<IP_SERVIDOR>:<PORT_SERVIDOR> \
   --agent-host <IP_MÀQUINA> \
   --agent-port <PORT_MÀQUINA> \
   --non-interactive'
sudo su stork-agent -s /bin/sh -c 'stork-agent register --server-url http://10.0.2.10:8080 --agent-host 10.0.2.11 --agent-port 8080 --non-interactive'
sudo systemctl enable --now isc-stork-agent

Característica	ISC DHCP (antic)	Kea (nou)
Estat	End of Life (2022)	Actiu i mantingut
Arquitectura	Monolítica	Modular (daemons separats)
Multifil (multithreaded)	No	Sí
API REST	No	Sí (JSON)
Backend de base de dades	Fitxer pla	Fitxer, MySQL, PostgreSQL
Interfície gràfica	No	Sí (Stork)
Alta disponibilitat (HA)	Limitada	Avançada

Nom de l’opció	Descripció
`routers`	Passarel·la predeterminada (gateway)
`domain-name-servers`	Servidors DNS
`domain-name`	Domini de cerca DNS
`broadcast-address`	Adreça de difusió
`ntp-servers`	Servidors de temps NTP
`domain-search`	Llista de dominis de cerca

Ruta	Descripció
`/etc/stork/server.env`	Configuració del servidor Stork
`/etc/stork/agent.env`	Configuració de l’agent Stork

Versió	Estat	Publicació	Fi de suport
3.2.0	Estable actual	Juny 2026	Juliol 2027
3.0.3	LTS (Long-Term Support)	Març 2026	Juny 2028
3.1.9	Desenvolupament	Maig 2026	—

Ruta	Descripció
`/etc/kea/kea-dhcp4.conf`	Configuració del servidor DHCPv4
`/etc/kea/kea-dhcp6.conf`	Configuració del servidor DHCPv6
`/etc/kea/kea-ctrl-agent.conf`	Configuració de l’agent de control REST
`/etc/kea/kea-dhcp-ddns.conf`	Configuració del servei DDNS
`/etc/kea/kea-api-password`	Contrasenya de l’API REST
`/var/lib/kea/`	Fitxers de lloguers (memfile)
`/run/kea/`	Sòcols de control Unix

1. Què és Kea?

1.1. Diferències respecte a ISC DHCP

2. Funcionalitats principals

2.1. Suport DHCPv4 i DHCPv6

2.2. Arquitectura modular

2.3. Alt rendiment i multifil

2.4. API REST potent

2.5. Backends de dades flexibles

2.6. Alta disponibilitat (HA)

2.7. Hooks modules (extensions)

2.8. Interfície gràfica: Stork

3. Instal·lació de Kea a Ubuntu Server 26.04

3.1. Prerequisits

3.2. Actualitza el sistema

3.3. Instal·lació del paquet

4. Configuració de kea-dhcp4

4.1. Estructura bàsica del fitxer de configuració

4.2. Explicació de les opcions principals

interfaces-config

lease-database

valid-lifetime i max-valid-lifetime

subnet4

option-data

5. Reserves d’amfitrions (host reservations)

6. Gestió del servei

6.1. Verifica l’estat dels serveis

6.2. Atura, inicia i reinicia

6.3. Recarrega la configuració sense reiniciar

6.4. Consulta els registres

7. Configuració de kea-dhcp6

8. Stork: tauler de control gràfic per a Kea

8.1. Arquitectura d’Stork

8.2. Instal·lació al servidor Ubuntu

Pas 1: Instal·lació de dependències

Pas 2: Instal·la PostgreSQL (prerequisit del servidor)

Pas 3: Afegeix el dipòsit d’Stork

Pas 4: Instal·la el servidor Stork

Pas 5: Crea la base de dades

Pas 6: Configura el servidor

Pas 7: Inicia el servei

Pas 8: Verifica l’estat del servei

8.3. Accedeix a la interfície web

8.4. Funcionalitats principals de la interfície

8.5. Instal·lació de l’agent Stork al mateix servidor

Pas 1. Instal·la l’agent

Pas 2. Registre

Pas 3. Autorització

Pas 4. Modifica el port de l’agent

Pas 5. Inicia l’agent

8.6. Instal·lació de l’agent Stork a una màquina que no és el servidor

Pas 1. Actualitza el sistema

Pas 2. Instal·la les dependències

Pas 3. Afegeix el dipòsit d’Stork

Pas 4. Instal·la l’agent

Pas 5. Registre

Pas 6. Autorització

Pas 7. Inicia l’agent

8.7. Configuració de l’agent

8.8. Fitxers d’Stork

9. Configuració del DNS dinàmic (DDNS)

10. Versions disponibles

11. Fitxers i directoris importants

12. Recursos addicionals

Versions d’aquest document

`interfaces-config`

`lease-database`

`valid-lifetime` i `max-valid-lifetime`

`subnet4`

`option-data`