Client SSH/SFTP personnel pour Windows
Reunit en un seul outil les fonctions utiles de MobaXterm, Termius et Bitvise, sans compte ni service tiers, avec toutes les donnees en local. - Terminaux multi-onglets : sessions SSH et terminaux Windows locaux (PowerShell / cmd) via la pseudo-console native ConPTY - Gestionnaire de fichiers SFTP facon WinSCP : double panneau, colonnes triables, glisser-deposer, renommage, permissions, file de transferts. Ouvrable sur une connexion en cours sans creer de favori - Gestion des cles SSH : generation Ed25519/RSA, import, export - Gestion du fichier known_hosts, avec remplacement guide d'une cle d'hote modifiee (cas frequent des serveurs en DHCP) - Trois themes (clair, bleu nuit, noir), commutables a chaud - Authentification automatique reprenant le comportement de la commande ssh (agent SSH et cles ~/.ssh), mot de passe demande seulement en secours Aucun mot de passe n'est stocke sur le disque. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
snoopy
123
README.md
Normal file
123
README.md
Normal file
@@ -0,0 +1,123 @@
|
||||
# PySSH Client
|
||||
|
||||
Client SSH/SFTP personnel (type MobaXterm/Termius/Bitvise), 100% local, sans compte ni service tiers.
|
||||
|
||||
## Fonctionnalites
|
||||
|
||||
- Sessions SSH multiples dans des onglets, avec terminal ANSI colore (theme "bleu nuit")
|
||||
- Terminaux locaux Windows (PowerShell / Invite de commandes) accessibles en un clic, **sans avoir besoin d'une session enregistree** — pratique pour un usage ponctuel, comme le terminal Windows natif
|
||||
- Carnet d'adresses de serveurs (JSON local, `data/sessions.json`) organise par dossiers, connexion en un clic
|
||||
- Gestion des cles SSH : generation (Ed25519 / RSA), import de cles existantes, export (cle publique/privee)
|
||||
- Client SFTP integre facon WinSCP : double panneau local/distant avec colonnes triables (nom, taille, date, droits),
|
||||
glisser-deposer entre les panneaux, renommage (F2), suppression (Suppr), creation de dossier, permissions distantes
|
||||
(chmod), et file de transferts avec progression. **Aucun favori n'est necessaire pour l'utiliser** — voir ci-dessous
|
||||
- **SFTP sur la connexion en cours** : depuis n'importe quel terminal ou vous avez tape `ssh user@hote` a la main, le
|
||||
bouton "📁 SFTP sur cette connexion" lit l'hote, l'utilisateur et le port dans la commande saisie et ouvre le
|
||||
gestionnaire de fichiers dessus. Pense pour les serveurs de test en DHCP, qu'on n'a aucune envie d'enregistrer
|
||||
- **Authentification automatique** (mode par defaut) : comme la commande `ssh`, l'application utilise l'agent SSH et les
|
||||
cles de `~/.ssh` sans que vous ayez a designer quoi que ce soit, et ne demande un mot de passe qu'en dernier recours
|
||||
- Verification des empreintes de cles d'hote (TOFU) avant premiere connexion, comme un client SSH classique
|
||||
- Gestionnaire des hotes connus (menu "Hotes connus" ou bouton "⚙" du panneau lateral) : si une adresse en DHCP change de machine, la cle d'hote presentee ne correspond plus a celle enregistree — l'application le detecte et propose de remplacer l'ancienne entree directement au moment de la connexion, sans avoir a vider le fichier `known_hosts` a la main. Le gestionnaire permet aussi un nettoyage manuel (par hote ou en une fois).
|
||||
|
||||
Aucun mot de passe n'est stocke sur le disque : l'authentification par mot de passe est demandee a chaque connexion, et les passphrases de cles sont demandees uniquement en memoire au moment de la connexion.
|
||||
|
||||
## Installation (Windows)
|
||||
|
||||
Necessite Python 3.10+ installe sur le poste (verifiable avec `py -3 --version`).
|
||||
|
||||
```bash
|
||||
setup.bat
|
||||
```
|
||||
|
||||
Ce script cree un environnement virtuel local (`venv/`) et y installe les dependances (PySide6, paramiko, pyte, cryptography, pywinpty) — rien n'est installe globalement sur le poste.
|
||||
|
||||
## Lancement
|
||||
|
||||
Trois facons, au choix :
|
||||
|
||||
- **Raccourci Windows** (recommande) : double-cliquez sur `PySSH Client.lnk` a la racine du projet.
|
||||
Il lance l'application via `pythonw.exe`, donc **sans fenetre de console noire**. Vous pouvez le
|
||||
copier sur le Bureau, ou l'epingler a la barre des taches.
|
||||
Pour le (re)creer — apres un deplacement du projet, ou sur un autre poste :
|
||||
|
||||
```bash
|
||||
powershell -ExecutionPolicy Bypass -File tools\create_shortcut.ps1 -Desktop
|
||||
```
|
||||
|
||||
(`-Desktop` et `-StartMenu` sont optionnels et ajoutent une copie a ces emplacements.)
|
||||
|
||||
- **En ligne de commande**, sans console residuelle :
|
||||
|
||||
```bash
|
||||
venv\Scripts\pythonw.exe main.py
|
||||
```
|
||||
|
||||
- **`run.bat`** : garde une fenetre de console ouverte, ce qui est pratique pour voir les erreurs
|
||||
si l'application refuse de demarrer.
|
||||
|
||||
## Version portable (sans Python installe)
|
||||
|
||||
```bash
|
||||
build_exe.bat
|
||||
```
|
||||
|
||||
Produit un dossier autonome `dist\PySSH Client\` contenant l'executable et tout ce dont il a besoin,
|
||||
interpreteur Python compris. Copiez ce dossier ou vous voulez (y compris sur une cle USB) : il
|
||||
fonctionne sur n'importe quel poste Windows, **meme sans Python installe**.
|
||||
|
||||
Le format retenu est un dossier plutot qu'un fichier `.exe` unique : avec PySide6, un executable
|
||||
unique doit decompresser environ 200 Mo a chaque lancement, ce qui ajoute plusieurs secondes
|
||||
d'attente a chaque demarrage. Le dossier demarre immediatement.
|
||||
|
||||
**Ou sont stockees les donnees ?** A cote de l'executable, dans son propre sous-dossier `data\`
|
||||
(mode portable : vos sessions et cles suivent la cle USB). Si cet emplacement n'est pas accessible
|
||||
en ecriture — installation dans `Program Files`, support en lecture seule — l'application bascule
|
||||
automatiquement sur `%APPDATA%\PySSHClient\`.
|
||||
|
||||
## Premiers pas
|
||||
|
||||
1. **Terminal local immediat** : bouton "💻 Terminal" dans le panneau lateral (ou `Ctrl+Shift+T`), ou double-clic sur "PowerShell"/"Invite de commandes" dans la section "Terminaux locaux" de l'arborescence — aucune session a creer.
|
||||
2. **Nouvelle session SSH** (bouton "+ Session" ou `Ctrl+N`) : renseignez l'hote, le port, l'utilisateur et le mode d'authentification.
|
||||
3. **Cles SSH** (menu "Cles SSH > Gestionnaire de cles") : generez une nouvelle paire de cles ou importez-en une existante, puis selectionnez-la dans le formulaire de session.
|
||||
4. Double-cliquez sur une session dans l'arborescence pour ouvrir un onglet terminal SSH.
|
||||
5. **SFTP — trois facons d'y arriver**, selon la situation :
|
||||
- *Vous avez tape `ssh user@hote` dans un terminal* : bouton **"📁 SFTP sur cette connexion"** dans la barre de
|
||||
l'onglet. L'hote et l'utilisateur sont deduits de la commande, le formulaire est pre-rempli. Rien a enregistrer.
|
||||
- *Connexion ponctuelle* : bouton **"📁 SFTP"** du panneau lateral, ou `Ctrl+Shift+F`. La case "Enregistrer dans mes
|
||||
sessions" est decochee par defaut.
|
||||
- *Session enregistree* : clic droit > **"Ouvrir en SFTP"** (onglet dedie). Dans une session SSH ouverte par
|
||||
l'application, le panneau de fichiers est deja affiche a cote du terminal, comme dans MobaXterm.
|
||||
|
||||
Dans tous les cas : glisser-deposer entre les deux panneaux, F2 renomme, Suppr supprime, F5 actualise, et le clic
|
||||
droit sur le panneau distant donne acces aux permissions (chmod).
|
||||
|
||||
## Structure du projet
|
||||
|
||||
```
|
||||
main.py point d'entree
|
||||
app/
|
||||
theme.py feuille de style "bleu nuit" + icone d'application
|
||||
session_manager.py base de sessions (JSON)
|
||||
key_manager.py generation/import/export de cles SSH
|
||||
ssh_connection.py connexion SSH en arriere-plan (paramiko + QThread)
|
||||
known_hosts_manager.py gestion du fichier known_hosts (lister/retirer/remplacer une cle d'hote)
|
||||
local_terminal.py terminal local Windows (PowerShell/cmd via pywinpty)
|
||||
terminal_widget.py emulateur de terminal ANSI (pyte + QPainter)
|
||||
sftp_panel.py client SFTP a deux panneaux
|
||||
main_window.py fenetre principale (arbre de sessions + onglets)
|
||||
dialogs/ boites de dialogue (session, cles, connexion)
|
||||
resources/
|
||||
theme.qss feuille de style Qt "bleu nuit"
|
||||
data/
|
||||
sessions.json vos serveurs enregistres (non versionne)
|
||||
keys.json registre des cles connues (non versionne)
|
||||
keys/ cles generees par l'application (non versionne)
|
||||
known_hosts empreintes d'hotes approuvees (non versionne)
|
||||
```
|
||||
|
||||
## Limites connues / pistes d'amelioration
|
||||
|
||||
- L'emulation de terminal couvre les usages courants (bash, vim, htop...) mais n'est pas un xterm parfaitement complet.
|
||||
- Le terminal local repose sur `pywinpty` (pseudo-console Windows). Si un onglet local reste bloque sur un ecran vide, tapez une touche : le rafraichissement de la console Windows peut etre paresseux dans certains contextes (notamment les sessions Windows non interactives) et se declenche a la premiere frappe.
|
||||
- Le SFTP ne propose pas encore l'edition de fichier distant en place (telecharger / modifier / renvoyer a la main).
|
||||
- Pas encore d'export/import global du carnet de sessions (le fichier `data/sessions.json` peut etre copie manuellement).
|
||||
Reference in New Issue
Block a user