Configuración y parámetros de ejecución

Opciones de línea de comandos

Opción	Descripción
-c	Directorio de configuración; también se puede definir con la variable de entorno GATELY_CONFIG_DIR
-listen	Sobrescribe la dirección de escucha de la interfaz de administración, p. ej. :16680
-apply	Directorio de configuración declarativa; también se puede definir con la variable de entorno GATELY_APPLY_DIR. Consulta más abajo
-version	Muestra la información de versión

Variable de entorno	Descripción
GATELY_INITIAL_PASSWORD	Contraseña inicial del administrador en el primer arranque (8 caracteres como mínimo); si no se define, se usa la contraseña predeterminada gately.cn. No tiene efecto si la cuenta ya existe

Directorio de configuración

Toda la configuración vive en el directorio de configuración, con un archivo de texto plano <nombre>.json por módulo, escrito de forma atómica con permisos 0600. Esto te permite:

• Inspeccionarlo con cualquier editor de texto;
• Guardar el directorio en git, auditar cada cambio con diferencias y revertir en cualquier momento;
• Hacer copias de seguridad simplemente copiando el directorio.

Nota

ssl.json contiene claves privadas de certificados. Antes de subirlo al control de versiones, asegúrate de que el repositorio sea privado o añade el archivo a tu lista de ignorados.

Configuración declarativa

Con -apply <directorio>, en cada arranque los archivos <nombre>.json de ese directorio se copian sobre el directorio de configuración; los archivos con contenido idéntico no se reescriben. Es útil para distribuir la configuración desde un repositorio git, un ConfigMap de Kubernetes o un script de despliegue.

• Antes de escribir se comprueba que cada archivo sea JSON válido; si alguno no lo es, Gately se niega a arrancar;
• account.json y tokens.json no se pueden sobrescribir: la cuenta y los tokens solo se gestionan desde la interfaz de administración;
• El contenido sobrescrito se conserva en el historial de configuración y se puede revertir en cualquier momento.

Directorio de programas externos

Los módulos de Tailscale, frp y cloudflared supervisan los programas oficiales externos. Gately busca cada ejecutable en este orden:

1. La ruta definida en los ajustes del módulo;
2. PATH;
3. El subdirectorio bin/ del directorio de configuración.

En despliegues con Docker, coloca los binarios en el directorio de configuración montado, por ejemplo ./gately-data/bin/frpc. Tailscale necesita tanto tailscale como tailscaled. Consulta Tailscale / frp / cloudflared para más detalles.

Registros de ejecución

Los registros de ejecución del sistema y de cada módulo se escriben por defecto en logs/ dentro del directorio de configuración, así que siguen disponibles en la página de registros del sistema y en la de cada módulo después de reiniciar o actualizar:

• Un archivo JSON Lines por origen: logs/<ID del módulo>.log, y los del sistema en logs/gately.log. Al arrancar se restauran desde el archivo las entradas más recientes, hasta «Líneas de registro conservadas»;
• Las entradas nuevas se escriben por lotes con un retraso máximo de 1 segundo. Cuando un archivo supera el límite (2 MB por defecto) se rota a .1 y solo se conserva ese archivo anterior, de modo que cada origen ocupa como máximo el doble del límite;
• En Ajustes → Red y ejecución → Parámetros de ejecución puedes desactivar «Guardar registros en disco» o cambiar «Límite del archivo de registro», con efecto inmediato. Si se desactiva, los registros solo se guardan en memoria y se borran al reiniciar;
• Borrar los registros de un módulo en la interfaz también elimina sus archivos;
• Las copias de seguridad de la configuración no incluyen logs/ ni el registro de auditoría audit.log.

Copia de seguridad y restauración

«Ajustes» ofrece la copia de seguridad y la restauración de la configuración, y es también el punto de entrada para importar configuraciones de Lucky.