Accedere ai file di Nextcloud usando WebDAV

Nextcloud supporta completamente il protocollo WebDAV e puoi connetterti e sincronizzarti con i file di Nextcloud tramite WebDAV. In questo capitolo, imparerai come connettere Linux, macOS, Windows e dispositivi mobili al tuo server Nextcloud.

WebDAV stands for Distributed Authoring and Versioning. It is an HTTP extension that makes it easy to create, read, and edit files hosted on remote Web servers. With a WebDAV client, you can access your Nextcloud Files (including shares) on Linux, macOS and Windows in a similar way as any remote network share, and stay synchronized.

Prima di procedere con la configurazione di WebDAV, diamo un’occhiata veloce al modo consigliato per connettere i dispositivi client a Nextcloud.

Client ufficiali di Nextcloud per desktop e dispositivi mobili.

Il modo consigliato per sincronizzare un computer con un server Nextcloud è utilizzando i client di sincronizzazione ufficiali di Nextcloud. Puoi configurare il client per salvare i file in qualsiasi directory locale e puoi scegliere quali directory sul server Nextcloud sincronizzare. Il client visualizza lo stato attuale della connessione e registra tutte le attività, quindi sai sempre quali file remoti sono stati scaricati sul tuo PC e puoi verificare che i file creati e aggiornati sul tuo PC locale siano correttamente sincronizzati con il server.

Il modo consigliato per sincronizzare dispositivi Android e Apple iOS è utilizzando le app mobili ufficiali di Nextcloud.

Per connettere le app ufficiali di Nextcloud a un server Nextcloud, utilizza lo stesso URL che usi per accedere a Nextcloud dal tuo browser web - es.:

https://cloud.example.com

If Nextcloud is installed in a subdirectory called «nextcloud»:

https://example.com/nextcloud

Client WebDAV di terze parti

Se preferisci, puoi anche connettere il tuo computer al tuo server Nextcloud utilizzando qualsiasi client di terze parti che supporti il protocollo WebDAV (incluso quello che potrebbe essere integrato nel tuo sistema operativo).

Puoi anche utilizzare app di terze parti in grado di supportare WebDAV per connettere il tuo dispositivo mobile a Nextcloud.

Quando si utilizzano client di terze parti, è importante tenere presente che potrebbero non essere ottimizzati per l’uso con Nextcloud o potrebbero non implementare funzionalità che si ritengono importanti per il proprio caso d’uso.

I client mobili segnalati dalla comunità di Nextcloud includono:

L’URL da utilizzare durante la configurazione delle app di terze parti per connettersi a Nextcloud è un po” più lungo rispetto a quello per i client ufficiali:

https://cloud.example.com/remote.php/dav/files/USERNAME/

If Nextcloud is installed in a subdirectory called «nextcloud»:

https://example.com/nextcloud/remote.php/dav/files/USERNAME/

Nota

When using a third-party WebDAV client (including your operating system’s built-in client), you should use an application password for login rather than your regular password. In addition improved security, this increases performance significantly. To configure an application password, log into the Nextcloud Web interface, click on the avatar in the top right and choose Personal settings. Then choose Security in the left sidebar and scroll to the very bottom. There you can create an app password (which can also be revoked in the future without changing your main user password).

Nota

Negli esempi seguenti, sostituisci example.com/nextcloud con l’URL del tuo server Nextcloud (ometti la parte della directory se l’installazione si trova nella radice del tuo dominio), e USERNAME con il nome utente dell’utente che si sta connettendo.

Vedi l’URL di webdav (in basso a sinistra nelle impostazioni) nel tuo Nextcloud.

Accedere ai file usando Linux

Puoi accedere ai file nel sistema operativo Linux utilizzando i seguenti metodi.

Gestore file Nautilus

Quando configurate il vostro account Nextcloud nel Centro di Controllo GNOME, i vostri file verranno automaticamente montati da Nautilus come condivisione WebDAV, a meno che non deselezionate l’accesso ai file.

Puoi anche montare i tuoi file Nextcloud manualmente. Usa il protocollo davs:// per connettere il gestore file Nautilus alle tue risorse condivise Nextcloud:

davs://example.com/nextcloud/remote.php/dav/files/USERNAME/

Nota

Se la tua connessione al server non è protetta con HTTPS, usa dav:// invece che davs://:

Screenshot della configurazione del gestore di file Nautilus per utilizzare WebDAV

Nota

Lo stesso metodo funziona per altri gestori di file che utilizzano GVFS, come il gestore di file Caja di MATE e il gestore di file Nemo di Cinnamon.

Accedere ai file con KDE e il gestore file Dolphin

  1. Navigate to System Settings -> Networking -> Online Accounts

  2. Click «Add Account…»

  3. Click Nextcloud

  4. Enter your server address

  5. Follow the on-screen instructions to log in

  6. After logging in, ensure you enable «Storage» in the «Use This Account For» section

  7. You can now access your files in Dolphin under «Network» in the sidebar

  8. (Optional) To add this as a shortcut in the sidebar, right click «Nextcloud Storage» then «Add to Places»

  9. (Optional) To customise the shortcut, right click the shortcut in the sidebar then «Edit…» and customise the icon and label as you please

Creare montaggi WebDAV sulla riga di comando Linux.

Puoi creare il montaggio di WebDAV dalla riga di comando di Linux. Ciò è utile se preferisci accedere a Nextcloud come qualunque altro filesystem remoto montato. Il seguente esempio mostra come creare un montaggio personale e averlo montato automaticamente ogni qual volta accedi al tuo Linux computer.

  1. Installa il driver del filesystem davfs2 di WebDAV, che ti consente di montare le condivisioni WebDAV come ogni altro filesystem remoto. Usa questo comando per installarlo su Debian/Ubuntu:

    apt-get install davfs2

  2. Usa questo comando per installarlo su CentOS, Fedora, e openSUSE:

    yum install davfs2

  3. Aggiungi il tuo utente al gruppo davfs2:

    usermod -aG davfs2 <username>

  4. Quindi crea una directory nextcloud nella tua directory home come punto di mount e .davfs2/ per il tuo file di configurazione personale:

    mkdir ~/nextcloud
mkdir ~/.davfs2

  5. Copia /etc/davfs2/secrets in ~/.davfs2:

    cp  /etc/davfs2/secrets ~/.davfs2/secrets

  6. Impostati come il proprietario e modifica i permessi di lettura-scrittura disponibili solo al proprietario.

    chown <linux_username>:<linux_username> ~/.davfs2/secrets
chmod 600 ~/.davfs2/secrets

  7. Aggiungi le tue credenziali di accesso di Nextcloud alla fine del file secrets, usando l’URL del tuo server Nextcloud e il nome utente e la password di Nextcloud.

    https://example.com/nextcloud/remote.php/dav/files/USERNAME/ <username> <password>
or
$PathToMountPoint $USERNAME $PASSWORD
for example
/home/user/nextcloud john 1234

  8. Aggiungi le informazioni di montaggio a /etc/fstab:

    https://example.com/nextcloud/remote.php/dav/files/USERNAME/ /home/<linux_username>/nextcloud davfs user,rw,auto 0 0

  9. Allora verifica che si monti e si autentichi eseguendo i seguenti comandi. Se l’hai impostato correttamente non avrai bisogno dei permessi di root.

    mount ~/nextcloud

  10. Dovresti essere in grado anche di smontarlo:

    umount ~/nextcloud

Ora, ogni volta che accederai al tuo sistema Linux, la tua condivisione di Nextcloud dovrebbe essere montata automaticamente tramite WebDAV nella tua cartella ~/nextcloud. Se preferisci montarla manualmente, cambia auto in noauto in «/etc/fstab.

Problemi noti

Problema

Risorsa temporaneamente non disponibile

Soluzione

Se riscontri problemi quando crei un file in una cartella, modifica /etc/davfs2/davfs2.conf e aggiungi:

use_locks 0

Problema

Avvisi relativi al certificato

Soluzione

Se utilizzi un certificato di sicurezza auto-firmato, avrai un avviso. Per modificarlo, devi configurare davfs2 in modo da riconoscere il tuo certificato. Copia miocertificato.pem in /etc/davfs2/certs/. Poi modifica /etc/davfs2/davfs2.conf ed elimina il commento della linea servercert. Ora aggiungi il percorso della tua certificazione come nell’esempio.

servercert /etc/davfs2/certs/mycertificate.pem

Accedere ai file usando macOS

Nota

Il Finder di macOS presenta una serie di problemi di implementazione e dovrebbe essere utilizzato solo se il server Nextcloud viene eseguito su Apache e mod_php, o Nginx 1.3.8+. Client alternativi compatibili con macOS in grado di accedere alle condivisioni WebDAV includono app open source come Cyberduck (vedi istruzioni qui) e Filezilla. Tra i client commerciali ci sono Mountain Duck, Forklift, Transmit e Commander One.

Accedere ai file tramite macOS Finder:

  1. Dal menu in alto del Finder, scegli Vai > Connetti al server…:

    Screenshot dell'inserimento dell'indirizzo del tuo server Nextcloud su macOS

  2. Quando si apre la finestra Connetti al server…, inserisci l’indirizzo WebDAV del tuo server Nextcloud nel campo Indirizzo del server:, ad esempio:

    https://cloud.YOURDOMAIN.com/remote.php/dav/files/USERNAME/
    Screenshot: Inserisci l'indirizzo del server Nextcloud nella finestra di dialogo "Connetti al server..."

  3. Fai clic su Connetti. Il tuo server WebDAV dovrebbe apparire sul desktop come un’unità di disco condivisa.

Accedere ai file usando Microsoft Windows

Se si utilizza l’implementazione nativa di WebDAV di Windows, è possibile mappare Nextcloud su un nuovo drive utilizzando Esplora risorse di Windows. La mappatura su un drive consente di navigare nei file memorizzati su un server Nextcloud allo stesso modo in cui si naviga nei file memorizzati in un drive di rete mappato.

L’utilizzo di questa funzionalità richiede una connessione alla rete. Se vuoi archiviati i tuoi file non in linea, usa il Client Desktop per sincronizzare i file nel tuo Nextcloud in una o più cartelle del tuo disco fisso locale.

Nota

Windows 10 ora predefinisce l’abilitazione dell’autenticazione di base se HTTPS è abilitato prima di mappare il tuo drive.

Su versioni più datate di Windows, è necessario consentire l’uso dell’autenticazione di base nel Registro di sistema di Windows:

  • Avvia regedit e naviga fino a HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters.

  • Crea o modifica il valore BasicAuthLevel (per Windows Vista, 7 e 8) o UseBasicAuth (per Windows XP e Windows Server 2003) come tipo DWORD e imposta il suo valore su 1 per le connessioni SSL. Un valore di 0 indica che l’autenticazione di base è disabilitata, mentre un valore di 2 consente sia connessioni SSL che non SSL (non raccomandato).

  • Quindi esci dall’Editor del Registro di sistema e riavvia il computer.

Associare drive con la riga di comando

Il seguente esempio mostra come associare un drive usando la riga di comando. Per associare il drive:

  1. Apri il prompt dei comandi su Windows.

  2. Digita la seguente riga nel prompt dei comandi per associare il drive Z del computer:

    net use Z: https://<drive_path>/remote.php/dav/files/USERNAME/ /user:youruser yourpassword

    con<drive_path> come URL del tuo server Nextcloud. Ad esempio:

    net use Z: https://example.com/nextcloud/remote.php/dav/files/USERNAME/ /user:youruser yourpassword

    Il computer associa i file del tuo account Nextcloud al drive con lettera Z.

Errore

If you get the following error System error 67 has occurred. The network name cannot be found., or frequent disconnections, open the Services app and make sure that the WebClient service is running and started automatically at startup.

Nota

Anche se non raccomandato, è possibile montare il server Nextcloud utilizzando HTTP, lasciando la connessione non crittografata.

Se prevedi di utilizzare connessioni HTTP su dispositivi mentre ti trovi in un luogo pubblico, ti consigliamo vivamente di utilizzare un tunnel VPN per fornire la necessaria sicurezza.

Una sintassi di comando alternativa è:

net use Z: \\example.com@ssl\nextcloud\remote.php\dav /user:youruser
yourpassword

Associare i drive con Windows Explorer

Per mappare un’unità utilizzando Microsoft Windows Explorer:

  1. Apri Esplora risorse sul tuo computer MS Windows.

  2. Fai clic con il tasto destro sulla voce Computer e seleziona Associa drive di rete… dal menu a tendina.

  3. Scegli un drive di rete locale a cui vuoi associare Nextcloud.

  4. Specifica l’indirizzo della tua istanza Nextcloud, seguito da /remote.php/dav/files/NOMEUTENTE/.

    Ad esempio:

    https://example.com/nextcloud/remote.php/dav/files/USERNAME/

    Nota

    Per i server protetti da SSL, seleziona Riconnetti all’accesso per garantire che il mapping sia persistente durante i riavvii successivi. Se desideri connetterti al server Nextcloud come un utente diverso, seleziona Connetti utilizzando credenziali diverse.

    Screenshot della mappatura di WebDAV su Esplora file di Windows

  1. Fai clic sul pulsante Fine.

Windows Explorer associa il drive di rete, rendendo disponibile la tua istanza Nextcloud.

Accedere ai file usando Cyberduck

Cyberduck è un browser open source per FTP, SFTP, WebDAV, OpenStack Swift e Amazon S3 progettato per trasferimenti di file su macOS e Windows.

Nota

Questo esempio usa Cyberduck versione 4.2.1.

Per usare Cyberduck:

  1. Specifica un server senza alcuna informazione sul protocollo di partenza.

    Per esempio: example.com

  2. Specifica la porta appropriata.

    La porta che scegli dipende dal fatto che il tuo server Nextcloud supporti o meno SSL. Cyberduck richiede che tu selezioni un tipo di connessione diverso se prevedi di utilizzare SSL.

    Per esempio:

    • 80 per WebDAV non criptato

    • 443 per WebDAV sicuro (HTTPS/SSL)

  3. Utilizza il menu a discesa “Altre opzioni” per aggiungere il resto dell’URL del tuo WebDAV nel campo “Percorso”.

    Per esempio: remote.php/dav/files/USERNAME/

Ora Cyberduck consente l’accesso ai file del server Nextcloud.

Accedere alle risorse pubbliche tramite WebDAV

Nextcloud fornisce la possibilità di accedere a condivisioni pubbliche in modo anonimo tramite WebDAV.

Per accedere alle risorse pubbliche, apri:

https://example.com/nextcloud/public.php/webdav

in un client WebDAV, utilizza il token di condivisione come nome utente e la (opzionale) password della condivisione come password. Ad esempio, con un link di condivisione https://example.com/s/kFy9Lek5sm928xP, kFy9Lek5sm928xP sarà il nome utente.

Nota

Impostazioni → Amministrazione → Condivisione → Consenti agli utenti di questo server di inviare condivisioni ad altri server. Questa opzione consente anche l’accesso WebDAV alle condivisioni pubbliche e deve essere abilitata per far funzionare questa funzione, tranne se si utilizza cURL (vedi sotto).

Problemi noti

Problema

Windows non si connette usando HTTPS.

Soluzione 1

Il client WebDAV di Windows potrebbe non supportare il Server Name Indication (SNI) per le connessioni cifrate. Se ricevi un errore montando un’istanza di Nextcloud con protocollo SSL, contatta il tuo provider sull’assegnazione di un indirizzo IP dedicato al tuo server basato su SSL.

Soluzione 2

Il client WebDAV di Windows potrebbe non supportare le connessioni TLSv1.1 e TLSv1.2. Se hai limitato la configurazione del server per fornire solo TLSv1.1 e versioni successive, la connessione al tuo server potrebbe non riuscire. Fai riferimento alla documentazione WinHTTP per ulteriori informazioni.

Problema

Ricevi il seguente messaggio di errore: Errore 0x800700DF: La dimensione del file supera il limite consentito e non può essere salvato.

Soluzione

Windows limits the maximum size a file transferred from or to a WebDAV share may have. You can increase the value FileSizeLimitInBytes in HKEY_LOCAL_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\WebClient\\Parameters by clicking on Modify.

To increase the limit to the maximum value of 4GB, select Decimal, enter a value of 4294967295, and reboot Windows or restart the WebClient service.

Problema

L’aggiunta di un’unità WebDAV su Windows tramite i passaggi descritti sopra non visualizza la dimensione corretta dello spazio disponibile in Nextcloud e mostra invece la dimensione dell’unità C: con il relativo spazio disponibile.

Risposta

Purtroppo, si tratta di una limitazione intrinseca di WebDAV stesso, poiché non fornisce un modo per il client di ottenere lo spazio libero disponibile dal server. Windows automaticamente utilizza la dimensione dell’unità C: con il suo spazio disponibile come alternativa. Quindi, purtroppo, non esiste una soluzione reale a questo problema.

Problema

L’accesso ai tuoi file da Microsoft Office tramite WebDAV non funziona.

Soluzione

Problemi noti e le loro soluzioni sono documentati nell’articolo KB2123563.

Problema

Non è possibile mappare Nextcloud come un’unità WebDAV in Windows utilizzando un certificato autofirmato.

Soluzione

  1. Accedi alla tua istanza Nextcloud tramite il tuo browser Web preferito.

  2. Fai clic fino a raggiungere l’errore del certificato nella barra di stato del browser.

  3. View the certificate, then from the Details tab, select “Copy to File”.

  4. Salva il file sul tuo desktop con un nome arbitrario, ad esempio myNextcloud.pem.

  5. Go to Start menu > Run, type MMC, and click “OK” to open Microsoft Management Console.

  6. Vai su File > Aggiungi/Rimuovi Snap-In.

  7. Select Certificates, Click “Add”, choose “My User Account”, then “Finish”, and finally “OK”.

  8. Scorri fino a Autorità di certificazione radice attendibili, Certificati.

  9. Fai clic con il tasto destro su Certificato, seleziona Tutte le attività, e poi Importa.

  10. Seleziona il certificato salvato sul Desktop.

  11. Seleziona Posiziona tutti i certificati nel seguente archivio e clicca su Sfoglia.

  12. Check the Box that says Show Physical Stores, expand out Trusted Root Certification Authorities, select Local Computer there, click “OK”, and Complete the Import.

  13. Controlla l’elenco per assicurarti che il certificato sia presente. Probabilmente dovrai fare clic su Aggiorna prima di vederlo.

  14. Esci da MMC.

Per gli utenti Firefox:

  1. Lancia il tuo browser, vai al menu Applicazione > Cronologia > Cancella cronologia recente…

  2. Seleziona “Tutto” nel menu a tendina “Intervallo di tempo da cancellare”

  3. Seleziona la casella di controllo “Accessi attivi”

  4. Clicca sul pulsante “Cancella ora”

  5. Chiudi il browser, poi riaprilo ed effettua un test.

Per gli utenti dei browser basati su Chrome (Chrome, Chromium, Microsoft Edge):

  1. Aprire il Pannello di controllo di Windows, navigare fino a Opzioni Internet

  2. Nella scheda Contenuto, fare clic sul pulsante Cancella stato SSL.

  3. Chiudi il browser, poi riaprilo ed effettua un test.

Accedere ai file usando cURL

Dal momento che WebDAV è un’estensione di HTTP, cURL può essere utilizzato per automatizzare le operazioni sui file.

Nota

Impostazioni → Amministrazione → Condivisione → Consenti agli utenti di questo server di inviare condivisioni ad altri server. Se questa opzione è disabilitata, è necessario passare l’opzione --header "X-Requested-With: XMLHttpRequest" a cURL.

Per creare una cartella con la data attuale come nome:

$ curl -u user:pass -X MKCOL "https://example.com/nextcloud/remote.php/dav/files/USERNAME/$(date '+%d-%b-%Y')"

Per caricare un file error.log in quella cartella:

$ curl -u user:pass -T error.log "https://example.com/nextcloud/remote.php/dav/files/USERNAME/$(date '+%d-%b-%Y')/error.log"

Per spostare un file:

$ curl -u user:pass -X MOVE --header 'Destination: https://example.com/nextcloud/remote.php/dav/files/USERNAME/target.jpg' https://example.com/nextcloud/remote.php/dav/files/USERNAME/source.jpg

Per ottenere le proprietà dei file nella cartella radice:

    $ curl -X PROPFIND -H "Depth: 1" -u user:pass https://example.com/nextcloud/remote.php/dav/files/USERNAME/ | xml_pp
    <?xml version="1.0" encoding="utf-8"?>
<d:multistatus xmlns:d="DAV:" xmlns:oc="http://nextcloud.org/ns" xmlns:s="http://sabredav.org/ns">
  <d:response>
    <d:href>/nextcloud/remote.php/dav/files/USERNAME/</d:href>
    <d:propstat>
      <d:prop>
        <d:getlastmodified>Tue, 13 Oct 2015 17:07:45 GMT</d:getlastmodified>
        <d:resourcetype>
          <d:collection/>
        </d:resourcetype>
        <d:quota-used-bytes>163</d:quota-used-bytes>
        <d:quota-available-bytes>11802275840</d:quota-available-bytes>
        <d:getetag>"561d3a6139d05"</d:getetag>
      </d:prop>
      <d:status>HTTP/1.1 200 OK</d:status>
    </d:propstat>
  </d:response>
  <d:response>
    <d:href>/nextcloud/remote.php/dav/files/USERNAME/welcome.txt</d:href>
    <d:propstat>
      <d:prop>
        <d:getlastmodified>Tue, 13 Oct 2015 17:07:35 GMT</d:getlastmodified>
        <d:getcontentlength>163</d:getcontentlength>
        <d:resourcetype/>
        <d:getetag>"47465fae667b2d0fee154f5e17d1f0f1"</d:getetag>
        <d:getcontenttype>text/plain</d:getcontenttype>
      </d:prop>
      <d:status>HTTP/1.1 200 OK</d:status>
    </d:propstat>
  </d:response>
</d:multistatus>

Accedere ai file usando WinSCP

WinSCP è un client open source gratuito SFTP, FTP, WebDAV, S3 e SCP per Windows. La sua principale funzione è il trasferimento di file tra un computer locale e remoto. Oltre a ciò, WinSCP offre funzionalità di scripting e gestione di base dei file.

Puoi scaricare la versione portatile di WinSCP ed eseguirla su Linux tramite Wine.

Per eseguire WinSCP su Linux, scarica wine tramite il gestore dei pacchetti della tua distribuzione, quindi eseguilo con il comando: wine WinSCP.exe.

Per connettersi a Nextcloud:

  • Avvia WinSCP

  • Premi “Sessione” nel menu

  • Premere l’opzione di menu “Nuova sessione”

  • Imposta il menu a tendina “Protocollo file” su WebDAV

  • Imposta il menu a tendina “Encryption” su crittografia implicita TLS/SSL.

  • Compila il campo hostname: example.com

  • Compila il campo nome utente: NEXTCLOUDUSERNAME

  • Compila il campo password: NEXTCLOUDPASSWORD

  • Premere il pulsante “Avanzate…”

  • Naviga su “Ambiente”, “Directory” sul lato sinistro

  • Compila il campo “Directory remota” con quanto segue: /nextcloud/remote.php/dav/files/NEXTCLOUDUSERNAME/

  • Premere il pulsante “OK”

  • Premere il pulsante “Salva”

  • Seleziona le opzioni desiderate e premi il pulsante “OK”

  • Premi il pulsante “Login” per connetterti a Nextcloud

Nota

It is recommended to use an app password for the password if you use TOTP as WinSCP does not understand TOTP with Nextcloud at the time of writing (2022-11-07).