Configuración
Synco utiliza variables de entorno para la gestión de toda su configuración, alineándose con los principios de las Aplicaciones de Doce Factores (Twelve-Factor App). Esto garantiza que las credenciales sensibles y los ajustes específicos del despliegue nunca estén codificados de forma rígida (hardcoded) en la aplicación.
Seguridad y Autenticación
Para asegurar el panel de administración y codificar correctamente los tokens de sesión, se recomienda encarecidamente configurar las siguientes credenciales en lugar de depender de los valores por defecto del sistema.
| Variable | Requisito | Descripción |
|---|---|---|
ADMIN_USERNAME | Recomendado | El nombre de usuario utilizado para acceder al panel. Si se omite, el valor por defecto es admin. |
ADMIN_PASSWORD | Recomendado | La contraseña utilizada para acceder al panel. Si se omite, el valor por defecto es admin. |
JWT_SECRET | Recomendado | Una cadena segura y aleatoria utilizada para firmar los JSON Web Tokens. Si se omite, el sistema utilizará un secreto inseguro por defecto, lo cual no es apto para producción. |
Alertas (Opcional)
Las siguientes variables pueden configurarse para establecer el flujo de alertas por Telegram. Si se omiten, Synco funcionará normalmente sin enviar notificaciones externas.
| Variable | Requisito | Descripción |
|---|---|---|
TELEGRAM_TOKEN | Opcional | El token de autorización de la API proporcionado por BotFather al crear el bot. Este token autentica a Synco con la API de Telegram. |
TELEGRAM_CHAT_ID | Opcional | El identificador numérico del chat o canal de Telegram donde se enviarán las notificaciones. |
Obtención de Credenciales
Token de Telegram
- Abra Telegram y busque a
@BotFather. - Envíe el comando
/newboty siga las instrucciones para nombrar a su bot. - Una vez creado exitosamente, BotFather le proporcionará un Token de la API HTTP (ej.
123456789:ABCdefGHIjklmNOPQrsTUVwxyZ). Utilice esta cadena para la variableTELEGRAM_TOKEN.
ID del Chat de Telegram
- Invite a su bot recién creado al grupo o canal de destino deseado, o inicie un mensaje directo con él.
- Envíe un mensaje de prueba al chat.
- Utilice una herramienta API o un bot público como
@userinfoboto@RawDataBotpara extraer elchat_idasociado a esa conversación. Utilice este valor numérico (que puede incluir un signo negativo en caso de grupos) para la variableTELEGRAM_CHAT_ID.
Una vez inyectadas las variables correctas durante la ejecución del comando Docker, Synco inicializará automáticamente la secuencia de monitoreo.