Autoaloja Dify en tu propio VPS: flujos LLM multiservicio, RAG y gateways privados
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.
Este artículo también está disponible en English, 简体中文, 繁體中文, 日本語 y Bahasa Indonesia.
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 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 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 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 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:
SECRET_KEY: genera una cadena aleatoria robusta y configura exactamente el mismo valor endify-apiydify-worker. Dify la usa para cifrar las claves de proveedores de modelos guardadas en la base de datos.- URLs públicas: tras vincular tu dominio (por ejemplo
dify.example.com) en Dominios y HTTPS, configuraCONSOLE_API_URL,CONSOLE_WEB_URL,SERVICE_API_URL,APP_API_URLyAPP_WEB_URLcomohttps://dify.example.com. - PostgreSQL y Redis privados: apunta
DB_HOSTapostgresql.zenavo.internalyREDIS_HOSTaredis.zenavo.internal(ovalkey.zenavo.internal). Ninguno necesita puerto público. - Almacén vectorial: usar
VECTOR_STORE=pgvectormantiene datos relacionales y embeddings en un solo servicio PostgreSQL fácil de respaldar con Copia de seguridad y restauración.
Guarda una copia de
SECRET_KEY: almacenaSECRET_KEYen tu gestor de contraseñas (como Vaultwarden autoalojado). 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, New API o 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): activa la salida JSON en SearXNG y apunta la herramienta SearXNG de Dify a
http://searxng.zenavo.internal:8080para dotar a tus agentes de búsqueda en vivo sin cuotas externas. - Automatización general (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
- Abre
https://dify.example.com/installen cuanto los servicios estén enRunningpara crear la cuenta administradora inicial. - Crea una app de prueba y sube un archivo Markdown o PDF pequeño a Knowledge para comprobar que
dify-workerprocesa la cola correctamente. - Si un documento queda atascado en
Indexing, abre el Zenavo Agent integrado en el borde derecho de la consola para revisar los logs dedify-workeryredis, o depura desde tu terminal con Claude Code yzenavo-mcp.
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 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), restaura tu volcado de PostgreSQL en Backup & Restore (ver Migrar PostgreSQL desde Zeabur) y conserva el mismo SECRET_KEY.
Conecta un servidor Linux o explora las plantillas de Zenavo para ejecutar tus flujos de IA y bases de conocimiento en tu propia infraestructura.
Esto es lo que leen los agentes de programación, en https://zenavo.app/es-ES/blog/self-host-dify.md.
No se pudo cargar el Markdown. Ábrelo directamente: https://zenavo.app/es-ES/blog/self-host-dify.md