diff xml/ru/docs/mail/ngx_mail_realip_module.xml @ 2677:3760176ba83e

Documented ngx_mail_realip_module.
author Yaroslav Zhuravlev <yar@nginx.com>
date Wed, 10 Mar 2021 20:35:36 +0000
parents
children
line wrap: on
line diff
new file mode 100644
--- /dev/null
+++ b/xml/ru/docs/mail/ngx_mail_realip_module.xml
@@ -0,0 +1,65 @@
+<?xml version="1.0"?>
+
+<!--
+  Copyright (C) Nginx, Inc.
+  -->
+
+<!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
+
+<module name="Модуль ngx_mail_realip_module"
+        link="/ru/docs/mail/ngx_mail_realip_module.html"
+        lang="ru"
+        rev="1">
+
+<section id="summary">
+
+<para>
+Модуль <literal>ngx_mail_realip_module</literal> позволяет
+менять адрес и порт клиента
+на переданные в заголовке протокола PROXY (1.19.8).
+Протокол PROXY должен быть предварительно включён при помощи установки
+параметра <link doc="ngx_mail_core_module.xml" id="proxy_protocol"/>
+в директиве <literal>listen</literal>.
+</para>
+
+</section>
+
+
+<section id="example" name="Пример конфигурации">
+
+<para>
+<example>
+listen 110 proxy_protocol;
+
+set_real_ip_from  192.168.1.0/24;
+set_real_ip_from  192.168.2.1;
+set_real_ip_from  2001:0db8::/32;
+</example>
+</para>
+
+</section>
+
+
+<section id="directives" name="Директивы">
+
+<directive name="set_real_ip_from">
+<syntax>
+    <value>адрес</value> |
+    <value>CIDR</value> |
+    <literal>unix:</literal></syntax>
+<default/>
+<context>mail</context>
+<context>server</context>
+
+<para>
+Задаёт доверенные адреса, которые передают верный адрес
+для замены.
+Если указано специальное значение <literal>unix:</literal>,
+доверенными будут считаться все UNIX-сокеты.
+</para>
+
+</directive>
+
+</section>
+
+</module>