100 lines
3.4 KiB
Plaintext
100 lines
3.4 KiB
Plaintext
# Hébergement de capsules gemini
|
|
|
|
## Description
|
|
|
|
Unbon.cafe propose un service d'hébergement de capsules gemini. Une capsule gemini est l'exact équivalent d'un site web sur le protocole Gemini. Cela peut être un site généraliste, une application, un blog (on dira alors gemlog). Ici, vous déposez vos textes dans votre dossier public et ils seront disponibles à tou.te.s via une adresse de type gemini://unbon.cafe/votrepseudo/votrearticle.gmi.
|
|
|
|
## Caractéristiques
|
|
|
|
* Espace de 27 Go partagé entre les utilisateurs
|
|
* Utilisation d'outils simples (sftp)
|
|
* Chiffrement assuré entre le serveur et le client via SSH
|
|
* Consommation électrique maîtrisée et raisonnable
|
|
* Prêt à l'emploi
|
|
|
|
## Prix
|
|
|
|
Le prix de ce service repose uniquement sur des donations à prix libre. Vous donnez ce que vous voulez, quand vous voulez. Cela se passe directement sur ma page Liberapay.
|
|
|
|
=> https://www.liberapay.com/linuxmario Lien vers ma page Liberapay
|
|
|
|
## Inscription
|
|
|
|
Pour vous inscrire au service, vous devez générer une paire de clés SSH et envoyer votre pseudo et votre clé publique SSH à l'administrateur à cette adresse mail : vinishor@unbon.cafe
|
|
Je créerai votre compte au plus vite et je vous enverrai votre mot de passe temporaire que vous pourrez changer en vous connectant avec votre clé sur le serveur. Vous pourrez alors publier vos textes dans le dossier public_gmi qui est directement relié au serveur gemini.
|
|
|
|
=> mailto:vinishor@unbon.cafe?subject=Nouvelle-capsule-pour-moi Lien pour vous inscrire
|
|
|
|
## Configuration
|
|
|
|
### Créer sa clé SSH
|
|
|
|
Pour créer une clé SSH sans prise de tête, faites simplement :
|
|
|
|
```
|
|
ssh-keygen -t ed25519 -f ~/.ssh/clessh -a 100
|
|
```
|
|
|
|
Vous pouvez entrer un mot de passe si vous voulez. En général, c'est conseillé (si jamais vous perdez la clé). Le fichier se terminant en .pub (ici ~/.ssh/clessh.pub) contient la clé publique que vous devez m'envoyer pour pouvoir configurer votre compte et vous connecter sur la machine. L'autre fichier, la clé privée, ne doit jamais être partagé.
|
|
|
|
### Informations de connexion
|
|
|
|
Pour vous connecter au service, voici les informations à rentrer :
|
|
|
|
* Nom de domaine : unbon.cafe
|
|
* Port : 23
|
|
|
|
### Configurer son client pour une connexion simplifiée
|
|
|
|
Pour vous connecter plus simplement à ce serveur, vous pouvez créer une configuration dans un fichier ~/.ssh/config :
|
|
|
|
```
|
|
Host unboncafe
|
|
User votrepseudo
|
|
Port 23
|
|
Hostname unbon.cafe
|
|
IdentityFile ~/.ssh/clessh
|
|
```
|
|
|
|
Une fois cela fait, il suffira d'utiliser la commande SFTP pour vous connecter automatiquement le serveur et déposer vos fichiers.
|
|
|
|
## Exemple de session
|
|
|
|
```
|
|
$ sftp unboncafe
|
|
...Bannière de unbon.cafe...
|
|
Connected to 10.10.0.2.
|
|
sftp> pwd
|
|
Remote working directory: /home/votrepseudo
|
|
sftp> put index.gmi
|
|
Uploading index.gmi to /home/votrepseudo/index.gmi
|
|
index.gmi 100% 2290 72.1KB/s 00:00
|
|
```
|
|
|
|
## Syntaxe
|
|
|
|
Si vous voulez un exemple de syntaxe sous Gemini, voici une petite liste d'exemples :
|
|
|
|
```
|
|
Une ligne est considérée comme un paragraphe.
|
|
|
|
Les lignes vides restent vides.
|
|
|
|
=> gemini://domaine.tld/un-lien.gmi Ceci est un lien
|
|
=> https://domaine.tld/ Un autre lien
|
|
=> /lien-relatif/sans/description
|
|
|
|
* liste 1
|
|
* liste 2
|
|
* liste 3
|
|
|
|
> Ceci est une citation
|
|
|
|
# TITRE niveau 1
|
|
## Titre niveau 2
|
|
### titre niveau 3
|
|
|
|
Chaque ligne constituée de ``` active ou désactive le mode préformaté. Encadrez du code source avec des lignes "```" pour qu'il reste intouché.
|
|
```
|
|
|