mirror of
https://github.com/minio/docs.git
synced 2025-07-28 19:42:10 +03:00
Initial work for git-managed redirects (#556)
This is the initial work for what should be a git-managed set of nginx configs we can include into the Nginx Docs server. The idea here is we manage redirects in git, and either chron-copy them to a location we can include via the sites-available/<file>, *or* we just include them from the git path (if nginx tolerates that) I can't really _test_ these right now since they are using live URLs. if we move forward with the soft-launch, we'll have a few opportunities to maybe test a subset of these URLs and see what happens. Please let me know if there is anything *obviously* wrong here. ToDo: The Legacy Docs redirects
This commit is contained in:
113
source/integrations/setup-nginx-proxy-with-minio.md
Normal file
113
source/integrations/setup-nginx-proxy-with-minio.md
Normal file
@ -0,0 +1,113 @@
|
||||
# Set up Nginx proxy with MinIO Server [](https://slack.min.io)
|
||||
|
||||
Nginx is an open source Web server and a reverse proxy server.
|
||||
|
||||
In this recipe we will learn how to set up Nginx proxy with MinIO Server.
|
||||
|
||||
## 1. Prerequisites
|
||||
|
||||
Install MinIO Server from [here](https://docs.min.io/docs/minio-quickstart-guide).
|
||||
|
||||
## 2. Installation
|
||||
|
||||
Install Nginx from [here](http://nginx.org/en/download.html).
|
||||
|
||||
## 3. Configuration
|
||||
|
||||
### Proxy all requests
|
||||
Add the following content as a file ``/etc/nginx/sites-enabled``, e.g. ``/etc/nginx/sites-enables/minio`` and also remove the existing ``default`` file in same directory.
|
||||
|
||||
```sh
|
||||
server {
|
||||
listen 80;
|
||||
server_name example.com;
|
||||
|
||||
# To allow special characters in headers
|
||||
ignore_invalid_headers off;
|
||||
# Allow any size file to be uploaded.
|
||||
# Set to a value such as 1000m; to restrict file size to a specific value
|
||||
client_max_body_size 0;
|
||||
# To disable buffering
|
||||
proxy_buffering off;
|
||||
|
||||
location / {
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
proxy_set_header Host $http_host;
|
||||
|
||||
proxy_connect_timeout 300;
|
||||
# Default is HTTP/1, keepalive is only enabled in HTTP/1.1
|
||||
proxy_http_version 1.1;
|
||||
proxy_set_header Connection "";
|
||||
chunked_transfer_encoding off;
|
||||
|
||||
proxy_pass http://localhost:9000; # If you are using docker-compose this would be the hostname i.e. minio
|
||||
# Health Check endpoint might go here. See https://www.nginx.com/resources/wiki/modules/healthcheck/
|
||||
# /minio/health/live;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Note:
|
||||
|
||||
* Replace example.com with your own hostname.
|
||||
* Replace ``http://localhost:9000`` with your own server name.
|
||||
* Add ``client_max_body_size 1000m;`` in the ``http`` context in order to be able to upload large files — simply adjust the value accordingly. The default value is `1m` which is far too low for most scenarios. To disable checking of client request body size, set ``client_max_body_size`` to `0`.
|
||||
* Nginx buffers responses by default. To disable Nginx from buffering MinIO response to temp file, set `proxy_buffering off;`. This will improve time-to-first-byte for client requests.
|
||||
* Nginx disallows special characters by default. Set ``ignore_invalid_headers off;`` to allow headers with special characters.
|
||||
|
||||
### Proxy requests based on the bucket
|
||||
If you want to serve web-application and MinIO from the same nginx port then you can proxy the MinIO requests based on the bucket name using path based routing. For nginx this uses the `location` directive, which also supports object key pattern-match based proxy splitting.
|
||||
|
||||
```sh
|
||||
# Proxy requests to the bucket "photos" to MinIO server running on port 9000
|
||||
location /photos/ {
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
proxy_set_header Host $http_host;
|
||||
|
||||
proxy_connect_timeout 300;
|
||||
# Default is HTTP/1, keepalive is only enabled in HTTP/1.1
|
||||
proxy_http_version 1.1;
|
||||
proxy_set_header Connection "";
|
||||
chunked_transfer_encoding off;
|
||||
|
||||
proxy_pass http://localhost:9000;
|
||||
}
|
||||
|
||||
# Proxy any other request to the application server running on port 9001
|
||||
location / {
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
proxy_set_header Host $http_host;
|
||||
|
||||
proxy_connect_timeout 300;
|
||||
# Default is HTTP/1, keepalive is only enabled in HTTP/1.1
|
||||
proxy_http_version 1.1;
|
||||
proxy_set_header Connection "";
|
||||
chunked_transfer_encoding off;
|
||||
|
||||
proxy_pass http://localhost:9001;
|
||||
}
|
||||
```
|
||||
|
||||
## 4. Recipe Steps
|
||||
|
||||
### Step 1: Start MinIO server.
|
||||
|
||||
```sh
|
||||
minio server /mydatadir
|
||||
```
|
||||
|
||||
### Step 2: Restart Nginx server.
|
||||
|
||||
```sh
|
||||
sudo service nginx restart
|
||||
```
|
||||
|
||||
## Explore Further
|
||||
|
||||
Refer [this blog post](https://www.nginx.com/blog/enterprise-grade-cloud-storage-nginx-plus-minio/) for various MinIO and Nginx configuration options.
|
Reference in New Issue
Block a user