Setup
The SeaweedFS S3 gateway (weed s3, port 8333 by default) takes access keys
from an S3 config file. With no identities defined, it accepts any key pair,
which suits local development.
Define an access key
Define an access key
Write the identities to Start the gateway with it,
s3.json:s3.json
weed s3 -filer=localhost:8888 -config=s3.json
or weed server -s3 -s3.config=s3.json. Drop Write:my-bucket for a
read-only key. Once any identity exists, the gateway requires
authentication even after the identities are removed.- The gateway is self-hosted, so the endpoint is required and requests are path-style.
- Blaxel Agent Drive is backed by SeaweedFS: use the drive’s
s3Urlas the endpoint and a drive access token’s credentials as the key pair.
Connect
- YAML
- Python
- TypeScript
workspace.yaml
Layout
- Each object key is a file path; folders are key prefixes, and the bucket holds no directory objects.
key_prefix(keyPrefixin TypeScript) mounts one subpath of the bucket as the root.grep -r,findanddustop after 1000 files; a glob matching more,tar -c,cp -randrm -rare refused.
Sample runs
write mount, redirects, cp, mv and rm change objects in the bucket.
For write: conditional, see S3-compatible VFSes.
SDK guides
Python
Every config field, the VFS.md and write support.
TypeScript
Every config field, the VFS.md and write support.