Wiki source code of Setting up NginX

Last modified by Manuel Leduc on 2024/02/14

Show last authors
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.

Get Connected