Guide de Démarrage Rapide

Ce guide vous aidera à installer et configurer Infrarust pour votre première utilisation.

Installation Rapide

Télécharger le Binaire Précompilé

1. Téléchargez la dernière version depuis la page des releases
2. Extrayez l'archive à l'emplacement souhaité

Configuration de Base

1. Créer les Fichiers de Configuration

Créez un fichier config.yaml dans votre répertoire de travail :

# Configuration minimale
bind: "0.0.0.0:25565"  # Adresse d'écoute
keepAliveTimeout: 30s
filters:
  rateLimiter:
    requestLimit: 10
    windowLength: 1s

Créez un dossier proxies et ajoutez un fichier de configuration pour votre serveur :

# proxies/my-server.yml
domains:
  - "hub.minecraft.example.com"  # Domaine spécifique
addresses:
  - "localhost:25566"  # Adresse du serveur Minecraft
proxyMode: "passthrough"  # Mode de proxy

2. Démarrer Infrarust

./infrarust

3. Se Connecter et Vérifier

1. Lancez votre client Minecraft
2. Connectez-vous à votre domaine configuré
3. Vérifiez les logs pour confirmer la connexion

Structure des Dossiers

infrarust/
├── config.yaml          # Configuration principale
├── proxies/            # Configurations des serveurs
│   ├── hub.yml
│   └── survival.yml
├── infrarust[.exe]
└── logs/               # Journaux (créé automatiquement)

Compilation depuis les Sources

Si vous préférez compiler depuis les sources, vous aurez besoin de :

• Rust 1.84 ou supérieur
• Cargo (gestionnaire de paquets Rust)

Méthodes d'Installation

Via Cargo

cargo install infrarust

Depuis les Sources

git clone https://github.com/shadowner/infrarust
cd infrarust
cargo build --release

Pour inclure la Télémétrie, vous pouvez utiliser l'option --features lors de la compilation :

cargo build --release --features telemetry

Premiers Pas

1. Démarrer Infrarust

# Si installé via cargo
infrarust --config-path "./custom_config_path/config.yaml" --proxies-path "./custom_proxies_path/"

# Si compilé depuis les sources
./target/release/infrarust --config-path "./custom_config_path/config.yaml" --proxies-path "./custom_proxies_path/"

:::note Les arguments sont nécessaires uniquement si l'exécutable n'est pas dans le même répertoire que la structure de dossiers présentée ci-dessus :::

2. Vérifier le Fonctionnement

1. Lancez votre client Minecraft
2. Connectez-vous à votre domaine configuré
3. Vérifiez les logs pour confirmer la connexion

Modes de Proxy Disponibles

Infrarust propose plusieurs modes de proxy pour différents cas d'utilisation :

Mode	Description	Cas d'Utilisation
passthrough	Transmission directe	Pas de fonction de plugin, juste un proxy compatible avec toutes les versions de Minecraft
client_only	Auth côté client	Serveurs en online_mode=false, mais client premium
offline	Sans authentification	Serveurs online_mode=false et client cracké

D'autres modes sont en cours de développement

Configuration de Base

Protection DDoS Simple

# Dans config.yaml
filters:
  rateLimiter:
    requestLimit: 10
    windowLength: 1s

Prochaines Étapes

Une fois la configuration de base terminée, vous pouvez :

1. Configurer les différents modes de proxy
2. Optimiser les performances
3. Configurer le monitoring

Résolution des Problèmes Courants

Le proxy ne démarre pas

• Vérifiez que le port n'est pas déjà utilisé
• Assurez-vous d'avoir les permissions nécessaires
• Vérifiez la syntaxe du fichier de configuration

Les clients ne peuvent pas se connecter

• Vérifiez la configuration des domaines
• Assurez-vous que les serveurs de destination sont accessibles
• Vérifiez les logs pour des erreurs spécifiques
• Vérifiez que le mode est compatible avec votre serveur

Problèmes de Performance

• Activez le cache de status
• Vérifiez la configuration du rate limiter
• Assurez-vous que votre serveur a assez de ressources

Besoin d'Aide ?

• 🐛 Signalez un bug sur GitHub
• 💬 Rejoignez notre Discord

TIP

Pensez à consulter régulièrement la documentation car Infrarust est en développement actif et de nouvelles fonctionnalités sont ajoutées régulièrement.