26bba23890
* Clarification, update links, organize * add nfs warning, fix debian version * add ENOSPC troubleshooting * add more enospc detail * add note on editing username * Documentation typo/grammar cleanup part 9 * grammar cleanup v10 * grammar editing v10 * grammar updates v11 * Grammar updates v11 * Lucky #13 (grammar updates) * grammar updates v14 * grammar updates v15 * grammar updates v16
52 lines
1.7 KiB
Markdown
52 lines
1.7 KiB
Markdown
# Reverse proxy
|
|
|
|
## Apache
|
|
|
|
As XO-web and XO-server communicate with *WebSockets*, you need to have the [`mod_proxy`](http://httpd.apache.org/docs/2.4/mod/mod_proxy.html), [`mod_proxy_http`](http://httpd.apache.org/docs/2.4/mod/mod_proxy_http.html), [`mod_proxy_wstunnel`](http://httpd.apache.org/docs/2.4/mod/mod_proxy_wstunnel.html) and [`mod_rewrite`](http://httpd.apache.org/docs/2.4/mod/mod_rewrite.html) modules enabled.
|
|
|
|
|
|
Please use this configuration in this order or it will not work. Do not forget the trailing slashes!:
|
|
|
|
```apache
|
|
RewriteEngine On
|
|
RewriteCond %{HTTP:upgrade} websocket [NC]
|
|
RewriteRule /[<path>]/(.*) ws://<xo-server ip>:<xo-server port>/$1 [L,P]
|
|
|
|
ProxyPass /[<path>]/ http://<xo-server ip>:<xo-server port>/
|
|
ProxyPassReverse /[<path>]/ http://<xo-server ip>:<xo-server port>/
|
|
```
|
|
|
|
|
|
## NGINX
|
|
|
|
Just configure your VirtualHost as usual (or your default site), with a `location` section like this one:
|
|
|
|
|
|
```nginx
|
|
location /[<path>] {
|
|
# Add some headers
|
|
proxy_set_header Host $host;
|
|
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 configuration
|
|
proxy_pass http://<XOA ip address>[:<port>]/;
|
|
|
|
proxy_http_version 1.1;
|
|
proxy_set_header Connection "upgrade";
|
|
proxy_set_header Upgrade $http_upgrade;
|
|
|
|
proxy_redirect default;
|
|
|
|
# Issue https://github.com/vatesfr/xen-orchestra/issues/1471
|
|
proxy_read_timeout 1800; # Error will be only every 30m
|
|
|
|
# For the VM import feature, this size must be larger than the file we want to upload.
|
|
# Without a proper value, nginx will have error "client intended to send too large body"
|
|
client_max_body_size 4G;
|
|
}
|
|
```
|
|
|
|
That's all!
|