Requisitos previos
- Docker Engine 24 o posterior con Compose v2
- Node.js 22 o posterior, para generar los secretos
- al menos 2 vCPU, 4 GB de RAM y almacenamiento en disco persistente
- un nombre DNS público para el panel
- cuentas de Twilio y OpenAI para las llamadas en vivo, y un trunk Elastic SIP de Twilio para las llamadas telefónicas
Configure el entorno
.env.example en .env y rellena cada contraseña de rol de PostgreSQL y cada secreto interno con un valor aleatorio de 64 caracteres. No sobrescribe un .env existente a menos que pase --force, que también reemplaza todos sus secretos.
Luego abra .env y configure APP_BASE_URL, OPENAI_API_KEY y sus credenciales de Twilio. Los servicios construyen sus cadenas de conexión a la base de datos a partir de las contraseñas de los roles, así que no necesita escribir ninguna URL de base de datos.
Compose configura STORAGE_PROVIDER=local por defecto. El servicio de administración y el worker montan el mismo volumen persistente storage_data en /var/lib/lobbystack/storage.
Inicie LobbyStack
docker compose logs, y los endpoints de estado siguen funcionando.
Sirva HTTPS desde Caddy
De forma predeterminada, el Caddy de Compose sirveAPP_HOSTNAME por HTTP simple y no publica el puerto 443, para uso local o detrás de su propio proxy HTTPS. En un servidor público, Caddy puede servir HTTPS por sí mismo: docker-compose.tls.yml lo cambia a docker/caddy/Caddyfile.tls y publica el puerto 443. Defina estos valores en .env:
COMPOSE_FILE, cada comando docker compose usa los dos archivos. Apunte el nombre DNS del panel al servidor, abra los puertos 80 y 443, y reinicie la pila. Caddy obtiene el certificado de un nombre de host la primera vez que alguien lo visita. Antes, consulta al admin en /api/tls/ask, que solo aprueba estos nombres de host:
- el nombre de host de
APP_BASE_URL, los orígenes deAUTH_TRUSTED_ORIGINSy los hosts deMARKETING_HOSTS - los subdominios de
PARTNER_BASE_DOMAINde sus socios - los dominios que sus socios conectaron, una vez que el worker comprobó que su DNS apunta a su servidor y que su registro TXT está en su lugar
CADDY_ON_DEMAND_TLS=true, los socios conectan un subdominio de su propio sitio web en la página Marca y dominio de la consola. Mientras venda niveles de socio con los productos POLAR_PARTNER_*, un socio necesita un nivel de pago para hacerlo; si no, cualquier socio puede. La página muestra dos registros que agregar: un CNAME que apunta a PARTNER_DOMAIN_CNAME_TARGET, y un registro TXT que demuestra que el socio controla el dominio. Deje CADDY_ON_DEMAND_TLS en false mientras su Caddy sirva HTTP simple, porque los dominios de los socios no obtendrían certificado.
Conecte los dominios de los socios con Cloudflare for SaaS
Si el DNS dePARTNER_BASE_DOMAIN está en Cloudflare, los dominios propios de sus socios pueden pasar por Cloudflare for SaaS en lugar del TLS bajo demanda de Caddy. Cloudflare emite entonces el certificado de cada dominio, y el worker registra y comprueba cada dominio mediante la API de Cloudflare. Configúrelo una vez:
- En la zona de Cloudflare de
PARTNER_BASE_DOMAIN, abra SSL/TLS > Custom Hostnames y active Cloudflare for SaaS. - Agregue un registro DNS con proxy que apunte a su servidor, como
host.partners.example.com, y agréguelo con Add Fallback Origin en la página Custom Hostnames. - Cree un token de API con el permiso Zone > SSL and Certificates > Edit para esa zona.
- En
.env, defina el token enCLOUDFLARE_SAAS_API_TOKENy el ID de la zona enCLOUDFLARE_SAAS_ZONE_ID, y reinicie la pila. - Configure el modo de cifrado SSL/TLS de la zona en Full. Cloudflare se conecta a su servidor con el dominio propio de cada socio, que su certificado de origen no cubre.
Host. Luego, los socios apuntan un registro CNAME al origen de respaldo, o a PARTNER_DOMAIN_CNAME_TARGET si lo define, y agregan el registro TXT que muestra su consola. Si define tanto Cloudflare for SaaS como CADDY_ON_DEMAND_TLS, el despliegue usa Cloudflare for SaaS.
Elija un backend de almacenamiento
El proveedor local predeterminado admite un solo host de Docker. Haga una copia de seguridad del volumenstorage_data junto con PostgreSQL y restaure ambos desde el mismo punto de recuperación.
Use S3 cuando el servicio de administración y el worker se ejecuten en hosts distintos. Configure estos valores en .env:
Exporte datos de OpenTelemetry
La exportación de OpenTelemetry está desactivada cuandoOTEL_EXPORTER_OTLP_ENDPOINT está vacía. Para enviar trazas, métricas y registros de OpenTelemetry a PostHog, agregue estos valores a .env:
/v1/traces, /v1/metrics y /v1/logs a la URL base. Puede usar las mismas variables con otro backend compatible con OTLP.
Reinicie los contenedores de la aplicación después de cambiar los valores:
Verifique la implementación
Lista de comprobación para producción
- reemplace todas las credenciales de desarrollo y restrinja los permisos de
.env - use un valor HTTPS de producción para
APP_BASE_URL - configure
OPENAI_WEBHOOK_SECRETyTWILIO_SIP_TRUNK_SIDpara contestar llamadas telefónicas. El worker no aprovisiona un número de teléfono sinTWILIO_SIP_TRUNK_SID. Las variables de llamadas de voz explican para qué sirve cada una - configure
WEB_CALL_ALLOWED_ORIGINScon los sitios exactos que alojan su llamada de demostración pública, si tiene una - configure copias de seguridad de PostgreSQL y del almacenamiento de archivos fuera del host
- haga un simulacro de restauración antes de aceptar tráfico de producción
- restrinja los puertos de PostgreSQL, Redis y, si lo usa, MinIO a redes privadas
- monitoree el estado del servicio de administración, el worker, las colas, la base de datos y el almacenamiento de objetos
- fije las versiones de las imágenes antes de las actualizaciones planificadas