Utiliser Git avec Forgejo en SSH sur un port personnalisé
Introduction
Lorsqu’on utilise Forgejo pour héberger ses dépôts Git, l’authentification HTTPS nécessite généralement un token personnel.
Il est possible de remplacer cette méthode par une authentification SSH, même lorsque le serveur Debian utilise un port SSH personnalisé.
L’avantage : plus besoin de copier-coller son token lors des opérations git push et git pull.
1. Configuration de Forgejo sur Debian
Dans le fichier app.ini de Forgejo, section [server], modifier les paramètres suivants :
1
2
3
4
5
[server]
SSH_DOMAIN = forgejo.rnmkcy.eu
SSH_PORT = 55205
DISABLE_SSH = false
START_SSH_SERVER = false
Explications :
SSH_DOMAIN: nom de domaine utilisé pour accéder à Forgejo.SSH_PORT: port du serveur OpenSSH Debian.DISABLE_SSH = false: autorise les connexions Git en SSH.START_SSH_SERVER = false: utilise le serveur OpenSSH existant plutôt que le serveur SSH intégré à Forgejo.
Redémarrer Forgejo :
1
sudo systemctl restart forgejo
2. Tester l’authentification SSH
L’accès SSH au serveur Debian utilise déjà une clé privée :
1
ssh -p 55205 -i /home/debjek/.ssh/cwwk yick@192.168.0.205
Pour Forgejo, on utilise le compte Git git :
1
ssh -p 55205 -i /home/debjek/.ssh/cwwk git@forgejo.rnmkcy.eu
La clé publique correspondante doit être enregistrée dans Forgejo :
Avatar → Paramètres → Clés SSH/GPG → Ajouter une clé.
Un test réussi affiche un message similaire à :
1
2
3
Hi there, yannig! You've successfully authenticated
with the key named debjek@debian,
but Forgejo does not provide shell access.
Ce message est normal : Forgejo autorise les opérations Git, mais pas l’ouverture d’un terminal interactif.
3. Configurer le dépôt Git
Dans le répertoire local du projet, remplacer l’adresse HTTPS par l’adresse SSH :
1
git remote set-url origin ssh://git@forgejo.rnmkcy.eu:55205/yannig/monprojet.git
Remplacer yannig et monprojet par le propriétaire et le nom du dépôt.
Vérifier l’adresse :
1
git remote -v
4. Mémoriser le port et la clé SSH dans Git
Pour éviter de préciser le port et le chemin de la clé à chaque opération, configurer Git directement dans le dépôt :
1
git config core.sshCommand "ssh -p 55205 -i /home/debjek/.ssh/cwwk -o IdentitiesOnly=yes"
Cette configuration est locale au dépôt.
Désormais, les commandes habituelles fonctionnent directement :
1
2
3
git push
git pull
git fetch
Plus besoin de token Forgejo ni de fichier ~/.ssh/config !
5. Vérification finale
La configuration peut être contrôlée avec :
1
2
git remote -v
git config --get core.sshCommand
Conclusion
Forgejo permet d’utiliser l’authentification SSH avec un port personnalisé, même lorsque le serveur Debian utilise déjà ce port pour son administration.
La configuration repose sur trois éléments :
- Activer SSH dans le fichier
app.inide Forgejo. - Enregistrer la clé publique dans son compte Forgejo.
- Configurer l’adresse distante et la commande SSH dans le dépôt Git.
On conserve ainsi son accès SSH habituel au serveur Debian tout en bénéficiant d’une authentification SSH transparente pour les opérations Git.
