Retour à la documentation

Edge SDK

Déployez Flitt localement sur votre infrastructure. L'Edge SDK est une application autonome et légère qui stocke vos données (joueurs, logs, samples) et communique automatiquement avec le backend Flitt pour répartir les requêtes entre vos instances.

🌐Qu'est-ce que l'Edge SDK ?

L'Edge SDK est une solution auto-hébergée qui vous permet de garder vos données de jeu localement tout en profitant de l'architecture distribuée de Flitt. Au lieu d'envoyer toutes vos données sur des serveurs centraux, vous exécutez une instance Edge qui :

  • •Stocke les données joueurs localement dans une base embarquée rapide
  • •Centralise les logs serveur pour tous vos serveurs hébergés
  • •Synchronise automatiquement avec le réseau Flitt
  • •Fonctionne en binaire autonome sans dépendances externes

Fonctionnalités clés

🚀

Binaire autonome

Aucune dépendance externe - téléchargez et lancez simplement

💾

BadgerDB

Base de données embarquée haute performance incluse

🔐

Cryptographie Ed25519

Communication sécurisée avec le réseau Flitt

📊

Gestion complète

Joueurs, logs, uptime et samples centralisés

🔄

Synchronisation automatique

Le système de heartbeat garde vos données synchronisées

💻

Multi-plateforme

Fonctionne sur Windows, Linux, macOS ou Docker

Prérequis

📦

Package Edge SDK

Téléchargez le binaire précompilé depuis votre tableau de bord

💻

Linux, Windows ou macOS

Machine dédiée ou VPS recommandé

🔌

Accès réseau

Port 8080 (modifiable) ouvert pour l'API

📝

Compte Flitt

Avec code d'enregistrement depuis le tableau de bord

Spécifications minimales

Configuration minimale recommandée pour exécuter l'Edge SDK de façon fiable sur un VPS ou une machine dédiée.

  • CPU:1 vCPU minimum
  • RAM:0.65 GB minimum
  • Disk:1 GB minimum
  • Network:Accès sortant stable + port 8080 ouvert (ou votre port configuré)
  • OS:Linux x64 recommandé (Windows pris en charge)

Ces valeurs ont été testées par nos soins en prenant en compte un serveur unique, utilisé avec des traitements de données moyens. Pour des déploiements plus importants, augmentez les ressources en conséquence.

Téléchargements

Téléchargez le binaire Edge SDK pour votre plateforme :

LinuxBinaire LinuxWindowsWindows .exePterodactylEgg Pterodactyl (.json)

Démarrage rapide

LinuxLinux (Ubuntu/Debian/Alpine)

# 1. Téléchargez l'Edge SDK.
# 2. Rendez-le exécutable (si besoin)
chmod +x ./flitt-edge-sdk

# 3. Générez la configuration
./flitt-edge-sdk --gen-config

# 4. Modifiez config.yaml avec vos informations
nano config.yaml

# 5. Lancez le SDK
./flitt-edge-sdk -config config.yaml

WindowsWindows (PowerShell)

# 1. Téléchargez l'Edge SDK.
# 2. Extrayez-le dans un dossier (exemple ci-dessous)
cd C:\\Flitt\\EdgeSDK

# 3. Générez la configuration
.\\flitt-edge-sdk.exe --gen-config

# 4. Modifiez config.yaml

# 5. Lancez le SDK
.\\flitt-edge-sdk.exe -config config.yaml

Configuration minimale

L'Edge SDK génère un fichier config.yaml par défaut. Voici la configuration minimale requise :

server:
  host: 0.0.0.0
  port: 8080

database:
  path: ./data/edge.db

instance:
  registration_code: "VVBS-XXXX-XXXX-XXXX"

💡 Note : VVBS-XXXX-XXXX-XXXX avec votre vrai code d'enregistrement depuis le tableau de bord Flitt.

Référence de configuration complète

server:
  host: 0.0.0.0          # Adresse d'écoute
  port: 8080             # Port de l'API

database:
  path: ./data/edge.db   # Chemin de stockage de la base
  max_connections: 10    # Connexions DB max

instance:
  registration_code: "${REGISTRATION_CODE}" # Requis pour le premier enregistrement
  id: ""                 # Défini automatiquement après enregistrement
  name: ""               # Par défaut : nom d'hôte si vide
  state_path: ./data/instance.json # Fichier d'état de l'instance
  edge_url: ""           # Par défaut : URL backend
  edge_port: 8080         # Par défaut : server.port

Les URLs backend, le heartbeat/reconnect, les flags de fonctionnalités et la gestion des clés sont automatiques et non configurables dans config.yaml.

Comment ça marche

1

Enregistrement

L'Edge SDK s'enregistre auprès du backend Flitt avec votre code d'enregistrement.

2

Stockage local

Toutes vos données (joueurs, logs, samples) sont stockées dans BadgerDB sur votre machine.

3

Synchronisation Heartbeat

Le SDK envoie périodiquement des heartbeats à Flitt pour garder le statut de l'instance à jour.

4

Routage des requêtes

Flitt route automatiquement les requêtes vers vos instances Edge, gardant les données localement.

Dépannage

❌ Le SDK ne démarre pas

./flitt-edge-sdk -config config.yaml 2>&1 | head -20

Vérifiez que votre fichier de configuration est un YAML valide et que tous les champs requis sont présents.

❌ Réinitialiser la base

rm -rf ./data/*
./flitt-edge-sdk --gen-config

Supprimez le dossier data pour réinitialiser la base locale.

Migrer vers Edge SDK

Si vous utilisez actuellement la solution hébergée, vous pouvez migrer vers Edge SDK :

1️⃣

Générer un code d'enregistrement

Récupérez votre code dans le tableau de bord Flitt, section instances Edge

2️⃣

Installer Edge SDK

Suivez le guide de démarrage rapide ci-dessus

3️⃣

Migrer depuis le tableau de bord

Utilisez /dashboard/edge pour déplacer un serveur cloud vers votre instance Edge SDK.

4️⃣

Vérifier

Vérifiez sur le tableau de bord que les données arrivent bien sur votre instance Edge