Přístup k souborům v Nextcloud prostřednictvím protokolu WebDAV
Nextcloud fully supports the WebDAV protocol, and you can connect and synchronize with Nextcloud Files over WebDAV. In this chapter, you will learn how to connect Linux, macOS, Windows, and mobile devices to your Nextcloud server via WebDAV. Before we get into configuring WebDAV, let’s take a quick look at the recommended way of connecting client devices to your Nextcloud servers.
Poznámka
In the following examples, you should replace example.com/nextcloud with the URL of your Nextcloud server (omit the directory part if the installation is in the root of your domain), and USERNAME with the username of the connecting user.
Viz URL pro WebDAV (vlevo dole v nastavení) ve vámi využívaném Nextcloud.
Poznámka
In the following examples, you must use an application password for login, which you can generate in your security settings.
Nextcloud klienti pro desktopové a mobilní platformy
Doporučeným způsobem synchronizace osobního počítače s Nextcloud serverem je pomocí Nextcloud/ownCloud synchronizačních klientů. Klienta je možné nastavit, aby ukládal soubory v libovolném adresáři v počítači a můžete zvolit, se kterými adresáři na Nextcloud serveru synchronizovat. Klient zobrazuje stav stávajícího spojení a zaznamenává veškerou aktivitu, takže vždy víte, které soubory z protějšku byly staženy na počítač a můžete si ověřit, že soubory vytvořené/aktualizované na počítači jsou správně synchronizovány na server.
Doporučený způsob, jak synchronizovat Nextcloud server s Android a Apple iOS zařízeními je pomocí mobilních aplikací.
Pro připojení mobilní aplikace k Nextcloud serveru použijte pouze základ URL a složku:
example.com/nextcloud
Kromě mobilních aplikací, poskytovaných Nextcloud nebo ownCloud, je pro připojení se k Nexcloud z mobilního zařízení pomocí WebDAV možné použít i ostatní aplikace. WebDAV Navigator je dobrá (ale proprietární) aplikace pro Android zařízení a iPhony. URL adresa, kterou takto použít je:
example.com/nextcloud/remote.php/dav/files/USERNAME/
Nastavení pro WebDAV
If you prefer, you may also connect your desktop PC to your Nextcloud server by using the WebDAV protocol rather than using a special client application. Web Distributed Authoring and Versioning (WebDAV) is a Hypertext Transfer Protocol (HTTP) extension that makes it easy to create, read, and edit files on Web servers. With WebDAV, you can access your Nextcloud shares on Linux, macOS and Windows in the same way as any remote network share, and stay synchronized.
Přístup k souborům ze systému Linux
Z linuxových systémů můžete k souborům přistupovat následujícími způsoby.
Správce souborů Nautilus
Když zadáte svůj Nextcloud účet do Ovládacích panelů GNOME, budou vaše soubory automaticky připojeny správcem souborů Nautilus jako WebDAV sdílení (pokud nezrušíte zaškrtnutí přístupu k souborům).
Soubory z Nextcloud je možné také připojit (mount) ručně. Pro připojení správce souborů k svému Nextcloud sdílení použijte protokol davs://
:
davs://example.com/nextcloud/remote.php/dav/files/USERNAME/
Poznámka
Pokud připojení k vámi využívanému serveru není zabezpečené pomocí HTTPS, použitje dav://
namísto davs://
.

Poznámka
The same method works for other file managers that use GVFS, such as MATE’s Caja and Cinnamon’s Nepomuk.
Přístup k souborům z desktopového prostředí KDE (prostřednictvím správce souborů Dolphin)
Pro přístup k vašim souborům v Nextcloud pomocí správce souborů Dolphin z desktopového prostředí KDE, použijte protokol webdav://
:
webdav://example.com/nextcloud/remote.php/dav/files/USERNAME/

Můžete vytvořit trvalý odkaz na vámi využívaný Nextcloud server:
Open Dolphin and click „Network“ in the left-hand „Places“ column.
Klikněte na ikonu označenou jako Přidat síťovou složku. Výsledný dialog by se měl objevit s už předvybraným WebDAV.
Pokud WebDAV není vybraný, vyberte ho.
Klikněte na Další.
Zadejte následující nastavení:
Name: the name you want to see in the Places bookmark, for example, Nextcloud.
User: the Nextcloud username you used to log in, for example, admin.
Server: the Nextcloud domain name, for example, example.com (without http:// before or directories afterwards).
Složka – Zadejte popis umístění
nextcloud/remote.php/dav/files/UZIVATELSKEJMENO/
.
(Volitelné) aby se ve sloupci Místa objevila záložka, zaškrtněte „Vytvořit ikonu“.
(Volitelné) v zaškrtávací kolonce „Port a šifrováno“ zadejte případná speciální nastavení nebo SSL certifikát.
Vytváření WebDAV připojení z linuxového příkazového řádku
WebDAV připojení (mount) je možné vytvářet z příkazového řádku. Toto se hodí, pokud chcete k Nexcloud přistupovat stejným způsobem, jako k jakémukoli na dálku připojenému souborovému systému. Následující příklad ukazuje jak vytvořit osobní připojení a zařídit to tak, aby bylo automaticky připojené pokaždé, když se přihlásíte do systému.
Nainstalujte ovladač WebDAV souborového systému
davfs2
, což vám umožní připojit WebDAV sdílení jako kterýkoli jiný vzdálený souborový systém. Pro instalaci na Debian/Ubuntu:apt-get install davfs2
Pro instalaci na CentOS, Fedora a openSUSE použijte tento příkaz:
yum install davfs2
Přidejte se do skupiny
davfs2
:usermod -aG davfs2 <username>
Then create a
nextcloud
directory in your home directory for the mount point, and.davfs2/
for your personal configuration file:mkdir ~/nextcloud mkdir ~/.davfs2
Zkopírujte
/etc/davfs2/secrets
do~/.davfs2
:cp /etc/davfs2/secrets ~/.davfs2/secrets
Nastavte sami sebe jako vlastníka a oprávnění pro čtení-zápis nastavte pouze na vlastníka:
chown <linux_username>:<linux_username> ~/.davfs2/secrets chmod 600 ~/.davfs2/secrets
Své přihlašovací údaje do Nexcloud přidejte na konec souboru
secrets
s použitím URL adresy Nexcloud serveru a svého Nexcloud uživatelského jména a hesla:https://example.com/nextcloud/remote.php/dav/files/USERNAME/ <username> <password> or $PathToMountPoint $USERNAME $PASSWORD for example /home/user/nextcloud john 1234
Přidejte údaje o připojení (mount) do souboru
/etc/fstab
:https://example.com/nextcloud/remote.php/dav/files/USERNAME/ /home/<linux_username>/nextcloud davfs user,rw,auto 0 0
Poté vyzkoušejte, že se připojuje (mount) a ověřuje spuštěním následujícího příkazu. Pokud jste vše nastavili správně, nebude zapotřebí oprávnění správce systému:
mount ~/nextcloud
Měli byste také být schopní ho odpojit (unmount):
umount ~/nextcloud
Nyní pokaždé, když se přihlásíte do svého linuxového systému, vaše Nextcloud sdílení by mělo být automaticky připojeno (mount) prostřednictvím WebDAV do adresáře ~/nextcloud
. Pokud chcete připojovat ručně, změňte v souboru s nastaveními /etc/fstab
na příslušném řádku hodnotu auto
na noauto
.
Známé problémy
Problém
Prostředek dočasně nedostupný
Řešení
Pokud narážíte na problémy při vytváření souboru v adresáři, přidejte do souboru /etc/davfs2/davfs2.conf
toto:
use_locks 0
Problém
Varování ohledně certifikátu
Řešení
Pokud používáte sám sebou podepsaný certifikát, obdržíte varování. To je možné změnit, nastavením davfs2
tak, aby uznávalo váš certifikát. Zkopírujte mujcertifikat.pem
do /etc/davfs2/certs/
. Poté upravte /etc/davfs2/davfs2.conf
a odkomentujte řádek servercert
. Nyní přidejte popis umístění vašeho certifikátu, jako v této ukázce:
servercert /etc/davfs2/certs/mycertificate.pem
Přístup k souborům ze systému macOS
Poznámka
The macOS Finder suffers from a series of implementation problems and should only be used if the Nextcloud server runs on Apache and mod_php, or Nginx 1.3.8+. Alternative macOS-compatible clients capable of accessing WebDAV shares include open source apps like Cyberduck (see instructions here) and Filezilla. Commercial clients include Mountain Duck, Forklift, Transmit, and Commander One.
Pro přístup k souborům z macOS Finder:
From the Finder’s top menu bar, choose Go > Connect to Server…:
When the Connect to Server… window opens, enter your Nextcloud server’s WebDAV address in the Server Address: field, i.e.:
https://cloud.YOURDOMAIN.com/remote.php/dav/files/USERNAME/
Klikněte na Připojit. Vámi používaný WebDAV server by se měl objevit na Ploše jako sdílená jednotka.
Přistupování k souborům ze systému Microsoft Windows
If you use the native Windows implementation of WebDAV, you can map Nextcloud to a new drive using Windows Explorer. Mapping to a drive enables you to browse files stored on a Nextcloud server the way you would browse files stored in a mapped network drive.
Použití této funkce vyžaduje připojení k síti. Pokud chcete ukládat své soubory offline, použijte desktopového klienta pro synchronizování všech souborů na vámi využívané instanci Nexcloud na úložiště ve vašem počítači.
Poznámka
Windows 10 now defaults to allow Basic Authentication if HTTPS is enabled before mapping your drive.
On older versions of Windows, you must permit the use of Basic Authentication in the Windows Registry:
launch
regedit
and navigate toHKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters
.Create or edit the
BasicAuthLevel
(Windows Vista, 7 and 8), orUseBasicAuth
(Windows XP and Windows Server 2003),DWORD
value and set its value data to1
for SSL connections. A value of0
means that Basic Authentication is disabled, and a value of2
allows both SSL and non-SSL connections (not recommended).Then exit Registry Editor, and restart the computer.
Mapování jednotek z příkazového řádku
Následující příklad zobrazuje jak namapovat jednotku z příkazového řádku. Pro namapování jednotky:
Ve Windows otevřete příkazový řádek.
Pro namapování jednotky Z v počítači zadejte do příkazového řádku následující:
net use Z: https://<drive_path>/remote.php/dav/files/USERNAME/ /user:youruser yourpassword
with <drive_path> as the URL to your Nextcloud server. For example:
net use Z: https://example.com/nextcloud/remote.php/dav/files/USERNAME/ /user:youruser yourpassword
Počítač namapuje soubory z vašeho Nextcloud účtu na jednotku s písmenkem Z.
Poznámka
Though not recommended, you can also mount the Nextcloud server using HTTP, leaving the connection unencrypted.
If you plan to use HTTP connections on devices while in a public place, we strongly recommend using a VPN tunnel to provide the necessary security.
Alternativní forma zápisu příkazu je:
net use Z: \\example.com@ssl\nextcloud\remote.php\dav /user:youruser yourpassword
Mapování disků pomocí Průzkumníka Windows
To map a drive using Microsoft Windows Explorer:
Otevřete Průzkumníka na svém počítači s MS Windows.
Klikněte pravým tlačítkem na položku Počítač a z rozbalovací nabídky vyberte Namapovat síťovou jednotku….
Zvolte písmenko pro nový místní síťový disk, na který chcete Nextcloud namapovat.
Zadejte adresu vámi používané instance Nextloud, následovanou /remote.php/dav/files/UZIVATELSKEJMENO/.
Například:
https://example.com/nextcloud/remote.php/dav/files/USERNAME/
Poznámka
For SSL-protected servers, check Reconnect at sign-in to ensure that the mapping is persistent upon subsequent reboots. If you want to connect to the Nextcloud server as a different user, check Connect using different credentials.
Klikněte na
Dokončit
.
Průzkumník Windows namapuje síťovou jednotku, čímž zpřístupní vámi využívanou instanci Nexcloud.
Přístup k souborům pomocí nástroje Cyberduck
Cyberduck is an open source FTP, SFTP, WebDAV, OpenStack Swift, and Amazon S3 browser designed for file transfers on macOS and Windows.
Poznámka
V tomto příkladu je použito Cyberduck verze 4.2.1.
Pro použití Cyberduck:
Specify a server without any leading protocol information.
For example:
example.com
Specify the appropriate port.
The port you choose depends on whether or not your Nextcloud server supports SSL. Cyberduck requires that you select a different connection type if you plan to use SSL.
- For example:
80
for unencrypted WebDAV443
for secure WebDAV (HTTPS/SSL)
Use the ‚More Options‘ drop-down menu to add the rest of your WebDAV URL into the ‚Path‘ field.
For example:
remote.php/dav/files/USERNAME/
Nyní Cyberduck umožní přístup k souborům na Nextcloud serveru.
Známé problémy
Problém
Windows se při použití HTTPS nepřipojují.
Řešení
WebDAV klient, obsažený v systému Windows, nemusí u šifrovaných spojení podporovat Server Name Indication (SNI). Pokud se setkáte s chybou při SSL šifrovaném připojování k instance Nexcloud, obraťte se na svého poskytovatele se žádostí o přidělení vyhrazené IP adresy pro váš na SSL založený server.
Jiné řešení
Může být, že WebDAV klient ve Windows nepodporuje TSLv1.1 a TSLv1.2 spojení. Pokud je v nastavení vámi využívaného serveru omezeno poskytování pouze na TLSv1.1 a novější, spojení se serverem se může nezdařit. Další informace naleznete v dokumentaci k WinHTTP.
Problém
Obdržíte následující chybové hlášení: Chyba 0x800700DF: Velikost souboru překračuje umožněný limit a není proto možné ho uložit.
Řešení
Systém Windows omezuje maximální velikost, jakou může mít soubor přenášený z nebo na WebDAV sdílení. Tuto hodnotu je možné zvýšit a to úpravou v registrech, konkrétně klíče FileSizeLimitInBytes v HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters, kliknutím na Změnit.
Pro zvýšení limitu na maximální hodnotu 4GB, vyberte Desítková, zadejte hodnotu 4294967295 a restartujte počítač nebo jen systémovou službu WebClient.
Problém
Přístup k vašim souborům z Microsoft Office prostřednictvím WebDAV se nedaří.
Řešení
Známé problémy a jejich řešení jsou popsány ve článku KB2123563 .
Problém
Cannot map Nextcloud as a WebDAV drive in Windows using a self-signed certificate.
Řešení
Access to your Nextcloud instance via your favorite Web browser.
Proklikejte se až obdržíte chybu certifikátu ve stavovém řádku prohlížeče.
View the certificate, then from the Details tab, select Copy to File.
Save the file to your desktop with an arbitrary name, for example
myNextcloud.pem
.Go to Start menu > Run, type MMC, and click OK to open Microsoft Management Console.
Go to File > Add/Remove Snap-In.
Select Certificates, Click Add, choose My User Account, then Finish, and finally OK.
Jděte až do Důvěryhodné kořenové certifikační autority, Certifikáty.
Right-Click Certificate, Select All Tasks, and Import.
Select the saved certificate from the Desktop.
Select Place all Certificates in the following Store, and click Browse.
Check the Box that says Show Physical Stores, expand out Trusted Root Certification Authorities, select Local Computer there, click OK, and Complete the Import.
Check the list to make sure the certificate shows up. You will probably need to Refresh before you see it.
Exit MMC.
For Firefox users:
Launch your browser, go to Application menu > History > Clear recent history…
Select ‚Everything‘ in the ‚Time range to clear‘ dropdown menu
Select the ‚Active Logins‘ check box
Click the ‚Clear now‘ button
Close the browser, then re-open and test.
For Chrome-based browsers (Chrome, Chromium, Microsoft Edge) users:
Open Windows Control Panel, navigate down to Internet Options
In the Content tab, click the Clear SSL State button.
Close the browser, then re-open and test.
Přistupování k souborů pomocí cURL
Protože WebDAV je rozšířením HTTP protokolu, lze pro naskriptování operací se soubory použít cURL.
Poznámka
Settings → Administration → Sharing → Allow users on this server to send shares to other servers.
If this option is disabled, the option --header "X-Requested-With: XMLHttpRequest"
needs to be passed to cURL.
Pro vytvoření složky, nazvanou podle stávajícího data:
$ curl -u user:pass -X MKCOL "https://example.com/nextcloud/remote.php/dav/files/USERNAME/$(date '+%d-%b-%Y')"
Pro nahrání souboru error.log
do tohoto adresáře:
$ curl -u user:pass -T error.log "https://example.com/nextcloud/remote.php/dav/files/USERNAME/$(date '+%d-%b-%Y')/error.log"
Pro přesunutí souboru:
$ 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
Pro získání vlastností souborů v kořenové složce:
$ 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>
Accessing files using WinSCP
WinSCP is an open source free SFTP, FTP, WebDAV, S3, and SCP client for Windows. Its main function is file transfer between a local and a remote computer. Beyond this, WinSCP offers scripting and basic file management functionality.
You can download the portable version of WinSCP and run it on Linux through Wine.
To run WinSCP on Linux, download wine through your distribution’s package manager, then run it with the command: wine WinSCP.exe
.
To connect to Nextcloud:
Start WinSCP
Press ‚Session‘ in the menu
Press the ‚New Session‘ menu option
Set the ‚File protocol‘ dropdown to WebDAV
Set the ‚Encryption‘ dropdown to TSL/SSL Implicit encryption
Fill in the hostname field:
example.com
Fill in the username field:
NEXTCLOUDUSERNAME
Fill in the password field:
NEXTCLOUDPASSWORD
Press the ‚Advanced…‘ button
Navigate to ‚Environment‘, ‚Directories‘ on the left side
Fill in the ‚Remote directory‘ field with the following:
/nextcloud/remote.php/dav/files/NEXTCLOUDUSERNAME/
Press the ‚OK‘ button
Press the ‚Save‘ button
Select the desired options and press the ‚OK‘ button
Press the ‚Login‘ button to connect to Nextcloud
Poznámka
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).