Files
quyun-v2/docs/storage_provider.md
2026-01-17 22:16:52 +08:00

37 lines
1013 B
Markdown

# Storage Provider Setup
This project supports local filesystem storage for development/tests and an S3-compatible provider (AWS S3/MinIO) for production.
## Local (dev/test)
Use local storage for tests and quick development.
```toml
[Storage]
Type = "local"
LocalPath = "./storage"
Secret = "your-storage-secret"
BaseURL = "http://localhost:8080/t/<tenantCode>/v1/storage"
```
Note: `BaseURL` should include the tenant code because storage routes are tenant-scoped.
## S3/MinIO (example)
```toml
[Storage]
Type = "s3"
AccessKey = "minioadmin"
SecretKey = "minioadmin"
Region = "us-east-1"
Bucket = "quyun-assets"
Endpoint = "http://127.0.0.1:9000"
PathStyle = true
# Optional: check bucket connectivity on boot
CheckOnBoot = false
```
For AWS S3, set `Endpoint` with `https://` (e.g., `https://s3.amazonaws.com`) and keep `PathStyle` as `false` unless your provider requires path-style access.
For local MinIO setup and a smoke test, see `docs/storage_minio_smoke_test.md` (includes `ENV_LOCAL=minio`).