# systemd-networkd (Español)

Related articles

- systemd
- systemd-nspawn
- Network bridge
- Network configuration
- Wireless network configuration
- Category:Network configuration

The translation of this article or section does not reflect the original text.

Reason: Incomplete translation (Discuss in Talk:Systemd-networkd (Español)#)

systemd-networkd es un demonio del sistema que maneja las configuraciones de red. Detecta y configura los dispositivos de red que aparecen; también puede crear dispositivos de red virtuales. Este servicio puede ser especialmente útil para establecer configuraciones complejas de red para un contenedor manejado por systemd-nspawn o por maquinas virtuales. Además trabaja bien en conecciones simples.

## Uso Básico

El paquete systemd es parte de la instalación de Arch por defecto y contiene todo los archivos necesarios para operar redes cableadas. Adaptadores inalámbricos pueden instalarse por otros servicios, como wpa_supplicant, los cuales serán vistos más adelante en ester articulo.

### Servicios Requeridos e Instalación

Para usar systemd-networkd, [iniciar[start]] los siguientes dos servicios y [habilitar[enable]] su ejecución al inicio del sistema:

- `systemd-networkd.service`
- `systemd-resolved.service`

Note: systemd-resolved es realmente requerido sólo su se esoecifica las entradas DNS en los archivos .network o si se quiere obtener direcciones DNS desde redes cliente DHCP.

Por compatibilidad con resolv.conf, elimina o renombra el archivo existente y crear el siguiente vinculo simbolico:

    # ln -s /run/systemd/resolve/resolv.conf /etc/resolv.conf

Opcionalmente, si se desea usar el talón resultor local DNS de systemd-resolver (y así usar LLMNR y fundir DNS por interface), reemplazar `dns` con `resolve` en `/etc/nsswitch.conf`:

    hosts: files resolve myhostname

Mira `man systemd-resolved` y `man resolved.conf` y Systemd README.

Note: Systemd's `resolve` no puede buscar el dominio local cuando sólo se da el hotname, aún cuando `UseDomains=yes` o `Domains=[domain-list]` está presente en el archivo `.network` apropiado, y ese archivo produce el esperado `search [domain-list]` en `resolv.conf`. Si se da ese problema:

- Cambia a usar nombres de dominios completamente calificados
- Usa `/etc/hosts` para resolver hostnames
- Recurrir a usar `dns` de glibc en vez de usar `resolve` de systemd

## Ejemplos de Configuración

Todas las configuraciones estan almasenada como {ic|foo.network}} en `/etc/systemd/network`. Para una lista completa de opciones y orden de procesamiento, mira #Configuration files y la página man de `systemd.network`.

Systemd/udev automaticamente asigna previsibles, nombres de intefaces de res estables para todo el Ethernet local, interfaces de WLAN y WWAN. Usa `networkctl list` para enlistar los dispositivos en el sistema.

Después de realizar cambios a los archivos de configuración, recarge el demonio de red.

    # systemctl restart systemd-networkd

Note: En el ejemplo de abajo, enp1s0 es el adaptador de cable y wlp2s0 es el adaptador inalámbrico. Estos nombres pueden ser diferentes en sistemas distintos.

#### Adaptador alámbrico usando DHCP

    /etc/systemd/network/wired.network

    [Match]
    Name=enp1s0

    [Network]
    DHCP=ipv4

#### Adaptador alámbrico Usando una IP Estática

    /etc/systemd/network/wired.network

    [Match]
    Name=enp1s0

    [Network]
    Address=10.1.10.9/24
    Gateway=10.1.10.1

Vease la página man `systemd.network(5)` para más opciones de red como especificar servidores DNS y direcciones de difución.

#### Adaptador Inalámbrico

A fin de conectarse a una red inalámbrica con systemd-networkd, a un adaptador inalámbrico configurado con otro servicio como wpa_supplicant es requerido. En este ejemplo, el archivo de servicio systemd correspondiente que se necesita habilitar es `wpa_supplicant@wlp2s0.service`.

    /etc/systemd/network/wireless.network

    [Match]
    Name=wlp2s0

    [Network]
    DHCP=ipv4

Si el adaptador inalámbrico tiene una dirección IP estática, la configuracipon es la misma (excepto por el nombre de la interface) como en un adaptador alámbrico .

#### Adaptador Alámbrico e Inalámbrico en la misma máquina

Esta instalación habilitará una IP DHCP para ambas conecciones haciendo uso de la directiva métrica que permite al kernel la desición al vuelo del cual usar. De esta forma, no se observará ningun tiempo de conección cuando la conección alámbrica se desconecte.

La ruta métrica del kernel (misma como configurada con ip) decide cual ruta usar para los paquetes salientes, en casos de mcuhas coincidencias. Esto será em el caso de que ambos dispositivos en el sistema tengan conecciones activas. Para romper la cola, el kernel usa la métrica. Si una de las conecciones es terminada, la otro automaticamente gana sin que sea un filtro con nada configurado (transferencias salientes pueden aún no lidiar con esto apropiadamente pero eso es otra capa diferente del OSI).

Note: La opción Metric es para rutas estáticas mientras la opción RouteMetric es para instalaciones que no usan rutas estáticas

    /etc/systemd/network/wired.network

    [Match]
    Name=enp1s0

    [Network]
    DHCP=ipv4

    [DHCP]
    RouteMetric=10

    /etc/systemd/network/wireless.network

    [Match]
    Name=wlp2s0

    [Network]
    DHCP=ipv4

    [DHCP]
    RouteMetric=20

#### IPv6 privacy extensions

Si se usa IPv6 tal vez se querrá además establecer la opción `IPv6PrivacyExtensions` como configuraciones localizadas en `/etc/sysctl.d/40-ipv6.conf` no son reconocidas.

    /etc/systemd/network/wireless.network

    [Match]
    Name=wlp2s0

    [Network]
    DHCP=yes
    IPv6PrivacyExtensions=true

    [DHCP]
    RouteMetric=20

## Archivos de Configuración

Los archivos de configuración están localizados en `/usr/lib/systemd/network`, el directorio volatil de ejecución de red `/run/systemd/network` y la carpeta local de administración de red `/etc/systemd/network`. Los archivos en `/etc/systemd/network` tienen la mayor prioridad.

Hay tres tipos de archivos de configuración.

- Archivos .network. Se aplicarán a la configuración de la red por un dispositivo acoplado.
- Archivos .netdev. Estos crean un dispositivo de red virtual para un entorno acoplado.
- Archivos .link'. Cuando un dispositivo de red aparece, [[udev] buscará el primer archivo .link acoplado.

Todos ellos singuen las siguientes reglas:

- Si todas las condiciones en la sección de `acoplamiento` coincidan, el perfil será activado.
- Una sección de `acoplamiento` vacia hace que el perfil se aplique de cualquier manera (puede compararse con el comodin `*`).
- Cada entrada es una clave con la sintaxis `NAME=VALUE`.
- Todos los archivos de configuración son colectivamente almacenados y procesados en orden léxico, independientemente del directorio donde esté almacenado.
- Los archivos con nombres identicos se reemplazan con el otro

Tip:

- Para sobreescribir un archivo proporcionado por el sistema en `/usr/lib/systemd/network` de forma permanente (ejemplo incluso despues de actualizar), coloca el archivo con el mismo nombre en `/etc/systemd/network` y un enlace simbolico a `/dev/null`.
- El comodin `*` se puede usar en `VALOR` (ejemplo `en*`) hará coincidir en cualquier dispositivo Ethernet.
- Según este hilo Arch-general, la mejor forma es establecer un contenedor de ajustes de red especificos dentro del contenedor con los archivos de configuración de networkd.

### Archivos de Red

Estos archivos son dorogodos a establecer variables de configuración de red, en especial a servidores y contenedores.

A continuación se muestra una estructura básica de un archivo `MiPerfil.network`:

    /etc/systemd/network/MiPerfil.network

    [Match]
    una lista vertical de claves

    [Network]
    una lista vertical de claves

    [Address]
    una lista vertical de claves

    [Route]
    una lista vertical de claves

#### Sección [Match]

Las claves más comunes son:

- `Name=` el nombre del dispositivo (ejemplo Br0, enp4s0).
- `Host=` el nombre de red del ordenador.
- `Virtualization=` revisa lo que el sistema ejecuta en un entorno virtualizado o no. Una clave `Virtualization=no` sólo se aplicará en el ordenador anfitrion, mientras `Virtualization=yes` se aplica a cualquier contenedor o máquina virtual.

#### Sección [Network]

Las claves más comunes son:

- `IPForward` por defecto es 0,

lo cual significa que si no se especifica una configuración para {ic|1=IPForward}} en el archivo .network, la interface tendrá el seguimiento IP deshabilitado aún si se habilitó con `sysctl` o escribiendo en `/proc/sys`.

#### Sección [Address]

Las claves más comunes en la sección `[Address]` son:

- `Address=` es una dirección IPv4 o IPv6 estática y su longitud prefija, separada por un `/` (ejemplo

`192.168.1.92/24`). Ésta opción es obligatoria a menos que el DHCP sea usado.

#### Sección [Route]

Las claves más comunes en la sección `[Route]` son:

- {{ic|1=Gateway=} es la dirección o la puerta de acceso del ordenador. ésta opción es obligatoria a menos que se use DHCP.

Para una exhaustiva lista de claves, por favor refiérase a`systemd.network(5)`

Tip: Se puede poner las claves `Address=` y `Gateway=` en la sección `[Network]` como un atajo si `Address=` contiene sólo una regla de dirección y la sección `Gateway=` contiene sólo una clave Gateway

### Archivos netdev

Estos archivos crean dispositivos virtuales de red.

A continuación se muestra la estructyura básica de un archivo MiDispositivo.netdev:

    /etc/systemd/network/MiDispositivo.netdev

    [Match]
    Una lista vertical de claves

    [Netdev]
    Una lista vertical de claves

#### Sección [Match]

Las claves más comunes son `Host=` y`Virtualization=`

#### [Netdev] section

Las claves más comunes son:

- `Name=` es el nombre de la interface cuando se crea el netdev. Esta opción es Obligatoria
- `Kind=` es el tipo de netdev. Por ejemplo bridge, bond, vlan, sit, etc. son soportados. Esta opción es Obligatoria

Para una lista exhaustiva lista de claves, por favor refiérase a `systemd.netdev(5)`

### Archivos Link

Estos archivos son una alternativa para personalizar las reglas udev y son aplicados por udev a medida que el dispositivo aparece.

A continuación se muestra la estructura básica de un archivo MiDispositivo.link:

    /etc/systemd/network/MiDispositivo.link

    [Match]
    Una lista vertical de claves

    [Link]
    Una lista vertical de claves

La sección `[Match]` determinará si un archivo link dado puede aplicarse a un dispositivo dado, mientras la sección `[Link]` especifica la configuración del dispositivo.

#### Sección [Match]

Las claves más comunes son `MACAddress=`, `Host=` y `Virtualization=`.

`Type=` es el tipo de dispositivo (e.g. vlan)

#### Sección [Link]

Las claves más usadas son:

`MACAddressPolicy=` ya sea persistente cuando el hardware tiene una dirección MAC persistente (cómo la mayoría del hardware suele ser) o random, lo cual permite darle una dirección MAC aleatoria cuando aparece el dispositivo.

`MACAddress=` suele usarse cuando no se especifica `MACAddressPolicy=`.

Note: el sistema `/usr/lib/systemd/network/99-default.link` es generalmente suficiente para la mayoría de los casos básicos

## Usage with containers

The service is available with systemd >= 210. You will want to enable and start the `systemd-networkd.service` on the host and container.

For debugging purposes, it is strongly advised to install the bridge-utils, net-tools and iproute2 packages.

If you are using systemd-nspawn, you may need to modify the `systemd-nspawn@.service` and append boot options to the `ExecStart` line. Please refer to `man 1 systemd-nspawn` for an exhaustive list of options.

Note that if you want to take advantage of automatic DNS configuration from DHCP, you need to enable `systemd-resolved` and symlink `/run/systemd/resolve/resolv.conf` to `/etc/resolv.conf`. See `systemd-resolved.service(8)` for more details.

This article or section needs language, wiki syntax or style improvements.

Reason: Too many points for a tip, some of them are very similar so they could be merged. (Discuss in Talk:Systemd-networkd (Español)#)
Tip: Before you start to configure your container network, it is useful to:

- disable all your netctl services. This will avoid any potential conflicts with systemd-networkd and make all your configurations easier to test. Furthermore, odds are high you will end with few or even no netctl activated profiles. The `netctl list` command will output a list of all your profiles, with the activated one being starred.
- disable the `systemd-nspawn@.service` and use the `systemd-nspawn -bnD /path_to/your_container/` command as root to boot the container. To log off and shutdown inside the container `systemctl poweroff` is used as root. Once the network setting meets your requirements, enable and start `systemd-nspawn@.service`
- disable the `dhcpcd.service` if enabled on your system, since it activates dhcpcd on all interfaces
- make sure you have no netctl profiles activated in the container, and ensure that `systemd-networkd.service` is neither enabled nor started
- make sure you do not have any iptables rules which can block traffic
- make sure packet forwarding is enabled if you want to let containers access the internet. Make sure that your .network file does not accidentally turn off forwarding because if you do not have a IPForward=1 setting in it, systemd-networkd will turn off forwarding on this interface, even if you have it enabled globally.
- when the daemon is started the systemd `networkctl` command displays the status of network interfaces.

Note: For the set-up described below,

- we will limit the output of the `ip a` command to the concerned interfaces
- we assume the host is your main OS you are booting to and the container is your guest virtual machine
- all interface names and IP addresses are only examples

### Basic DHCP network

This setup will enable a DHCP IP for host and container. In this case, both systems will share the same IP as they share the same interfaces.

    /etc/systemd/network/MyDhcp.network

    [Match]
    Name=en*

    [Network]
    DHCP=ipv4

Then, enable and start `systemd-networkd.service` on your container.

You can of course replace `en*` by the full name of your ethernet device given by the output of the `ip link` command.

- on host and container:

    $ ip a

    2: enp7s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP group default qlen 1000
        link/ether 14:da:e9:b5:7a:88 brd ff:ff:ff:ff:ff:ff
        inet 192.168.1.72/24 brd 192.168.1.255 scope global enp7s0
           valid_lft forever preferred_lft forever
        inet6 fe80::16da:e9ff:feb5:7a88/64 scope link
           valid_lft forever preferred_lft forever

By default hostname received from the DHCP server will be used as the transient hostname.

To change it add `UseHostname=false` in section `[DHCPv4]`

    /etc/systemd/network/MyDhcp.network

    [DHCPv4]
    UseHostname=false

If you did not want configure a DNS in `/etc/resolv.conf` and want to rely on DHCP for setting it up, you need to enable `systemd-resolved.service` and symlink `/run/systemd/resolve/resolv.conf` to `/etc/resolv.conf`

    # ln -sf /run/systemd/resolve/resolv.conf /etc/resolv.conf

See `systemd-resolved.service(8)` for more details.

### DHCP with two distinct IP

#### Bridge interface

Create a virtual bridge interface

    /etc/systemd/network/MyBridge.netdev

    [NetDev]
    Name=br0
    Kind=bridge

On host and container:

    $ ip a

    3: br0: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN group default
        link/ether ae:bd:35:ea:0c:c9 brd ff:ff:ff:ff:ff:ff

Note that the interface br0 is listed but is DOWN.

#### Bind ethernet to bridge

Modify the `/etc/systemd/network/MyDhcp.network` to remove the DHCP, as the bridge requires an interface to bind to with no IP, and add a key to bind this device to br0. Let us change its name to a more relevant one.

    /etc/systemd/network/MyEth.network

    [Match]
    Name=en*

    [Network]
    Bridge=br0

#### Bridge network

Create a network profile for the Bridge

    /etc/systemd/network/MyBridge.network

    [Match]
    Name=br0

    [Network]
    DHCP=ipv4

#### Add option to boot the container

As we want to give a separate IP for host and container, we need to Disconnect networking of the container from the host. To do this, add this option `--network-bridge=br0` to your container boot command.

    # systemd-nspawn --network-bridge=br0 -bD /path_to/my_container

#### Result

- on host

    $ ip a

    3: br0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP group default
        link/ether 14:da:e9:b5:7a:88 brd ff:ff:ff:ff:ff:ff
        inet 192.168.1.87/24 brd 192.168.1.255 scope global br0
           valid_lft forever preferred_lft forever
        inet6 fe80::16da:e9ff:feb5:7a88/64 scope link
           valid_lft forever preferred_lft forever
    6: vb-MyContainer: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast master br0 state UP group default qlen 1000
        link/ether d2:7c:97:97:37:25 brd ff:ff:ff:ff:ff:ff
        inet6 fe80::d07c:97ff:fe97:3725/64 scope link
           valid_lft forever preferred_lft forever

- on container

    $ ip a

    2: host0: <BROADCAST,MULTICAST,ALLMULTI,AUTOMEDIA,NOTRAILERS,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP group default qlen 1000
        link/ether 5e:96:85:83:a8:5d brd ff:ff:ff:ff:ff:ff
        inet 192.168.1.73/24 brd 192.168.1.255 scope global host0
           valid_lft forever preferred_lft forever
        inet6 fe80::5c96:85ff:fe83:a85d/64 scope link
           valid_lft forever preferred_lft forever

#### Notice

- we have now one IP address for Br0 on the host, and one for host0 in the container
- two new interfaces have appeared: `vb-MyContainer` in the host and `host0` in the container. This comes as a result of the `--network-bridge=br0` option. This option implies another option, `--network-veth`. This means a virtual Ethernet link has been created between host and container.
- the DHCP address on `host0` comes from the system `/usr/lib/systemd/network/80-container-host0.network` file.
- on host

    $ brctl show

    bridge name	bridge id		STP enabled	interfaces
    br0		8000.14dae9b57a88	no		enp7s0
    							vb-MyContainer

the above command output confirms we have a bridge with two interfaces binded to.

- on host

    $ ip route

    default via 192.168.1.254 dev br0
    192.168.1.0/24 dev br0  proto kernel  scope link  src 192.168.1.87

- on container

    $ ip route

    default via 192.168.1.254 dev host0
    192.168.1.0/24 dev host0  proto kernel  scope link  src 192.168.1.73

the above command outputs confirm we have activated `br0` and `host0` interfaces with an IP address and Gateway 192.168.1.254. The gateway address has been automatically grabbed by systemd-networkd

    $ cat /run/systemd/resolve/resolv.conf

    nameserver 192.168.1.254

### Static IP network

Setting a static IP for each device can be helpful in case of deployed web services (e.g FTP, http, SSH). Each device will keep the same MAC address across reboots if your system `/usr/lib/systemd/network/99-default.link` file has the `MACAddressPolicy=persistent` option (it has by default). Thus, you will easily route any service on your Gateway to the desired device. First, we shall get rid of the system `/usr/lib/systemd/network/80-container-host0.network` file. To do it in a permanent way (e.g even after upgrades), do the following on container. This will mask the file `/usr/lib/systemd/network/80-container-host0.network` since files of the same name in `/etc/systemd/network` take priority over `/usr/lib/systemd/network`.

    # ln -sf /dev/null /etc/systemd/network/80-container-host0.network

Then, enable and start `systemd-networkd` on your container.

The needed configuration files:

- on host

The factual accuracy of this article or section is disputed.

Reason: In the listing of configuration files, /etc/systemd/network/MyBridge.netdev has the .netdev extension. But, the MyBridge.network example file has the .network extension. (Discuss in Talk:Systemd-networkd (Español)#)

    /etc/systemd/network/MyBridge.netdev
    /etc/systemd/network/MyEth.network

A modified MyBridge.network

    /etc/systemd/network/MyBridge.network

    [Match]
    Name=br0

    [Network]
    DNS=192.168.1.254
    Address=192.168.1.87/24
    Gateway=192.168.1.254

- on container

    /etc/systemd/network/MyVeth.network

    [Match]
    Name=host0

    [Network]
    DNS=192.168.1.254
    Address=192.168.1.94/24
    Gateway=192.168.1.254

## See also

- systemd.networkd man page
- Tom Gundersen, main systemd-networkd developer, G+ home page
- Tom Gundersen posts on Core OS blog
- How to set up systemd-networkd with wpa_supplicant (WonderWoofy's walkthrough on Arch forums)

Categories:

- Network configuration (Español)
- Virtualization (Español)

Hidden categories:

- Pages using duplicate arguments in template calls
- Pages or sections flagged with Template:Bad translation
- Pages or sections flagged with Template:Style
- Pages or sections flagged with Template:Accuracy