🔐 Capabilities, sysctls y puertos UDP
Algunas aplicaciones necesitan más acceso al kernel del que recibe un contenedor normal. Una VPN es el caso más claro: WireGuard tiene que crear una interfaz de red y programar rutas dentro de su propio namespace, activar el reenvío de IP y responder en un puerto UDP. Nada de eso es posible con los valores predeterminados del contenedor, y nada de ello requiere recurrir a una medida tan amplia como Acceso privilegiado.
Tres campos cubren todo esto; todos forman parte del registro de la aplicación y todos se aplican al crear el contenedor.
Capabilities (caps)
Una capability es una fracción de los privilegios de root. NET_ADMIN permite a una aplicación configurar interfaces y enrutamiento dentro de su propio namespace de red, que es justo lo que necesita un túnel y nada más.
{
"type": "app",
"app": "wireguard",
"caps": ["NET_ADMIN"]
}
ODAC solo concede las siguientes:
| Capability | Para qué sirve |
|---|---|
NET_ADMIN |
Interfaces, enrutamiento y netfilter en el propio namespace de la aplicación: WireGuard, OpenVPN, Tailscale |
NET_RAW |
Sockets raw y de paquetes: ping, traceroute |
NET_BIND_SERVICE |
Vincular un puerto por debajo de 1024 sin ejecutarse como root |
IPC_LOCK |
Bloquear memoria con mlock para que los secretos nunca lleguen a swap: Vault, Redis |
SYS_NICE |
Cambiar la prioridad de planificación de los propios hilos de la aplicación |
Cualquier otra se rechaza al crear la aplicación. SYS_ADMIN, SYS_MODULE, SYS_RAWIO, SYS_PTRACE y sus equivalentes cruzan el límite del contenedor: cargar un módulo del kernel o leer memoria arbitraria del host equivale a ser root en el host, diga lo que diga el contenedor. Una aplicación que realmente necesite eso requiere Acceso privilegiado, que es una decisión deliberada e independiente.
Los nombres pueden escribirse con o sin el prefijo CAP_ y en mayúsculas o minúsculas: NET_ADMIN, net_admin y CAP_NET_ADMIN representan la misma solicitud.
Sysctls (sysctls)
Parámetros del kernel configurados por contenedor:
{
"type": "app",
"app": "wireguard",
"caps": ["NET_ADMIN"],
"sysctls": {
"net.ipv4.ip_forward": "1",
"net.ipv4.conf.all.src_valid_mark": "1"
}
}
Solo se aceptan parámetros con espacio de nombres (namespaced), aquellos que el motor de contenedores puede ajustar para un contenedor sin tocar el host: todo lo que está bajo net.*, además de kernel.msg*, kernel.sem, kernel.shm* y fs.mqueue.*. Un parámetro global del host como vm.max_map_count se rechaza: el motor también lo rechazaría, y un contenedor rechazado provoca que ODAC intente recrearlo continuamente en lugar de mostrar un error visible.
Los valores pueden enviarse como cadenas, números o booleanos; 1, "1" y true llegan al kernel como 1.
⚠️ El modo de red host descarta los sysctls
net.*. Una aplicación con red de host comparte el namespace de red del host, por lo que esos ajustes reconfigurarían el propio host. Cambiar una aplicación a modo host los elimina y te indica cuáles eliminó; configúralos en el host en su lugar. Las capabilities y los sysctls que no son de red no se ven afectados. Consulta Modo de red.
Puertos UDP (proto)
Una entrada de puerto indica su protocolo de transporte:
{
"ports": [
{ "container": 51820, "host": 51820, "proto": "udp", "public": true }
]
}
protoes"tcp"o"udp". Si se omite, equivale atcp, que era el comportamiento de todos los puertos antes de que existiera este campo.- El mismo número puede publicarse en ambos protocolos de transporte:
51820/tcpy51820/udpson dos vinculaciones distintas. - Una entrada enrutada mediante
proxyes siempre TCP. El proxy inverso de ODAC habla HTTP, así que no tiene nada que ver con un puerto de datagramas y la combinación se rechaza. public: truevincula todas las interfaces, exactamente igual que para TCP. Un puerto publicado omite la cadena INPUT del firewall del host (el DNAT del motor reescribe el destino antes de llegar allí), por lo que un puerto UDP público es accesible desde internet tanto si tu firewall tiene una regla UDP coincidente como si no. Si mantienes reglas de firewall para puertos publicados, deben especificarudp: una regla TCP no sirve para un túnel.
La API app.port.set que usa el editor de puertos del panel conserva proto intacto, de modo que la primera edición de configuración de un usuario nunca degrade en silencio un túnel a TCP. Por el mismo motivo, un protocolo que no pueda leer se rechaza en lugar de aplicar un valor predeterminado.
Aplicaciones con plantilla
En una plantilla con múltiples aplicaciones, cada campo pertenece al contenedor que lo necesita, bajo apps.<key>:
{
"type": "template",
"name": "vpn-stack",
"apps": {
"tunnel": {
"image": "linuxserver/wireguard",
"caps": ["NET_ADMIN"],
"sysctls": { "net.ipv4.ip_forward": "1" },
"ports": [{ "container": 51820, "host": 51820, "proto": "udp", "public": true }]
},
"web": { "image": "nginx" }
}
}
Solo tunnel recibe la capability. Una solicitud que ODAC no conceda hace fallar todo el stack antes de que se cree un solo contenedor, así que una plantilla nunca queda desplegada a medias por esto.
Notas
- Los tres campos quedan fijos al crear el contenedor. Reinicia la aplicación para aplicar un cambio:
odac app restart my-app. - Una aplicación que no solicite ninguno de ellos se crea exactamente igual que antes, sin campos adicionales en su registro.
- Cada concesión se escribe en el registro del servidor con el nombre de la aplicación, de modo que queda constancia de qué contenedores tienen privilegios adicionales del kernel.