# 🌐 Publier un serveur web local avec localhost.run

## 🎯 Objectif

Rendre accessible sur Internet un site web ou une application web hébergée localement (par exemple avec `python -m http.server` ou Streamlit), grâce à un **tunnel SSH** via [localhost.run](https://localhost.run).

---

## 🧩 1. Démarrer un petit serveur web local

Placez-vous dans le dossier contenant votre fichier `index.html`, puis lancez :

```bash
python3 -m http.server 8501
```

- Le serveur écoute sur le port **8501**  
- Vérifiez sur : [http://localhost:8501](http://localhost:8501)

---

## 🔑 2. Créer une clé SSH (une seule fois par machine)

Une **clé SSH** permet de s’authentifier de façon sécurisée auprès de `localhost.run` sans mot de passe.

### ➤ Étape 1 : Génération de la clé

```bash
ssh-keygen -t ed25519 -C "localhost.run"
```

- Appuyez sur **Entrée** à chaque question pour accepter les valeurs par défaut.  
- Les fichiers sont créés dans :
  - `~/.ssh/id_ed25519` → clé **privée**
  - `~/.ssh/id_ed25519.pub` → clé **publique**

### ➤ Étape 2 : Démarrer l’agent SSH et ajouter la clé

```bash
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
```

### ➤ Étape 3 : Copier la clé publique

```bash
cat ~/.ssh/id_ed25519.pub
```

Copiez la ligne affichée (commence par `ssh-ed25519 ...`).

---

## 🌍 3. Créer un compte sur localhost.run

1. Ouvrez [https://admin.localhost.run](https://admin.localhost.run)
2. Connectez-vous (Google, GitHub ou email)
3. Collez votre **clé publique SSH** dans la zone prévue
4. Validez

> 🔐 Votre clé publique identifie votre machine.  
> Ne partagez **jamais** la clé privée (`id_ed25519`).

---

## 🚀 4. Créer le tunnel sécurisé

Dans un **nouveau terminal** (laissez votre serveur HTTP ouvert) :

```bash
ssh -o ExitOnForwardFailure=yes -R 80:localhost:8501 localhost.run
```

Une URL s’affiche, par exemple :

```
https://9a12bc34d5ef6.lhr.life
```

👉 Ce lien permet d’accéder à votre site depuis Internet.

---

## ⚙️ 5. Comprendre la commande

| Élément | Signification |
|----------|----------------|
| `ssh` | démarre une connexion sécurisée |
| `-R` | redirection de port distante |
| `80` | port distant (HTTP public) |
| `localhost:8501` | adresse et port du serveur local |
| `localhost.run` | service de tunnel public |

> 💡 Avec le **compte gratuit**, l’adresse générée est aléatoire et temporaire (ex. `https://abc123.lhr.life`).  
> La réservation d’un sous-domaine personnalisé (`mon-site.lhr.rocks`) nécessite un **abonnement payant**.

---

## 🔁 6. Maintenir la connexion

Tant que le terminal reste ouvert, le site est accessible.  
Pour un tunnel plus stable :

```bash
autossh -M 0 -o "ServerAliveInterval=60" -R 80:localhost:8501 localhost.run
```

---

## 🔒 7. Sécurité

- Ne partagez **jamais** votre clé privée.  
- Servez uniquement des fichiers publics.  
- Le tunnel est **chiffré** (SSH + HTTPS).  
- Fermez le terminal pour couper l’accès public.

---

## 🧠 8. Exemples pratiques

| Application | Commande locale | Tunnel |
|--------------|-----------------|---------|
| Site statique | `python3 -m http.server 8000` | `ssh -R 80:localhost:8000 localhost.run` |
| Streamlit | `streamlit run app.py --server.port 8501` | `ssh -R 80:localhost:8501 localhost.run` |
| Flask | `flask run -p 5000` | `ssh -R 80:localhost:5000 localhost.run` |

---

## ✅ Récapitulatif

| Étape | Commande | Résultat |
|:--|:--|:--|
| 1️⃣ Créer la clé SSH | `ssh-keygen -t ed25519 -C "localhost.run"` | Authentification sécurisée |
| 2️⃣ Démarrer le serveur | `python3 -m http.server 8501` | Serveur local actif |
| 3️⃣ Créer le tunnel | `ssh -R 80:localhost:8501 localhost.run` | URL publique générée |
| 4️⃣ Tester | Ouvrir le lien HTTPS fourni | Accès depuis Internet |

---

## 🧾 Références

- Site officiel : [https://localhost.run](https://localhost.run)  
- Documentation : [https://localhost.run/docs](https://localhost.run/docs)  
- Gestion de compte : [https://admin.localhost.run](https://admin.localhost.run)

---

✍️ *Fiche réalisée pour les élèves de BTS CIEL / NSI — Prof. F. Méchain*