Archivos de configuración
master.conf y agent.conf, clave por clave.
La mayoría de las opciones se administran en el panel. Los dos archivos de configuración contienen lo que los programas necesitan antes de que el panel esté disponible. Después de editar uno, reinicie su servicio:
sudo systemctl restart 3rmonitor-master # después de editar master.conf
sudo systemctl restart 3rmonitor-agent # después de editar agent.confmaster.conf
/etc/3rmonitor/master.conf
listen = 0.0.0.0:8899
data_dir = /var/lib/3rmonitor
public_url = https://monitor.example.com/
dist_dir = /opt/3rmonitor/dist
trust_proxy = auto
tls_cert =
tls_key =
tls_listen =
update_url =| Clave | Significado |
|---|---|
listen | Dirección y puerto del panel. 127.0.0.1:8899 = accesible solo mediante un proxy inverso en el mismo servidor. |
data_dir | Dónde se guardan la base de datos y la base de datos de IP por país |
public_url | URL pública del panel. Después del primer inicio se administra en Configuración → General; este valor es solo el inicial. |
dist_dir | Paquetes del agente que los agentes descargan desde el servidor principal |
trust_proxy | auto: toma la IP real del cliente en las solicitudes reenviadas por este equipo, la red local o Cloudflare. true o false para forzarlo. |
tls_cert, tls_key | Certificado y clave privada (PEM) para servir HTTPS directamente. Consulte HTTPS, opción 2. |
tls_listen | Puerto HTTPS, por ejemplo 0.0.0.0:8443; listen sigue en HTTP. Vacío con un certificado: el propio listen pasa a HTTPS. |
update_url | Dónde buscar versiones nuevas. Vacío = https://3rsoft.com.pa/api/releases/latest. |
El archivo pertenece a root y el grupo 3rmonitor puede leerlo (permisos 640).
agent.conf
/etc/3rmonitor/agent.conf. Contiene el token, así que solo root y el agente pueden leerlo: propietario root, grupo 3rmonitor-agent, permisos 640 (600 en los agentes anteriores a la 1.1.0).
master_url = https://monitor.example.com
token = …
insecure = false
auto_update = true
mysql_defaults_file =
access_logs =
public_ip = auto
project_dirs =
firewall = auto
ai = on
sandbox_networks_max = 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, 100.64.0.0/10, fc00::/7
protected_ips =
ai_auto_per_day = 20Las cuatro últimas claves no están en el archivo hasta que usted las configure; los valores que se muestran son los predeterminados.
| Clave | Significado |
|---|---|
master_url | La dirección del servidor principal. Cámbiela, o use 3rmonitor bind, cuando el servidor principal cambie de lugar. |
token | El token de este servidor. Lo escribe el instalador o 3rmonitor bind. |
insecure | true si el servidor principal usa un certificado autofirmado |
auto_update | true: se actualiza automáticamente a la versión del servidor principal |
mysql_defaults_file | Archivo de credenciales para leer el estado de MySQL / MariaDB. En Debian se usa /etc/mysql/debian.cnf automáticamente. |
access_logs | Ubicación de los registros de acceso, separadas por comas, se admiten comodines (por ejemplo /var/log/nginx/*.log). Vacío = buscar en las ubicaciones habituales; off = sin estadísticas de solicitudes. |
public_ip | auto = interfaces de red → metadatos de la nube → consulta externa (1.1.1.1); off; o una IP fija |
project_dirs | Directorios adicionales donde la comprobación de vulnerabilidades busca archivos de bloqueo, separados por comas. Los habituales se encuentran solos. |
firewall | auto = aplicar las listas de bloqueo / permitidos del panel una vez activadas en la configuración del servidor; off = nunca (lo escribe 3rmonitor firewall off) |
ai | Qué puede ejecutar la IA del panel en este servidor: on (predeterminado), read = solo diagnósticos de solo lectura y en sandbox, off = nada. Lo escribe 3rmonitor ai on / read / off. Consulte Guardia de IA. |
sandbox_networks_max | Las redes a las que el sandbox de IA podrá conectarse desde este servidor, como máximo, separadas por comas. Las redes permitidas en Servidores → Configuración solo funcionan dentro de estas. Predeterminado: las redes privadas. |
protected_ips | IP o rangos que el ayudante de este servidor nunca bloquea, separados por comas, además del servidor principal y de las direcciones protegidas del panel |
ai_auto_per_day | Cuántas reparaciones aprobadas solo por la IA revisora (sin un administrador) ejecuta este servidor en 24 horas. Por defecto 20; 0 = sin límite en el servidor (sigue valiendo Reparaciones automáticas por día del panel). La misma reparación además se ejecuta como máximo 3 veces por hora. Los cambios se aplican enseguida, sin reiniciar nada. |
Los agentes no guardan datos, aparte de este archivo y de las claves en las que confía el servidor para aprobar operaciones de IA, en /var/lib/3rmonitor-helper (se administran con 3rmonitor approvers).
Ejemplo: credenciales de MySQL para el agente
El agente lee el estado de MySQL / MariaDB con el cliente mysql (que debe estar instalado), que su ayudante ejecuta como root. Esto funciona sin configuración en Debian y Ubuntu, y en cualquier sistema donde root pueda iniciar sesión a través del socket local. En otros casos, la sección Software del servidor muestra "No se puede iniciar sesión en la base de datos para leer su estado". Para solucionarlo, cree un usuario de base de datos sin ningún privilegio:
CREATE USER 'monitor'@'localhost' IDENTIFIED BY 'SU_CONTRASEÑA';Guarde sus credenciales en /etc/3rmonitor/mysql.cnf:
[client]
user = monitor
password = SU_CONTRASEÑAsudo chmod 600 /etc/3rmonitor/mysql.cnfDespués configure mysql_defaults_file = /etc/3rmonitor/mysql.cnf en agent.conf y reinicie el agente. Leer el estado y la versión no requiere privilegios sobre ninguna base de datos.