Skip to content

fix: enable proxy_cache_convert_head off and add tips at nginx config #81

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
laozhoubuluo wants to merge 1 commit into
base: main
Choose a base branch
from
Open

fix: enable proxy_cache_convert_head off and add tips at nginx config #81

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 16 additions & 3 deletions docs/integration/nginx.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ server {
proxy_set_header X-Forwarded-Proto $scheme;

# Disable Nginx from converting HEAD to GET
# proxy_cache_convert_head off;
proxy_cache_convert_head off;

proxy_connect_timeout 300;
# Default is HTTP/1, keepalive is only enabled in HTTP/1.1
Expand Down Expand Up @@ -94,7 +94,7 @@ server {
proxy_set_header X-Forwarded-Proto $scheme;

# Disable Nginx from converting HEAD to GET
# proxy_cache_convert_head off;
proxy_cache_convert_head off;

proxy_connect_timeout 300;
# Default is HTTP/1, keepalive is only enabled in HTTP/1.1
Expand All @@ -115,6 +115,19 @@ server {

```

#### Important Notice

> [!WARNING]
> **Key configuration items**
>
> The `proxy_cache_convert_head off` directive **must be added** to the Nginx configuration for the following reasons:
>
> - By default, Nginx converts HEAD requests to GET requests for caching.
> - This conversion will cause S3 V4 signature verification to fail.
> - The symptom is `Bucket not found` or `403 Access Denied` error when accessing the storage bucket.
>
> Refer to [Nginx Official Documentation](http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_convert_head)。

## 3. Multi-Machine Load Balancing

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.
Expand Down Expand Up @@ -203,4 +216,4 @@ server {
proxy_pass http://127.0.0.1:9001;
}
}
~~~
~~~