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:

  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, 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.

Guarda una copia de SECRET_KEY: almacena SECRET_KEY en 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:8080 para 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

  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 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.

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.