Feat: add fuse mount

This commit is contained in:
benato.denis96@gmail.com 2026-03-12 09:09:51 +01:00
parent d3cae9fd20
commit 0351b32ab6
6 changed files with 1424 additions and 116 deletions

View file

@ -179,6 +179,37 @@ swfss3 --endpoint http://localhost:8333 --bucket mybucket --path-style \
rm-prefix some/path/ --yes
```
### Mount bucket via FUSE3 (Linux)
Mount the whole bucket read-only:
```bash
mkdir -p /tmp/s3mnt
swfss3 --endpoint http://localhost:8333 --bucket mybucket --path-style \
mount /tmp/s3mnt
```
Mount only a prefix (the prefix becomes the filesystem root):
```bash
swfss3 --endpoint http://localhost:8333 --bucket mybucket --path-style \
mount /tmp/s3mnt --prefix photos/2025/
```
Enable writes (naive buffered uploads on flush/close):
```bash
swfss3 --endpoint http://localhost:8333 --bucket mybucket --path-style \
mount /tmp/s3mnt --read-write
```
Allow access by other users (requires `user_allow_other` in `/etc/fuse.conf`):
```bash
swfss3 --endpoint http://localhost:8333 --bucket mybucket --path-style \
mount /tmp/s3mnt --allow-other
```
## Troubleshooting
### `NoSuchBucket` but the bucket “exists”
@ -205,4 +236,5 @@ swfss3 mv --help
swfss3 presign-get --help
swfss3 presign-put --help
swfss3 rm-prefix --help
swfss3 mount --help
```