Configuration
bext-tui est configuré principalement via des indicateurs CLI. Tout ce que vous voudriez remplacer par session y réside. Le fichier de configuration facultatif ( ~/.config/bext-tui/config.toml, prévu) est destiné aux préférences qui persistent au fil des sessions.
Indicateurs CLI#
bext-tui [OPTIONS]
| Drapeau | Défaut | Description |
|---|---|---|
--host <HOST> |
127.0.0.1 |
Hôte de l'API d'administration |
--port <PORT> |
4000 |
Port API d'administration |
--tls |
désactivé | Utiliser HTTPS |
--token <TOKEN> |
de l'environnement | Jeton du porteur de l'API d'administration |
--insecure |
désactivé | Ignorer la vérification du certificat TLS (DANGEREUX — développeur/auto-signé uniquement). Sans cet indicateur, les certificats invalides sont rejetés. |
--local |
désactivé | Mode local : lit l'état du système de fichiers avec l'API |
--instances <PATH> |
aucun | Chemin d'accès à un fichier de configuration multi-instance |
--mouse |
désactivé | Activer la prise en charge de la souris (cliquer sur les onglets, faire défiler les listes) |
--poll-ms <MS> |
2000 |
Intervalle d'interrogation rapide en millisecondes |
--config <PATH> |
aucun | Chemin d'accès à bext.config.toml (mode local) |
--help |
Utilisation de l'impression | |
--version |
Version imprimable |
Note de sécurité :
--insecuredésactive entièrement la vérification de la chaîne TLS. N'importe qui sur le chemin réseau peut intercepter l'API d'administration, y compris le jeton du porteur. Utilisez-le uniquement pour les certificats de développement auto-signés sur un réseau de confiance. Combiné avec--tls, il imprime un avertissement au démarrage.
Variables d'environnement#
| Variable | Drapeau équivalent | Remarques |
|---|---|---|
BEXT_TUI_HOST |
--host |
|
BEXT_TUI_PORT |
--port |
|
BEXT_TUI_TLS |
--tls |
Vérité = activé |
BEXT_ADMIN_TOKEN |
--token |
Même variable d'environnement utilisée par la CLI |
BEXT_TUI_LOG |
— | Filtre tracing (par exemple BEXT_TUI_LOG=debug) |
Les indicateurs CLI l'emportent toujours sur les variables d'environnement.
Niveaux de sondage#
La TUI interroge l'API d'administration sur trois niveaux : différents points de terminaison ont des besoins de fraîcheur différents :
| Étage | Intervalle par défaut | Points de terminaison |
|---|---|---|
| Rapide | 2 s ( --poll-ms ) |
/overview, /requests, /cache |
| Moyen | 10 s (5 × rapide) | /workers, /proxy, /waf |
| Lent | 60 s (30 × rapide) | /sites, /certs, /deployments, /license, /config |
La réduction de --poll-ms rend le tableau de bord plus vif mais augmente la charge sur le serveur bext. La valeur par défaut de 2 s est une bonne base de référence. Pour les très petites instances, vous pouvez descendre à 500 ms ; pour les flottes de production, 5 s suffisent.
Configuration multi-instance#
bext-tui --instances ~/.config/bext-tui/instances.toml lit un fichier TOML décrivant chaque serveur que vous souhaitez surveiller :
# ~/.config/bext-tui/instances.toml
[[instance]]
name = "activ-2"
host = "activ-2.activcommunication.ch"
port = 443
tls = true
token = "$BEXT_ADMIN_TOKEN_ACTIV2"
[[instance]]
name = "vps-staging"
host = "staging.example.com"
port = 4000
token = "$BEXT_ADMIN_TOKEN_STAGING"
[[instance]]
name = "dev"
host = "127.0.0.1"
port = 4000
token peut être une chaîne littérale ou une référence $ENV_VAR (développée au démarrage).
En mode multi-instance, la vue Tableau de bord regroupe toutes les instances. Utilisez :connect <name> dans la palette de commandes pour explorer un serveur.
Enregistrement#
bext-tui écrit ses propres journaux de diagnostic dans stderr, et non dans le tampon d'écran alternatif (afin qu'ils n'interfèrent pas avec la TUI). Exécutez avec un filtre pour les voir :
BEXT_TUI_LOG=debug bext-tui --host ... 2> bext-tui.log
Le filtre accepte la syntaxe standard tracing-subscriber : info, debug, bext_tui=trace,reqwest=warn, etc.
Thématisation#
Les couleurs sont définies dans crates/bext-tui/src/theme.rs. Ils utilisent la palette standard du terminal de 16 couleurs ainsi que quelques sélections RVB, afin de respecter la palette de couleurs de votre terminal. La re-thème est une recompilation - il n'y a pas encore de configuration d'exécution pour les couleurs.
Les mappages sémantiques sont :
| Style | Utilisé pour |
|---|---|
success (vert) |
UP, sain, 2xx, HIT, certificats valides > 30j |
warn (jaune) |
dégradé, 4xx, MISS, certificats 10–30d, > 60 % d'utilité |
error (rouge gras) |
vers le bas, 5xx, expiré, > 85 % d'utilisation |
info (bleu) |
informatif, 3xx, accents de la barre d'état |
dim (gris foncé) |
texte secondaire, horodatages, astuces |
Configuration future#
Les préférences persistantes (largeurs de colonnes, filtres par défaut, remplacements de thème) résideront dans ~/.config/bext-tui/config.toml. Ce fichier n'est pas encore lu – suivez [issue #N] pour connaître la progression.
--insecure désactive entièrement la vérification de la chaîne TLS et expose le jeton d'administrateur à toute personne se trouvant sur le chemin réseau. Utilisez-le uniquement pour les certificats de développement auto-signés sur un réseau de confiance.
En rapport#
- Présentation de TUI — résumé des fonctionnalités et comparaison avec la CLI et son compagnon
- Modes de connexion TUI —
--local,--instanceset utilisation des indicateurs à distance - Installation TUI — où les points de terminaison de l'API d'administration sont répertoriés
- Configuration → Variables d'environnement – vars d'environnement côté serveur, y compris
BEXT_ADMIN_TOKEN