Tutorial de Debian 13 / Crear un servicio systemd y modificarlo con archivos drop-in
En Debian 13, active indica el estado de activación actual de un servicio systemd, y enabled muestra si está habilitado para iniciarse al arrancar. Si ha modificado el archivo de unidad o el drop-in, use daemon-reload para que el gestor de systemd vuelva a leer las definiciones de unidades, y cualquier comando de ejecución modificado debe ser seguido por un reinicio del servicio y la verificación de la respuesta real.
Distinga el estado de ejecución de la configuración de inicio
systemd gestiona tareas como servicios, temporizadores y montajes como unidades. Este tutorial crea un servicio HTTP de Python restringido a la interfaz local (loopback) en un sistema Debian 13 con systemd 257, mostrando su estado y comparando procesos, puertos y respuestas. Es una práctica para manipular servicios generales del sistema y no implica reiniciar todos los servicios existentes de la misma manera.
| Comandos | Objetivo a cambiar | Resultado de esta práctica |
|---|---|---|
| start / stop | Servicio en ejecución actualmente | Iniciar o detener el servicio sin cambiar sus enlaces de inicio |
| enable / disable | Enlaces de inicio de la unidad | Agregar o eliminar enlaces de inicio sin detener un proceso en ejecución |
| enable --now | Configuración de inicio y estado en tiempo de ejecución | Habilitar enlaces de inicio y también iniciar el servicio ahora |
| daemon-reload | Configuración de la unidad leída por systemd | Volver a leer las definiciones de la unidad sin reemplazar el proceso HTTP |
| restart | Proceso del servicio | Aplicar nuevo comando de ejecución deteniendo e iniciando |
Incluso si enabled, el servicio puede fallar, e incluso si disabled, puede iniciarse manualmente o ejecutarse a solicitud de otra unidad. La sección [Install] contiene WantedBy=multi-user.target: enable usa esa información para crear enlaces que asocian el servicio al arranque de ese target. La sección no es, por sí misma, un target. Hay servicios que son unidades estáticas sin conexiones de instalación o que se inician mediante sockets, por lo que no se debe determinar el comportamiento de arranque de todos los servicios basándose únicamente en si están habilitados. Los significados detallados de los comandos se pueden encontrar en el manual de systemctl de Debian 13.
Verifique el estado inicial del laboratorio dedicado
Use la cuenta lfstudent con privilegios sudo, Python 3 y curl. Si es una cuenta diferente, ajuste el User del servicio a continuación y la ruta del documento para que coincida con la cuenta real. El servidor HTTP de Python es solo para fines de práctica y no necesita estar expuesto al host o a la LAN, por lo que escucha únicamente en 127.0.0.1. No se requiere reenvío de NAT ni cambios en el firewall.
id lfstudent
python3 --version
curl --version
systemctl --version
systemctl show lf-http17.service -p LoadState
sudo ss -lntp 'sport = :8080'
sudo ss -lntp 'sport = :8082'
ls -ld /home/lfstudent/lf-http17 /etc/systemd/system/lf-http17.service.d
El servicio es LoadState=not-found, ninguno de los puertos tiene una fila de escucha, y la carpeta no existe como condición inicial. El error de archivo faltante en el último ls es el resultado esperado para confirmar que la ruta todavía no existe. Si algún recurso del laboratorio ya existe, deténgase aquí e identifique a su propietario. No lo sobrescriba ni detenga otro servicio. Si Python o curl no están instalados, revise la lista de cambios en sudo apt install --no-install-recommends python3 curl para instalarlos.
Cree el directorio y el archivo dedicados en un terminal conectado como lfstudent.
mkdir /home/lfstudent/lf-http17 &&
printf 'systemd-service-lab\n' > /home/lfstudent/lf-http17/probe.txt
Si la creación del directorio falla, se omite el comando printf encadenado. Detenga el laboratorio en ese punto en lugar de continuar con el archivo de servicio. El servidor ofrece únicamente el directorio de documentos dedicado al laboratorio, no todo el directorio personal del usuario. El servicio del sistema generalmente es manejado por el administrador del sistema, pero el proceso HTTP en sí se ejecuta con permisos de usuario regular como se muestra a continuación en User=lfstudent.
Escriba y valide la unidad de servicio completa
Abra un nuevo archivo con sudo nano /etc/systemd/system/lf-http17.service y guarde todo el contenido siguiente. Puede usar otro editor, pero conserve el nombre del archivo, la ruta y la estructura de líneas. No sobrescriba un archivo existente con un nuevo ejemplo.
[Unit]
Description=Local HTTP service for lesson 17
[Service]
Type=exec
User=lfstudent
ExecStart=/usr/bin/python3 -m http.server 8080 --bind 127.0.0.1 --directory /home/lfstudent/lf-http17
Restart=on-failure
RestartSec=2s
[Install]
WantedBy=multi-user.target
Type=exec ayuda a comprobar errores en la etapa de inicio del ejecutable. Sin embargo, el inicio exitoso del ejecutable no garantiza que el puerto HTTP esté listo para recibir solicitudes. Restart=on-failure es una configuración para reiniciar en terminación anormal, y no es una opción para revivir un servicio que el administrador haya detenido normalmente.
No agregue & para la ejecución en segundo plano en ExecStart. systemd gestiona directamente el proceso ejecutándolo en primer plano. A diferencia de una línea de comandos de shell normal, las tuberías y redirecciones no se manejan automáticamente como sintaxis de shell. Consulte la opción relevante en la documentación systemd.service para métodos de ejecución.
sudo systemd-analyze verify /etc/systemd/system/lf-http17.service
sudo systemctl daemon-reload
systemctl is-enabled lf-http17.service
systemctl is-active lf-http17.service
systemctl cat lf-http17.service
Verifique la causa si hay algún error o advertencia de inspección. Incluso después de validar y releer las definiciones sin errores, el servicio aún no se ha iniciado: los estados esperados son disabled e inactive. Estas dos consultas devuelven códigos de salida distintos de cero según el estado, por lo que no trate simplemente todas las salidas anormales como fallas de instalación en la automatización.
Observe active y enabled por separado
Primero, inicie el servicio manualmente y verifique la respuesta real del archivo.
sudo systemctl start lf-http17.service
systemctl is-active lf-http17.service
systemctl is-enabled lf-http17.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/probe.txt
sudo ss -lntp 'sport = :8080'
Espere active y disabled en las consultas de estado, y systemd-service-lab de la solicitud HTTP. Los reintentos limitados en curl toman en cuenta la pequeña diferencia para que el puerto esté listo inmediatamente después de que el proceso comience. Si continúa fallando, no confíe únicamente en el estado y verifique la causa con sudo journalctl -u lf-http17.service -b --no-pager -n 30.
Habilite el enlace de inicio, luego detenga el proceso actual.
sudo systemctl enable lf-http17.service
sudo systemctl stop lf-http17.service
systemctl is-enabled lf-http17.service
systemctl is-active lf-http17.service
Los estados esperados son enabled e inactive. stop no elimina el enlace de inicio durante el arranque. Inicie el servicio nuevamente y luego deshabilite su enlace de inicio.
sudo systemctl start lf-http17.service
sudo systemctl disable lf-http17.service
systemctl is-enabled lf-http17.service
systemctl is-active lf-http17.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/probe.txt
Los estados esperados son disabled y active, con la misma respuesta HTTP del archivo. En este ejemplo, deshabilitar no detuvo el proceso HTTP en ejecución. Si se desea una detención inmediata, use disable --now. En esta comparación, mantenga el servicio active y disabled para el cambio de puerto posterior.
Cambie el puerto con un drop-in
Un drop-in es una configuración suplementaria añadida a la carpeta unit-name.d/ junto al archivo de unidad original. En lugar de modificar directamente el archivo /usr/lib/systemd/system/ proporcionado por el paquete, los administradores generalmente gestionan los cambios como un drop-in de /etc/systemd/system/. Este ejemplo aplica el mismo método a una unidad creada manualmente para distinguir entre los archivos originales y suplementarios.
systemctl show lf-http17.service -p MainPID -p ExecStart -p FragmentPath -p DropInPaths
sudo install -d /etc/systemd/system/lf-http17.service.d
Registre el MainPID actual, es decir, el identificador del proceso principal que supervisa systemd, para compararlo después de los cambios. Cree el drop-in con sudo nano /etc/systemd/system/lf-http17.service.d/20-port.conf.
[Service]
ExecStart=
ExecStart=/usr/bin/python3 -m http.server 8082 --bind 127.0.0.1 --directory /home/lfstudent/lf-http17
Un ExecStart= vacío sirve para restablecer el comando de ejecución previamente establecido y reemplazarlo en la siguiente línea. Si se añade un segundo comando de ejecución sin restablecer, no ocurrirá el reemplazo previsto en este tipo de servicio. Los drop-ins se combinan o sobrescriben de manera diferente según la opción, por lo que no todas las configuraciones se gestionan de la misma manera. La ruta de búsqueda de configuración y la descripción de drop-in de systemd.unit son la referencia.
sudo systemd-analyze verify /etc/systemd/system/lf-http17.service
sudo systemctl daemon-reload
systemctl cat lf-http17.service
systemctl show lf-http17.service -p MainPID -p ExecStart -p DropInPaths
curl --noproxy '*' --max-time 5 -fsS http://127.0.0.1:8080/probe.txt
curl --noproxy '*' --max-time 3 -fsS http://127.0.0.1:8082/probe.txt
Aunque el gestor de systemd ahora muestra 8082 en ExecStart, el MainPID del proceso en ejecución es el valor anterior, y las respuestas en 8080 continúan. Se espera que las solicitudes a 8082 fallen porque aún no hay nada escuchando allí. Esta es la comparación que daemon-reload vuelve a leer la definición de la unidad y es diferente de reiniciar el proceso.
sudo systemctl restart lf-http17.service
systemctl show lf-http17.service -p MainPID -p ActiveState -p SubState -p UnitFileState
sudo ss -lntp 'sport = :8082'
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8082/probe.txt
curl --noproxy '*' --max-time 3 -fsS http://127.0.0.1:8080/probe.txt
Verifique el identificador de proceso (PID) tras el reinicio, compruebe la escucha en el puerto 8082 y la respuesta del archivo, y compare si la escucha anterior en 8080 ha desaparecido. El número de PID varía según el entorno, y es más importante verificar el estado, la escucha y la respuesta juntos que el número en sí. reload es una acción distinta de daemon-reload y restart. La unidad de este laboratorio no define ExecReload ni otro mecanismo de recarga compatible: use restart para sustituir su proceso. La recarga de la configuración interna de otra aplicación depende de los mecanismos que esa aplicación ofrezca.
Elimine solo el drop-in del laboratorio y restaure el puerto 8080
Mantenga el archivo de servicio original y borre solo el 20-port.conf creado esta vez. No utilice un revert completo en esta operación, lo que podría borrar otras configuraciones suplementarias.
sudo rm -- /etc/systemd/system/lf-http17.service.d/20-port.conf
sudo rmdir -- /etc/systemd/system/lf-http17.service.d
sudo systemctl daemon-reload
sudo systemctl restart lf-http17.service
systemctl show lf-http17.service -p ExecStart -p DropInPaths
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/probe.txt
sudo journalctl -u lf-http17.service -b --no-pager -n 20
La restauración se confirma cuando DropInPaths está vacío, ExecStart nuevamente especifica el puerto 8080 y la solicitud HTTP devuelve el archivo original. Si rmdir falla porque no está vacío, primero verifique si hay otros archivos y no elimine toda la carpeta. El registro conserva trazas de inicio, detención y solicitudes, lo que le permite verificar las transiciones de estado.
Diagnostique errores y elimine el servicio dedicado
Los errores tipográficos en la ruta del archivo o los problemas de permisos de acceso pueden manifestarse como fallos en las solicitudes HTTP o en el inicio del servicio. Los conflictos de puerto se pueden verificar con ss para ver si otro servidor está escuchando. Lea los resultados de systemctl status lf-http17.service --no-pager y los errores específicos en el journal y corríjalos. Ejecutar solo reset-failed para borrar los registros de fallos no resuelve la causa subyacente.
Después de terminar la práctica, detenga únicamente el servicio dedicado, desactive el inicio automático y luego elimine los archivos creados.
sudo systemctl disable --now lf-http17.service
sudo rm -- /etc/systemd/system/lf-http17.service
sudo systemctl daemon-reload
rm -- /home/lfstudent/lf-http17/probe.txt
rmdir -- /home/lfstudent/lf-http17
systemctl show lf-http17.service -p LoadState
sudo ss -lntp 'sport = :8080'
sudo ss -lntp 'sport = :8082'
Verifique que la unidad muestre not-found y que ninguno de los puertos de laboratorio tenga una fila de escucha. Si el servicio permanece en un estado fallido, primero confirme la eliminación de archivos y la terminación del proceso, luego limpie solo los registros de fallos de esa unidad con sudo systemctl reset-failed lf-http17.service. Mantenga los demás registros del servicio y del sistema.




