Ejecutar dsh como servicio systemd en un VPS
Configura dsh de DeepSeek Harness como un servicio systemd persistente. Aprende a crear un usuario dedicado, gestionar logs con journalctl y mantener el proceso activo.
Ejecutar dsh sin terminal en un VPS
Ejecutar dsh sin terminal en un VPS requiere un archivo de unidad de systemd y un usuario específico que sea su propietario. dsh es el lanzador de línea de comandos de DeepSeek Harness, el entorno de ejecución de agentes de DeepSeek, publicado con licencia MIT en versión preliminar para desarrolladores en agosto de 2026. Un harness es el programa que rodea al modelo, no el modelo en sí. Por tanto, lo que se ejecuta bajo systemd es el bucle, las herramientas y los permisos, no la inferencia de DeepSeek. La guía de inicio rápido indica que debe escribir npx @deepseek-ai/dsh web. Esto es correcto, pero el proceso también termina en cuanto cierra la sesión SSH (secure shell).
Un archivo de unidad resuelve cuatro aspectos a la vez. El servicio vuelve a iniciarse después de un reinicio. Su salida se envía al journal en lugar de desplazarse por la terminal. Se ejecuta con una cuenta que no es root. Además, se ejecuta la versión que seleccionó. Esto es más importante de lo habitual porque el proyecto indica lo siguiente en mayúsculas:
DeepSeek Harness está actualmente en versión preliminar para desarrolladores y evoluciona rápidamente. HABRÁ CAMBIOS QUE ROMPAN LA COMPATIBILIDAD.
Esta guía presupone que dsh ya funciona cuando lo ejecuta manualmente. Si no es así, empiece por instalar DeepSeek Harness en un VPS y vuelva cuando npx @deepseek-ai/dsh web sirva una página.
Node primero, porque las advertencias de npm no bastan
node -vEl paquete propio de Ubuntu 24.04 es Node 18 (18.19.1 en agosto de 2026), una versión antigua para un paquete publicado este año. npm sí comprueba las versiones de Node: su documentación indica que el campo engines de un paquete «sólo generará advertencias» a menos que se habilite engine-strict. Los manifiestos @deepseek-ai/dsh publicados no contienen ningún campo engines (comprobado el 27 de octubre de 2026 para 0.1.0-rc.7, 0.2.1-rc.2 y 0.2.1-rc.4), aunque el repositorio declara uno. Además, npm comprueba los requisitos de engine de las dependencias. La versión fijada de 0.2.1-rc.2 declara commander: ^15.0.0, y Commander 15 requiere Node >=22.12.0, por lo que su instalación en el Node 18 de Ubuntu produce una advertencia EBADENGINE con la configuración normal de npm. De forma predeterminada, esa advertencia no detiene la instalación. Compruebe Node antes de encontrarse con un fallo en tiempo de ejecución.
El mínimo requerido por el repositorio también ha cambiado. El código fuente de 0.2.1-rc.2 acepta ^22.19.0 || >=24.0.0, pero el paquete CLI de la rama master ahora declara >=24.9.0, requisito que Node 22 no cumple. Instale Node 24 desde NodeSource. Es una línea de soporte a largo plazo (LTS), en mantenimiento desde el 20 de octubre de 2026, y sus compilaciones actuales cumplen ambos rangos. Node 26 pasó a LTS el 28 de octubre de 2026, según el calendario de versiones de Node.js.
curl -fsSL https://deb.nodesource.com/setup_24.x -o /tmp/nodesource_setup.sh
less /tmp/nodesource_setup.sh
sudo -E bash /tmp/nodesource_setup.sh
sudo apt install -y nodejs
node -vnode -v ahora debería mostrar una versión v24, 24.9.0 o posterior. La línea less está ahí porque canalizar directamente un script remoto a bash ejecuta código que no ha leído.
Compruebe que se ejecuta antes de escribir una unidad
npx @deepseek-ai/dsh@0.2.1-rc.2 webDéjelo en ejecución. Desde una segunda sesión SSH:
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/Cualquier código de estado HTTP indica que el perfil web está escuchando en loopback, que es donde se enlaza de forma predeterminada. Espere un 401 y considérelo correcto: la interfaz autentica los navegadores mediante un token de lanzamiento incluido en la URL mostrada. Después, intercambia ese token por una cookie de sesión firmada. Una petición que no incluya ninguno de los dos recibe un 401. 000 junto con curl: (7) Failed to connect to 127.0.0.1 port 3080 indica que no está escuchando y que el primer terminal muestra el motivo. Detenga la ejecución manual con Ctrl+C antes de continuar: una unidad que intenta enlazarse a un puerto que ya ocupa otro proceso falla con Error: listen EADDRINUSE: address already in use 127.0.0.1:3080.
0.1.0-rc.7 era la versión publicada el 18 August 2026 y es anterior a la autenticación del navegador en la que se basa esta guía: su README de Connection indica que la barrera es una política de accesibilidad y que «el Web carrier no proporciona ninguna capa de autenticación». El 11 October 2026, la etiqueta latest apuntaba a 0.2.0-rc.2. El 27 October 2026, latest apuntaba a 0.2.1-rc.2 y next a 0.2.1-rc.4, por lo que los comandos de aquí fijan 0.2.1-rc.2. El 4 November 2026, la lista de versiones de npm muestra latest y next en 0.2.1-rc.5; estos comandos mantienen la fijación existente. Compruebe cuál es la versión actual con npm view @deepseek-ai/dsh version y fije la que decida ejecutar.
Instale globalmente la versión fijada
npx es la herramienta incorrecta dentro de un archivo de unidad. Sin una versión o una instalación local coincidente, resuelve la versión del paquete cuando se inicia el proceso. Por tanto, un reinicio dentro de tres meses puede iniciar una compilación diferente de un agente en fase preliminar sin que usted haya cambiado nada. Los paquetes o los datos de caché que falten también requieren acceso al registro de npm. Un registro lento puede retrasar o impedir el arranque. npm también admite la ejecución desde la caché y sin conexión. Instálelo una vez con una versión que haya anotado:
sudo npm install -g @deepseek-ai/dsh@0.2.1-rc.2
command -v dsh
npm ls -g --depth=0 @deepseek-ai/dshcommand -v dsh muestra /usr/bin/dsh cuando npm procede de NodeSource y /usr/local/bin/dsh cuando procede del paquete propio de Ubuntu. Use en el archivo de unidad la ruta que haya mostrado realmente. npm ls -g muestra la versión exacta. Esa es la información que necesitará dentro de seis semanas, cuando cambie el comportamiento y no recuerde qué instaló. Si la instalación falla, si command -v dsh no muestra nada después o si la versión obtenida no es la que solicitó, revise los fallos habituales de instalación y versión de dsh antes de escribir el archivo de unidad.
Un usuario propietario del servicio y nada más
El agente ejecuta comandos de shell. Esa es su función. Si lo ejecuta como root, cada llamada a una herramienta se ejecuta como root. Por eso, asígnele una cuenta propia sin shell de inicio de sesión.
sudo useradd --system --create-home --home-dir /var/lib/dsh --shell /usr/sbin/nologin dsh
sudo install -d -o dsh -g dsh -m 750 /var/lib/dsh/harness /var/lib/dsh/workspace
id dsh/var/lib/dsh/harness se convierte en DSH_HOME, el directorio donde dsh guarda los perfiles. Un perfil es una pila con nombre de conjuntos de plugins y una capa de parches propia encima. Los perfiles web y headless se crean a partir de las plantillas incluidas la primera vez que se inician. Todo lo que añada después a esa pila se ejecutará como este usuario, con el acceso propio del agente a los archivos y al shell. Por tanto, verificar un plugin antes de instalarlo forma parte de la misma tarea que crear la cuenta. Ese primer inicio escribe archivos y puede descargar conjuntos, así que hágalo manualmente para poder supervisarlo.
sudo -u dsh env HOME=/var/lib/dsh DSH_HOME=/var/lib/dsh/harness /usr/bin/dsh --profile webEstablezca HOME explícitamente en lugar de confiar en lo que sudo haga con él, porque que sudo conserve o reescriba HOME depende de ajustes que incluyen env_reset, env_keep y always_set_home en /etc/sudoers. Si lo configura mal, la primera ejecución intentará usar su directorio personal para las cachés y el estado. Esto puede causar errores de permisos o guardar el estado en una ubicación que el servicio no utilizará después. Deténgalo con Ctrl+C cuando la comprobación de curl muestre un código de estado.
El archivo de unidad
Escriba /etc/systemd/system/dsh.service:
[Unit]
Description=DeepSeek Harness (dsh) web profile
Documentation=https://github.com/deepseek-ai/deepseek-harness
After=network-online.target
Wants=network-online.target
StartLimitIntervalSec=300
StartLimitBurst=5
[Service]
Type=exec
User=dsh
Group=dsh
WorkingDirectory=/var/lib/dsh/workspace
Environment=HOME=/var/lib/dsh
Environment=DSH_HOME=/var/lib/dsh/harness
ExecStart=/usr/bin/dsh --profile web
Restart=on-failure
RestartSec=5s
TimeoutStopSec=30s
SyslogIdentifier=dsh
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=full
ProtectHome=true
[Install]
WantedBy=multi-user.targetExecStart= usa la ruta absoluta obtenida de command -v dsh. systemd busca los nombres de comandos simples en una lista de rutas fija, pero esa lista no es el PATH de su shell. Por tanto, una ruta absoluta evita esa suposición.
WorkingDirectory= indica dónde se resuelven las rutas relativas y desde dónde empieza una llamada a una herramienta que ejecuta ls sin argumentos. Apúntelo al espacio de trabajo que entrega al agente. Si el directorio no existe o el usuario del servicio no puede acceder a él, la unidad falla con status=200/CHDIR antes de que dsh se ejecute.
ProtectHome=true oculta /home y /root al proceso. En este caso es seguro porque todo lo que usa el servicio se encuentra bajo /var/lib/dsh. Si apunta el espacio de trabajo a una ruta bajo /home, el agente informará de que el directorio no existe. Esto resulta confuso hasta recordar esta línea. ProtectSystem=full hace que /usr, /boot y /etc sean de solo lectura, y el servicio nunca necesita escribir en ellos.
Seguir aplicando restricciones puede parecer conveniente, pero normalmente es un error. ProtectSystem=strict hace que todo el sistema de archivos sea de solo lectura, excepto los sistemas de archivos pseudo del kernel y, con PrivateTmp=true, /tmp y /var/tmp de esta unidad, por lo que las escrituras en el espacio de trabajo fallan con EROFS: read-only file system. Si necesita ese nivel de restricción, añada ReadWritePaths=/var/lib/dsh en la misma edición.
Qué valor de Type= corresponde aquí
Type=exec, porque dsh permanece en primer plano y nunca crea un proceso hijo. Esto proporciona un mensaje de error real, a diferencia del comportamiento predeterminado. Con Type=simple, systemd considera correcto el inicio en cuanto el proceso ha creado un proceso hijo, antes de saber siquiera si existe el binario. Por eso, systemctl start dsh termina correctamente y el fallo sólo aparece en el journal. Con Type=exec, systemd espera a que execve() se complete correctamente. Así, un error tipográfico en ExecStart= hace que falle el comando que acaba de ejecutar y puede verlo directamente.
Las otras dos opciones incorrectas se quedan bloqueadas. Type=forking indica a systemd que espere a que termine un proceso padre, pero dsh nunca termina. Por tanto, el inicio se bloquea hasta que vence TimeoutStartSec, que es de 90 segundos de forma predeterminada, y después informa de Job for dsh.service failed because a timeout was exceeded.. Type=notify espera un mensaje READY=1 a través de sd_notify, y un proceso de Node que nunca envía ese mensaje se bloquea de la misma manera. La comparación completa de los tipos de servicio de systemd explica el resto, incluido cuándo merece la pena configurar notify.
Reglas de reinicio que fallan de forma visible
Restart=on-failure reinicia tras una salida distinta de cero o una señal no limpia, y deja la unidad detenida después de una salida limpia; systemd considera SIGHUP, SIGINT, SIGTERM y SIGPIPE señales limpias para este tipo de servicio. Este es el comportamiento adecuado para una compilación preliminar. Si dsh termina alguna vez con el código 0 porque ha leído una configuración que no acepta, la unidad se detiene y permanece detenida, y systemctl status dsh muestra inactive (dead), donde puede verlo. Restart=always convierte el mismo evento en un bucle de reinicio que parece saludable a distancia.
El límite de frecuencia es la parte que suele omitirse. Los valores predeterminados de systemd son cinco arranques en diez segundos, y con RestartSec=5s nunca se alcanzan cinco arranques dentro de una ventana de diez segundos. Por tanto, una unidad que falla al arrancar se reinicia indefinidamente y sólo el journal lo registra. StartLimitIntervalSec=300 con StartLimitBurst=5 permite cinco arranques en cinco minutos y después rechaza otro arranque durante ese intervalo. systemd abandona el intento y deja la unidad en failed, registrando Start request repeated too quickly.. Borre ese estado con sudo systemctl reset-failed dsh después de corregir la causa. Ambas opciones deben estar en [Unit], no en [Service]; las opciones no reconocidas generan advertencias en los registros en lugar de ignorarse silenciosamente.
Inícielo y compruebe su estado
sudo systemctl daemon-reload
sudo systemctl enable --now dsh
systemctl status dshenable --now realiza dos tareas. enable hace que el servicio vuelva a iniciarse después de un reinicio, y --now lo inicia durante este arranque. Un systemctl start independiente deja de ser efectivo después del siguiente reinicio, y las actualizaciones del kernel requieren reinicios.
systemctl status dsh debería mostrar una línea Active: active (running), una línea Main PID y una línea Memory:. Después, confirme en qué dirección está escuchando:
sudo ss -lntp | grep 3080Debe aparecer 127.0.0.1:3080. Si aparece otra dirección, un indicador --host ha movido el proceso de escucha a la red a la que pertenece esa dirección. El servicio ofrecerá HTTP sin cifrar, salvo que se configure TLS. El nombre del proceso en esa salida es node, no dsh, porque el binario dsh es un script de Node. Por eso pgrep -x dsh no encuentra nada. Use systemctl show -p MainPID dsh en su lugar.
Después, reinicie el sistema una vez. Un servicio que nunca ha sobrevivido a un reinicio todavía no es un servicio operativo.
sudo rebootVuelva a conectarse y ejecute systemctl is-active dsh. Mostrará active.
Lectura de registros con journalctl
Todo lo que dsh escribe en stdout y stderr termina en el journal, bajo el nombre de la unidad.
journalctl -u dsh -f
journalctl -u dsh -n 200 --no-pager
journalctl -u dsh --since "10 min ago" -p err-f sigue las líneas nuevas, -n muestra las últimas N y -p err filtra por prioridad. SyslogIdentifier=dsh en la unidad es la razón por la que esas líneas aparecen etiquetadas como dsh en lugar de node, algo importante la primera vez que se lee la salida del journal sin filtrarla por unidad.
Compruebe que el journal sobreviva a los reinicios antes de necesitarlo:
journalctl -u dsh -b -1Si muestra Specifying boot ID or boot offset has no effect, no persistent journal was found, el journal se almacena en /run y se elimina en cada reinicio. Con Storage=auto, cree el directorio y reinicie el daemon; si Storage=volatile está configurado, cámbielo primero a persistent:
sudo mkdir -p /var/log/journal
sudo systemctl restart systemd-journaldEjecute sudo journalctl --flush para activar el almacenamiento persistente y volcar en disco los registros del arranque actual.
Acceda a la interfaz de usuario a través de un túnel SSH, no mediante un puerto público
dsh sirve la interfaz web (UI) en 127.0.0.1:3080 de forma predeterminada. El loopback es la opción por defecto, pero no la única: --host acepta una dirección IPv4 o IPv6 concreta de una interfaz local. Cualquier dirección distinta al loopback sirve a la red a la que pertenece mediante HTTP plano, con una advertencia al inicio, a menos que también pase --tls-cert y --tls-key. Lo que dsh rechaza es un comodín. Si solicita --host 0.0.0.0, el error comienza así:
webserver: host "0.0.0.0" is an unspecified (wildcard) address, which is not supported:Continúa indicando que "vincular todas las interfaces expondría la ejecución remota de código a la red" y le indica que "vincule una dirección IPv4 o IPv6 concreta de una interfaz local en su lugar". Un valor que no sea un literal IP, como un nombre de host, falla con is not a concrete IPv4 or IPv6 address literal.
Mantenga el valor predeterminado. La API web (interfaz de programación de aplicaciones) controla el agente, y el agente ejecuta comandos de shell. dsh incluye autenticación antes de esa API: comprobaciones de Host y Origin, además de un token de lanzamiento en la URL impresa que la UI intercambia por una cookie de sesión firmada. Sin embargo, sobre HTTP plano, ese token cruza la red en texto plano, y la propia documentación de upstream indica que la comprobación de Host no protege el puerto de escucha en sí. Si necesita la UI en un nombre de host real, la guía de despliegues públicos de DeepSeek cubre un proxy inverso con --public-url y --trusted-host, o TLS nativo con --tls-cert y --tls-key. Vale la pena leer lo que significa realmente la línea 127.0.0.1:3080 en la salida de inicio antes de intentar moverla. Para una máquina que solo usa usted, reenvíe el puerto desde su propia máquina:
ssh -N -L 3080:127.0.0.1:3080 you@203.0.113.10-L 3080:127.0.0.1:3080 abre el puerto 3080 en su portátil y envía todo lo que llega allí a 127.0.0.1:3080 tal como se resuelve en el VPS. -N significa no ejecutar ningún comando remoto, por lo que la sesión solo mantiene el túnel abierto. Déjelo ejecutándose, busque la URL que dsh imprimió al inicio con journalctl -u dsh -n 100 --no-pager y ábrala en su navegador. Esa URL contiene el token de lanzamiento. Si abre la http://127.0.0.1:3080/ básica en un navegador que no ha iniciado sesión, obtendrá un 401. El token pertenece al proceso en ejecución, pero la cookie de sesión que obtiene sobrevive a este: la cookie está firmada con un secreto que dsh guarda en $DSH_HOME/.credentials.yaml y dura 30 días por defecto, por lo que un navegador que ya haya iniciado sesión puede abrir la URL básica de nuevo, incluso después de un reinicio. Solo necesita una URL nueva del journal para un navegador nuevo, o una vez que esa cookie haya expirado. Trate la URL como una credencial: upstream dice que solo debe compartirla con los usuarios previstos, y cualquiera que pueda leer el journal del sistema puede leerla. Una vez dentro, es ahí donde debe introducir la clave de API de DeepSeek, en Settings y luego Models, y donde debe elegir el directorio de trabajo. Apunte el espacio de trabajo a /var/lib/dsh/workspace, el directorio que posee el usuario del servicio, o las herramientas de archivo del agente fallarán con EACCES: permission denied.
Si el puerto 3080 está ocupado en su portátil, ssh se lo indicará:
bind [127.0.0.1]:3080: Address already in use
channel_setup_fwd_listener_tcpip: cannot listen to port: 3080Elija un puerto local diferente con ssh -N -L 3081:127.0.0.1:3080 you@203.0.113.10, luego abra la URL impresa con 3080 cambiado a 3081. Ahorre escritura en ~/.ssh/config en su propia máquina:
Host dsh-vps
HostName 203.0.113.10
User you
LocalForward 3080 127.0.0.1:3080Después de eso, ssh -N dsh-vps es el comando completo. Este túnel es ahora la única puerta a su agente, por lo que el daemon SSH es lo que lo protege: solo claves, sin autenticación por contraseña, y el resto de endurecimiento de SSH en su VPS se aplica con más fuerza de lo habitual. Si ese VPS crece hasta convertirse en una pequeña red privada propia, con una base de datos o una máquina de staging detrás, anunciar esas direcciones a su tailnet con un router de subred le ahorra un reenvío por servicio, aunque con dsh en su valor predeterminado de loopback, la UI sigue llegando a través de un túnel.
La clave no pertenece al archivo de unidad. Los valores de Environment= son impresos por systemctl show dsh -p Environment, que cualquier usuario en la máquina puede ejecutar. Si un plugin que instala necesita una clave en el entorno, colóquela en /etc/dsh.env con modo 600 propiedad de root y haga referencia a ella con EnvironmentFile=/etc/dsh.env. systemd lee ese archivo como root en el momento de la ejecución, y systemctl show no imprime su contenido. Qué archivo en disco contiene realmente cada configuración, y qué sale de su máquina cuando apunta dsh a un endpoint local de Ollama en lugar de a la API de DeepSeek, es el tema de configuración de claves, modelos y endpoints de dsh.
Qué cuesta ejecutar el servicio
La inferencia se ejecuta en la API de DeepSeek, no en tu VPS. El servidor consume recursos para el proceso de Node, la interfaz que sirve y cada comando que el agente decide ejecutar. Los dos primeros consumos son constantes y reducidos. El tercero no está limitado por nada en este archivo de unidad.
Mide el consumo mínimo en tu propio servidor en lugar de confiar en una cifra obtenida de otro:
systemctl show dsh -p MemoryCurrent
systemd-cgtop -1 --depth 2MemoryCurrent se expresa en bytes. Obsérvalo mientras el agente trabaja, no cuando está inactivo.
Las llamadas a herramientas son procesos secundarios del servicio. Por tanto, se incluyen en el mismo grupo de control y cuentan para los mismos límites. Un agente que ejecuta npm install o una suite de pruebas dentro del espacio de trabajo puede usar mucha más memoria que el propio entorno de ejecución. En un VPS de 1 GB es donde suelen producirse los fallos: el kernel elige un proceso y lo termina, y journalctl -k | grep -i "out of memory" muestra la línea Out of memory: Killed process con el nombre del proceso elegido. A menudo ese proceso no es el que causó el problema.
La solución es establecer un límite de forma intencionada. MemoryMax= y CPUQuota= en la sección [Service] mantienen el impacto dentro de la unidad. Así, una compilación descontrolada termina en lugar de bloquear todo el servidor. Limitar la memoria y la CPU con systemd explica los valores y el comportamiento en caso de fallo. El uso de disco también crece por el historial de sesiones en DSH_HOME y por todo lo que el agente escribe en el espacio de trabajo. Por tanto, incluye du -sh /var/lib/dsh en la herramienta que ya utilices para supervisar el disco.
Si necesitas un agente interactivo al que puedas conectarte y desconectarte, un servicio no tiene la estructura adecuada. En ese caso, ejecutar un agente en una sesión persistente de tmux es una opción más apropiada. Ejecuta dsh como unidad cuando quieras que esté siempre activo y accesible mediante un túnel.
Modos de fallo y las cadenas que verá
status=203/EXEC. systemd no pudo ejecutar el archivo y registra Failed to locate executable /usr/local/bin/dsh: No such file or directory. La ruta en ExecStart= no coincide con lo que imprimió command -v dsh. Este es el fallo que Type=exec reporta en tiempo de systemctl start en lugar de ocultarlo.
status=217/USER. systemd falló al determinar o cambiar las credenciales de usuario de User= y Group=, o al configurar el espacio de nombres de usuario. Para esta unidad, la causa habitual es una cuenta que no existe. Confírmelo con id dsh.
status=200/CHDIR. WorkingDirectory= falta, o el usuario del servicio no puede acceder a ella. sudo -u dsh ls /var/lib/dsh/workspace lo reproduce directamente.
Error: listen EADDRINUSE: address already in use 127.0.0.1:3080. Algo ya ocupa el puerto, usualmente la ejecución de npx que quedó abierta en otra terminal. sudo ss -lntp | grep 3080 nombra al proceso.
EACCES: permission denied seguido de una ruta. La propiedad bajo /var/lib/dsh es incorrecta, normalmente porque una primera ejecución ocurrió como root o con el HOME equivocado. sudo chown -R dsh:dsh /var/lib/dsh lo soluciona.
Start request repeated too quickly. La unidad alcanzó el límite de tasa de inicio y se detuvo. El error real está en las líneas anteriores. Ejecute sudo systemctl reset-failed dsh antes de intentar de nuevo.
La unidad está active (running) pero el navegador no muestra nada. Ejecute la comprobación en el VPS: si curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/ imprime un código de estado allí, el listener responde en el VPS, así que revise el reenvío de puertos a continuación. Ese código no prueba que todo se haya cargado: el upstream indica que los fallos en plugins opcionales no suprimen la disponibilidad, así que lea journalctl -u dsh -n 200 --no-pager para ver errores de plugins también. Un 401 en el navegador significa que no tiene una cookie de sesión válida y la URL no contenía un token de lanzamiento válido, ya sea porque abrió la URL base o porque el token es anterior al último reinicio. Abra la URL que imprimió el proceso actual.
Actualización deliberada
Fijar una versión significa que la actualización es una acción que usted ejecuta, no algo que sucede de forma imprevista. Lea primero las notas de la versión, ya que las advertencias del desarrollador sobre cambios que rompen la compatibilidad son la razón principal para fijar la versión. Realice una copia de seguridad del directorio de estado y, a continuación, cambie la versión:
sudo systemctl stop dsh
sudo tar czf /root/dsh-home-$(date +%F).tgz -C /var/lib/dsh harness
sudo npm install -g @deepseek-ai/dsh@0.2.1-rc.2
sudo systemctl start dsh
journalctl -u dsh -n 50 --no-pagerRevertir a una versión anterior es el mismo npm install -g con la versión antigua, además de restaurar el archivo tar, lo cual solo funciona si realizó la copia previamente. Un entorno de ejecución de agente en fase de previsualización es precisamente el tipo de software donde una actualización puede modificar el formato de configuración sin previo aviso.
FAQ
¿Por qué dsh se detiene cuando cierro mi sesión SSH?
Porque npx @deepseek-ai/dsh web es un proceso en primer plano propiedad de la sesión de inicio de sesión, por lo que se termina cuando finaliza la sesión. Una unidad de systemd pertenece al sistema de inicio, por lo que sigue ejecutándose después de desconectarse y vuelve a iniciarse tras un reinicio. sudo systemctl enable --now dsh es el par de pasos que proporciona ambas cosas: enable para el reinicio y --now para este arranque.
¿Debo usar Type=simple o Type=exec para dsh?
Type=exec. dsh se ejecuta en primer plano y nunca crea un proceso hijo, por lo que ambas opciones funcionan. Sin embargo, Type=exec hace que systemd espere a que execve() termine correctamente antes de marcar el inicio como correcto. Una ruta incorrecta en ExecStart= hace que systemctl start falle con status=203/EXEC visible. Con Type=simple, el mismo error devuelve un resultado correcto y queda oculto en el journal. Type=forking y Type=notify son incorrectos en este caso, y ambos esperan hasta que TimeoutStartSec caduque, después de 90 segundos de forma predeterminada.
¿Cómo abro la interfaz web de dsh desde mi portátil?
Reenvía el puerto mediante SSH: ssh -N -L 3080:127.0.0.1:3080 you@your-vps. Después, abre en el navegador la URL que dsh mostró al iniciar. Puedes encontrarla con journalctl -u dsh. Esa URL contiene el token de inicio, y un navegador que no haya iniciado sesión recibe un 401 si no lo incluye. Tras iniciar sesión, la cookie de sesión dura 30 días de forma predeterminada y sobrevive al reinicio del servicio. Mantén el servicio con su configuración predeterminada de loopback. dsh rechaza un comodín como --host 0.0.0.0 porque es una dirección no especificada. Aunque acepta una dirección local concreta, un enlace que no sea de loopback sirve HTTP sin cifrado si no configuras TLS. En ese caso, el token de inicio de un agente que ejecuta comandos de shell a través de la red se transmite en texto claro.
¿Puedo ejecutar dsh como root para simplificar los permisos?
No. El sistema ejecutor existe para ejecutar comandos y escribir archivos, por lo que los privilegios del servicio son también los privilegios del agente. Crea una cuenta del sistema con useradd --system --shell /usr/sbin/nologin dsh, asígnale la propiedad de /var/lib/dsh y añade NoNewPrivileges=true a la unidad. Si después encuentras EACCES: permission denied, la causa habitual es una ejecución anterior como root que dejó archivos propiedad de root. sudo chown -R dsh:dsh /var/lib/dsh lo corrige.
¿Qué versión de dsh debo fijar en la unidad?
La versión que npm view @deepseek-ai/dsh version muestre al configurar el servicio, instalada con npm install -g @deepseek-ai/dsh@<that version> y registrada en un lugar que puedas consultar. 0.1.0-rc.7 era la versión actual el 18 August 2026, 0.2.0-rc.2 el 11 October 2026 y 0.2.1-rc.2 el 27 October 2026, cuando next ya estaba en 0.2.1-rc.4. El 4 November 2026, tanto latest como next apuntan a 0.2.1-rc.5. Las compilaciones tan antiguas como 0.1.0-rc.7 no tienen autenticación del navegador, por lo que no debes fijar una de ellas para el perfil web. El número no es lo importante. Lo importante es que npx sin versión resuelve el paquete al iniciar, por lo que un reinicio desatendido puede cambiarte silenciosamente a una compilación con un formato de configuración diferente.