Mercurial > hg > nginx-site
comparison xml/en/docs/http/ngx_http_realip_module.xml @ 348:5a848934a12d
English translation of ngx_http_geoip_module, ngx_http_map_module,
ngx_http_realip_module, ngx_http_secure_link_module,
ngx_http_split_clients_module, and ngx_http_sub_module.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Mon, 23 Jan 2012 16:50:35 +0000 |
parents | |
children | a4fa80755eab |
comparison
equal
deleted
inserted
replaced
347:daae2b619815 | 348:5a848934a12d |
---|---|
1 <?xml version="1.0"?> | |
2 | |
3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> | |
4 | |
5 <module name="Module ngx_http_realip_module" | |
6 link="/en/docs/http/ngx_http_realip_module.html" | |
7 lang="en"> | |
8 | |
9 <section id="summary"> | |
10 | |
11 <para> | |
12 The <literal>ngx_http_realip_module</literal> module allows | |
13 to change the client address to the one sent in the specified header field. | |
14 </para> | |
15 | |
16 <para> | |
17 This module is not built by default, it should be enabled with the | |
18 <literal>--with-http_realip_module</literal> | |
19 configuration parameter. | |
20 </para> | |
21 | |
22 </section> | |
23 | |
24 | |
25 <section id="example" name="Example Configuration"> | |
26 | |
27 <para> | |
28 <example> | |
29 set_real_ip_from 192.168.1.0/24; | |
30 set_real_ip_from 192.168.2.1; | |
31 real_ip_header X-Real-IP; | |
32 </example> | |
33 </para> | |
34 | |
35 </section> | |
36 | |
37 | |
38 <section id="directives" name="Directives"> | |
39 | |
40 <directive name="set_real_ip_from"> | |
41 <syntax><value>address</value> | <value>CIDR</value></syntax> | |
42 <default/> | |
43 <context>http</context> | |
44 <context>server</context> | |
45 <context>location</context> | |
46 | |
47 <para> | |
48 Describes trusted addresses that are known to send correct | |
49 replacement addresses. | |
50 </para> | |
51 | |
52 </directive> | |
53 | |
54 | |
55 <directive name="real_ip_header"> | |
56 <syntax> | |
57 <value>field</value> | | |
58 <literal>X-Real-IP</literal> | | |
59 <literal>X-Forwarded-For</literal></syntax> | |
60 <default>X-Real-IP</default> | |
61 <context>http</context> | |
62 <context>server</context> | |
63 <context>location</context> | |
64 | |
65 <para> | |
66 Defines a request header field used to send | |
67 the address for a replacement. | |
68 In case of the <header>X-Forwarded-For</header> field, | |
69 the last address in the field’s value is used. | |
70 For other fields the whole value is used. | |
71 </para> | |
72 | |
73 </directive> | |
74 | |
75 </section> | |
76 | |
77 </module> |