Wiki source code of Setting up NginX
Last modified by Manuel Leduc on 2024/02/14
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{box cssClass="floatinginfobox" title="**Contents**"}} | ||
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
| 4 | |||
| 5 | = Set up = | ||
| 6 | |||
| 7 | {{warning}} | ||
| 8 | * This configuration has been contributed by an XWiki user and needs to be verified. | ||
| 9 | {{/warning}} | ||
| 10 | |||
| 11 | Example running XWiki on the Glassfish 2 Application Server: | ||
| 12 | |||
| 13 | * NginX listens on ##<domain>:80## and redirects HTTP queries to ##<domain>:8080## and thus NginX is referred to as "frontend" and Glassfish as "backend". | ||
| 14 | * Glassfish is installed in the ##/user/local/glassfish/glassfish## folder. | ||
| 15 | |||
| 16 | For more information you can consult the [[NginX manual>>http://wiki.nginx.org/Main]]. | ||
| 17 | |||
| 18 | NginX configuration example with ##<domain>## being ##vostrets.ru## (##/etc/nginx.conf##): | ||
| 19 | |||
| 20 | {{code}} | ||
| 21 | user www-data; | ||
| 22 | worker_processes 2; # This should be equal to number of CPUs | ||
| 23 | |||
| 24 | worker_rlimit_nofile 20000; # Max open file descriptors, increase if nginx is serving large amount of static data for many users | ||
| 25 | |||
| 26 | events | ||
| 27 | { | ||
| 28 | worker_connections 1024; # number of max connections per worker (worker_connections * worker_processes = max connections) | ||
| 29 | use epoll; | ||
| 30 | multi_accept on; | ||
| 31 | } | ||
| 32 | |||
| 33 | |||
| 34 | http | ||
| 35 | { | ||
| 36 | include mime.types; | ||
| 37 | default_type application/octet-stream; | ||
| 38 | |||
| 39 | server_tokens off; # don't send nginx version to end users | ||
| 40 | |||
| 41 | sendfile on; | ||
| 42 | tcp_nopush on; | ||
| 43 | tcp_nodelay on; | ||
| 44 | |||
| 45 | gzip on; | ||
| 46 | gzip_comp_level 4; # increase for better compression (values 1 to 9, 1 = fastest, 9 = slowest/best compression) | ||
| 47 | gzip_types text/plain text/css application/x-javascript text/xml application/xml application/xml+rss text/javascript; # compress multiple mime types | ||
| 48 | gzip_vary on; # send Vary: Accept-Encoding header | ||
| 49 | gzip_proxied any; # enable compression for proxied requests | ||
| 50 | |||
| 51 | server | ||
| 52 | { | ||
| 53 | listen 80; | ||
| 54 | |||
| 55 | server_name vostrets.ru; | ||
| 56 | |||
| 57 | # redirect all http://vostrets.ru/* requests to http://www.vostrets.ru/* | ||
| 58 | rewrite ^(.*) http://www.vostrets.ru$1 permanent; | ||
| 59 | } | ||
| 60 | |||
| 61 | server | ||
| 62 | { | ||
| 63 | listen 80; | ||
| 64 | |||
| 65 | server_name www.vostrets.ru; | ||
| 66 | |||
| 67 | charset utf-8; | ||
| 68 | |||
| 69 | access_log /var/log/nginx_access.log; | ||
| 70 | |||
| 71 | # count skin images for static data, though they are in "bin" path | ||
| 72 | location ~* ^/xwiki/bin/skin/(.*)\.(jpg|jpeg|gif|png|ico)$ | ||
| 73 | { | ||
| 74 | access_log off; | ||
| 75 | |||
| 76 | rewrite ^/xwiki/bin/skin/(.*) /xwiki/$1 permanent; | ||
| 77 | |||
| 78 | expires max; | ||
| 79 | } | ||
| 80 | |||
| 81 | # fetch all the data, which doesn't lie in "bin" path, as static data | ||
| 82 | location ~* ^/xwiki(?!/bin/).+\.(jpg|jpeg|gif|png|ico|css|js)$ | ||
| 83 | { | ||
| 84 | access_log off; | ||
| 85 | |||
| 86 | # ${root} is the path, where the static files lie (i.e. ${root}/xwiki/skins/toucan/logo.png) | ||
| 87 | root /user/local/glassfish/glassfish/domains/default_domain/applications/j2ee-modules; | ||
| 88 | |||
| 89 | expires max; | ||
| 90 | } | ||
| 91 | |||
| 92 | # forward all http://vostrets.ru/ requests to http://vostrets.ru:8080/ | ||
| 93 | location / | ||
| 94 | { | ||
| 95 | proxy_pass http://localhost:8080; | ||
| 96 | proxy_set_header X-Real-IP $remote_addr; | ||
| 97 | proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; | ||
| 98 | proxy_set_header Host $http_host; | ||
| 99 | proxy_set_header X-Forwarded-Proto $scheme; | ||
| 100 | |||
| 101 | expires 0m; | ||
| 102 | } | ||
| 103 | |||
| 104 | # ... | ||
| 105 | } | ||
| 106 | } | ||
| 107 | {{/code}} | ||
| 108 | |||
| 109 | = Troubleshooting = | ||
| 110 | |||
| 111 | == Request Entity Too Large == | ||
| 112 | |||
| 113 | If you find the following message in your logs: {{code}}Failed to load resource: the server responded with a status of 413 (Request Entity Too Large){{/code}} then you might want to try to [[increase the request body size>>http://nginx.org/en/docs/http/ngx_http_core_module.html#client_max_body_size]] since it seems nginx does not allow request bodies larger than 1MB by default. |
