Étape 1. Préparer un VPS & vérifier les prérequis
Avant de lancer l'installateur, provisionnez un VPS/VDS propre (chez votre propre fournisseur ou via les partenaires recommandés dans /vps et /cabinet) :
- Système d'exploitation : Debian 13 propre (recommandé) ou Debian 12 x86_64. Évitez les panneaux de contrôle préinstallés ou les règles de pare-feu conflictuelles.
- Identifiants d'accès : adresse IPv4 publique, port SSH (habituellement
22), nom d'utilisateur (rootou un utilisateur avec privilèges sudo) et soit un mot de passe SSH, soit une clé privée OpenSSH/PEM (-----BEGIN OPENSSH PRIVATE KEY-----). - Domaine (optionnel avant installation) : vous pouvez lier un domaine personnalisé et émettre des certificats TLS directement depuis le panneau d'administration Apium Cloud OS juste après le déploiement.
- Emplacement de licence (optionnel) : si vous prévoyez d'utiliser Pro (jusqu'à 100 utilisateurs, API REST complète, Cascade) ou Ultra (jusqu'à 1 000 utilisateurs), achetez un emplacement à vie dans /cabinet au préalable — ou démarrez gratuitement sur Lite (jusqu'à 25 utilisateurs) et mettez à niveau plus tard.
Étape 2. Lancer l'assistant SSH Zero-Disk dans l'Espace Client
Connectez-vous à /cabinet (2FA prise en charge), choisissez « Install on my server » et remplissez le formulaire de déploiement :
- Saisissez l'IP / Hôte du serveur, le Port SSH et l'Utilisateur SSH.
- Sélectionnez le type d'authentification : Mot de passe SSH ou Clé SSH privée. Les identifiants restent strictement en mémoire pour la session SSH active et ne sont jamais écrits sur disque (architecture Zero-Disk).
- Sélectionnez éventuellement un emplacement de licence payant non attribué (Pro ou Ultra) pour une liaison automatique lors du provisionnement, ou laissez sur Lite.
- Cliquez sur « Install Apium Cloud OS on server » et suivez la console de progression en direct.
Étape 3. Les 4 étapes d'installation automatisées
Ce qui se passe pendant le déploiement
Pipeline automatiséL'assistant exécute quatre étapes déterministes sur votre serveur Debian cible et diffuse les journaux en temps réel dans votre Espace Client.
| Étape | Identifiant | Actions effectuées sur le VPS cible |
|---|---|---|
| Étape 1 | SSH Preflight & OS Check | Vérifie l'accessibilité SSH, les privilèges root/sudo, la compatibilité Debian 12/13 et les ressources système disponibles. |
| Étape 2 | Prepare Apium Cloud OS Environment | Configure les dépôts, installe les dépendances système, ajuste les paramètres réseau du noyau et prépare les répertoires isolés. |
| Étape 3 | Bootstrap Runtime & Panel | Déploie le démon de contrôle Rust, les services systemd, les moteurs Xray/Hysteria2/accel-ppp/strongSwan, les règles nftables et lie votre licence si sélectionnée. |
| Étape 4 | Health & Readiness Verification | Exécute des contrôles de santé sur les démons principaux et affiche l'URL unique de votre panneau, le nom d'utilisateur admin et le mot de passe temporaire. |
Étape 4. Première connexion & configuration initiale du panneau
Une fois l'étape 4 terminée, enregistrez les identifiants à usage unique affichés dans la sortie de l'assistant et ouvrez l'URL de votre console d'administration :
- 1. Sécurisez votre compte admin : connectez-vous avec les identifiants temporaires et modifiez immédiatement le mot de passe administrateur.
- 2. Sélectionnez le mode de fonctionnement : conservez Cascade VPN pour l'Internet multi-protocoles & le routage Upstream Relay, ou activez Corporate Gateway pour une base de données isolée, une CA X.509, AD/RADIUS et des ACL de segments.
- 3. Configurez le domaine & les protocoles : pointez votre enregistrement DNS A vers l'IP du VPS, liez votre domaine dans les paramètres du panneau pour le TLS (Windows SSTP / console HTTPS) et activez les protocoles nécessaires (
VLESS Reality,Hysteria 2,Windows SSTP,L2TP/IPsec). - 4. Définissez les profils pare-feu & shaper : choisissez un niveau
nftables(Basic,RestrictedouParanoidpour bloquer P2P/SMTP) et configurez les limites de bande passantetcpar groupe.
Étape 5. Gestion, import & transfert des licences
- Liaison automatique via l'assistant : les licences sélectionnées à l'étape 2 s'activent automatiquement sur le nœud pendant l'étape 3.
- Import manuel (serveurs autonomes) : copiez votre identifiant serveur depuis l'en-tête du panneau admin, générez
license.keydans l'Espace Client et importez-le dans le panneau. - Migration VPS en un clic : vous changez de serveur ? Cliquez sur Unbind from server dans l'Espace Client pour révoquer l'ancienne liaison et réutiliser votre emplacement à vie sur le nouveau VPS.
Étape 6. Liste de vérification post-installation
Vérification de santé technique
- Confirmez que tous les services de tunnel requis affichent ONLINE sur le tableau de bord Apium (MS-SSTP, L2TP, strongSwan, sing-box/Xray).
- Vérifiez que la télémétrie CPU, RAM et charge de canal en temps réel se met à jour.
Vérification client & routage
- Créez un compte de test, vérifiez les limites de quota/vitesse et testez la connectivité depuis votre client cible (application, Windows SSTP ou MikroTik/Keenetic).
- Si vous utilisez Upstream Relay, vérifiez que les sondes de santé 15s réussissent pour vos nœuds de sortie par pays.