Operación y solución de problemas

Objetivo

Proporcionar comandos comunes de operación tras el despliegue, métodos de salud y rutas de diagnóstico para problemas típicos.

Comandos comunes

cd $INSTALL_PATH
docker compose ps
docker compose logs --tail 200 --follow
docker compose down
docker compose up -d

Ver registros de la aplicación:

tail -n 200 $INSTALL_PATH/logs/app/app.log

Actualizar datos geográficos:

bash update_geolite2.sh

Comprobación de salud

Objeto	Comando o entrada	Resultado normal
Estado de contenedores	docker compose ps	Servicios clave en running/up
Salud de aplicación	https://<APP_DOMAIN>/status/health	Devuelve estado sano
Consola de administración	/admin/login	Abre página de login
Portal de usuario	/app/login	Abre página de login
HTTPS	Barra de dirección del navegador	Certificado válido o conforme a política intranet auto-firmada
Recursos de reproducción	/__replay__/...	Recursos empresariales cargan correctamente

Problemas típicos

Síntoma	Causa posible	Recomendación
La página no abre	Dominio sin resolver, puerto cerrado, Caddy no iniciado	Revisar DNS, 80/443, firewall y registros de contenedor
El administrador no puede iniciar sesión	Contraseña errónea, inicialización incompleta, caché del navegador	Usar la contraseña system de instalación y revisar logs
El usuario no ve el sitio	Grupo no autorizado, sitio deshabilitado, categoría sin sitios	Revisar autorización SaaS del grupo y estado del sitio
El usuario no ve el espacio	Grupo sin autorización de espacio de trabajo	Agregar autorización en gestión de espacios del grupo
Inicio de sesión anómalo	Cambios en categoría de cuenta, script o política del sitio destino	Revisar configuración de sitio, categoría de cuenta y URL de coincidencia
Certificado automático falla	Dominio no apunta a IP pública o puertos inaccesibles	Confirmar DNS y reglas entrantes 80/443
Reproducción no disponible	Despliegue no full o recursos de almacenamiento inaccesibles	Revisar licencia, tipo de despliegue y recursos /__replay__/

Recomendaciones de cambio

• Antes de modificar scripts, plugins, proxy o espacios de trabajo, registre la configuración anterior.
• Antes de una actualización mayor, haga copia de $INSTALL_PATH/volumes, $INSTALL_PATH/logs y datos de base de datos.
• Antes de distribuir enlaces de colaboración externos, ábralos completamente con un usuario de prueba sin privilegios.
• Tras activar scripts en sitios de producción, organice validación empresarial de login y páginas clave.