woodpecker/doc/setup-nginx.md

23 lines
955 B
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Using a proxy server is not really necessary. Drone serves most static content from a CDN and uses the Go standard librarys high-performance net/http package to serve dynamic content. If using Nginx to proxy traffic to Drone you may use the following configuration:
```nginx
location / {
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Host $http_host;
proxy_set_header Origin "";
proxy_pass http://127.0.0.1:8000;
proxy_redirect off;
}
```
It is very important to set the `X-Forwarded-For` and `X-Forwarded-Proto` header variables. Drone needs to know its own URL so that it can configure a repository's post-commit hooks properly.
You may also want to change Drones default port when proxying traffic. You can change the port in the `/etc/drone/drone.toml` configuration file:
```toml
[server]
addr = ":8000"
```