SSD Nodes Learn Hosting plans →
Guías Matt ConnorPor Matt Connor

Qué significa http://127.0.0.1:3080 en dsh web

dsh muestra http://127.0.0.1:3080 porque la Web UI solo escucha en localhost. Acceda con un túnel SSH y vea por qué publicar el puerto 3080 es inseguro.

Qué significa dsh web: http://127.0.0.1:3080

Al iniciar el perfil web de DeepSeek Harness en un VPS, muestra una línea como esta y después espera:

dsh web: http://127.0.0.1:3080/?token=...

127.0.0.1 es la dirección de loopback. Es la dirección que usa una máquina para comunicarse consigo misma. Un socket enlazado a 127.0.0.1 acepta conexiones de procesos de esa misma máquina y de ninguna otra. Por tanto, esa línea indica dos cosas a la vez: dónde está escuchando la interfaz web y quién puede acceder a ella. Sólo puede acceder la máquina en la que se está ejecutando dsh. La parte ?token= del final es una credencial aleatoria nueva que el proceso genera cada vez que se inicia. Más adelante se explica con más detalle.

Por eso la URL no hace nada cuando la pegas en el navegador de tu portátil. El 127.0.0.1 de tu portátil es el de tu portátil. Harness está escuchando en el 127.0.0.1 del VPS, que es otra máquina con otra pila de loopback. No hay ningún fallo. Debes transportar la conexión entre ambas máquinas.

El README oficial indica claramente el valor predeterminado: "El comando inicia la interfaz web en http://127.0.0.1:3080 de forma predeterminada y la abre en el navegador predeterminado cuando se inicia localmente." Mediante SSH no hay ningún navegador que abrir, así que la URL queda disponible para que la uses manualmente. La dirección de enlace procede del complemento de host del servidor web, @deepseek-ai/dsh-host-webserver. En la versión 0.2.0-rc.2 que usa esta guía, su clave host está documentada como "Host de escucha; los dos valores admitidos son loopback y todas las interfaces". Obtienes loopback salvo que cambies esta configuración. Si los puertos son un concepto nuevo para ti, cómo funcionan los puertos en Linux explica el modelo de dirección más puerto en el que se basa todo esto.

Por qué la interfaz web sólo se enlaza a localhost

dsh es un arnés de agente: el programa que envuelve el modelo. Se encarga del bucle, las llamadas a herramientas y los permisos con los que se ejecutan esas llamadas. La pestaña del navegador es una superficie de control para un proceso que ejecuta comandos de shell, lee y escribe archivos en el directorio de trabajo que elegiste y consume tu clave de API del modelo. Cualquiera que pueda cargar esa página puede hacer todo eso como el usuario que ejecuta dsh. La red tampoco es la única vía de acceso a esas capacidades: un plugin que instales se ejecuta dentro del mismo proceso y con los mismos permisos. Por eso, revisar un plugin de dsh antes de instalarlo requiere el mismo cuidado que decidir en qué dirección y puerto escucha el servidor.

Por tanto, el puerto 3080 no es un panel de sólo lectura. Cargar esa página permite ejecutar comandos en el servidor.

Abre la URL mostrada y entrarás directamente en la lista de sesiones. No hay pantalla de inicio de sesión ni cuentas de usuario. El acceso a la página lo controla el token incluido al final de la URL: la página raíz lo intercambia por una cookie de sesión firmada y redirige a una dirección limpia. Después, cada llamada RPC y cada flujo WebSocket que la interfaz realiza sin una cookie válida recibe 401 Unauthorized. Sin embargo, no todo lo que se ofrece en el puerto está protegido. La documentación del plugin Connection indica que los recursos estáticos siguen siendo públicos. Además, el servidor web no tiene autenticación global ni una política de origen general, por lo que cada plugin que registra una ruta aplica sus propias reglas. En esas rutas protegidas, el plugin Connection también responde con 403 cuando la cabecera Host no es una dirección de loopback ni un host en el que confíes explícitamente. En loopback, esto constituye una segunda capa razonable detrás del control de acceso real: el sistema operativo sólo permite el acceso a procesos locales. No es una razón para publicar el puerto. El token queda en el historial visible de la terminal y en cualquier registro que haya capturado la salida de inicio. La propia guía del proxy inverso del proyecto indica que ni su comprobación de Host ni la URL anunciada protegen el puerto de escucha. La documentación del servidor web advierte de que enlazar una dirección que no sea de loopback «sigue exponiendo a esa red las rutas sin protección y los recursos estáticos». Además, en 0.2.0-rc.2 el plugin del servidor web no incluye TLS propio. Los escáneres automatizados recorren continuamente los puertos poco habituales, así que debes considerar descubierto un puerto 3080 publicado.

No abras el puerto 3080 en el firewall ni configures host del servidor web con 0.0.0.0 o con tu IP pública en un VPS público. Esa combinación deja la ejecución de comandos en tu servidor a una URL filtrada de distancia de cualquiera que se conecte.

Las versiones actuales ya te orientan en esa dirección: la propia aplicación web rechaza, mediante su opción --host, el enlace a todas las interfaces. Sin embargo, en 0.2.0-rc.2 la clave de configuración host del plugin del servidor web todavía acepta 0.0.0.0, por lo que una modificación de la configuración aún puede exponerlo. La documentación del servidor web en la rama predeterminada del proyecto, y en la versión 0.2.1-rc.5 a la que ahora apunta la etiqueta latest de npm, va más allá: rechaza una dirección no especificada durante la carga y añade una opción tls opcional. Todavía acepta cualquier dirección concreta de una interfaz local, por lo que apuntar host a la IP pública de tu VPS expone igualmente la interfaz.

El mismo razonamiento se aplica a cualquier runtime de agente que ejecutes en un servidor. Por eso, ejecutar un agente de programación de forma segura en un VPS parte de la misma regla: el puerto de control del agente debe permanecer privado y algo en lo que confíes debe proporcionarte el acceso.

¿Cómo accedo a la interfaz web de dsh desde mi portátil?

Existen tres formas honestas y todas ellas mantienen el arnés vinculado a loopback.

  • Un túnel SSH. No se abre ningún servicio nuevo en la interfaz pública y ya dispone de las credenciales. Esta es la opción recomendada.
  • Una red superpuesta privada, para que la interfaz sea accesible desde sus propios dispositivos y sea invisible para el resto.
  • Un proxy inverso que termina TLS (seguridad de la capa de transporte) y solicita una contraseña antes de reenviar cualquier petición.

La diferencia entre ellas es el mecanismo que transporta su navegador hasta loopback. Ninguna de ellas debería implicar mover el arnés fuera de loopback.

Alcanzarlo mediante un túnel SSH

Ejecute esto en su portátil, no en el VPS:

ssh -N -L 3080:127.0.0.1:3080 you@your-vps

Déjelo en ejecución y abra en el navegador local la URL completa dsh que se muestra, http://127.0.0.1:3080/?token=... con el token incluido. La interfaz web se carga, intercambia el token por una cookie de sesión y elimina el token de la barra de direcciones. El navegador envía 127.0.0.1:3080 como Host, que es la dirección de loopback, por lo que el túnel supera la comprobación de Host sin configuración adicional.

El argumento -L contiene tres campos separados por dos puntos. El primero es el puerto que se abrirá en el portátil. El segundo y el tercero son la dirección y el puerto a los que se reenviará cada conexión. El detalle importante es el siguiente: 127.0.0.1 del campo central lo resuelve el servidor SSH del VPS, después de que el tráfico ya haya llegado allí. Se refiere a la interfaz de loopback del VPS, no a la del portátil. Esa es exactamente la dirección que muestra dsh, por lo que el túnel funciona cuando una conexión directa desde el navegador no funciona.

-N indica a SSH que no ejecute un comando remoto, por lo que obtiene un reenviador sin shell. Para crear un túnel en segundo plano que muestre los errores en lugar de ocultarlos:

ssh -N -f -o ExitOnForwardFailure=yes -o ServerAliveInterval=30 -L 3080:127.0.0.1:3080 you@your-vps

-f lo envía al segundo plano después de la autenticación. ExitOnForwardFailure=yes es más importante de lo que parece: sin él, SSH se conecta correctamente aunque no pueda configurar el reenvío. Así obtiene una sesión activa y un túnel inactivo sin ninguna advertencia. ServerAliveInterval=30 envía un keepalive cada 30 segundos para que un túnel inactivo sobreviva a los tiempos de espera de NAT (traducción de direcciones de red) de los routers de cafeterías y hoteles.

Qué debería ver

En el VPS, confirme qué proceso está escuchando realmente:

ss -ltnp | grep 3080

Un resultado correcto muestra la dirección de loopback:

LISTEN 0  511  127.0.0.1:3080  0.0.0.0:*  users:(("node",pid=1042,fd=21))

Si la columna de dirección local muestra 0.0.0.0:3080 en su lugar, la interfaz web está disponible en todas las interfaces, incluida la pública. La IP pública del VPS en esa columna implica la misma exposición. Detenga el servicio y corrija la dirección de escucha antes de hacer cualquier otra cosa. Si ss muestra el socket pero deja vacío el campo users:, ejecútelo con sudo, porque de lo contrario se oculta el nombre del proceso de un socket propiedad de otro usuario.

Cuando el túnel no se inicia

SSH muestra esto y termina:

bind [127.0.0.1]:3080: Address already in use
channel_setup_fwd_listener_tcpip: cannot listen to port: 3080

El problema está en el portátil, no en el servidor. Algo local ya está usando el puerto 3080, normalmente un túnel anterior que olvidó cerrar. Elija otro puerto local libre:

ssh -N -L 3081:127.0.0.1:3080 you@your-vps

Sólo cambió el primer campo, por lo que ahora debe navegar a http://127.0.0.1:3081/?token=..., con el mismo token, mientras el entorno de ejecución sigue escuchando en 3080. Los dos números no tienen que coincidir. La cookie de sesión está vinculada al host y al puerto de la barra de direcciones, por lo que un puerto local nuevo requiere abrir una vez más la URL con el token.

Si el túnel se inicia pero el navegador muestra una conexión rechazada o una respuesta vacía, el tráfico llegó al VPS y no encontró nada en el extremo remoto. Puede que dsh haya terminado o que se haya asociado a otro puerto. Compruébelo con ss -ltnp | grep 3080 en el servidor. Si la página responde con 401 Unauthorized, el túnel funciona y el navegador simplemente no tiene una cookie válida para esa dirección: vuelva a abrir la URL mostrada, con el token incluido. Después de reiniciar, obtenga la URL de la nueva salida, porque cada proceso genera un token nuevo.

Hay otro problema frecuente. Un npx @deepseek-ai/dsh web en primer plano termina cuando se cierra su shell, por lo que el entorno de ejecución se detiene en cuanto cierra la sesión. Inícielo dentro de tmux o mediante un servicio de usuario de systemd. Es el mismo problema que se resuelve en mantener un agente de programación en ejecución en un VPS. Con systemd, la línea dsh web:, incluido el token, queda en el registro del servicio, por lo que debe leerla allí. Mientras configura el acceso SSH, conviene hacer primero reforzar SSH en su VPS, porque el túnel convierte su inicio de sesión SSH en la única puerta de acceso al agente.

Acceda a él mediante una red superpuesta privada

Una red superpuesta proporciona a su VPS y a su portátil direcciones en una red privada a la que sólo se conectan sus dispositivos. Tailscale es la opción habitual, y su comando serve encaja exactamente en este caso: tailscaled se ejecuta en el VPS y se conecta al propio localhost:3080, por lo que el harness sigue escuchando en loopback.

tailscale serve --bg localhost:3080
tailscale serve status

La interfaz estará disponible en HTTPS mediante el nombre de su equipo dentro de su tailnet, sin abrir ningún puerto en la interfaz pública. Para ello, debe habilitar los certificados HTTPS para su tailnet; de lo contrario, serve no tendrá ningún certificado que presentar. Como el navegador enviará ahora ese nombre de tailnet en la cabecera Host, inicie el harness con ese nombre como nombre de confianza; de lo contrario, sus llamadas a la API recibirán 403. Una entrada sin puerto coincide con cualquier puerto:

npx @deepseek-ai/dsh@0.2.0-rc.2 web --trusted-host your-vps.your-tailnet.ts.net

A continuación, abra https://your-vps.your-tailnet.ts.net/?token=... y transfiera el token de la línea mostrada. Para detenerlo, repita el comando con off:

tailscale serve --https=443 off

Use serve, nunca funnel. Funnel publica el mismo destino en Internet, lo que deja un runtime de agente en un puerto abierto y lo protege únicamente con un token incluido en la URL. Los dos comandos son casi idénticos, pero hacen lo contrario. Lea la diferencia entre Tailscale Serve y Funnel antes de ejecutar cualquiera de ellos. Tailscale como red privada explica la configuración en sí.

Acceder mediante un proxy inverso que comprueba una contraseña

Esta es la opción que realmente publica un puerto en Internet, por lo que la autenticación es la única barrera entre un desconocido y la ejecución de comandos en el servidor. Elíjala cuando varias personas necesiten la interfaz y no sea práctico configurar un túnel para cada una.

El harness se mantiene en 127.0.0.1:3080. nginx se ejecuta en el mismo equipo, por lo que puede acceder a loopback, y escucha en 443 con un certificado y un archivo de contraseñas.

server {
    listen 443 ssl;
    server_name dsh.example.com;

    ssl_certificate     /etc/letsencrypt/live/dsh.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/dsh.example.com/privkey.pem;

    auth_basic           "dsh";
    auth_basic_user_file /etc/nginx/dsh.htpasswd;

    location / {
        proxy_pass http://127.0.0.1:3080;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_read_timeout 3600s;
        proxy_buffering off;
    }
}

Cree el archivo de contraseñas y vuelva a cargar la configuración:

sudo apt install -y apache2-utils
sudo htpasswd -c /etc/nginx/dsh.htpasswd you
sudo nginx -t && sudo systemctl reload nginx

nginx -t debe mostrar syntax is ok seguido de test is successful. Si el archivo no es válido, la recarga falla y mantiene activa la configuración en ejecución. Por tanto, lea el error en lugar de reiniciar a ciegas.

Tres de esas líneas del proxy son necesarias. Las cabeceras Upgrade y Connection permiten completar el handshake de WebSocket. Sin ellas, la página carga, pero nunca se actualiza. proxy_read_timeout 3600s aumenta de 60 segundos a una hora el tiempo de espera por inactividad de nginx. No limita la duración total de una ejecución del agente. La versión fijada, 0.2.0-rc.2, ya envía pings de WebSocket cada dos segundos de forma predeterminada. Esto mantiene activa la conexión durante un paso largo del agente. proxy_buffering off desactiva el almacenamiento en búfer de las respuestas HTTP enviadas mediante proxy. No controla las tramas de WebSocket. Configuración de un proxy inverso de nginx, línea por línea explica el resto, y elegir entre nginx, Caddy y Traefik explica cómo hacer lo mismo con certificados automáticos.

El harness también debe conocer el proxy. proxy_set_header Host $host transmite sin cambios el nombre que usa el navegador. Esto es lo que solicita la guía del proxy del proyecto. Por tanto, inicie dsh con ese nombre en la lista de nombres de confianza. De lo contrario, responde 403:

npx @deepseek-ai/dsh@0.2.0-rc.2 web --trusted-host dsh.example.com

Después, cada persona abre https://dsh.example.com/?token=... una vez con el token de la línea dsh web:. A partir de ese momento, el navegador conserva la cookie de sesión. El backend establece esa cookie sin la marca Secure, y la guía del proxy solicita que el proxy la añada cuando se usa HTTPS. En nginx 1.19.3 o posterior, proxy_cookie_flags ~ secure; dentro del bloque location hace esto.

Mantenga 3080 cerrado en el firewall independientemente del proxy que elija. La única vía de acceso debe ser el proxy autenticado. Conceptos básicos del firewall ufw explica las reglas. La autenticación básica sobre TLS es un nivel mínimo de protección, no un modelo de seguridad completo: quien tenga esa contraseña y la URL con el token tiene acceso a un shell en el servidor. Prefiera el túnel cuando sea posible.

¿Cómo cambio el puerto en el que escucha la interfaz web de dsh?

--port pertenece a la aplicación web, no al launcher. La documentación de la CLI muestra directamente el ejemplo:

dsh --profile web --port 8080

dsh web es un alias de --profile web, por lo que dsh web --port 8080 es el mismo comando. El launcher analiza sólo sus propios flags y pasa todo lo que aparece después al perfil iniciado. Por tanto, los flags del launcher van primero, y el primer token que el launcher no reconoce inicia los argumentos de la aplicación. Coloque --port después del perfil, nunca antes.

Lea la URL que imprime el comando en lugar de asumirla, porque esa línea indica la dirección en la que el servidor está escuchando realmente, junto con el token que necesitará. Después, actualice el último campo del túnel para que coincida:

ssh -N -L 3080:127.0.0.1:8080 you@your-vps

Para cambiarlo de forma permanente, el puerto se configura en el perfil en lugar de la línea de comandos. Los perfiles web y headless se inicializan automáticamente en el primer uso a partir de las plantillas incluidas, en ~/.dsh. En ese mismo directorio se encuentran la configuración de la API key y del endpoint del modelo, por lo que configurar las keys, los modelos y los endpoints de dsh es la lectura complementaria si ya va a editar estos archivos. Para comprobar qué configuración está activa después de combinar todas las capas:

dsh --dump-config

La dirección de escucha procede de dos keys del plugin del servidor web: host y port. En 0.2.0-rc.2, las demás keys sólo ajustan la compresión de las respuestas, mientras que 0.2.1-rc.2 y la rama predeterminada añaden una key tls opcional. Establecer port en 0 solicita al sistema operativo un puerto libre, documentado como "zero requests an OS-assigned port". Esto evita cualquier conflicto, pero no es adecuado para un túnel porque el número cambia en cada reinicio.

¿Por qué dsh falla con el error «address already in use»?

Otro proceso ya usa esa dirección y ese puerto, por lo que el kernel rechaza el segundo bind. Node lo muestra así:

Error: listen EADDRINUSE: address already in use 127.0.0.1:3080

Identifique qué proceso usa la dirección antes de cambiar nada:

sudo ss -ltnp | grep 3080

El campo users:(("node",pid=1042,fd=21)) indica el proceso y su PID. Lo habitual es que se trate de una instancia anterior de dsh que creía detenida y que todavía sigue activa en una ventana de tmux separada. Deténgala con kill 1042 o inicie la nueva instancia en otro puerto. Tenga en cuenta que 127.0.0.1:3080 y 0.0.0.0:3080 también entran en conflicto, porque enlazar todas las interfaces ya incluye la interfaz de loopback.

Fije la versión porque se trata de una vista previa para desarrolladores

El README lo indica claramente: DeepSeek Harness está en vista previa para desarrolladores, evoluciona rápidamente y habrá cambios incompatibles. Si ese ritmo es la razón por la que duda, cómo se compara dsh con Claude Code y Omnigent lo compara con dos harnesses que se encuentran en puntos diferentes de la misma evolución.

Un npx @deepseek-ai/dsh web sin versión no especifica ninguna versión, por lo que no controla qué compilación se inicia. La documentación de npm indica que un nombre de paquete sin especificador «se comparará con cualquier versión que exista en el proyecto local», y que un paquete que falta en el proyecto se instala en una carpeta de la caché de npm. La compilación que se inicia depende de lo que haya en esa máquina, por lo que un reinicio puede iniciar una CLI diferente de la que probó, con flags distintos. Fije la versión para que un reinicio no sea una actualización:

npx @deepseek-ai/dsh@0.2.0-rc.2 web

A fecha de noviembre de 2026 (comprobado el 2026-11-01), el tag npm latest apunta a 0.2.1-rc.5, publicado en GitHub el 2026-10-30. GitHub registra 0.2.1-rc.4 como publicado el 2026-10-28 a las 02:49 UTC, aproximadamente cuatro días y once horas después de 0.2.1-rc.3, publicado el 2026-10-23 a las 15:26 UTC. Por tanto, en una máquina sin una copia local, un npx @deepseek-ai/dsh sin especificar descarga ahora una release candidate 0.2.1, no la compilación que fija esta guía. El 0.2.0-rc.2 fijado se publicó en GitHub el 2026-09-29. La compilación 0.1.0-rc.7 que esta guía fijó en agosto está ahora varias versiones de vista previa por detrás, a lo largo del resto de la línea 0.1 y hasta 0.2. Compruebe qué descargaría un npx sin especificar antes de aceptarlo:

npm view @deepseek-ai/dsh version

npm view @deepseek-ai/dsh dist-tags muestra todos los tags a la vez. Así puede distinguir una release candidate de una alpha antes de fijarla.

Si la versión fijada no se puede instalar o npx sigue iniciando la compilación antigua después de fijar una nueva, los errores de instalación y versión que produce explican cómo borrar la caché de npx y comprobar qué npm incluye su Node.

Los flags cambian entre el launcher y la aplicación web en las distintas versiones de vista previa. Si --port deja de comportarse como se describe en esta guía, solicite a la aplicación su propia lista de flags en lugar de intentar adivinarlos:

dsh --profile web --help

Para la instalación, la configuración del workspace y la clave del modelo, consulte cómo instalar DeepSeek Harness en un VPS. Para una guía más breve sólo sobre el paso de acceso, cómo acceder a la interfaz web de dsh en un VPS explica el túnel sin el razonamiento.

FAQ

¿Por qué no puedo abrir http://127.0.0.1:3080 en el navegador de mi portátil?

Porque 127.0.0.1 representa el equipo en el que está escribiendo. La interfaz web de DeepSeek Harness está vinculada a la dirección de loopback del VPS, por lo que sólo los procesos del VPS pueden conectarse a ella. Su portátil tiene su propio loopback independiente y allí no hay ningún proceso escuchando en el puerto 3080. Reenvíe el puerto mediante SSH con ssh -N -L 3080:127.0.0.1:3080 you@your-vps y cargue localmente la URL completa que se muestra, http://127.0.0.1:3080/?token=.... El campo intermedio del argumento -L se resuelve en el servidor, por lo que apunta al harness. Si omite el token, obtendrá 401 Unauthorized hasta que el navegador conserve una cookie de sesión.

¿Es seguro vincular la interfaz web de dsh a 0.0.0.0 en un VPS público?

No. La interfaz web es la superficie de control de un agente que ejecuta comandos de shell y modifica archivos con el usuario que ejecuta dsh. No tiene cuentas de usuario ni pantalla de inicio de sesión: la única credencial es el token incluido en la URL mostrada, los recursos estáticos se sirven sin él y la documentación del propio proyecto indica que el puerto de escucha no está protegido. Vincularla a todas las interfaces de una IP pública permite ejecutar comandos en el servidor a cualquiera que acceda al puerto 3080 y obtenga una URL filtrada. Vincularla directamente a la IP pública conlleva el mismo riesgo. Mantenga el enlace en 127.0.0.1, mantenga cerrado el puerto 3080 en el firewall y use un túnel SSH, una red superpuesta privada o un proxy inverso que requiera contraseña.

¿Cómo mantengo la interfaz web de dsh en ejecución después de cerrar la sesión SSH?

Un npx @deepseek-ai/dsh web en primer plano es hijo del shell de inicio de sesión, por lo que termina cuando se cierra ese shell. Inícielo dentro de una sesión de tmux y sepárese con Ctrl-b d, o ejecútelo como un servicio de usuario de systemd con el modo persistente habilitado. El túnel y el harness son independientes: puede cerrar y reconstruir el túnel SSH tantas veces como quiera sin afectar al harness en ejecución, siempre que el propio harness tenga un proceso padre que sobreviva a su inicio de sesión.

¿Por qué se bloquea la interfaz web de dsh a mitad de una ejecución larga del agente detrás de nginx?

Compruebe la conexión WebSocket y el registro de errores de nginx. El valor predeterminado de proxy_read_timeout de nginx es de 60 segundos entre lecturas, pero la versión fijada 0.2.0-rc.2 envía pings de WebSocket cada dos segundos de forma predeterminada, por lo que un paso largo del agente por sí solo no activa ese tiempo de espera. proxy_read_timeout 3600s; aumenta el tiempo de inactividad permitido a una hora. proxy_buffering off; deshabilita el almacenamiento en búfer de las respuestas HTTP, no de las tramas WebSocket. Envíe las cabeceras Upgrade y Connection con proxy_http_version 1.1; para que el handshake de WebSocket se complete correctamente. Sin esas cabeceras, la página se carga, pero nunca recibe actualizaciones.

¿Te resultó útil este artículo?