You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
fix: enable proxy_cache_convert_head off and add tips at nginx config (#81)
Add important note about 'proxy_cache_convert_head off' in Nginx configuration to prevent S3 V4 signature verification failures.
Related Issue: rustfs/rustfs#717
Copy file name to clipboardExpand all lines: docs/integration/nginx.md
+16-3Lines changed: 16 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -54,7 +54,7 @@ server {
54
54
proxy_set_header X-Forwarded-Proto $scheme;
55
55
56
56
# Disable Nginx from converting HEAD to GET
57
-
# proxy_cache_convert_head off;
57
+
proxy_cache_convert_head off;
58
58
59
59
proxy_connect_timeout 300;
60
60
# Default is HTTP/1, keepalive is only enabled in HTTP/1.1
@@ -94,7 +94,7 @@ server {
94
94
proxy_set_header X-Forwarded-Proto $scheme;
95
95
96
96
# Disable Nginx from converting HEAD to GET
97
-
# proxy_cache_convert_head off;
97
+
proxy_cache_convert_head off;
98
98
99
99
proxy_connect_timeout 300;
100
100
# Default is HTTP/1, keepalive is only enabled in HTTP/1.1
@@ -115,6 +115,19 @@ server {
115
115
116
116
```
117
117
118
+
#### Important Notice
119
+
120
+
> [!WARNING]
121
+
> **Key configuration items**
122
+
>
123
+
> The `proxy_cache_convert_head off` directive **must be added** to the Nginx configuration for the following reasons:
124
+
>
125
+
> - By default, Nginx converts HEAD requests to GET requests for caching.
126
+
> - This conversion will cause S3 V4 signature verification to fail.
127
+
> - The symptom is `Bucket not found` or `403 Access Denied` error when accessing the storage bucket.
128
+
>
129
+
> Refer to [Nginx Official Documentation](http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_convert_head)。
130
+
118
131
## 3. Multi-Machine Load Balancing
119
132
120
133
If you need to add multiple RustFS servers in a distributed environment, please adjust DNS resolution or local Hosts addresses in advance, and modify and add servers.
0 commit comments