SSHPortForwarder Support Doc.it - ai-doge/PublicWiki GitHub Wiki
🌐 English · العربية · Deutsch · Español · Français · Italiano · 日本語 · 한국어 · Nederlands · Português (BR) · Русский · ภาษาไทย · Türkçe · 简体中文 · 繁體中文
SSH Port Forwarder - Documentazione di Supporto
Introduzione
SSH Port Forwarder (SSHPortForwarder) è un'app per macOS che crea inoltri di porta SSH e proxy SOCKS. Configuri host remoti, porte e metodi di autenticazione (password o chiave privata), poi avvii un inoltro per ottenere una porta locale o un proxy SOCKS senza lasciare il terminale o modificare la configurazione SSH. L'app può essere eseguita nella barra dei menu per un avvio/arresto rapido. Le tue configurazioni, password (nel Portachiavi) e l'accesso ai file di chiave rimangono sul tuo Mac; l'app non carica i tuoi dati.
Per iniziare con SSH Port Forwarder
- Scarica e installa l'app (dall'App Store o dal tuo canale di distribuzione).
- Avvia l'app. Puoi utilizzare la finestra principale per gestire le configurazioni o l'icona nella barra dei menu per un accesso rapido.
- Aggiungi o seleziona una configurazione di inoltro:
- Inserisci un nome, l'host remoto, la porta SSH (predefinita 22) e il nome utente.
- Scegli Password o Chiave Privata per l'autenticazione. Se usi una chiave privata, utilizza il pulsante Sfoglia accanto al percorso della chiave per selezionare il tuo file chiave (necessario affinché l'app possa accedervi in modalità sandbox).
- Scegli Proxy SOCKS (proxy SOCKS locale) o Inoltro Locale (inoltra una specifica porta remota a una porta locale) e imposta la porta locale (e la porta remota per Inoltro Locale).
- Facoltativamente, usa Test per verificare la connessione SSH prima di avviare.
- Clicca Avvia per iniziare l'inoltro. Usa l'icona nella barra dei menu per avviare o arrestare rapidamente gli inoltri.
- Salva la tua configurazione affinché persista; se usi una password, viene memorizzata nel Portachiavi di sistema.
Importante: File della chiave privata e nuova selezione
Se usi l'autenticazione Chiave Privata e selezioni un file chiave nell'app:
- L'app ricorda l'accesso a quel file tramite un segnalibro di sistema (percorso + identità del file).
- Se elimini quel file chiave e poi crei un nuovo file con lo stesso nome (o lo stesso percorso), l'app punta ancora al vecchio file. Il segnalibro potrebbe diventare non valido o puntare al file sbagliato.
- Devi selezionare nuovamente il file chiave nel client: apri la configurazione, clicca Sfoglia accanto al percorso della chiave, scegli il nuovo file chiave, poi Salva. Altrimenti l'app potrebbe non riuscire a connettersi o mostrare errori di permesso.
Risoluzione dei problemi
-
Connessione o autenticazione fallisce
- Controlla host remoto, porta SSH e nome utente.
- Per autenticazione con password: assicurati che la password sia corretta e salvata (Portachiavi).
- Per chiave privata: assicurati di aver selezionato la chiave tramite Sfoglia, che il formato della chiave sia supportato (OpenSSH o PEM) e, se la chiave ha una passphrase, inseriscila quando richiesto. Se hai sostituito il file chiave (ad esempio, eliminato e ricreato uno con lo stesso nome), seleziona nuovamente il file chiave nell'app e salva.
-
“Nessun permesso per leggere il file chiave” o errori relativi alla chiave
- Usa il pulsante Sfoglia per selezionare nuovamente il tuo file di chiave privata, poi salva. Questo è necessario anche dopo aver sostituito il file chiave (ad esempio, nuova chiave con lo stesso percorso/nome).
-
Porta locale in uso
- Scegli un'altra porta locale nella configurazione, o arresta l'applicazione che sta utilizzando la porta corrente.
-
L'inoltro non si avvia o rimane in “connessione”
- Esegui Test per verificare la connettività SSH. Controlla firewall e rete. Assicurati che l'host remoto permetta SSH e, per Inoltro Locale, che la porta remota sia corretta.
-
Icona nella barra dei menu o finestra principale
- L'app può essere eseguita solo con l'icona nella barra dei menu. Usa il menu per aprire la finestra completa per la configurazione o per avviare/arrestare gli inoltri.
Feedback e Suggerimenti
Apprezziamo il tuo feedback e i tuoi suggerimenti per migliorare SSH Port Forwarder. Se hai idee o suggerimenti, inviali a [email protected].
Grazie per usare SSH Port Forwarder!