# Servicio en Linux (systemd) En producción el servidor FastCGI debe arrancar solo con el sistema, reiniciarse si falla y correr con un usuario propio, sin permisos de escritura sobre la instalación. Esta página arma ese servicio con systemd, con socket Unix para nginx, y explica los permisos, cómo varias instancias y cómo correr las tareas de consola. Requisitos: Devkron instalado en `/opt/devkron` ([Instalar en Linux](/es/devkron/2.0/instalacion/linux.md)) y nginx instalado ([nginx con FastCGI](/es/devkron/2.0/instalacion/nginx.md)). ## 1. Cree el usuario del servicio Un usuario de sistema, sin shell, con su carpeta de estado como `HOME` (ahí quedan la llave de la caché de compilados y la carpeta `.dotnet` que usa el runtime): ```bash sudo useradd --system --home-dir /var/lib/devkron --shell /usr/sbin/nologin devkron sudo chown -R root:root /opt/devkron && sudo chmod -R go-w /opt/devkron ``` La segunda línea deja la instalación como solo lectura para el servicio. Si sus aplicaciones escriben archivos (subidas, reportes generados, cachés propias), dé permiso de escritura **solo** a esas carpetas: ```bash sudo mkdir -p /opt/devkron/web/erp.ejemplo.com/archivos sudo chown devkron:devkron /opt/devkron/web/erp.ejemplo.com/archivos ``` ## 2. Cree la unidad de systemd `/etc/systemd/system/devkron.service`: ```ini [Unit] Description=Devkron 2.0 FastCGI After=network.target [Service] Type=simple User=devkron # grupo de nginx: el socket Unix se crea con este grupo Group=www-data WorkingDirectory=/opt/devkron ExecStart=/opt/devkron/dkl -fastcgi /opt/devkron/fastcgi.json # no fije DOTNET_GCgen0size: con concurrencia es contraproducente # cultura de las tareas que lance este proceso; la de las peticiones va en "culture" de fastcgi.json Environment=DEVKRON_CULTURE=es-MX # /run/devkron (socket), /var/lib/devkron (HOME y llave), /var/cache/devkron (compilados) RuntimeDirectory=devkron RuntimeDirectoryMode=0750 StateDirectory=devkron StateDirectoryMode=0700 CacheDirectory=devkron CacheDirectoryMode=0700 Restart=on-failure RestartSec=2 TimeoutStopSec=30 LimitNOFILE=65536 [Install] WantedBy=multi-user.target ``` Qué hace cada parte: | Línea | Para qué | |---|---| | `User=devkron`, `Group=www-data` | el proceso corre sin privilegios; el socket se crea con el grupo de nginx para que nginx pueda conectarse | | `WorkingDirectory=/opt/devkron` | **obligatorio**: el controlador, `web/`, `connections.xml` y `devkron.license` se buscan en el directorio de trabajo | | `RuntimeDirectory`, `StateDirectory`, `CacheDirectory` | systemd crea `/run/devkron`, `/var/lib/devkron` y `/var/cache/devkron` con el dueño y los permisos correctos en cada arranque | | `Restart=on-failure` | si el proceso termina con error, systemd lo vuelve a levantar a los 2 segundos | | `LimitNOFILE=65536` | suficientes descriptores para muchas conexiones y archivos abiertos | ## 3. Ajuste `fastcgi.json` `/opt/devkron/fastcgi.json` para esta unidad: ```json { "controller": "fastcgi/http.dkl", "unix_socket": "/run/devkron/devkron.sock", "unix_socket_mode": "660", "max_concurrent_requests": 128, "connection_timeout": 10000, "max_header_size": 16384, "max_body_size": 52428800, "culture": "es-MX", "native_cache_dir": "/var/cache/devkron/native", "native_key_file": "/var/lib/devkron/native.key" } ``` Sin `port`, el servidor no abre TCP: solo escucha en el socket. Las llaves están explicadas en [Servidor FastCGI](/es/devkron/2.0/instalacion/fastcgi.md). ## 4. Actívelo ```bash sudo systemctl daemon-reload sudo systemctl enable --now devkron sudo systemctl status devkron ``` Ver la bitácora en vivo: ```bash journalctl -u devkron -f ``` Apunte nginx al socket (`server unix:/run/devkron/devkron.sock;`), como se explica en [nginx con FastCGI](/es/devkron/2.0/instalacion/nginx.md). ## Operación diaria | Tarea | Comando | |---|---| | reiniciar (después de cambiar `fastcgi.json`, la licencia, `connections.xml` o una DLL) | `sudo systemctl restart devkron` | | detener | `sudo systemctl stop devkron` | | ver estado y últimas líneas | `sudo systemctl status devkron` | | bitácora desde hoy | `journalctl -u devkron --since today` | - `systemctl stop` envía `SIGTERM`: el servidor deja de aceptar conexiones, termina ordenadamente y borra el socket. - El servicio **no tiene recarga**: `systemctl reload devkron` falla con "Job type reload is not applicable". Use `restart`. - Los cambios a `.dkl`, `.dk` y `.dkh` **no** requieren reinicio. Una DLL de extensión nueva o actualizada **sí** (como en 1.x). ## Permisos del socket, la caché y la llave Este esquema se probó con un usuario de servicio, socket `660` con grupo `www-data` en una carpeta `0750` y nginx con `user www-data`. Si su nginx corre con otro usuario (en algunas distribuciones `nginx` o `nobody`), ajuste `Group=`. El síntoma de un permiso mal puesto es un **502** y en el `error.log` de nginx: ```text connect() to unix:/run/devkron/devkron.sock failed (13: Permission denied) while connecting to upstream ``` | Ruta | Dueño | Modo | Por qué | |---|---|---|---| | carpeta de la llave (`/var/lib/devkron`) | usuario del servicio | `0700` | Devkron rechaza la llave si su carpeta es escribible por el grupo u otros | | llave (`native.key`) | usuario del servicio | `0600` (la crea Devkron) | rechaza la llave si el grupo u otros tienen permisos | | caché de compilados (`/var/cache/devkron/native`) | usuario del servicio | `0700` recomendado | otro usuario no podría hacer cargar código ajeno (cada entrada va firmada), pero sí borrar entradas o llenar el disco | | caché persistente del árbol (solo si usa `DEVKRON_TREE_CACHE_DIR`) | usuario del servicio | `0700` **obligatorio en la práctica** | quien pueda escribir ahí puede inyectar código | Ninguna de estas carpetas debe estar dentro de `web/`. Si la llave se rechaza, Devkron no usa la caché de compilados (todo se interpreta) y `DEVKRON_NATIVE_STATS=1` muestra el motivo. ## Variables de entorno del servicio Para dar variables a sus programas (por ejemplo, datos de configuración que no quiere en el código), use un archivo *drop-in* sin tocar la unidad. Vea [Variables de entorno](/es/devkron/2.0/instalacion/variables-de-entorno.md). ## Varias instancias Para un servicio por cliente o por aplicación, use una unidad plantilla `/etc/systemd/system/devkron@.service`, igual a la de arriba pero con: ```ini Description=Devkron 2.0 FastCGI (%i) ExecStart=/opt/devkron/dkl -fastcgi /opt/devkron/fastcgi-%i.json RuntimeDirectory=devkron-%i StateDirectory=devkron-%i CacheDirectory=devkron-%i ``` y un `fastcgi-.json` por instancia con su propio socket (`/run/devkron-/devkron.sock`) y sus carpetas de caché y llave. Se activan con `sudo systemctl enable --now devkron@cliente1`. Cada instancia cuenta para el límite de instancias de la licencia. ## Tareas de consola (cron, instaladores, lotes) Corren con el usuario de la tarea, que tiene su propia llave y caché de compilados (no comparten compilados con el servicio; no es un error). Para que usen la misma cultura que el servicio: ```bash cd /opt/tareas && DEVKRON_CULTURE=es-MX /opt/devkron/dkl tarea.dkl -hide-log ``` `dkl` devuelve código de salida 1 si la tarea terminó con un error no manejado. Vea [Ejecutar programas de consola](/es/devkron/2.0/instalacion/consola.md). ## Errores típicos | Síntoma | Causa | Solución | |---|---|---| | `status` muestra `activating (auto-restart)` una y otra vez | el proceso termina al arrancar | `journalctl -u devkron -n 50`; lo común es un `fastcgi.json` con error de sintaxis JSON, un socket que ya existe de otro proceso o falta de permisos | | 502 con `Permission denied` en el `error.log` de nginx | nginx no pertenece al grupo del socket | ajuste `Group=` al usuario de nginx o agregue ese usuario al grupo | | 502 con `No such file or directory` | el socket no existe: el servicio no está corriendo o `fastcgi_pass` apunta a otra ruta | revise `status` y que la ruta coincida con `unix_socket` | | los programas no encuentran `connections.xml` | falta `WorkingDirectory` o apunta a otra carpeta | `WorkingDirectory=/opt/devkron` (o ponga `connections.xml` junto a `dkl`) | | `Access to the path … is denied` al escribir archivos | el usuario `devkron` no puede escribir en esa carpeta | dé permiso solo a la carpeta que lo necesita | | la memoria crece mucho más que con 1.x | `DOTNET_GCgen0size` quedó en la unidad o en el entorno | quítela; vea [Rendimiento](/es/devkron/2.0/migracion/rendimiento.md) |