Inserisci il tuo server self-hosted in ONLYOFFICE Documents, tocchi Avanti e l'app continua a caricare finché non segnala un timeout di connessione. Lo stesso account potrebbe funzionare correttamente in un browser desktop, il che fa sembrare il problema un bug dell'app. In realtà, il timeout di solito significa che il telefono non riesce a raggiungere l'URL del servizio esatto che hai inserito, che l'URL punta al componente ONLYOFFICE sbagliato o che un livello di rete blocca la richiesta.
Inizia identificando cosa offre effettivamente il tuo server. L'app mobile Documents si connette a un portale ONLYOFFICE come DocSpace o Workspace, oppure a un cloud di terze parti supportato come Nextcloud, ownCloud o un altro servizio WebDAV. ONLYOFFICE Docs, chiamato anche Document Server, è il servizio di modifica che funziona con una piattaforma di archiviazione; non è automaticamente la stessa cosa di un portale utente o di un account file WebDAV. Le panoramiche di ONLYOFFICE Documents per Android e iOS descrivono i tipi di account supportati.
1. Conferma quale indirizzo deve utilizzare l'app mobile
Non incollare l'URL del server documenti in ogni campo di connessione. Se i tuoi file sono archiviati in un portale DocSpace o Workspace self-hosted, utilizza l'indirizzo pubblico di tale portale ed effettua l'accesso con l'account del portale. Se i tuoi file si trovano in Nextcloud o ownCloud, seleziona tale servizio nell'app e inserisci l'indirizzo WebDAV del server di archiviazione con le relative credenziali di accesso. Per un servizio WebDAV generico, seleziona l'opzione "Altro WebDAV" nell'app, se disponibile.
Per Nextcloud e ownCloud, l'URL può includere un percorso che va oltre il dominio. Copia l'indirizzo WebDAV mostrato nelle impostazioni dell'account cloud anziché cercare di indovinare un percorso da un vecchio tutorial. La guida alla connessione mobile di ONLYOFFICE fornisce un esempio per Nextcloud e indica agli utenti di incollare l'URL completo, incluso il protocollo. Anche le istruzioni dell'app per Android indicano di fornire l'URL di connessione, il nome utente e la password per l'archiviazione WebDAV. Consulta la guida ufficiale all'integrazione con Nextcloud o la guida all'integrazione con ownCloud per la procedura di connessione aggiornata.
- Utilizzare l'URL del portale per un account del portale, non l'indirizzo del servizio di modifica.
- Utilizza l'URL WebDAV completo per Nextcloud, ownCloud o un altro account WebDAV.
- Includi
https://o http://esattamente come configurato sul server. - Non aggiungere un suffisso non verificato come
/webdavo /remote.php/dav; copia l'URL WebDAV visualizzato dal server.
2. Prova lo stesso indirizzo al di fuori dell'app
Sul telefono, apri l'indirizzo in un browser mobile. Per un URL di un portale, il risultato atteso è una pagina di accesso o un reindirizzamento al portale. Per un endpoint WebDAV, il browser potrebbe mostrare una richiesta di accesso, una risposta di autorizzazione o un semplice messaggio di errore anziché un normale sito web; l'importante è che risponda prontamente e che il browser non segnali che l'host non è raggiungibile o non può essere trovato.
Ripeti il test una volta tramite Wi-Fi e una volta tramite dati mobili. Se funziona solo su una rete, probabilmente l'app non è la prima cosa da controllare. Verifica il router, la VPN, il filtro DNS, le restrizioni dell'operatore mobile o le impostazioni del firewall sulla rete in cui si verifica il problema. Se il test fallisce su entrambe le reti, verifica che il nome host sia risolvibile pubblicamente e che il reverse proxy o il firewall inoltrino il traffico HTTPS del servizio al backend previsto.
Un server raggiungibile solo tramite un indirizzo privato, come ad esempio, 192.168.x.xsarà normalmente non disponibile quando il telefono si trova al di fuori della rete locale, a meno che il dispositivo non sia connesso tramite una VPN o un'altra configurazione di accesso remoto sicura. Non esporre un servizio interno a Internet pubblico solo per testare l'app; utilizzare il metodo di accesso remoto approvato dall'organizzazione.
3. Controlla l'URL, i reindirizzamenti e il proxy inverso
Confronta l'indirizzo nell'app con l'indirizzo funzionante nel browser, carattere per carattere. Cerca eventuali sottocartelle mancanti, nomi host obsoleti, porte errate, percorsi copiati da un servizio diverso o reindirizzamenti a nomi host interni che il telefono non riesce a risolvere. Se il tuo server si trova dietro un proxy inverso, l'URL pubblico dovrebbe indirizzare all'applicazione corretta e le informazioni sullo schema di inoltro e sull'host dovrebbero essere coerenti con l'indirizzo HTTPS a cui accedono gli utenti.
Quando un portale o un servizio WebDAV viene pubblicato sotto un sottopercorso, verificare che il proxy mantenga il percorso richiesto e inoltri le richieste a tale applicazione. Un URL radice che visualizza una pagina di benvenuto del reverse proxy dimostra solo che il server web ha risposto, ma non che il portale o l'endpoint WebDAV dell'app siano instradati correttamente. Se possibile, testare l'URL preciso copiato nell'app mobile anziché solo la homepage del dominio.
Se l'app segnala un timeout ma il browser raggiunge rapidamente la pagina di login, controlla i log di accesso proxy e di errore al momento di un nuovo tentativo di connessione. Una risposta 502 o 504 indica un timeout a monte o del proxy; un 404 di solito suggerisce un'incongruenza di percorso o di routing; un 401 o 403 indica che l'endpoint ha risposto ma l'autenticazione o l'accesso sono stati negati. Questi codici di stato restringono il campo di indagine, ma il loro significato può dipendere dal proxy e dal software cloud davanti a ONLYOFFICE.
4. Convalidare HTTPS e la catena di certificati
I sistemi operativi mobili convalidano i certificati del server. Un certificato scaduto, emesso per un nome host diverso, privo di un certificato intermedio o firmato da un'autorità di cui il dispositivo non si fida può impedire una connessione sicura. Apri l'indirizzo HTTPS corretto sul telefono e controlla eventuali avvisi relativi al certificato nel browser. Verifica inoltre che la data e l'ora del dispositivo siano corrette, poiché un orologio errato può far apparire scaduto o non ancora valido un certificato valido.
Utilizza un certificato rilasciato per l'hostname pubblico e installa l'intera catena di certificati sul proxy o server accessibile pubblicamente. La documentazione di ONLYOFFICE descrive la configurazione di HTTPS per Document Server; il certificato deve corrispondere all'URL utilizzato dai client. Evita di disabilitare la verifica del certificato come soluzione permanente. ONLYOFFICE descrive tale opzione come insicura nella sua documentazione di integrazione e una connessione che funziona solo dopo aver ignorato i controlli del certificato necessita comunque di una configurazione del certificato corretta.
5. Separare un problema di accesso all'app da un problema di connessione all'editor.
Un utente potrebbe accedere correttamente a un portale e riscontrare comunque problemi nell'apertura di un documento. Si tratta di connessioni separate. L'applicazione deve prima raggiungere il server di archiviazione o il portale. Quando si apre un file, l'integrazione può coinvolgere anche il server dei documenti. Pertanto, un accesso mobile funzionante non dimostra che il servizio di modifica possa raggiungere il server di archiviazione, o che il server di archiviazione possa raggiungere il servizio di modifica.
Se il timeout si verifica solo dopo l'apertura di un file, chiedi all'amministratore di testare l'integrazione dal lato server. Le guide di ONLYOFFICE per Nextcloud e ownCloud spiegano che le installazioni dietro reti con restrizioni potrebbero richiedere la configurazione di indirizzi interni per le richieste dal server di archiviazione a ONLYOFFICE Docs e da ONLYOFFICE Docs al servizio di archiviazione. Gli indirizzi pubblici possono funzionare in un browser per dispositivi mobili, mentre il traffico da server a server continua a non funzionare.
In qualità di amministratore, verifica che entrambi i servizi risolvano reciprocamente i nomi host configurati, che le regole del firewall consentano il traffico richiesto e che il connettore utilizzi la stessa chiave segreta JWT configurata per Document Server quando JWT è abilitato. Non modificare la chiave segreta né disabilitare JWT a caso; confronta prima i valori configurati utilizzando la guida di integrazione ufficiale per la tua piattaforma cloud.
6. Ricontrollare le credenziali e lo stato dell'app.
Dopo aver verificato la raggiungibilità e i certificati, controlla il nome utente e la password nell'interfaccia web per lo stesso portale o account di archiviazione. Un endpoint WebDAV potrebbe richiedere le credenziali effettive dell'account o una password dell'app, a seconda dei criteri di autenticazione del server. Se è abilitata l'autenticazione a più fattori, segui le istruzioni per quel server; non dare per scontato che la normale password di accesso web sia accettata da ogni implementazione WebDAV.
Aggiorna ONLYOFFICE Documents dall'app store ufficiale, chiudila e riaprila, quindi prova ad aggiungere nuovamente l'account. Se l'account è stato precedentemente salvato con un indirizzo errato, rimuovi la connessione salvata e creane una nuova con l'URL verificato. Questa operazione non elimina i file sul server: la disconnessione di un account cloud nell'app mobile rimuove la voce di connessione locale, non il contenuto dell'archivio remoto. Prima di reinstallare l'app o cancellarne i dati, assicurati che tutti i documenti locali non sincronizzati siano stati salvati o sottoposti a backup.
7. Controllare il server solo dopo aver escluso cause più semplici
Se l'URL pubblico esatto va in timeout su più dispositivi e reti, il problema probabilmente risiede nel server o nel suo percorso di rete. Verificare che il portale, il servizio di archiviazione, il proxy inverso e il server dei documenti siano in esecuzione. Per le installazioni Docker, un amministratore può controllare lo stato del container e i log recenti con comandi come:
docker compose ps
docker compose logs --tail=100 <service-name>
Utilizza i nomi effettivi dei servizi presenti nel file Compose dell'installazione; i nomi variano a seconda dell'installazione. Verifica la presenza di riavvii ripetuti, errori DNS, errori di connessione a monte, esaurimento delle risorse o problemi di rinnovo dei certificati. Evita di riavviare ogni componente prima di acquisire i log, poiché un riavvio può eliminare prove utili dell'errore.
Nello specifico, per quanto riguarda il Document Server, il centro assistenza ufficiale documenta una /info/pagina che gli amministratori possono utilizzare per verificare se il servizio è abilitato e accessibile. Si tratta di uno strumento di diagnostica per il Document Server, non di un sostituto per il test del portale o dell'indirizzo WebDAV inserito nell'app mobile. Consultare le istruzioni di ONLYOFFICE per la pagina Informazioni sul Document Server .
Verifica la correzione dal telefono
Esegui i controlli in quest'ordine: apri l'URL esatto del portale o WebDAV nel browser del telefono; ripeti la procedura sia con Wi-Fi che con dati mobili; aggiungi l'account a ONLYOFFICE Documents con il tipo di servizio corrispondente; accedi; esplora una cartella; e apri un piccolo documento di prova. Se la navigazione funziona ma la modifica no, verifica l'integrazione lato server di ONLYOFFICE Documents. Se sia il browser che l'app vanno in timeout, procedi con i controlli DNS, firewall, proxy e server anziché cambiare ripetutamente la password.
Un risultato positivo si ottiene con un accesso stabile e la visualizzazione dell'elenco delle cartelle sulla rete in cui si intende lavorare. Prima di affidarsi alla configurazione per documenti importanti, testare l'apertura e il salvataggio di un file non critico. Se il problema persiste, fornire all'amministratore il tipo esatto di URL (portale, WebDAV o server documenti), il sistema operativo del telefono, la rete utilizzata, la data e l'ora e qualsiasi stato HTTP o voce del registro proxy. Non inviare password, token di accesso o contenuto dei documenti nelle richieste di supporto.