mirror of
https://github.com/seaweedfs/seaweedfs.git
synced 2026-10-09 15:57:47 +02:00
docs: document -volumeName for the mount disk label
1 parent
c182f792fd
commit
ae46aefc82
2 files changed
+27
No files matched your search
+10
@@ -203,6 +203,16 @@ mount -t weed fuse /mnt -o "filer='192.168.0.1:8888,192.168.0.2:8888',filer.path
|
||||
Now you can operate the SeaweedFS files, browsing or modifying directories and files, in local file system.
|
||||
To unmount, just shut it down the "weed mount".
|
||||
|
||||
#### Disk name (`-volumeName`)
|
||||
|
||||
Where the platform labels the mount — Finder on macOS, Explorer on Windows, and `mount`/`df` on Linux and FreeBSD — the name is derived from the mounted path: `-filer.path` first, then the `-dir` mount point, then the filer address. `-volumeName` overrides that derivation without changing what is mounted:
|
||||
|
||||
```bash
|
||||
weed mount -filer=localhost:8888 -dir=/mnt/seaweedfs -filer.path=/ -volumeName=Photos
|
||||
```
|
||||
|
||||
Leave `-volumeName` empty to keep the derived name. On Windows the override is the volume label Explorer shows; the UNC share name (e.g. `\\seaweedfs\Images`) is unaffected. See [[Mount on Windows]] for the Windows-specific details.
|
||||
|
||||
#### Mount with fstab
|
||||
|
||||
```
|
||||
|
||||
@@ -38,9 +38,26 @@ Stop the mount with Ctrl-C, which unmounts cleanly and flushes pending writes. K
|
||||
| `-readOnly` | Reject every modification at the WinFsp layer. |
|
||||
| `-cacheMetaTtlSec` | How long WinFsp may cache attributes and directory entries. |
|
||||
| `-debug.fuse` | Log every filesystem operation. |
|
||||
| `-volumeName` | Name shown by Explorer for the disk, overriding the name taken from `-filer.path` or `-dir`. See [Disk name](#disk-name). |
|
||||
|
||||
Everything else — `-cacheDirForRead`, `-cacheSizeMBForRead`, `-chunkSizeLimitMB`, `-collection`, `-replication`, `-concurrentWriters` — behaves as it does elsewhere. See [[FUSE Mount]].
|
||||
|
||||
### Disk name
|
||||
|
||||
Explorer labels the mounted disk after the mounted path:
|
||||
|
||||
* `-filer.path=/Image Disk` shows up as `Image Disk`.
|
||||
* Mounting the whole tree (`-filer.path=/`) takes the name from the mount point instead, so `-dir=\\seaweedfs\Images` labels the disk `Images` while still mounting everything.
|
||||
* A bare drive letter (`-dir=S:`) has no name to take, so the disk falls back to the filer address.
|
||||
|
||||
The derived name can collide with the real drive it sits on, or with another mount's label. `-volumeName` overrides the derivation without changing what is mounted:
|
||||
|
||||
```powershell
|
||||
weed.exe mount -filer=127.0.0.1:8888 -dir=\\seaweedfs\Images -volumeName=Photos
|
||||
```
|
||||
|
||||
This mounts `\\seaweedfs\Images` as before but labels the disk `Photos`. The UNC share name (`\\seaweedfs\Images`) is unaffected — only the volume label changes. Leave `-volumeName` empty to keep the old behaviour. Commas in the value are replaced with `+`, since WinFsp treats commas as option separators.
|
||||
|
||||
#### Case sensitivity
|
||||
|
||||
The filer is case-sensitive, and so is the mount by default: `Report.txt` and `report.txt` are two files. Some Windows software assumes otherwise and will misbehave. `-windows.caseInsensitive` makes the mount match Windows expectations, at the cost of making one of any two names that differ only in case unreachable. WinFsp cannot do NTFS-style mixed sensitivity, so it is one or the other for the whole mount.
|
||||
|
||||
Reference in new issue
Block a user