Risolvere problemi di connessione o trasferimento SFTP

Individua se il problema si verifica prima dell’autenticazione, durante l’elenco dello spazio di lavoro, il trasferimento dei byte o la chiusura del file sul server. dosya conferma un caricamento SFTP a CLOSE: una barra al 100% non prova che il file sia stato accettato nel cloud.

Passaggi

Impostazione	Valore dosya
Protocollo	SFTP / SSH File Transfer Protocol
Host	sftp.dosya.dev
Porta	2222
Nome utente	Email dell’account proprietario della chiave API, rispettando maiuscole e minuscole
Autenticazione	Password
Password	Chiave API dos_… completa
Cartella iniziale	/

Il gateway non accetta password dell’account dosya, token OAuth/MCP, chiavi pubbliche SSH, FTP o FTPS. Non offre una shell interattiva. In OpenSSH -P 2222 maiuscola sceglie la porta; -p minuscola ha un altro significato.

Crea una chiave dedicata in Profilo → Chiavi API. Deve consentire SFTP, essere vincolata a uno spazio accessibile se limitata e usare Read only per elenchi e download oppure Accesso completo se servono scritture. Una chiave Solo caricamento non può effettuare gli elenchi necessari alla maggior parte dei client SFTP. Il gateway rifiuta chiavi vincolate a cartelle e restrizioni sugli IP consentiti; usa invece un vincolo allo spazio di lavoro. Restano valide scadenza, orari attivi e restrizioni esplicite di utilizzo.

Verifica l’identità dell’host separatamente dalla password

Alla prima connessione confronta nome host, porta, tipo di chiave e impronta con un valore attendibile ricevuto dall’assistenza dosya o dall’amministratore tramite un canale separato. Questa guida non pubblica un’impronta di produzione certificata.

Se il client segnala REMOTE HOST IDENTIFICATION HAS CHANGED!, fermati. Conferma che la rotazione sia legittima prima di modificare known_hosts. Sostituire la chiave API non risolve una chiave host non corrispondente; disattivare la verifica elimina la protezione offerta dall’avviso.

Risolvi gli errori di autenticazione

Controlla email esatta, chiave completa, scelta del protocollo SFTP, vincolo allo spazio di lavoro e scadenza. Cinque password errate dallo stesso indirizzo di origine nella finestra di controllo possono bloccarlo per 15 minuti. Smetti di tentare, correggi la credenziale e attendi la scadenza del blocco prima di riprovare una volta.

Per impostazione predefinita il server interrompe una connessione non autenticata dopo 30 secondi. Un errore temporaneo di verifica API non conta come password errata: annota l’ora del client e riprova una volta invece di sostituire subito una chiave valida.

Le cache degli accessi SFTP riusciti e dei permessi dei ruoli durano ciascuna fino a 60 secondi. L’autorizzazione API usa cache separate: questo intervallo non garantisce la revoca completa. Dopo una revoca o modifica del ruolo, verifica il rifiuto con una nuova connessione e un’operazione innocua, una volta propagata l’invalidazione. Un canale già aperto non prova che un’operazione successiva possa ancora essere confermata.

Interpreta messaggi di percorso e permesso

• Il tuo ruolo non consente di usare SFTP indica che il ruolo nello spazio di lavoro attivo non dispone di access_sftp; chiedi a un proprietario o amministratore di modificarlo.
• access to that workspace is not permitted for this credential (stato 3) indica che appartenenza, vincolo allo spazio o ruolo non coprono il percorso.
• no such file or directory (stato 2) può indicare un nome digitato male o una risorsa nascosta alla credenziale. Riparti da / e usa un nome o slug di spazio restituito lì.
• the parent directory does not exist or is not writable by this credential richiede una destinazione esistente e il permesso di creare o caricare.
• this server supports open for reading or writing, not append or read-write indica che il client ha scelto una modalità di aggiunta o ripresa non supportata.

La radice elenca gli spazi di lavoro consentiti; non contiene la raccolta WebDAV All. Non puoi creare spazi di lavoro tramite SFTP. Le richieste chmod e chown vengono accettate senza modificare i permessi dosya; i link simbolici non sono supportati.

Diagnostica il completamento del caricamento

Il limite attualmente distribuito è 352 MiB (369.098.752 byte) per caricamento SFTP; una distribuzione può annunciare un valore attivo inferiore. Regole sui file dello spazio di lavoro, spazio cloud disponibile e limiti di chiave e ruolo possono rifiutare file più piccoli.

Risultato	Cosa fare
write past the 352 MB per-file limit (o altro valore mostrato)	Usa un metodo dosya adatto al file completo. Scrivere a un altro offset non aggira il limite.
close failed: API 403 …	Leggi il motivo di permesso o regola allegato; il successo di WRITE non ha confermato il file nel cloud.
close failed: API 429 (rate limited - back off and retry) …	Ferma i trasferimenti paralleli, attendi e riprova l’intero file quando si libera la quota o lo slot applicabile.
access to this workspace was revoked while the upload was in flight	Ripristina appartenenza o ruolo autorizzati oppure scegli un’altra destinazione consentita; non riprendere l’handle parziale.
SSH_FX_FAILURE generico	Annota operazione e messaggio limitato del server. API 403 corrisponde a permesso negato, 404 a file inesistente e gli altri errori allo stato 4.

I caricamenti sono mantenuti temporaneamente durante la sessione SFTP e confermati alla chiusura. Un caricamento vuoto attualmente non crea un file. Le scritture interrotte non hanno una ripresa persistente sul server: evita Riprendi, Append, reput o put -a. Riparti dall’offset zero, preferibilmente con un nuovo nome di prova, perché riaprire non carica la parte precedente.

Sostituire un percorso esistente può aggiungere una versione del file dosya e cambiarne i byte correnti. rm e l’eliminazione di cartelle spostano i contenuti idonei nel cestino e revocano i link associati. La conservazione è di sette giorni per i piani gratuiti e 30 giorni per gli altri; l’eliminazione definitiva è irreversibile.

Risultato previsto

1. Connettiti ed esegui pwd e ls in /.
2. Inserisci il nome dello spazio di lavoro restituito dal server ed elenca una cartella esistente.
3. Scarica un file noto e innocuo e confrontane i byte localmente.
4. Se consentito, carica un file di prova non vuoto con nome unico e attendi il risultato finale della chiusura.
5. Aggiorna File in dosya, confronta nome e dimensione, poi scarica la copia cloud e verifica il suo SHA-256.

Le modifiche alle cartelle tramite un altro protocollo possono apparire solo alla scadenza della cache configurata, che per impostazione predefinita è di 10 secondi. Attendi l’intervallo applicabile e aggiorna l’elenco prima di segnalare una vista non aggiornata.

Per l’assistenza includi client e versione, host e porta, operazione, spazio di lavoro e percorso con nomi privati oscurati, stato e messaggio, dimensione, ora e fuso orario e fase del problema: accesso, WRITE o CLOSE. Non allegare mai la chiave API, il contenuto della richiesta di password o i byte di file privati.

Guide correlate

• Connettere SFTP
• Revocare una chiave