┌─────────────────────────────────────┐
│          Couche Présentation        │
│         (lib/view/page/)            │
│  - Pages, Widgets, Contrôleurs      │
└─────────────────────────────────────┘
                 ↓
┌─────────────────────────────────────┐
│         Couche Logique Métier       │
│      (lib/data/provider/)           │
│  - Providers Riverpod               │
│  - Gestion de l'état                │
└─────────────────────────────────────┘
                 ↓
┌─────────────────────────────────────┐
│           Couche Données            │
│      (lib/data/model/, store/)      │
│  - Modèles, Stockage, Services      │
└─────────────────────────────────────┘

Action Utilisateur → Widget → Provider → Service/Store → Mise à jour Modèle → Reconstruction UI

Exécuter en mode développement

flutter run
Exécuter sur un appareil spécifique

flutter run -d <id-appareil>

Construire pour une plateforme spécifique

dart run fl_build -p <plateforme>
Plateformes disponibles :

- ios

- android

- macos

- linux

- windows

dart run fl_build -p ios

dart run fl_build -p android

dart run fl_build -p macos

dart run fl_build -p linux

dart run fl_build -p windows

flutter clean
dart run build_runner build --delete-conflicting-outputs
flutter pub get

flutter pub upgrade

Générer tout le code

dart run build_runner build --delete-conflicting-outputs
Nettoyer le cache de génération

dart run build_runner clean
Puis régénérer

dart run build_runner build --delete-conflicting-outputs

@freezed
class ServerState with _$ServerState {
  const factory ServerState.connected() = Connected;
  const factory ServerState.disconnected() = Disconnected;
  const factory ServerState.error(String message) = Error;
}

@JsonSerializable()
class Server {
  final String id;
  final String name;
  final String host;
  Server({required this.id, required this.name, required this.host});
  factory Server.fromJson(Map<String, dynamic> json) =>
      _$ServerFromJson(json);
  Map<String, dynamic> toJson() => _$ServerToJson(this);
}

@riverpod
class MyNotifier extends _$MyNotifier {
  @override
  int build() => 0;
}

@HiveType(typeId: 0)
class ServerModel {
  @HiveField(0)
  final String id;
}

flutter gen-l10n

@riverpod
class Settings extends _$Settings {
  @override
  SettingsModel build() {
    return SettingsModel.defaults();
  }
  void update(SettingsModel newSettings) {
    state = newSettings;
  }
}

@riverpod
class ServerStatus extends _$ServerStatus {
  @override
  Future<StatusModel> build(Server server) async {
    return fetchStatus(server);
  }
  Future<void> refresh() async {
    state = const AsyncValue.loading();
    state = await AsyncValue.guard(() => fetchStatus(server));
  }
}

@riverpod
Stream<CpuUsage> cpuUsage(CpuUsageRef ref, Server server) {
  return cpuService.monitor(server);
}

state.when(
  data: (data) => DataWidget(data),
  loading: () => LoadingWidget(),
  error: (error, stack) => ErrorWidget(error),
)

@riverpod
List<Container> containers(ContainersRef ref, Server server) {
  return containerService.list(server);
}

@Riverpod(keepAlive: false)
class TempState extends _$TempState {
  // ...
}

class ServerWidget extends ConsumerWidget {
  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final status = ref.watch(serverStatusProvider(server));
    return status.when(...);
  }
}

ref.read(settingsProvider.notifier).update(newSettings);

lib/
├── core/              # Utilitaires de base et extensions
├── data/              # Couche de données
│   ├── model/         # Modèles de données par fonctionnalité
│   ├── provider/      # Providers Riverpod
│   └── store/         # Stockage local (Hive)
├── view/              # Couche UI
│   ├── page/          # Pages principales
│   └── widget/        # Widgets réutilisables
├── generated/         # Localisation générée
├── l10n/              # Fichiers ARB de localisation
└── hive/              # Adaptateurs Hive

Exécuter tous les tests

flutter test
Exécuter un fichier de test spécifique

flutter test test/battery_test.dart
Exécuter avec couverture de code

flutter test --coverage

test('devrait calculer le pourcentage du CPU', () {
  final cpu = CpuModel(usage: 75.0);
  expect(cpu.usagePercentage, '75%');
});

testWidgets('ServerCard affiche le nom du serveur', (tester) async {
  await tester.pumpWidget(
    ProviderScope(
      child: MaterialApp(
        home: ServerCard(server: testServer),
      ),
    ),
  );
  expect(find.text('Test Server'), findsOneWidget);
});

test('serverStatusProvider retourne le statut', () async {
  final container = ProviderContainer();
  final status = await container.read(serverStatusProvider(testServer).future);
  expect(status, isA<StatusModel>());
});

Bonnes pratiques  Copy Chapter
1. Arrange-Act-Assert : Structurer les tests clairement
2. Noms descriptifs : Les noms de tests doivent décrire le comportement
3. Une assertion par test : Garder les tests focalisés
4. Mocker les dépendances externes : Ne pas dépendre de serveurs réels
5. Tester les cas limites : Listes vides, valeurs nulles, etc.
---
Src/Content/Docs/Fr/Advanced/Bulk Import  Copy Section
---
title: Importation massive de serveurs
description: Importer plusieurs serveurs à partir d'un fichier JSON
---
Importez plusieurs configurations de serveur en une seule fois à l'aide d'un fichier JSON.
Format JSON  Copy Chapter
:::danger[Avertissement de sécurité]
Ne stockez jamais de mots de passe en clair dans des fichiers ! Cet exemple JSON montre un champ de mot de passe à des fins de démonstration uniquement, mais vous devriez :
- Préférer les clés SSH (pubKeyId) au lieu de pwd - elles sont plus sûres
- Utiliser des gestionnaires de mots de passe ou des variables d'environnement si vous devez utiliser des mots de passe
- Supprimer le fichier immédiatement après l'importation - ne laissez pas traîner des identifiants
- Ajouter au .gitignore - ne validez jamais de fichiers d'identifiants dans le contrôle de version
:::

Champs  Copy Chapter
| Champ | Requis | Description |
|-------|----------|-------------|
| name | Oui | Nom d'affichage |
| ip | Oui | Domaine ou adresse IP |
| port | Oui | Port SSH (généralement 22) |
| user | Oui | Nom d'utilisateur SSH |
| pwd | Non | Mot de passe (à éviter - utilisez plutôt des clés SSH) |
| pubKeyId | Non | ID de clé privée (à partir des clés privées - recommandé) |
| tags | Non | Tags d'organisation |
| autoConnect | Non | Connexion automatique au démarrage |
| id | Non | ID serveur stable ; les valeurs absentes ou vides sont générées à l'import |
Étapes d'importation  Copy Chapter
1. Créer un fichier JSON avec les configurations de serveur
2. Paramètres → Sauvegarde → Importation massive de serveurs
3. Sélectionnez votre fichier JSON
4. Confirmez l'importation
Exemple  Copy Chapter

Conseils  Copy Chapter
- Utilisez des clés SSH au lieu de mots de passe lorsque cela est possible
- Testez la connexion après l'importation
- Organisez avec des tags pour une gestion plus facile
- Supprimez le fichier JSON après l'importation
- Ne validez jamais de fichiers JSON contenant des identifiants dans le contrôle de version
---
Src/Content/Docs/Fr/Advanced/Custom Commands  Copy Section
---
title: Commandes personnalisées
description: Afficher la sortie des commandes personnalisées sur la page du serveur
---
Ajoutez des commandes shell personnalisées pour afficher leur sortie sur la page de détails du serveur.
Configuration  Copy Chapter
1. Paramètres du serveur → Commandes personnalisées
2. Entrez les commandes au format JSON
Format de base  Copy Chapter

Exemple :

Visualisation des résultats  Copy Chapter
Après la configuration, les commandes personnalisées apparaissent sur la page de détails du serveur et s'actualisent automatiquement.
Noms de commandes spéciaux  Copy Chapter
server_card_top_right  Copy Section
Affichage sur la carte du serveur de la page d'accueil (coin supérieur droit) :

Conseils  Copy Chapter
Utilisez des chemins absolus :

Commandes avec pipe :

Formater la sortie :

Gardez les commandes rapides : Moins de 5 secondes pour une meilleure expérience.
Limiter la sortie :

Sécurité  Copy Chapter
Les commandes s'exécutent avec les permissions de l'utilisateur SSH. Évitez les commandes qui modifient l'état du système.
---
Src/Content/Docs/Fr/Advanced/Custom Logo  Copy Section
---
title: Logo de serveur personnalisé
description: Utiliser des images personnalisées pour les cartes de serveur
---
Affichez des logos personnalisés sur les cartes de serveur à l'aide d'URL d'images.
Configuration  Copy Chapter
1. Paramètres du serveur → Logo personnalisé
2. Entrez l'URL de l'image
Espaces réservés d'URL  Copy Chapter
{DIST} - Distribution Linux  Copy Section
Remplacé automatiquement par la distribution détectée :

Devient : debian.png, ubuntu.png, arch.png, etc.
{BRIGHT} - Thème  Copy Section
Remplacé automatiquement par le thème actuel :

Devient : light.png ou dark.png
Combiner les deux  Copy Section

Devient : debian-light.png, ubuntu-dark.png, etc.
Conseils  Copy Chapter
- Utilisez les formats PNG ou SVG
- Taille recommandée : 64x64 à 128x128 pixels
- Utilisez des URL HTTPS
- Gardez des tailles de fichiers réduites
Distributions supportées  Copy Chapter
debian, ubuntu, centos, fedora, opensuse, kali, alpine, arch, rocky, deepin, armbian, wrt
Liste complète : dist.dart
---
Src/Content/Docs/Fr/Advanced/Json Settings  Copy Section
---
title: Paramètres cachés (JSON)
description: Accéder aux paramètres avancés via l'éditeur JSON
---
Certains paramètres sont masqués de l'interface utilisateur mais accessibles via l'éditeur JSON.
Accès  Copy Chapter
Appuyez longuement sur Paramètres dans le menu latéral pour ouvrir l'éditeur JSON.
Paramètres cachés courants  Copy Chapter
timeOut  Copy Section
Délai d'attente de connexion en secondes.

Type : entier | Par défaut : 5 | Plage : 1-60
recordHistory  Copy Section
Enregistrer l'historique (chemins SFTP, etc.).

Type : booléen | Par défaut : true
textFactor  Copy Section
Facteur de mise à l'échelle du texte.

Type : double | Par défaut : 1.0 | Plage : 0.8-1.5
Trouver plus de paramètres  Copy Chapter
Tous les paramètres sont définis dans setting.dart.
Recherchez :

⚠️ Important  Copy Chapter
Avant d'éditer :
- Créer une sauvegarde - De mauvais paramètres peuvent empêcher l'ouverture de l'application
- Éditer avec soin - Le JSON doit être valide
Récupération  Copy Chapter
Si l'application ne s'ouvre plus après l'édition :
1. Effacer les données de l'application (dernier recours)
2. Réinstaller l'application
3. Restaurer à partir d'une sauvegarde
---
Src/Content/Docs/Fr/Advanced/Troubleshooting  Copy Section
---
title: Problèmes courants
description: Solutions aux problèmes fréquents
---
Problèmes de connexion  Copy Chapter
SSH ne se connecte pas  Copy Section
Symptômes : Délai d'attente (timeout), connexion refusée, échec d'authentification
Solutions :
1. Vérifier le type de serveur : Seuls les systèmes de type Unix sont supportés (Linux, macOS, Android/Termux)
2. Tester manuellement : ssh utilisateur@serveur -p port
3. Vérifier le pare-feu : Le port 22 doit être ouvert
4. Vérifier les identifiants : Nom d'utilisateur et mot de passe/clé corrects
Déconnexions fréquentes  Copy Section
Symptômes : Le terminal se déconnecte après une période d'inactivité
Solutions :
1. Keep-alive du serveur :

2. Désactiver l'optimisation de la batterie :
   - MIUI : Batterie → "Pas de restrictions"
   - Android : Paramètres → Applications → Désactiver l'optimisation
   - iOS : Activer l'actualisation en arrière-plan
Problèmes de saisie  Copy Chapter
Impossible de taper certains caractères  Copy Section
Solution : Paramètres → Type de clavier → Passer à visiblePassword
Note : La saisie CJK (Chinois, Japonais, Coréen) peut ne pas fonctionner après ce changement.
Problèmes de l'application  Copy Chapter
L'application plante au démarrage  Copy Section
Symptômes : L'application ne s'ouvre pas, écran noir
Causes : Paramètres corrompus, particulièrement via l'éditeur JSON
Solutions :
1. Effacer les données de l'application :
   - Android : Paramètres → Applications → ServerBox → Effacer les données
   - iOS : Supprimer et réinstaller
2. Restaurer une sauvegarde : Importer une sauvegarde créée avant de modifier les paramètres
Problèmes de sauvegarde/restauration  Copy Section
La sauvegarde ne fonctionne pas :
- Vérifier l'espace de stockage
- Vérifier que l'application a les permissions de stockage
- Essayer un autre emplacement
La restauration échoue :
- Vérifier l'intégrité du fichier de sauvegarde
- Vérifier la compatibilité de la version de l'application
Problèmes de Widget  Copy Chapter
Le widget ne se met pas à jour  Copy Section
iOS :
- Attendre jusqu'à 30 minutes pour le rafraîchissement automatique
- Supprimer et rajouter le widget
- Vérifier que l'URL se termine par /status
Android :
- Appuyer sur le widget pour forcer le rafraîchissement
- Vérifier que l'ID du widget correspond à la configuration dans les paramètres de l'application
watchOS :
- Redémarrer l'application sur la montre
- Attendre quelques minutes après un changement de configuration
- Vérifier le format de l'URL
Le widget affiche une erreur  Copy Section
- Vérifier que ServerBox Monitor fonctionne sur le serveur
- Tester l'URL dans un navigateur
- Vérifier les identifiants d'authentification
Problèmes de performance  Copy Chapter
L'application est lente  Copy Section
Solutions :
- Réduire la fréquence de rafraîchissement dans les paramètres
- Vérifier la vitesse du réseau
- Désactiver les serveurs inutilisés
Utilisation élevée de la batterie  Copy Section
Solutions :
- Augmenter les intervalles de rafraîchissement
- Désactiver le rafraîchissement en arrière-plan
- Fermer les sessions SSH inutilisées
Obtenir de l'aide  Copy Chapter
Si les problèmes persistent :
1. Rechercher dans les Issues GitHub : https://github.com/lollipopkit/flutter_server_box/issues
2. Créer une nouvelle Issue : Inclure la version de l'application, la plateforme et les étapes pour reproduire le problème
3. Consulter le Wiki : Cette documentation et le Wiki GitHub
---
Src/Content/Docs/Fr/Advanced/Widgets  Copy Section
---
title: Widgets de l'écran d'accueil
description: Ajoutez des widgets d'état du serveur à votre écran d'accueil
---
Nécessite l'installation de ServerBox Monitor sur vos serveurs.
Prérequis  Copy Chapter
Installez d'abord ServerBox Monitor sur votre serveur. Consultez le Wiki de ServerBox Monitor pour les instructions de configuration.
Après l'installation, votre serveur doit avoir :
- Un point de terminaison HTTP/HTTPS
- Un point de terminaison API /status
- Une authentification facultative
Format de l'URL  Copy Chapter

Doit se terminer par /status.
Widget iOS  Copy Chapter
Configuration  Copy Section
1. Appuyez longuement sur l'écran d'accueil → Appuyez sur +
2. Recherchez "ServerBox"
3. Choisissez la taille du widget
4. Appuyez longuement sur le widget → Modifier le widget
5. Entrez l'URL se terminant par /status
Notes  Copy Section
- Doit utiliser HTTPS (sauf pour les adresses IP locales)
- Taux de rafraîchissement maximal : 30 minutes (limite iOS)
- Ajoutez plusieurs widgets pour plusieurs serveurs
Widget Android  Copy Chapter
Configuration  Copy Section
1. Appuyez longuement sur l'écran d'accueil → Widgets
2. Trouvez "ServerBox" → Ajoutez à l'écran d'accueil
3. Notez le numéro d'ID du widget affiché
4. Ouvrez l'application ServerBox → Paramètres
5. Appuyez sur Configurer le lien du widget d'accueil
6. Ajoutez l'entrée : Widget ID = URL d'état
Exemple :
- Clé : 17
- Valeur : https://mon-serveur.com/status
7. Appuyez sur le widget sur l'écran d'accueil pour le rafraîchir
Widget watchOS  Copy Chapter
Configuration  Copy Section
1. Ouvrez l'application iPhone → Paramètres
2. Paramètres iOS → Application Watch
3. Appuyez sur Ajouter une URL
4. Entrez l'URL se terminant par /status
5. Attendez que l'application de la montre se synchronise
Notes  Copy Section
- Essayez de redémarrer l'application de la montre si elle ne se met pas à jour
- Vérifiez que le téléphone et la montre sont connectés
Dépannage  Copy Chapter
Le widget ne se met pas à jour  Copy Section
iOS : Attendez jusqu'à 30 minutes, puis supprimez et rajoutez-le.
Android : Appuyez sur le widget pour forcer le rafraîchissement, vérifiez l'ID dans les paramètres.
watchOS : Redémarrez l'application de la montre, attendez quelques minutes.
Le widget affiche une erreur  Copy Section
- Vérifiez que ServerBox Monitor fonctionne
- Testez l'URL dans un navigateur
- Vérifiez que l'URL se termine par /status
Sécurité  Copy Chapter
- Utilisez toujours HTTPS si possible
- Adresses IP locales uniquement sur les réseaux de confiance
---
Src/Content/Docs/Fr/Platforms/Desktop  Copy Section
---
title: Fonctionnalités de bureau
description: Fonctionnalités spécifiques à macOS, Linux et Windows
---
Server Box sur les plateformes de bureau offre des fonctionnalités de productivité supplémentaires.
macOS  Copy Chapter
Intégration de la barre de menus  Copy Section
- État rapide du serveur dans la barre de menus
- Accès au serveur en un clic
- Mode compact pour une distraction minimale
- Style de barre de menus natif macOS
Persistance de l'état des fenêtres  Copy Section
- Mémorise la position et la taille de la fenêtre
- Restaurer la session précédente au lancement
- Prise en charge de plusieurs écrans
Fonctionnalités natives  Copy Section
- Barre de titre : Option de barre de titre personnalisée ou système
- Mode plein écran : Surveillance dédiée du serveur
- Raccourcis clavier : Raccourcis natifs macOS
- Touch Bar (appareils compatibles) : Actions rapides
Linux  Copy Chapter
Intégration native  Copy Section
- Prise en charge de la zone de notification (systray)
- Intégration des notifications de bureau
- Intégration du sélecteur de fichiers
Gestion des fenêtres  Copy Section
- Prise en charge de X11 et Wayland
- Compatible avec les gestionnaires de fenêtres à tuiles (tiling)
- Option de décorations de fenêtre personnalisées
Windows  Copy Chapter
Fonctionnalités  Copy Section
- Intégration de la zone de notification (systray)
- Actions rapides via la Jump List
- Contrôles de fenêtre natifs
- Option de démarrage automatique au boot
Fonctionnalités de bureau multiplateformes  Copy Chapter
Raccourcis clavier  Copy Section
- Cmd/Ctrl + N : Nouveau serveur
- Cmd/Ctrl + W : Fermer l'onglet
- Cmd/Ctrl + T : Nouvel onglet de terminal
- Cmd/Ctrl + , : Paramètres
Thèmes  Copy Section
- Thème clair
- Thème sombre
- Thème AMOLED (noir pur)
- Thème système (suit l'OS)
Fenêtres multiples  Copy Section
- Ouvrir plusieurs serveurs dans des fenêtres séparées
- Faire glisser des onglets vers une nouvelle fenêtre
- Comparer les statistiques des serveurs côte à côte
Avantages par rapport au mobile  Copy Section
- Écran plus grand pour la surveillance
- Clavier complet pour le terminal
- Opérations de fichiers plus rapides
- Meilleur multitâche
---
Src/Content/Docs/Fr/Platforms/Mobile  Copy Section
---
title: Fonctionnalités mobiles
description: Fonctionnalités spécifiques à iOS et Android
---
Server Box offre plusieurs fonctionnalités spécifiques aux mobiles pour les appareils iOS et Android.
Authentification biométrique  Copy Chapter
Sécurisez vos serveurs avec l'authentification biométrique :
- iOS : Face ID ou Touch ID
- Android : Authentification par empreinte digitale
Activez-la dans Paramètres > Sécurité > Authentification biométrique.
Widgets de l'écran d'accueil  Copy Chapter
Ajoutez des widgets d'état du serveur à votre écran d'accueil pour une surveillance rapide.
iOS  Copy Section
- Appui long sur l'écran d'accueil
- Appuyez sur + pour ajouter un widget
- Recherchez "Server Box"
- Choisissez la taille du widget :
  - Petit : État d'un seul serveur
  - Moyen : Plusieurs serveurs
  - Grand : Informations détaillées
Android  Copy Section
- Appui long sur l'écran d'accueil
- Appuyez sur Widgets
- Trouvez "Server Box"
- Sélectionnez le type de widget
Fonctionnement en arrière-plan  Copy Chapter
Android  Copy Section
Maintenir les connexions actives en arrière-plan :
- Activer dans Paramètres > Avancé > Fonctionnement en arrière-plan
- Nécessite l'exclusion de l'optimisation de la batterie
- Notifications persistantes pour les connexions actives
iOS  Copy Section
Des limitations en arrière-plan s'appliquent :
- Les connexions peuvent se mettre en pause en arrière-plan
- Reconnexion rapide au retour dans l'application
- Prise en charge de l'actualisation en arrière-plan
Notifications Push  Copy Chapter
Recevez des notifications pour :
- Alertes de serveur hors ligne
- Avertissements d'utilisation élevée des ressources
- Alertes de fin de tâche
Configurez dans Paramètres > Notifications.
Fonctionnalités de l'interface mobile  Copy Chapter
- Tirer pour rafraîchir : Mettre à jour l'état du serveur
- Actions de glissement : Opérations rapides sur le serveur
- Mode paysage : Meilleure expérience du terminal
- Clavier virtuel : Raccourcis pour le terminal
Intégration de fichiers  Copy Chapter
- Application Fichiers (iOS) : Accès direct SFTP depuis Fichiers
- Storage Access Framework (Android) : Partager des fichiers avec d'autres applications
- Sélecteur de documents : Sélection de fichiers facile
---
Src/Content/Docs/Fr/Principles/Architecture  Copy Section
---
title: Présentation de l'architecture
description: Architecture de haut niveau de l'application
---
Server Box suit une architecture en couches avec une séparation claire des préoccupations.
Couches architecturales  Copy Chapter

Fondations de l'application  Copy Chapter
Point d'entrée principal  Copy Section
lib/main.dart initialise l'application :

Widget racine  Copy Section
MyApp fournit :
- Gestion des thèmes : Commutation entre thèmes clair/sombre
- Configuration du routage : Structure de navigation
- Provider Scope : Racine de l'injection de dépendances
Page d'accueil  Copy Section
HomePage sert de plaque tournante pour la navigation :
- Interface par onglets : Serveur, Snippet, Conteneur, SSH
- Gestion de l'état : État par onglet
- Navigation : Accès aux fonctionnalités
Systèmes de base  Copy Chapter
Gestion de l'état : Riverpod  Copy Section
Pourquoi Riverpod ?
- Sécurité au moment de la compilation
- Tests faciles
- Pas de dépendance au Build context
- Fonctionne sur toutes les plateformes
Types de Provider utilisés :
- StateProvider : État mutable simple
- AsyncNotifierProvider : États de chargement/erreur/données
- StreamProvider : Flux de données en temps réel
- Future providers : Opérations asynchrones uniques
Persistance des données : Hive CE  Copy Section
Pourquoi Hive CE ?
- Pas de dépendances de code natif
- Stockage clé-valeur rapide
- Type-safe avec génération de code
- Pas d'annotations de champs manuelles requises
Stores :
- SettingStore : Préférences de l'application
- ServerStore : Configurations de serveur
- SnippetStore : Extraits de commande
- KeyStore : Clés SSH
Modèles immuables : Freezed  Copy Section
Avantages :
- Immuabilité au moment de la compilation
- Types Union pour l'état
- Sérialisation JSON intégrée
- Extensions CopyWith
Stratégie multiplateforme  Copy Chapter
Système de plugins  Copy Section
Les plugins Flutter permettent l'intégration avec les plateformes :
| Plateforme | Méthode d'intégration |
|------------|----------------------|
| iOS | CocoaPods, Swift/Obj-C |
| Android | Gradle, Kotlin/Java |
| macOS | CocoaPods, Swift |
| Linux | CMake, C++ |
| Windows | CMake, C# |
Fonctionnalités spécifiques aux plateformes  Copy Section
iOS uniquement :
- Widgets de l'écran d'accueil
- Activités en direct (Live Activities)
- Compagnon Apple Watch
Android uniquement :
- Service en arrière-plan
- Notifications push
- Accès au système de fichiers
Bureau uniquement :
- Intégration de la barre de menus
- Fenêtres multiples
- Barre de titre personnalisée
Dépendances personnalisées  Copy Chapter
Fork de dartssh2  Copy Section
Client SSH amélioré avec :
- Meilleur support mobile
- Gestion des erreurs améliorée
- Optimisations de performance
Fork de xterm.dart  Copy Section
Émulateur de terminal avec :
- Rendu optimisé pour le mobile
- Support des gestes tactiles
- Intégration du clavier virtuel
fl_lib  Copy Section
Paquet d'utilitaires partagés avec :
- Widgets communs
- Extensions
- Fonctions d'aide
Système de construction  Copy Chapter
Paquet fl_build  Copy Section
Système de construction personnalisé pour :
- Constructions multiplateformes
- Signature de code
- Regroupement des ressources (assets)
- Gestion des versions
Processus de construction  Copy Section

1. Pré-construction : Calculer la version à partir de Git
2. Construction : Compiler pour la plateforme cible
3. Post-construction : Paqueter et signer
Exemple de flux de données  Copy Chapter
Mise à jour de l'état du serveur  Copy Section

Flux d'action utilisateur  Copy Section

Architecture de sécurité  Copy Chapter
Protection des données  Copy Section
- Mots de passe : Chiffrés avec flutter_secure_storage
- Clés SSH : Chiffrées au repos
- Empreintes d'hôte : Stockées de manière sécurisée
- Données de session : Non persistées
Sécurité de la connexion  Copy Section
- Vérification de la clé d'hôte : Détection MITM (homme du milieu)
- Chiffrement : Chiffrement SSH standard
- Pas de texte clair : Les données sensibles ne sont jamais stockées en clair
---
Src/Content/Docs/Fr/Principles/Sftp  Copy Section
---
title: Système SFTP
description: Comment fonctionne le navigateur de fichiers SFTP
---
Le système SFTP fournit des capacités de gestion de fichiers via SSH.
Architecture  Copy Chapter

Établissement de la connexion  Copy Chapter
Création du client SFTP  Copy Section

Réutilisation de la connexion  Copy Section
SFTP réutilise les connexions SSH existantes :

Opérations du système de fichiers  Copy Chapter
Liste des répertoires  Copy Section

Métadonnées de fichiers  Copy Section

Opérations sur les fichiers  Copy Chapter
Téléversement (Upload)  Copy Section

Téléchargement (Download)  Copy Section

Édition des permissions  Copy Section

Gestion des chemins  Copy Chapter
Structure de chemin  Copy Section

Historique de navigation  Copy Section

Système de transfert  Copy Chapter
Requête de transfert  Copy Section

Suivi de progression  Copy Section

Gestion de la file d'attente  Copy Section

Modèle de stockage local  Copy Chapter
Cache de téléchargement  Copy Section
Fichiers téléchargés stockés sur :

Exemple :
- Distant : /var/log/nginx/access.log
- spiId : server-123
- Local : Paths.file/server-123/_var_log_nginx_access.log
Édition de fichiers  Copy Chapter
Flux d'édition  Copy Section

Intégration d'un éditeur externe  Copy Section

Gestion des erreurs  Copy Chapter
Erreurs de permission  Copy Section

Erreurs de connexion  Copy Section

Erreurs d'espace disque  Copy Section

Optimisations de performance  Copy Chapter
Cache de répertoire  Copy Section

Chargement différé (Lazy Loading)  Copy Section
Pour les répertoires volumineux (>1000 éléments) :

Pagination  Copy Section

---
Src/Content/Docs/Fr/Principles/Ssh  Copy Section
---
title: Connexion SSH
description: Comment les connexions SSH sont établies et gérées
---
Comprendre les connexions SSH dans Server Box.
Flux de connexion  Copy Chapter

Étape 1 : Configuration  Copy Section
Le modèle Spi (Server Parameter Info) contient :

Étape 2 : Génération du client  Copy Section
genClient(spi) crée le client SSH :

Étape 3 : Serveur de rebond (si configuré)  Copy Section
Pour les serveurs de rebond, connexion récursive :

Méthodes d'authentification  Copy Chapter
Authentification par mot de passe  Copy Section

- Mot de passe stocké chiffré dans Hive
- Déchiffré lors de la connexion
- Envoyé au serveur pour vérification
Authentification par clé privée  Copy Section

Processus de chargement de la clé :
1. Récupérer la clé chiffrée depuis KeyStore
2. Déchiffrer le mot de passe (biométrie/invite)
3. Analyser le format PEM
4. Standardiser les fins de ligne (LF)
5. Retourner pour l'authentification
Keyboard-Interactive  Copy Section

Supporte :
- L'authentification par mot de passe
- Les jetons OTP
- L'authentification à deux facteurs (2FA)
Vérification de la clé d'hôte  Copy Chapter
Pourquoi vérifier les clés d'hôte ?  Copy Section
Empêche les attaques de type Man-in-the-Middle (MITM) en s'assurant que vous vous connectez au même serveur.
Format de stockage  Copy Section

Exemple :

Formats d'empreinte  Copy Section
MD5 Hex :

Base64 :

Flux de vérification  Copy Section

Gestion des sessions  Copy Chapter
Mise en commun des connexions (Pooling)  Copy Section
Clients actifs maintenus dans ServerProvider :

Keep-Alive  Copy Section
Maintenir la connexion pendant l'inactivité :

Reconnexion automatique  Copy Section
En cas de perte de connexion :

Cycle de vie de la connexion  Copy Chapter

Gestion des erreurs  Copy Chapter
Délai d'attente de connexion (Timeout)  Copy Section

Échec d'authentification  Copy Section

Discordance de clé d'hôte  Copy Section

Considérations de performance  Copy Chapter
Réutilisation de la connexion  Copy Section
- Réutiliser les clients entre les fonctionnalités
- Ne pas déconnecter/reconnecter inutilement
- Mutualiser les connexions pour les opérations simultanées
Paramètres optimaux  Copy Section
- Timeout : 30 secondes (ajustable)
- Keep-alive : Toutes les 30 secondes
- Délai de relecture : 5 secondes
Efficacité du réseau  Copy Section
- Connexion unique pour plusieurs opérations
- Commandes en pipeline si possible
- Éviter d'ouvrir plusieurs connexions
---
Src/Content/Docs/Fr/Principles/State  Copy Section
---
title: Gestion de l'état
description: Comment l'état est géré avec Riverpod
---
Comprendre l'architecture de gestion de l'état dans Server Box.
Pourquoi Riverpod ?  Copy Chapter
Avantages clés :
- Sécurité à la compilation : Capture les erreurs lors de la compilation
- Pas de BuildContext requis : Accès à l'état n'importe où
- Tests faciles : Simple de tester les providers de manière isolée
- Génération de code : Moins de code répétitif, type-safe
Architecture des Providers  Copy Chapter

Types de Providers utilisés  Copy Chapter
1. StateProvider (État simple)  Copy Section
Pour un état simple et observable :

Utilisation :

2. AsyncNotifierProvider (État asynchrone)  Copy Section
Pour les données qui se chargent de manière asynchrone :

Utilisation :

3. StreamProvider (Données en temps réel)  Copy Section
Pour les flux de données continus :

Utilisation :

4. Family Providers (Paramétrés)  Copy Section
Providers qui acceptent des paramètres :

Utilisation :

Optimisations de performance  Copy Chapter
- Provider Keep-Alive : Utilisez @Riverpod(keepAlive: true) pour empêcher la destruction automatique quand il n'y a plus d'écouteurs.
- Observation sélective : Utilisez select pour n'observer qu'une partie spécifique de l'état.
- Mise en cache des Providers : Les Family providers mettent en cache les résultats par paramètre.
Bonnes pratiques  Copy Chapter
1. Co-localiser les providers : Placez-les près des widgets qui les consomment.
2. Utiliser la génération de code : Utilisez toujours @riverpod.
3. Garder les providers focalisés : Responsabilité unique.
4. Gérer les états de chargement : Gérez toujours les états AsyncValue.
5. Libérer les ressources : Utilisez ref.onDispose() pour le nettoyage.
6. Éviter les arbres de providers profonds : Gardez le graphe des providers plat.
---
Src/Content/Docs/Fr/Principles/Terminal  Copy Section
---
title: Implémentation du terminal
description: Comment le terminal SSH fonctionne en interne
---
Le terminal SSH est l'une des fonctionnalités les plus complexes, basée sur un fork personnalisé de xterm.dart.
Présentation de l'architecture  Copy Chapter

Cycle de vie d'une session de terminal  Copy Chapter
1. Création de la session  Copy Section

2. Émulation de terminal  Copy Section
Le fork xterm.dart fournit :
Émulation VT100/ANSI :
- Mouvement du curseur
- Couleurs (support 256 couleurs)
- Attributs de texte (gras, souligné, etc.)
- Régions de défilement
- Tampon d'écran alterné
Rendu :
- Rendu basé sur les lignes
- Support du texte bidirectionnel
- Support Unicode/emoji
- Redessins optimisés
3. Flux de données  Copy Section

Système multi-onglets  Copy Chapter
Gestion des onglets  Copy Section
Les onglets maintiennent leur état lors de la navigation :
- Connexion SSH maintenue active
- État du terminal préservé
- Tampon de défilement conservé
- Historique de saisie retenu
Clavier virtuel  Copy Chapter
Implémentation spécifique à la plateforme  Copy Section
iOS :
- Clavier personnalisé basé sur UIView
- Basculable avec un bouton clavier
- Affichage/masquage automatique basé sur le focus
Android :
- Méthode de saisie personnalisée
- Intégré au clavier système
- Boutons d'action rapide
Boutons du clavier  Copy Section
| Bouton | Action |
|--------|--------|
| Basculer | Afficher/masquer le clavier système |
| Ctrl | Envoyer le modificateur Ctrl |
| Alt | Envoyer le modificateur Alt |
| SFTP | Ouvrir le répertoire courant |
| Presse-papiers | Copier/Coller contextuel |
| Snippets | Exécuter un extrait de code |
Sélection de texte  Copy Chapter
1. Appui long : Entrer en mode sélection
2. Glisser : Étendre la sélection
3. Relâcher : Copier dans le presse-papiers
Police et dimensions  Copy Chapter
Calcul de la taille  Copy Section

Pincer pour zoomer (Pinch-to-Zoom)  Copy Section

Schéma de couleurs  Copy Chapter
- Clair (Light) : Fond clair, texte sombre
- Sombre (Dark) : Fond sombre, texte clair
- AMOLED : Fond noir pur
Optimisations de performance  Copy Chapter
- Dirty rectangle : Ne redessiner que les régions modifiées
- Mise en cache des lignes : Mettre en cache les lignes rendues
- Défilement paresseux (Lazy scrolling) : Défilement virtuel pour les longs tampons
- Mises à jour par lots : Fusionner plusieurs écritures
- Compression : Compresser le tampon de défilement
- Anti-rebond (Debouncing) : Anti-rebond pour les saisies rapides
---
Src/Content/Docs/Fr/Index  Copy Section
---
title: Server Box
description: Une application complète de gestion de serveurs multiplateforme
hero:
  tagline: Gérez vos serveurs Linux de n'importe où
  actions:
    - text: Commencer
      link: /docs/fr/introduction/
      icon: right-arrow
      variant: primary
    - text: Voir sur GitHub
      link: https://github.com/lollipopkit/flutter_server_box
      icon: github
      variant: minimal
---
import { Card, CardGrid } from '@astrojs/starlight/components';
Fonctionnalités  Copy Chapter
<CardGrid stagger>
	<Card title="Surveillance en temps réel" icon="chart">
		Surveillez le CPU, la mémoire, le disque, le réseau, le GPU et la température avec de magnifiques graphiques en temps réel.
	</Card>
	<Card title="Terminal SSH" icon="terminal">
		Terminal SSH complet avec support multi-onglets et clavier virtuel pour les appareils mobiles.
	</Card>
	<Card title="Navigateur de fichiers SFTP" icon="folder">
		Gérez les fichiers sur vos serveurs avec le client SFTP intégré et le navigateur de fichiers local.
	</Card>
	<Card title="Gestion Docker" icon="box">
		Démarrez, arrêtez et surveillez les conteneurs Docker avec une interface intuitive.
	</Card>
	<Card title="Multiplateforme" icon="device-mobile">
		Disponible sur iOS, Android, macOS, Linux, Windows et watchOS.
	</Card>
	<Card title="Plus de 12 langues" icon="globe">
		Support complet de localisation incluant l'anglais, le chinois, l'allemand, le français et plus encore.
	</Card>
</CardGrid>
Liens rapides  Copy Chapter
- Téléchargement: Disponible sur l'App Store, GitHub, F-Droid, CDN et OpenAPK
- Documentation: Explorez les guides pour commencer avec Server Box
- Support: Rejoignez notre communauté sur GitHub pour des discussions et des problèmes
---
Src/Content/Docs/Fr/Installation  Copy Section
---
title: Installation
description: Téléchargez et installez Server Box sur votre appareil
---
Server Box est disponible sur plusieurs plateformes. Choisissez votre méthode d'installation préférée.
Applications Mobiles  Copy Chapter
iOS  Copy Section
Téléchargez depuis l'App Store.
Android  Copy Section
Choisissez votre source préférée :
- GitHub Releases - Pour la dernière version directement depuis la source
- CDN - Miroir pour les paquets de publication
- F-Droid - Pour les utilisateurs qui préfèrent les sources exclusivement FOSS
- OpenAPK - Boutique Android tierce
Applications de Bureau  Copy Chapter
macOS  Copy Section
Téléchargez depuis l’App Store ou installez avec Homebrew Cask :

Caractéristiques :
- Intégration native de la barre de menus
- Prise en charge d'Intel et d'Apple Silicon
Linux  Copy Section
Téléchargez depuis les GitHub Releases ou le CDN.
GitHub Releases et le CDN fournissent des paquets Linux AppImage.
Windows  Copy Section
Téléchargez depuis les GitHub Releases ou le CDN.
GitHub Releases et le CDN fournissent des paquets Windows zip.
watchOS  Copy Chapter
Disponible sur l'App Store en tant que partie de l'application iOS.
Construction à partir des sources  Copy Chapter
Pour construire Server Box à partir des sources, consultez la section Construction dans la documentation de développement.
Informations sur la version  Copy Chapter
Consultez la page GitHub Releases pour la dernière version et le journal des modifications (changelog).
---
Src/Content/Docs/Fr/Introduction  Copy Section
---
title: Introduction
description: Découvrez ce qu'est Server Box et ce qu'il peut faire
---
Server Box est une application complète de gestion de serveur multiplateforme construite avec Flutter. Elle vous permet de surveiller, gérer et contrôler vos serveurs Linux, Unix et Windows de n'importe où.
Qu'est-ce que Server Box ?  Copy Chapter
Server Box fournit une interface unifiée pour les tâches d'administration de serveur via des connexions SSH. Que vous soyez un administrateur système, un développeur ou un passionné gérant des serveurs domestiques, cette application met de puissants outils de gestion de serveur dans votre poche.
Capacités clés  Copy Chapter
- Surveillance en temps réel : Suivez le processeur (CPU), la mémoire, l'utilisation du disque, la vitesse du réseau, l'état du GPU et les températures du système.
- Terminal SSH : Accès complet au terminal avec prise en charge multi-onglets et apparence personnalisable.
- Client SFTP : Parcourez et gérez les fichiers sur vos serveurs.
- Gestion Docker : Contrôlez les conteneurs en toute simplicité.
- Gestion des processus : Visualisez et gérez les processus système.
- Services Systemd : Démarrez, arrêtez et surveillez les services systemd.
- Outils réseau : Tests iPerf, ping et Wake-on-LAN.
- Snippets : Enregistrez et exécutez des commandes shell personnalisées.
Plateformes supportées  Copy Chapter
Server Box est véritablement multiplateforme :
- Mobile : iOS et Android
- Bureau : macOS, Linux et Windows
Licence  Copy Chapter
Ce projet est sous licence AGPL v3. Le code source est disponible sur GitHub.
---
Src/Content/Docs/Fr/Quick Start  Copy Section
---
title: Démarrage Rapide
description: Soyez opérationnel avec Server Box en quelques minutes
---
Suivez ce guide de démarrage rapide pour vous connecter à votre premier serveur et commencer la surveillance.
Étape 1 : Ajouter un serveur  Copy Chapter
1. Ouvrez Server Box
2. Appuyez sur le bouton + pour ajouter un nouveau serveur
3. Remplissez les informations du serveur :
   - Nom : Un nom convivial pour votre serveur
   - Hôte : Adresse IP ou nom de domaine
   - Port : Port SSH (par défaut : 22)
   - Utilisateur : Nom d'utilisateur SSH
   - Mot de passe ou Clé : Méthode d'authentification
4. Appuyez sur Enregistrer pour ajouter le serveur
Étape 2 : Connecter et surveiller  Copy Chapter
1. Appuyez sur la carte de votre serveur pour vous connecter
2. L'application établira une connexion SSH
3. Vous verrez le statut en temps réel pour :
   - L'utilisation du processeur (CPU)
   - La mémoire (RAM) et le Swap
   - L'utilisation du disque
   - La vitesse du réseau
Étape 3 : Explorer les fonctionnalités  Copy Chapter
Une fois connecté, vous pouvez :
- Ouvrir le terminal : Appuyez sur le bouton du terminal pour un accès SSH complet
- Parcourir les fichiers : Utilisez SFTP pour gérer les fichiers
- Gérer les conteneurs : Visualisez et contrôlez les conteneurs Docker
- Afficher les processus : Vérifiez les processus en cours d'exécution
- Exécuter des snippets : Exécutez des commandes enregistrées
Conseils  Copy Chapter
- Authentification biométrique : Activez Face ID / Touch ID / Empreinte digitale pour un accès rapide (mobile)
- Widgets de l'écran d'accueil : Ajoutez des widgets d'état du serveur à votre écran d'accueil (iOS/Android)
- Fonctionnement en arrière-plan : Maintenez les connexions actives en arrière-plan (Android)
---
Src/Content/Docs/Es/Development/Architecture  Copy Section
---
title: Arquitectura
description: Patrones de arquitectura y decisiones de diseño
---
Server Box sigue los principios de Clean Architecture con una clara separación entre las capas de datos, dominio y presentación.
Arquitectura por Capas  Copy Chapter

Patrones Clave  Copy Chapter
Gestión de Estado: Riverpod  Copy Section
- Generación de Código: Usa riverpod_generator para providers con tipado seguro
- State Notifiers: Para estados mutables con lógica de negocio
- Async Notifiers: Para estados de carga y error
- Stream Providers: Para datos en tiempo real
Modelos Inmutables: Freezed  Copy Section
- Todos los modelos de datos usan Freezed para inmutabilidad
- Tipos Union para representación de estados
- Serialización JSON integrada
- Extensiones CopyWith para actualizaciones
Almacenamiento Local: Hive  Copy Section
- hive_ce: Edición comunitaria de Hive
- Sigue el patrón existente: la mayoría de los stores usan hive_ce, mientras algunos modelos versionados aún declaran explícitamente @HiveType y @HiveField
- Adaptadores de tipo generados automáticamente
- Almacenamiento persistente clave-valor
Inyección de Dependencias  Copy Chapter
Los servicios y almacenes se inyectan a través de:
1. Providers: Exponen dependencias a la UI
2. GetIt: Localizador de servicios (donde sea aplicable)
3. Inyección en Constructor: Dependencias explícitas
Flujo de Datos  Copy Chapter

1. El usuario interactúa con el widget
2. El widget llama al método del provider
3. El provider actualiza el estado a través del servicio/almacén
4. El cambio de estado activa la reconstrucción de la UI
5. El nuevo estado se refleja en el widget
Dependencias Personalizadas  Copy Chapter
El proyecto utiliza varias ramas (forks) personalizadas para extender la funcionalidad:
- dartssh2: Funciones SSH mejoradas
- xterm: Emulador de terminal con soporte móvil
- fl_lib: Componentes de UI y utilidades compartidas
Multihilo  Copy Chapter
- Isolates: Computación pesada fuera del hilo principal
- paquete computer: Utilidades para multihilo
- Async/Await: Operaciones de E/S no bloqueantes
---
Src/Content/Docs/Es/Development/Building  Copy Section
---
title: Compilación
description: Instrucciones de compilación para diferentes plataformas
---
Server Box utiliza un sistema de compilación personalizado (fl_build) para compilaciones multiplataforma.
Requisitos Previos  Copy Chapter
- Flutter SDK (canal stable)
- Herramientas específicas de cada plataforma (Xcode para iOS, Android Studio para Android)
- Cadena de herramientas de Rust (para algunas dependencias nativas)
Compilación de Desarrollo  Copy Chapter

Compilación de Producción  Copy Chapter
El proyecto utiliza fl_build para compilar:

Compilaciones Específicas por Plataforma  Copy Chapter
iOS  Copy Section

Requiere:
- macOS con Xcode
- CocoaPods
- Cuenta de Apple Developer para la firma
Android  Copy Section

Requiere:
- Android SDK
- Java Development Kit
- Keystore para la firma
macOS  Copy Section

Linux  Copy Section

Windows  Copy Section

Requiere Windows con Visual Studio.
Pre/Post Compilación  Copy Chapter
El script make.dart se encarga de:
- Generación de metadatos
- Actualización de cadenas de versión
- Configuraciones específicas de plataforma
Solución de Problemas  Copy Chapter
Compilación Limpia  Copy Section

Discrepancia de Versión  Copy Section
Asegúrate de que todas las dependencias son compatibles:

Lista de Verificación de Lanzamiento  Copy Chapter
1. Actualizar la versión en pubspec.yaml
2. Ejecutar la generación de código
3. Ejecutar las pruebas
4. Compilar para todas las plataformas de destino
5. Probar en dispositivos físicos
6. Crear lanzamiento (release) en GitHub
---
Src/Content/Docs/Es/Development/Codegen  Copy Section
---
title: Generación de Código
description: Uso de build_runner para la generación de código
---
Server Box utiliza intensivamente la generación de código para modelos, gestión de estado y serialización.
Cuándo Ejecutar la Generación de Código  Copy Chapter
Ejecutar tras modificar:
- Modelos con la anotación @freezed
- Clases con @JsonSerializable
- Modelos de Hive
- Providers con @riverpod
- Localizaciones (archivos ARB)
Ejecutar la Generación de Código  Copy Chapter

Archivos Generados  Copy Chapter
Freezed (.freezed.dart) .freezed.dart)')" title="Copy section prompt for LLMs"> Copy Section
Modelos de datos inmutables con tipos Union:

Serialización JSON (.g.dart) .g.dart)')" title="Copy section prompt for LLMs"> Copy Section
Generado por json_serializable:

Providers de Riverpod (.g.dart) .g.dart)')" title="Copy section prompt for LLMs"> Copy Section
Generados a partir de la anotación @riverpod:

Adaptadores de Hive (.g.dart) .g.dart)')" title="Copy section prompt for LLMs"> Copy Section
Auto-generados para modelos de Hive (hive_ce):

Generación de Localización  Copy Chapter

Genera lib/generated/l10n/ a partir de los archivos lib/l10n/*.arb.
Consejos  Copy Chapter
- Usa --delete-conflicting-outputs para evitar conflictos
- Mantén los archivos generados en el control de versiones cuando este repositorio ya los sigue
- Nunca edites manualmente los archivos generados
---
Src/Content/Docs/Es/Development/State  Copy Section
---
title: Gestión de Estado
description: Patrones de gestión de estado basados en Riverpod
---
Server Box utiliza Riverpod con generación de código para la gestión de estado.
Tipos de Provider  Copy Chapter
StateProvider  Copy Section
Estado simple que se puede leer y escribir:

AsyncNotifierProvider  Copy Section
Estado que se carga de forma asíncrona con estados de carga/error:

StreamProvider  Copy Section
Datos en tiempo real desde flujos (streams):

Patrones de Estado  Copy Chapter
Estados de Carga  Copy Section

Family Providers  Copy Section
Providers parametrizados:

Auto-Dispose  Copy Section
Providers que se eliminan cuando ya no están referenciados:

Mejores Prácticas  Copy Chapter
1. Usar generación de código: Usa siempre la anotación @riverpod
2. Co-localizar providers: Ponlos cerca de los widgets que los consumen
3. Evitar singletons: Usa providers en su lugar
4. Capas correctas: Mantén la lógica de UI separada de la lógica de negocio
Leer el Estado en Widgets  Copy Chapter

Modificar el Estado  Copy Chapter

---
Src/Content/Docs/Es/Development/Structure  Copy Section
---
title: Estructura del Proyecto
description: Comprendiendo la base de código de Server Box
---
El proyecto Server Box sigue una arquitectura modular con una clara separación de responsabilidades.
Estructura de Directorios  Copy Chapter

Capa Central (lib/core/) lib/core/)')" title="Copy chapter prompt for LLMs"> Copy Chapter
Contiene utilidades, extensiones y configuración de rutas:
- Extensions: Extensiones de Dart para tipos comunes
- Routes: Configuración de rutas de la app
- Utils: Funciones de utilidad compartidas
Capa de Datos (lib/data/) lib/data/)')" title="Copy chapter prompt for LLMs"> Copy Chapter
Modelos (lib/data/model/) lib/data/model/)')" title="Copy section prompt for LLMs"> Copy Section
Organizados por función:
- server/ - Modelos de conexión y estado del servidor
- container/ - Modelos de contenedores Docker
- ssh/ - Modelos de sesión SSH
- sftp/ - Modelos de archivos SFTP
- app/ - Modelos específicos de la app
Providers (lib/data/provider/) lib/data/provider/)')" title="Copy section prompt for LLMs"> Copy Section
Providers de Riverpod para inyección de dependencias y gestión de estado:
- Providers de servidor
- Providers de estado de UI
- Providers de servicios
Almacenes (lib/data/store/) lib/data/store/)')" title="Copy section prompt for LLMs"> Copy Section
Almacenamiento local basado en Hive:
- Almacén de servidores
- Almacén de ajustes
- Almacén de caché
Capa de Vista (lib/view/) lib/view/)')" title="Copy chapter prompt for LLMs"> Copy Chapter
Páginas (lib/view/page/) lib/view/page/)')" title="Copy section prompt for LLMs"> Copy Section
Pantallas principales de la aplicación:
- server/ - Páginas de gestión de servidores
- ssh/ - Páginas de terminal SSH
- container/ - Páginas de contenedores
- setting/ - Páginas de ajustes
- storage/ - Páginas de SFTP
- snippet/ - Páginas de fragmentos (snippets)
Widgets (lib/view/widget/) lib/view/widget/)')" title="Copy section prompt for LLMs"> Copy Section
Componentes de UI reutilizables:
- Tarjetas de servidor
- Gráficos de estado
- Componentes de entrada
- Diálogos
Archivos Generados  Copy Chapter
- lib/generated/l10n/ - Localización auto-generada
- *.g.dart - Código generado (json_serializable, freezed, hive, riverpod)
- *.freezed.dart - Clases inmutables de Freezed
Directorio de Paquetes (/packages/) /packages/)')" title="Copy chapter prompt for LLMs"> Copy Chapter
Contiene ramas (forks) personalizadas de las dependencias:
- dartssh2/ - Librería SSH
- xterm/ - Emulador de terminal
- fl_lib/ - Utilidades compartidas
- fl_build/ - Sistema de compilación
---
Src/Content/Docs/Es/Development/Testing  Copy Section
---
title: Pruebas
description: Estrategias de prueba y ejecución de pruebas
---
Ejecución de Pruebas  Copy Chapter

Estructura de las Pruebas  Copy Chapter
Las pruebas se encuentran en el directorio test/. La suite actual es mayormente plana y se agrupa por comportamiento de parsers, modelos y utilidades, por ejemplo cpu_test.dart, container_test.dart y ssh_config_test.dart.
Pruebas Unitarias  Copy Chapter
Probar la lógica de negocio y los modelos de datos:

Pruebas de Widgets  Copy Chapter
Probar componentes de la interfaz de usuario (UI):

Pruebas de Providers  Copy Chapter
Probar providers de Riverpod:

Dependencias externas  Copy Chapter
Evita pruebas que dependan de servidores SSH reales. Las pruebas de parsers, modelos y constructores de comandos deben ser deterministas; añade fakes o fixtures dirigidos cuando una función introduzca una frontera de servicio.
Pruebas de Integración  Copy Chapter
El repositorio actual no contiene una suite integration_test/. Añade pruebas de integración solo cuando una función necesite cobertura end-to-end de dispositivo o flujo completo de la app.
Buenas Prácticas  Copy Chapter
1. Arrange-Act-Assert: Estructurar las pruebas claramente.
2. Nombres descriptivos: Los nombres de las pruebas deben describir el comportamiento.
3. Una aserción por prueba: Mantener las pruebas enfocadas.
4. Simular dependencias externas: No depender de servidores reales.
5. Probar casos límite: Listas vacías, valores nulos, etc.
---
Src/Content/Docs/Es/Advanced/Bulk Import  Copy Section
---
title: Importación Masiva de Servidores
description: Importar múltiples servidores desde un archivo JSON
---
Importa múltiples configuraciones de servidor a la vez utilizando un archivo JSON.
Formato JSON  Copy Chapter
:::danger[Advertencia de Seguridad]
¡Nunca guardes contraseñas en texto plano en archivos! Este ejemplo JSON muestra un campo de contraseña solo con fines demostrativos, pero deberías:
- Preferir claves SSH (pubKeyId) en lugar de pwd; son más seguras
- Usar gestores de secretos o variables de entorno si debes usar contraseñas
- Eliminar el archivo inmediatamente después de la importación; no dejes credenciales tiradas
- Añadir a .gitignore: nunca subas archivos de credenciales al control de versiones
:::

Campos  Copy Chapter
| Campo | Requerido | Descripción |
|-------|-----------|-------------|
| name | Sí | Nombre para mostrar |
| ip | Sí | Dominio o dirección IP |
| port | Sí | Puerto SSH (usualmente 22) |
| user | Sí | Usuario SSH |
| pwd | No | Contraseña (evitar - usar claves SSH en su lugar) |
| pubKeyId | No | ID de clave privada (de Claves Privadas - recomendado) |
| tags | No | Etiquetas de organización |
| autoConnect | No | Autoconexión al iniciar |
Pasos para Importar  Copy Chapter
1. Crea un archivo JSON con las configuraciones del servidor
2. Ajustes → Copia de seguridad → Importación masiva de servidores
3. Selecciona tu archivo JSON
4. Confirma la importación
Ejemplo  Copy Chapter

Consejos  Copy Chapter
- Usa claves SSH en lugar de contraseñas cuando sea posible
- Prueba la conexión después de la importación
- Organiza con etiquetas para una gestión más sencilla
- Elimina el archivo JSON después de la importación
- Nunca subas archivos JSON con credenciales al control de versiones
---
Src/Content/Docs/Es/Advanced/Custom Commands  Copy Section
---
title: Comandos Personalizados
description: Mostrar la salida de comandos personalizados en la página del servidor
---
Añade comandos shell personalizados para mostrar su salida en la página de detalles del servidor.
Configuración  Copy Chapter
1. Ajustes del servidor → Comandos personalizados
2. Introduce los comandos en formato JSON
Formato Básico  Copy Chapter

Ejemplo:

Ver Resultados  Copy Chapter
Tras la configuración, los comandos personalizados aparecerán en la página de detalles del servidor y se actualizarán automáticamente.
Nombres de Comando Especiales  Copy Chapter
server_card_top_right  Copy Section
Se muestra en la tarjeta del servidor de la página de inicio (esquina superior derecha):

Consejos  Copy Chapter
Usa rutas absolutas:

Comandos con tuberías (pipes):

Formatear salida:

Mantén los comandos rápidos: Menos de 5 segundos para una mejor experiencia.
Limitar salida:

Seguridad  Copy Chapter
Los comandos se ejecutan con los permisos del usuario SSH. Evita comandos que modifiquen el estado del sistema.
---
Src/Content/Docs/Es/Advanced/Custom Logo  Copy Section
---
title: Logo de Servidor Personalizado
description: Usa imágenes personalizadas para las tarjetas de servidor
---
Muestra logos personalizados en las tarjetas de servidor mediante URLs de imagen.
Configuración  Copy Chapter
1. Ajustes del servidor → Logo personalizado
2. Introduce la URL de la imagen
Marcadores de posición de URL  Copy Chapter
{DIST} - Distribución Linux  Copy Section
Se reemplaza automáticamente por la distribución detectada:

Se convierte en: debian.png, ubuntu.png, arch.png, etc.
{BRIGHT} - Tema  Copy Section
Se reemplaza automáticamente por el tema actual:

Se convierte en: light.png o dark.png
Combinar ambos  Copy Section

Se convierte en: debian-light.png, ubuntu-dark.png, etc.
Consejos  Copy Chapter
- Usa formatos PNG o SVG
- Tamaño recomendado: de 64x64 a 128x128 píxeles
- Usa URLs HTTPS
- Mantén tamaños de archivo pequeños
Distribuciones Soportadas  Copy Chapter
debian, ubuntu, centos, fedora, opensuse, kali, alpine, arch, rocky, deepin, armbian, wrt
Lista completa: dist.dart
---
Src/Content/Docs/Es/Advanced/Json Settings  Copy Section
---
title: Ajustes Ocultos (JSON)
description: Accede a ajustes avanzados mediante el editor JSON
---
Algunos ajustes están ocultos en la interfaz de usuario pero son accesibles a través del editor JSON.
Acceso  Copy Chapter
Mantén pulsado Ajustes en el menú lateral para abrir el editor JSON.
Ajustes Ocultos Comunes  Copy Chapter
timeOut  Copy Section
Tiempo de espera de conexión en segundos.

Tipo: entero | Predeterminado: 5 | Rango: 1-60
recordHistory  Copy Section
Guardar historial (rutas SFTP, etc.).

Tipo: booleano | Predeterminado: true
textFactor  Copy Section
Factor de escala de texto.

Tipo: doble | Predeterminado: 1.0 | Rango: 0.8-1.5
Encontrar Más Ajustes  Copy Chapter
Todos los ajustes están definidos en setting.dart.
Busca:

⚠️ Importante  Copy Chapter
Antes de editar:
- Crea una copia de seguridad: unos ajustes incorrectos pueden hacer que la app no se abra
- Edita con cuidado: el JSON debe ser válido
Recuperación  Copy Chapter
Si la aplicación no se abre tras editar:
1. Borra los datos de la aplicación (último recurso)
2. Reinstala la aplicación
3. Restaura desde una copia de seguridad
---
Src/Content/Docs/Es/Advanced/Troubleshooting  Copy Section
---
title: Problemas Comunes
description: Soluciones a problemas frecuentes
---
Problemas de Conexión  Copy Chapter
SSH no conecta  Copy Section
Síntomas: Tiempo de espera agotado (timeout), conexión rechazada, fallo de autenticación
Soluciones:
1. Verificar el tipo de servidor: Solo se admiten sistemas tipo Unix (Linux, macOS, Android/Termux)
2. Probar manualmente: ssh usuario@servidor -p puerto
3. Comprobar el cortafuegos: El puerto 22 debe estar abierto
4. Verificar credenciales: Usuario y contraseña/clave correctos
Desconexiones frecuentes  Copy Section
Síntomas: El terminal se desconecta tras un periodo de inactividad
Soluciones:
1. Keep-alive del servidor:

2. Desactivar optimización de batería:
   - MIUI: Batería → "Sin restricciones"
   - Android: Ajustes → Aplicaciones → Desactivar optimización
   - iOS: Activar actualización en segundo plano
Problemas de Entrada  Copy Chapter
No se pueden escribir ciertos caracteres  Copy Section
Solución: Ajustes → Tipo de teclado → Cambiar a visiblePassword
Nota: Es posible que la entrada CJK (chino, japonés, coreano) no funcione tras este cambio.
Problemas de la Aplicación  Copy Chapter
La aplicación se cierra al iniciar  Copy Section
Síntomas: La aplicación no se abre, pantalla en negro
Causas: Ajustes corruptos, especialmente tras usar el editor JSON
Soluciones:
1. Borrar datos de la aplicación:
   - Android: Ajustes → Aplicaciones → ServerBox → Borrar datos
   - iOS: Eliminar y reinstalar
2. Restaurar copia de seguridad: Importar una copia de seguridad creada antes de cambiar los ajustes
Problemas con Copia de Seguridad/Restauración  Copy Section
La copia de seguridad no funciona:
- Comprobar espacio de almacenamiento
- Verificar que la aplicación tiene permisos de almacenamiento
- Probar una ubicación diferente
La restauración falla:
- Verificar la integridad del archivo de copia de seguridad
- Comprobar la compatibilidad de la versión de la aplicación
Problemas con Widgets  Copy Chapter
El Widget no se actualiza  Copy Section
iOS:
- Esperar hasta 30 minutos para la actualización automática
- Eliminar y volver a añadir el widget
- Comprobar que la URL termina en /status
Android:
- Pulsar el widget para forzar la actualización
- Verificar que el ID del widget coincide con la configuración en los ajustes de la aplicación
watchOS:
- Reiniciar la aplicación del reloj
- Esperar unos minutos tras cambiar la configuración
- Verificar el formato de la URL
El Widget muestra un error  Copy Section
- Verificar que ServerBox Monitor se está ejecutando en el servidor
- Probar la URL en un navegador
- Comprobar las credenciales de autenticación
Problemas de Rendimiento  Copy Chapter
La aplicación va lenta  Copy Section
Soluciones:
- Reducir la tasa de refresco en los ajustes
- Comprobar la velocidad de la red
- Desactivar servidores no utilizados
Alto consumo de batería  Copy Section
Soluciones:
- Aumentar los intervalos de refresco
- Desactivar la actualización en segundo plano
- Cerrar sesiones SSH no utilizadas
Obtener Ayuda  Copy Chapter
Si los problemas persisten:
1. Buscar en GitHub Issues: https://github.com/lollipopkit/flutter_server_box/issues
2. Crear nueva Issue: Incluir versión de la aplicación, plataforma y pasos para reproducir
3. Consultar la Wiki: Esta documentación y la Wiki de GitHub
---
Src/Content/Docs/Es/Advanced/Widgets  Copy Section
---
title: Widgets de Pantalla de Inicio
description: Añade widgets de estado del servidor a tu pantalla de inicio
---
Requiere tener instalado ServerBox Monitor en tus servidores.
Requisitos Previos  Copy Chapter
Instala primero ServerBox Monitor en tu servidor. Consulta la Wiki de ServerBox Monitor para ver las instrucciones de configuración.
Tras la instalación, tu servidor debería tener:
- Un punto de acceso (endpoint) HTTP/HTTPS
- El punto de acceso API /status
- Autenticación opcional
Formato de URL  Copy Chapter

Debe terminar en /status.
Widget de iOS  Copy Chapter
Configuración  Copy Section
1. Mantén pulsada la pantalla de inicio → Toca el símbolo +
2. Busca "ServerBox"
3. Elige el tamaño del widget
4. Mantén pulsado el widget → Editar widget
5. Introduce la URL terminada en /status
Notas  Copy Section
- Debe usar HTTPS (excepto IPs locales)
- Tasa máxima de refresco: 30 minutos (límite de iOS)
- Añade varios widgets para varios servidores
Widget de Android  Copy Chapter
Configuración  Copy Section
1. Mantén pulsada la pantalla de inicio → Widgets
2. Busca "ServerBox" → Añadir a la pantalla de inicio
3. Anota el número de ID del widget que aparece
4. Abre la app ServerBox → Ajustes
5. Toca en Configurar enlace de widget de inicio
6. Añade la entrada: Widget ID = URL de estado
Ejemplo:
- Clave (Key): 17
- Valor (Value): https://mi-servidor.com/status
7. Toca el widget en la pantalla de inicio para refrescarlo
Widget de watchOS  Copy Chapter
Configuración  Copy Section
1. Abre la app en el iPhone → Ajustes
2. Ajustes de iOS → App del Watch
3. Toca en Añadir URL
4. Introduce la URL terminada en /status
5. Espera a que la app del reloj se sincronice
Notas  Copy Section
- Prueba a reiniciar la app del reloj si no se actualiza
- Verifica que el teléfono y el reloj están conectados
Solución de Problemas  Copy Chapter
El Widget no se actualiza  Copy Section
iOS: Espera hasta 30 minutos, luego elimínalo y vuelve a añadirlo.
Android: Toca el widget para forzar el refresco, verifica el ID en los ajustes.
watchOS: Reinicia la app del reloj, espera unos minutos.
El Widget muestra un error  Copy Section
- Verifica que ServerBox Monitor se está ejecutando
- Prueba la URL en un navegador
- Comprueba que la URL termina en /status
Seguridad  Copy Chapter
- Usa siempre HTTPS cuando sea posible
- IPs locales solo en redes de confianza
---
Src/Content/Docs/Es/Platforms/Desktop  Copy Section
---
title: Funciones de Escritorio
description: Funciones específicas para macOS, Linux y Windows
---
Server Box en plataformas de escritorio ofrece funciones de productividad adicionales.
macOS  Copy Chapter
Integración en la Barra de Menús  Copy Section
- Estado rápido del servidor en la barra de menús
- Acceso al servidor con un solo clic
- Modo compacto para una mínima distracción
- Estilo nativo de la barra de menús de macOS
Persistencia del Estado de la Ventana  Copy Section
- Recuerda la posición y el tamaño de la ventana
- Restaura la sesión anterior al iniciar
- Soporte para múltiples monitores
Funciones Nativas  Copy Section
- Barra de título: Opción de barra de título personalizada o del sistema
- Modo pantalla completa: Monitorización dedicada del servidor
- Atajos de teclado: Atajos nativos de macOS
- Touch Bar (dispositivos compatibles): Acciones rápidas
Linux  Copy Chapter
Integración Nativa  Copy Section
- Soporte para bandeja del sistema (systray)
- Integración con notificaciones de escritorio
- Integración con el selector de archivos
Gestión de Ventanas  Copy Section
- Soporte para X11 y Wayland
- Compatible con gestores de ventanas en mosaico (tiling)
- Opción de decoraciones de ventana personalizadas
Windows  Copy Chapter
Funciones  Copy Section
- Integración en la bandeja del sistema
- Acciones rápidas en la Jump List
- Controles de ventana nativos
- Opción de inicio automático al arrancar
Funciones de Escritorio Multiplataforma  Copy Chapter
Atajos de Teclado  Copy Section
- Cmd/Ctrl + N: Nuevo servidor
- Cmd/Ctrl + W: Cerrar pestaña
- Cmd/Ctrl + T: Nueva pestaña de terminal
- Cmd/Ctrl + ,: Ajustes
Temas  Copy Section
- Tema claro
- Tema oscuro
- Tema AMOLED (negro puro)
- Tema del sistema (sigue al SO)
Múltiples Ventanas  Copy Section
- Abrir varios servidores en ventanas separadas
- Arrastrar pestañas a una nueva ventana
- Comparar estadísticas de servidores en paralelo
Ventajas sobre el Móvil  Copy Section
- Pantalla más grande para monitorización
- Teclado completo para la terminal
- Operaciones de archivos más rápidas
- Mejor multitarea
---
Src/Content/Docs/Es/Platforms/Mobile  Copy Section
---
title: Funciones Móviles
description: Funciones específicas para iOS y Android
---
Server Box proporciona varias funciones específicas para dispositivos móviles iOS y Android.
Autenticación Biométrica  Copy Chapter
Asegura tus servidores con autenticación biométrica:
- iOS: Face ID o Touch ID
- Android: Autenticación por huella dactilar
Actívalo en Ajustes > Seguridad > Autenticación biométrica.
Widgets de Pantalla de Inicio  Copy Chapter
Añade widgets de estado del servidor a tu pantalla de inicio para una monitorización rápida.
iOS  Copy Section
- Mantén pulsada la pantalla de inicio
- Toca en + para añadir un widget
- Busca "Server Box"
- Elige el tamaño del widget:
  - Pequeño: Estado de un solo servidor
  - Mediano: Múltiples servidores
  - Grande: Información detallada
Android  Copy Section
- Mantén pulsada la pantalla de inicio
- Toca en Widgets
- Busca "Server Box"
- Selecciona el tipo de widget
Ejecución en Segundo Plano  Copy Chapter
Android  Copy Section
Mantén las conexiones activas en segundo plano:
- Actívalo en Ajustes > Avanzado > Ejecución en segundo plano
- Requiere exclusión de la optimización de batería
- Notificaciones persistentes para conexiones activas
iOS  Copy Section
Se aplican limitaciones de segundo plano:
- Las conexiones pueden pausarse en segundo plano
- Reconexión rápida al volver a la app
- Soporte para actualización en segundo plano
Notificaciones Push  Copy Chapter
Recibe notificaciones para:
- Alertas de servidor fuera de línea
- Avisos de alto uso de recursos
- Alertas de finalización de tareas
Configúralo en Ajustes > Notificaciones.
Funciones de UI Móvil  Copy Chapter
- Deslizar para refrescar: Actualiza el estado del servidor
- Acciones de deslizamiento: Operaciones rápidas de servidor
- Modo horizontal: Mejor experiencia de terminal
- Teclado virtual: Atajos de terminal
Integración de Archivos  Copy Chapter
- App Archivos (iOS): Acceso directo SFTP desde Archivos
- Storage Access Framework (Android): Comparte archivos con otras apps
- Selector de documentos: Selección de archivos sencilla
---
Src/Content/Docs/Es/Principles/Architecture  Copy Section
---
title: Descripción General de la Arquitectura
description: Arquitectura de alto nivel de la aplicación
---
Server Box sigue una arquitectura por capas con una clara separación de responsabilidades.
Capas de la Arquitectura  Copy Chapter

Fundamentos de la Aplicación  Copy Chapter
Punto de Entrada Principal  Copy Section
lib/main.dart inicializa la aplicación:

Widget Raíz  Copy Section
MyApp proporciona:
- Gestión de Temas: Cambio entre tema claro/oscuro
- Configuración de Rutas: Estructura de navegación
- Provider Scope: Raíz para la inyección de dependencias
Página de Inicio  Copy Section
HomePage sirve como núcleo de navegación:
- Interfaz de Pestañas: Servidor, Snippet, Contenedor, SSH
- Gestión de Estado: Estado por pestaña
- Navegación: Acceso a funciones
Sistemas Principales  Copy Chapter
Gestión de Estado: Riverpod  Copy Section
¿Por qué Riverpod?
- Seguridad en tiempo de compilación
- Facilidad para realizar pruebas
- Sin dependencia del Build context
- Funciona en todas las plataformas
Tipos de Provider Utilizados:
- StateProvider: Estado mutable simple
- AsyncNotifierProvider: Estados de carga/error/datos
- StreamProvider: Flujos de datos en tiempo real
- Future providers: Operaciones asíncronas únicas
Persistencia de Datos: Hive CE  Copy Section
¿Por qué Hive CE?
- Sin dependencias de código nativo
- Almacenamiento clave-valor rápido
- Tipado seguro con generación de código
- Sin necesidad de anotaciones manuales de campos
Almacenes (Stores):
- SettingStore: Preferencias de la app
- ServerStore: Configuraciones de servidores
- SnippetStore: Fragmentos de comandos
- KeyStore: Claves SSH
Modelos Inmutables: Freezed  Copy Section
Beneficios:
- Inmutabilidad en tiempo de compilación
- Tipos Union para el estado
- Serialización JSON integrada
- Extensiones CopyWith
Estrategia Multiplataforma  Copy Chapter
Sistema de Plugins  Copy Section
Los plugins de Flutter proporcionan la integración con la plataforma:
| Plataforma | Método de Integración |
|------------|-----------------------|
| iOS | CocoaPods, Swift/Obj-C |
| Android | Gradle, Kotlin/Java |
| macOS | CocoaPods, Swift |
| Linux | CMake, C++ |
| Windows | CMake, C# |
Funciones Específicas por Plataforma  Copy Section
Solo iOS:
- Widgets de pantalla de inicio
- Actividades en Directo (Live Activities)
- Compañero de Apple Watch
Solo Android:
- Servicio en segundo plano
- Notificaciones push
- Acceso al sistema de archivos
Solo Escritorio:
- Integración en la barra de menús
- Múltiples ventanas
- Barra de título personalizada
Dependencias Personalizadas  Copy Chapter
Rama (Fork) de dartssh2  Copy Section
Cliente SSH mejorado con:
- Mejor soporte para móviles
- Gestión de errores mejorada
- Optimizaciones de rendimiento
Rama (Fork) de xterm.dart  Copy Section
Emulador de terminal con:
- Renderizado optimizado para móviles
- Soporte para gestos táctiles
- Integración con teclado virtual
fl_lib  Copy Section
Paquete de utilidades compartidas con:
- Widgets comunes
- Extensiones
- Funciones de ayuda
Sistema de Compilación  Copy Chapter
Paquete fl_build  Copy Section
Sistema de compilación personalizado para:
- Compilaciones multiplataforma
- Firma de código
- Empaquetado de recursos (assets)
- Gestión de versiones
Proceso de Compilación  Copy Section

1. Pre-compilación: Cálculo de la versión desde Git
2. Compilación: Compilar para la plataforma de destino
3. Post-compilación: Empaquetado y firma
Ejemplo de Flujo de Datos  Copy Chapter
Actualización del Estado del Servidor  Copy Section

Flujo de Acción del Usuario  Copy Section

Arquitectura de Seguridad  Copy Chapter
Protección de Datos  Copy Section
- Contraseñas: Cifradas con flutter_secure_storage
- Claves SSH: Cifradas en reposo
- Huellas de Host: Almacenadas de forma segura
- Datos de Sesión: No se persisten
Seguridad de Conexión  Copy Section
- Verificación de Clave de Host: Detección de MITM
- Cifrado: Cifrado SSH estándar
- Sin Texto Plano: Los datos sensibles nunca se almacenan en plano
---
Src/Content/Docs/Es/Principles/Sftp  Copy Section
---
title: Sistema SFTP
description: Cómo funciona el explorador de archivos SFTP
---
El sistema SFTP proporciona capacidades de gestión de archivos sobre SSH.
Arquitectura  Copy Chapter

Establecimiento de la Conexión  Copy Chapter
Creación del Cliente SFTP  Copy Section

Reutilización de Conexiones  Copy Section
SFTP reutiliza las conexiones SSH existentes:

Operaciones del Sistema de Archivos  Copy Chapter
Listado de Directorios  Copy Section

Metadatos de Archivo  Copy Section

Operaciones de Archivo  Copy Chapter
Subida (Upload)  Copy Section

Descarga (Download)  Copy Section

Edición de Permisos  Copy Section

Gestión de Rutas  Copy Chapter
Estructura de Rutas  Copy Section

Historial de Navegación  Copy Section

Sistema de Transferencia  Copy Chapter
Petición de Transferencia  Copy Section

Seguimiento de Progreso  Copy Section

Gestión de Colas  Copy Section

Patrón de Almacenamiento Local  Copy Chapter
Caché de Descargas  Copy Section
Los archivos descargados se guardan en:

Ejemplo:
- Remoto: /var/log/nginx/access.log
- spiId: server-123
- Local: Paths.file/server-123/_var_log_nginx_access.log
Edición de Archivos  Copy Chapter
Flujo de Trabajo de Edición  Copy Section

Integración con Editor Externo  Copy Section

Gestión de Errores  Copy Chapter
Errores de Permiso  Copy Section

Erreores de Conexión  Copy Section

Errores de Espacio  Copy Section

Optimizaciones de Rendimiento  Copy Chapter
Caché de Directorios  Copy Section

Carga Perezosa (Lazy Loading)  Copy Section
Para directorios grandes (>1000 elementos):

Paginación  Copy Section

---
Src/Content/Docs/Es/Principles/Ssh  Copy Section
---
title: Conexión SSH
description: Cómo se establecen y gestionan las conexiones SSH
---
Entendiendo las conexiones SSH en Server Box.
Flujo de Conexión  Copy Chapter

Paso 1: Configuración  Copy Section
El modelo Spi (Server Parameter Info) contiene:

Paso 2: Generación del Cliente  Copy Section
genClient(spi) crea el cliente SSH:

Paso 3: Servidor de Salto (si está configurado)  Copy Section
Para servidores de salto, conexión recursiva:

Métodos de Autenticación  Copy Chapter
Autenticación por Contraseña  Copy Section

- Contraseña almacenada cifrada en Hive
- Descifrada al conectar
- Enviada al servidor para verificación
Autenticación por Clave Privada  Copy Section