feat(webdav): configurable mount display name (WEBDAV_NAME)

The WebDAV root now advertises a configurable DAV:displayname (env
WEBDAV_NAME, default "OpenCoper") instead of the hard-coded "OpenCoperLock",
so Finder / Cyberduck / GNOME label the mount with a short, tidy name.

Windows Explorer ignores DAV:displayname and labels the mapped drive from
the URL's last path segment, so docs/API.md gains a "Naming the drive"
section with the nginx recipe to expose WebDAV under a path ending in the
desired name (e.g. /OpenCoper/, using the X-Forwarded-Prefix we already
honour). .env.example documents WEBDAV_NAME.

Author: softpython2884

.env.example

@@ -92,3 +92,9 @@ UPDATE_BRANCH=main
 GITHUB_TOKEN=
 # Set to false where updates are managed externally; disables the one-click update button.
 SELF_UPDATE_ENABLED=true
+
+# ── WebDAV ───────────────────────────────────────────────────────────────────
+# Name advertised for the WebDAV root. Finder / Cyberduck / GNOME label the mount with this;
+# keep it short. (Windows Explorer ignores it and uses the URL's last path segment instead —
+# see docs/API.md "Naming the drive on Windows".)
+WEBDAV_NAME=OpenCoper

apps/api/src/env.ts

@@ -70,6 +70,12 @@ const envSchema = z.object({
     .enum(['true', 'false'])
     .default('true')
     .transform((v) => v === 'true'),
+
+  // Display name advertised for the WebDAV root (DAV:displayname). Clients that honour it
+  // (Finder, Cyberduck, GNOME…) label the mount with this. Keep it short — some clients (and
+  // rename fields) truncate long names. NOTE: Windows Explorer ignores this and labels the
+  // mapped drive from the URL's last path segment instead.
+  WEBDAV_NAME: z.string().default('OpenCoper'),
 });
 
 export type Env = z.infer<typeof envSchema> & { masterKey: Buffer };

apps/api/src/routes/webdav.ts

@@ -192,7 +192,7 @@ export const webdavRoutes: FastifyPluginAsync = async (app) => {
         };
       }
       if (node.type === 'root') {
-        parts.push(propXml(base, [], true, 'OpenCoperLock', 0, new Date(), '', quota));
+        parts.push(propXml(base, [], true, app.ctx.env.WEBDAV_NAME, 0, new Date(), '', quota));
       } else if (node.type === 'folder') {
         parts.push(propXml(base, segments, true, node.folder.name, 0, node.folder.createdAt, '', quota));
       } else {

docs/API.md

@@ -121,6 +121,36 @@ from there rather than typing it).
 > clients that strip `/api` can list the root but fail to open folders. With it, hrefs become
 > `/api/dav/…` and navigation works.
 
+### Naming the drive
+
+The name a client shows for the mount depends on the client:
+
+- **Finder / Cyberduck / GNOME** use the server's advertised name. Set `WEBDAV_NAME` in `.env`
+  (default `OpenCoper`) and reconnect — the mount is labelled with that.
+- **Windows Explorer ignores the advertised name** and labels the mapped drive from the **last
+  segment of the URL** you mounted. So `…/api/dav/` shows up as *“dav (\\host@SSL\DavWWWRoot\…)”*.
+  To get a custom label like **OpenCoper**, expose WebDAV under a path ending in that word and
+  mount *that* URL — the server already rewrites hrefs from `X-Forwarded-Prefix`:
+
+  ```nginx
+  # Mount https://<host>/OpenCoper/  →  Windows labels the drive "OpenCoper"
+  location /OpenCoper/ {
+      proxy_pass http://127.0.0.1:4000/dav/;        # trailing slash → API sees /dav/
+      proxy_set_header Host               $host;
+      proxy_set_header Authorization      $http_authorization;
+      proxy_set_header X-Forwarded-Proto  $scheme;
+      proxy_set_header X-Forwarded-Prefix /OpenCoper;   # hrefs stay under /OpenCoper
+      proxy_pass_request_headers on;
+      client_max_body_size 0;
+      proxy_request_buffering off;
+      proxy_buffering off;
+      proxy_read_timeout 3600s;
+  }
+  ```
+
+  (Or simply map the drive and rename it in *This PC* — but the label above is set once, for
+  everyone.)
+
 ### Diagnosing a mount that won't connect
 
 First prove the server side works, independent of any OS client: