Skip to content

Self-hosted personal gallery application with online photo management and albums, supporting Live/Motion Photos, EXIF parsing, geolocation recognition, and an explore map.

feat(s3): add forcePathStyle configuration for S3 storage provider

EmccK62df98cc3ec9
diff --git a/.env.example b/.env.example
index 285725c6..cd6b781c 100644
--- a/.env.example
+++ b/.env.example
@@ -28,6 +28,7 @@ NUXT_PROVIDER_S3_ACCESS_KEY_ID=
NUXT_PROVIDER_S3_SECRET_ACCESS_KEY=
NUXT_PROVIDER_S3_PREFIX=photos/
NUXT_PROVIDER_S3_CDN_URL=
+NUXT_PROVIDER_S3_FORCE_PATH_STYLE=false
# Local storage provider configuration
NUXT_PROVIDER_LOCAL_PATH=./data/storage
diff --git a/docs/configuration/storage-providers.md b/docs/configuration/storage-providers.md
index 1ebee2b0..3eec31bb 100644
--- a/docs/configuration/storage-providers.md
+++ b/docs/configuration/storage-providers.md
@@ -27,6 +27,7 @@ NUXT_PROVIDER_S3_SECRET_ACCESS_KEY=your-secret-access-key
# Optional configuration
NUXT_PROVIDER_S3_PREFIX=photos/
NUXT_PROVIDER_S3_CDN_URL=https://cdn.example.com
+NUXT_PROVIDER_S3_FORCE_PATH_STYLE=false
```
### Cloud Provider Configuration Examples
@@ -87,6 +88,8 @@ NUXT_PROVIDER_S3_BUCKET=chronoframe
NUXT_PROVIDER_S3_REGION=us-east-1
NUXT_PROVIDER_S3_ACCESS_KEY_ID=minioadmin
NUXT_PROVIDER_S3_SECRET_ACCESS_KEY=minioadmin
+# MinIO requires path-style access
+NUXT_PROVIDER_S3_FORCE_PATH_STYLE=true
```
### Bucket Configuration
diff --git a/docs/zh/configuration/storage-providers.md b/docs/zh/configuration/storage-providers.md
index 77978b89..652a7831 100644
--- a/docs/zh/configuration/storage-providers.md
+++ b/docs/zh/configuration/storage-providers.md
@@ -27,6 +27,7 @@ NUXT_PROVIDER_S3_SECRET_ACCESS_KEY=your-secret-access-key
# 可选配置
NUXT_PROVIDER_S3_PREFIX=photos/
NUXT_PROVIDER_S3_CDN_URL=https://cdn.example.com
+NUXT_PROVIDER_S3_FORCE_PATH_STYLE=false
```
### 云服务商配置示例
@@ -87,6 +88,8 @@ NUXT_PROVIDER_S3_BUCKET=chronoframe
NUXT_PROVIDER_S3_REGION=us-east-1
NUXT_PROVIDER_S3_ACCESS_KEY_ID=minioadmin
NUXT_PROVIDER_S3_SECRET_ACCESS_KEY=minioadmin
+# MinIO 需要启用路径样式访问
+NUXT_PROVIDER_S3_FORCE_PATH_STYLE=true
```
### 存储桶配置
diff --git a/nuxt.config.ts b/nuxt.config.ts
index 020ad932..60530a9e 100644
--- a/nuxt.config.ts
+++ b/nuxt.config.ts
@@ -68,6 +68,7 @@ export default defineNuxtConfig({
secretAccessKey: '',
prefix: '',
cdnUrl: '',
+ forcePathStyle: false,
},
local: {
localPath: './data/storage',
diff --git a/server/plugins/storage.ts b/server/plugins/storage.ts
index 8e05342d..961b63d7 100644
--- a/server/plugins/storage.ts
+++ b/server/plugins/storage.ts
@@ -26,6 +26,7 @@ export default nitroPlugin(async (nitroApp) => {
cdnUrl: config.provider.s3.cdnUrl,
accessKeyId: config.provider.s3.accessKeyId,
secretAccessKey: config.provider.s3.secretAccessKey,
+ forcePathStyle: config.provider.s3.forcePathStyle,
},
local: {
provider: 'local',
diff --git a/server/services/storage/interfaces.ts b/server/services/storage/interfaces.ts
index 0796fcfe..f866322c 100644
--- a/server/services/storage/interfaces.ts
+++ b/server/services/storage/interfaces.ts
@@ -14,6 +14,7 @@ export type S3StorageConfig = {
cdnUrl?: string
accessKeyId?: string
secretAccessKey?: string
+ forcePathStyle?: boolean
maxKeys?: number
}
diff --git a/server/services/storage/providers/s3.ts b/server/services/storage/providers/s3.ts
index e371a1e1..756d6954 100644
--- a/server/services/storage/providers/s3.ts
+++ b/server/services/storage/providers/s3.ts
@@ -27,6 +27,7 @@ const createClient = (config: S3StorageConfig): S3Client => {
const clientConfig: S3ClientConfig = {
endpoint,
region,
+ forcePathStyle: config.forcePathStyle,
responseChecksumValidation: 'WHEN_REQUIRED',
requestChecksumCalculation: 'WHEN_REQUIRED',
credentials: {