5.3 KiB
Configuración (adn-mon.yaml)
Todos los componentes leen el mismo YAML (ruta por defecto a menudo monitor/adn-mon.yaml; se puede sobrescribir con ADN_CONFIG_PATH). El ejemplo del repositorio adn-monitor es la plantilla autoritativa; las claves siguientes coinciden con monitor/adn-mon.yaml y monitor/src/adn_monitor/infrastructure/config_loader.py (los nombres internos pueden diferir).
GLOBAL
| Clave | Significado |
|---|---|
| BRIDGES_INC | Mostrar estado de bridges en el panel si es true. |
| HOMEBREW_INC | Incluir estado HBP peer/master. |
| LASTHEARD_INC | Activar funciones / tablas Last Heard. |
| LASTHEARD_ROWS | Filas para widgets Last Heard. |
| EMPTY_MASTERS | Mostrar masters sin peers. |
| TGCOUNT_INC | Activar página / estadísticas de conteo de TG. |
| TGCOUNT_ROWS | Filas para el conteo de TG. |
| TIMEZONE | Zona horaria IANA (p. ej. America/Santiago) para mostrar; vacío usa la hora local del servidor. |
ADN_CONNECTION
Debe coincidir con la configuración de informes del ADN DMR Peer Server.
| Clave | Significado |
|---|---|
| ADN_IP | Host/IP donde está el listener TCP de informes del peer server (vista de red desde el monitor). |
| ADN_PORT | Puerto TCP — debe ser igual a REPORTS.REPORT_PORT en el servidor y ser alcanzable. |
SELF_SERVICE
Credenciales MySQL y parámetros PBKDF2 para login y acceso a la tabla Clients. PBKDF2_SALT y PBKDF2_ITERATIONS deben coincidir con hotspot_proxy_self_service.py (o tu herramienta de registro de contraseñas) para que los hashes verifiquen en PHP y Python.
| Clave | Significado |
|---|---|
| USE_SELFSERVICE | Lo usa el cargador de config del proxy para rutas con BD / self-service (ver README del proxy). |
| DB_SERVER, DB_USERNAME, DB_PASSWORD, DB_NAME, DB_PORT | Conexión MySQL para Clients (y tablas relacionadas). |
Si el backend PHP no puede conectar, las rutas de auth y self-service no se registran (ver backend/public/index.php).
PROXY
Proxy UDP hotspot — guía completa: Proxy hotspot. Resumen: reenvía cada cliente a MASTER:DESTPORT_START…DEST_PORT_END; el peer server debe escuchar en esa IP y rango de puertos (ver también Arquitectura).
| Clave | Significado |
|---|---|
| MASTER | Host del peer server (IP o DNS; resuelto al arrancar el proxy). |
| LISTEN_PORT / LISTEN_IP | Dónde el proxy acepta UDP del hotspot (IP vacía suele significar todas las interfaces). |
| DESTPORT_START / DEST_PORT_END | Un puerto por cliente proxy hacia MASTER. |
| TIMEOUT, STATS, DEBUG, CLIENT_INFO | Comportamiento y registro. |
| BLACK_LIST / IP_BLACK_LIST | Listas de bloqueo opcionales. |
OPB_FILTER
Network IDs separados por comas (como cadenas). El tráfico desde esas fuentes OpenBridge puede ocultarse de ciertas rutas de persistencia del panel (ver manejo de OPB_FILTER en el controlador del monitor).
ALIASES
Misma idea que en el peer server: descargar JSON de peer / subscriber / TGID y checksums opcionales. Claves: PATH, *_FILE, *_URL, STALE_HOURS, REVIEW_INTERVAL_MINUTES, CHECKSUM_*, TG_LIST_URL, BRIDGE_LIST_URL (proxy del backend para páginas del frontend).
LOGGER
| Clave | Significado |
|---|---|
| LOG_PATH | Directorio de ficheros de log. |
| LOG_FILE | Nombre del log del monitor (p. ej. adn-mon.log). |
| PROXY_LOG_FILE | Nombre de log separado para el proxy (cuando se ejecuta con logging del proxy). |
| LOG_LEVEL | p. ej. INFO, DEBUG. |
WEBSOCKET_SERVER
| Clave | Significado |
|---|---|
| WEBSOCKET_PORT | Puerto del WebSocket Twisted que envía estado JSON a los navegadores. |
| FREQUENCY | Intervalo de envío (segundos). |
| CLIENT_TIMEOUT | Cerrar clientes WS inactivos tras N segundos (0 = desactivado). |
| USE_SSL, SSL_PATH, SSL_CERTIFICATE, SSL_PRIVATEKEY | WSS opcional. |
DASHBOARD
| Clave | Significado |
|---|---|
| DASHTITLE | Título de cabecera. |
| BACKGROUND | Usar fondo bk.jpg si es true. |
| LANGUAGE | Idioma por defecto de la UI (en, es, …). |
| SELF_SERVICE | Si es true, la UI puede mostrar la entrada Self-service (el backend debe exponer API + BD). |
| SHOW_CONSOLE | Mostrar página consola (mensajes inicio/fin de llamada). |
| MIN_DURATION | Duración mínima de llamada (segundos) para la tabla Last Heard del panel (la página Last Heard puede seguir mostrando más cortas). |
| nav_links, footer, news | Enlaces estructurados / marquee opcionales. |
Entorno
ADN_CONFIG_PATH: ruta absoluta aadn-mon.yamlpara monitor, backend y proxy.- El backend puede usar
API_BASE_PATHsi la API va bajo un prefijo.
Ver también
- Inicio de la documentación
- Arquitectura
- Self-service
REPORTSen el peer server: Monitor e informes, Configuración del servidor (secciónREPORTS).