Se connecter en SSH

Chaque machine Secure n’accepte qu’une chose depuis Internet : SSH sur le port 22, depuis l’adresse que vous indiquez, avec la clé que vous fournissez. Les sessions Community prennent votre clé et n’ont besoin d’aucune règle IP.

Le pare-feu d’une machine Secure refuse toute autre connexion entrante : JupyterLab et les autres interfaces web s’ouvrent sur votre ordinateur par SSH, comme indiqué plus bas.

Créer une clé

Utilisez une clé Ed25519 :

ssh-keygen -t ed25519 -C "you@laptop"
cat ~/.ssh/id_ed25519.pub

Collez la ligne unique du fichier .pub. Ne collez jamais la clé privée.

Types de clés acceptés :

Autoriser votre IP

Sur Secure, saisissez l’adresse IPv4 publique de l’ordinateur depuis lequel vous vous connecterez. Trouvez-la avec :

curl -4 https://ifconfig.me

Règles :

• Une adresse unique (198.51.100.7), ou une plage d’au plus /24 (198.51.100.0/24).
• IPv4 publique uniquement. Les plages privées (10.0.0.0/8, 192.168.0.0/16, …) et 0.0.0.0/0 sont refusées.
• L’adresse est fixe pour toute la session.

Votre réseau change souvent d’adresse publique? Saisissez sa plage /24.

Sessions Community

La page de la session donne la commande SSH, prête à coller, et ouvre JupyterLab avec un terminal dans le navigateur. La machine du fournisseur n’ouvre aucun port : les connexions atteignent votre VM en passant par Node Lodge.

Se connecter

La page de la session affiche la commande dès que la machine est prête :

ssh ubuntu@203.0.113.42

• Utilisateur : ubuntu, avec sudo.
• Port : 22.
• Image : Ubuntu 24.04 LTS, pilote NVIDIA R570, CUDA 12.8.

Utiliser une clé précise :

ssh -i ~/.ssh/id_ed25519 ubuntu@203.0.113.42

Ouvrir JupyterLab

Chaque machine Secure exécute JupyterLab, prêt quand la session l’est. Il n’écoute que sur la machine. La page de la session donne la commande qui ouvre votre shell et amène JupyterLab sur votre ordinateur :

ssh -L 8888:127.0.0.1:8888 ubuntu@203.0.113.42

Tant que cette connexion reste ouverte, ouvrez http://localhost:8888/ et collez le jeton de la page de la session sur la page de connexion. Le jeton reste valable toute la session. Les notebooks sont enregistrés dans /home/ubuntu, et %pip install dans un notebook installe les paquets pour son noyau.

Port 8888 déjà pris sur votre ordinateur ? Prenez un autre port local : ssh -L 8899:127.0.0.1:8888 ubuntu@203.0.113.42, puis ouvrez http://localhost:8899/.

Atteindre une interface web ou une API

Seul le port 22 est ouvert en entrée. Redirigez les autres ports par SSH :

ssh -N -L 8000:localhost:8000 ubuntu@203.0.113.42

Ouvrez ensuite http://localhost:8000 sur votre ordinateur. Même principe pour ComfyUI (8188), Jupyter (8888) ou TensorBoard (6006).

Garder les tâches actives après la déconnexion

Lancez les longues tâches dans tmux :

tmux new -s work
# start your job, then detach with Ctrl+b d
tmux attach -t work

Transférer des fichiers

# Upload
rsync -avz ./data/ ubuntu@203.0.113.42:~/data/
# Download
rsync -avz ubuntu@203.0.113.42:~/results/ ./results/

scp fonctionne aussi. Les deux passent par le même accès SSH.

Règles réseau

Les miroirs de paquets, Hugging Face, PyPI, GitHub et les registres de conteneurs sont accessibles. Envoyez vos courriels par un relais authentifié sur le port 587.

Dépannage

Connection timed out Votre adresse IP publique ne correspond plus à celle que vous avez saisie. Vérifiez-la avec curl -4 https://ifconfig.me. Les VPN et les partages de connexion mobile la changent.

Permission denied (publickey) La clé de votre ordinateur ne correspond pas à celle que vous avez collée. Indiquez-la explicitement avec ssh -i. Utilisez l’utilisateur ubuntu, pas root.

Connection refused juste après le démarrage de la machine SSH démarre encore. Attendez 30 secondes et réessayez.

« Waiting for its public address » Le fournisseur attache l’adresse. Elle apparaît en quelques secondes.

REMOTE HOST IDENTIFICATION HAS CHANGED Une nouvelle session réutilise une adresse à laquelle vous vous êtes déjà connecté. Supprimez l’ancienne entrée :

ssh-keygen -R 203.0.113.42

Toujours bloqué? Écrivez à support@nodelodge.com avec votre numéro de session.