---
title: "Autoaloja Dify en tu propio VPS: flujos LLM multiservicio, RAG y gateways privados"
description: "Despliega Dify en tu propio servidor Linux con PostgreSQL, Redis/Valkey y sandbox aislado sobre la red privada de Zenavo, conéctalo con LiteLLM, New API o SearXNG y mantén tu base de conocimiento en tu máquina."
date: 2026-11-16
language: es-ES
url: https://zenavo.app/es-ES/blog/self-host-dify
---

# Autoaloja Dify en tu propio VPS: flujos LLM multiservicio, RAG y gateways privados

Construir un asistente RAG interno o un flujo LLM de varios pasos suele implicar unir plantillas de prompts, troceado de documentos, búsqueda vectorial, llamadas a herramientas y registros de ejecución. [Dify](https://github.com/langgenius/dify) reúne todo esto en un editor visual de flujos y una API backend. Autoalojarlo en tu propio VPS mantiene los documentos subidos, los embeddings y los logs en tu propio disco, sin límites por asiento de planes cloud.

Esta guía explica cómo se organizan los servicios de Dify en Zenavo, cómo conectarlo con un gateway de modelos o buscador privado por `.zenavo.internal` y qué revisar si algo falla al arrancar. Tu servidor y Zenavo se facturan por separado.

## 1. Tamaño del servidor y arquitectura

Dify es una pila multiservicio, no un único contenedor. Para indexar documentos y ejecutar flujos concurrentes con holgura, [conecta un servidor Linux](https://docs.zenavo.app/es-ES/servers/add-a-server) con al menos **4 GB de memoria** (8 GB si también ejecutas una base vectorial dedicada en el mismo host).

Dentro de un mismo proyecto en Zenavo, cada servicio resuelve a los demás por la [red privada del proyecto](https://docs.zenavo.app/es-ES/networking/private) sin exponer puertos internos a internet:

| Componente | Función en la pila | Almacenamiento y notas |
|---|---|---|
| `postgresql` | Base relacional principal (y almacén vectorial si usas `pgvector`) | Volumen persistente en `/var/lib/postgresql/data`; programa copias en **Backup & Restore** |
| `redis` / `valkey` | Cola Celery, caché y estado de límites de tasa | Volumen persistente si quieres conservar tareas en cola tras reiniciar |
| `dify-api` y `dify-worker` | `langgenius/dify-api` (`MODE=api` y `MODE=worker`) | Comparten el mismo `SECRET_KEY`, URLs de base de datos y Redis, y el volumen `/app/api/storage` |
| `dify-web` | Consola Next.js `langgenius/dify-web` | Apunta `CONSOLE_API_URL` y `APP_API_URL` a tu dominio HTTPS |
| `dify-sandbox` | `langgenius/dify-sandbox` aislado para nodos de código | Accesible solo desde `dify-api` / `dify-worker` vía `.zenavo.internal` |
| `nginx` (proxy inverso) | Enruta `/console/api`, `/api`, `/v1`, `/files` → `dify-api:5001` y `/` → `dify-web:3000` | Único servicio con dominio público en el puerto `80` |

Explora la [galería de plantillas de Zenavo](https://zenavo.app/es-ES/templates) para stacks de IA listos para usar o organiza estos servicios en un mismo proyecto.

## 2. Variables de entorno clave

La mayoría de errores de arranque o inicio de sesión en Dify se deben a URLs o secretos desalineados:

1. **`SECRET_KEY`**: genera una cadena aleatoria robusta y configura **exactamente el mismo valor** en `dify-api` y `dify-worker`. Dify la usa para cifrar las claves de proveedores de modelos guardadas en la base de datos.
2. **URLs públicas**: tras vincular tu dominio (por ejemplo `dify.example.com`) en [Dominios y HTTPS](https://docs.zenavo.app/es-ES/networking/domains), configura `CONSOLE_API_URL`, `CONSOLE_WEB_URL`, `SERVICE_API_URL`, `APP_API_URL` y `APP_WEB_URL` como `https://dify.example.com`.
3. **PostgreSQL y Redis privados**: apunta `DB_HOST` a `postgresql.zenavo.internal` y `REDIS_HOST` a `redis.zenavo.internal` (o `valkey.zenavo.internal`). Ninguno necesita puerto público.
4. **Almacén vectorial**: usar `VECTOR_STORE=pgvector` mantiene datos relacionales y embeddings en un solo servicio PostgreSQL fácil de respaldar con [Copia de seguridad y restauración](https://docs.zenavo.app/es-ES/operations/backups).

> **Guarda una copia de `SECRET_KEY`**: almacena `SECRET_KEY` en tu gestor de contraseñas (como [Vaultwarden autoalojado](https://zenavo.app/es-ES/blog/self-host-vaultwarden)). Cambiarla después deja ilegibles las credenciales de modelos guardadas en PostgreSQL.

## 3. Conecta Dify a tu gateway de modelos y buscador privado

En lugar de pegar claves directas de OpenAI o Anthropic en Dify, conéctalo a otros servicios del mismo proyecto por `.zenavo.internal`:

- **Gateway de modelos ([LiteLLM](https://zenavo.app/es-ES/blog/self-host-litellm), [New API](https://zenavo.app/es-ES/blog/self-host-new-api) o [Magpie](https://zenavo.app/es-ES/blog/self-host-magpie))**: en **Settings → Model Provider → OpenAI-API-compatible**, usa `http://litellm.zenavo.internal:4000/v1` (o la dirección interna de New API / Magpie) y una clave virtual. Todo el tráfico queda en tu red privada con presupuestos y registro centralizados.
- **Búsqueda web privada ([SearXNG](https://zenavo.app/es-ES/blog/self-host-searxng))**: activa la salida JSON en SearXNG y apunta la herramienta SearXNG de Dify a `http://searxng.zenavo.internal:8080` para dotar a tus agentes de búsqueda en vivo sin cuotas externas.
- **Automatización general ([n8n](https://zenavo.app/es-ES/blog/self-host-n8n))**: deja las cadenas LLM y el RAG en Dify y dispara webhooks hacia n8n para integraciones SaaS o tareas programadas.

## 4. Inicializa el administrador y verifica los workers

1. Abre `https://dify.example.com/install` en cuanto los servicios estén en `Running` para crear la cuenta administradora inicial.
2. Crea una app de prueba y sube un archivo Markdown o PDF pequeño a **Knowledge** para comprobar que `dify-worker` procesa la cola correctamente.
3. Si un documento queda atascado en `Indexing`, abre el [Zenavo Agent](https://docs.zenavo.app/es-ES/zenavo-agent) integrado en el borde derecho de la consola para revisar los logs de `dify-worker` y `redis`, o depura desde tu terminal con [Claude Code y `zenavo-mcp`](https://zenavo.app/es-ES/blog/claude-code-deploy-debug).

## Preguntas frecuentes

**¿Por qué Dify muestra una página en blanco o falla con 401 / CORS tras configurar el dominio?**
Comprueba que `CONSOLE_API_URL` y `APP_API_URL` en `dify-web` y `dify-api` incluyan `https://` sin barra final, y que el proxy inverso reenvíe `/console/api` y `/api` al puerto `5001` de `dify-api`.

**¿Por qué los documentos subidos a Knowledge se quedan en `Queuing` o `Indexing`?**
Suele ocurrir si `dify-worker` no está activo, si apunta a una instancia de Redis distinta de la de `dify-api`, o si ambos servicios no comparten el volumen `/app/api/storage`.

**¿Debo elegir Dify o n8n?**
Elige **Dify** cuando el núcleo sea orquestar prompts, bases de conocimiento RAG, comparar modelos y publicar APIs de chat. Elige **[n8n](https://zenavo.app/es-ES/blog/self-host-n8n)** para más de 400 integraciones SaaS, tareas cron y webhooks entre sistemas, o combínalos por `.zenavo.internal`.

**¿Puedo migrar un despliegue de Dify desde Zeabur a Zenavo?**
Sí. Exporta la plantilla YAML en Zeabur e impórtala en Zenavo (ver [Migrar desde Zeabur](https://zenavo.app/es-ES/blog/migrate-from-zeabur)), restaura tu volcado de PostgreSQL en **Backup & Restore** (ver [Migrar PostgreSQL desde Zeabur](https://zenavo.app/es-ES/blog/migrate-zeabur-postgresql)) y conserva el mismo `SECRET_KEY`.

[Conecta un servidor Linux](https://docs.zenavo.app/es-ES/servers/add-a-server) o explora las [plantillas de Zenavo](https://zenavo.app/es-ES/templates) para ejecutar tus flujos de IA y bases de conocimiento en tu propia infraestructura.
