CoCalc -- ngx_http_access

GitHub Repository: nginx/nginx.org
Path: blob/main/xml/ru/docs/http/ngx_http_access_module.xml
¹ views
1
<?xml version="1.0"?>
2

3
<!--
4
  Copyright (C) Igor Sysoev
5
  Copyright (C) Nginx, Inc.
6
  -->
7

8
<!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9

10
<module name="Модуль ngx_http_access_module"
11
        link="/ru/docs/http/ngx_http_access_module.html"
12
        lang="ru"
13
        rev="5">
14

15
<section id="summary">
16

17
<para>
18
Модуль <literal>ngx_http_access_module</literal> позволяет
19
ограничить доступ для определённых адресов клиентов.
20
</para>
21

22
<para>
23
Ограничить доступ можно также по
24
<link doc="ngx_http_auth_basic_module.xml">паролю</link>, по
25
<link doc="ngx_http_auth_request_module.xml">результату подзапроса</link>
26
или по <link doc="ngx_http_auth_jwt_module.xml">JWT</link>.
27
Одновременное ограничение доступа по адресу и паролю управляется
28
директивой <link doc="ngx_http_core_module.xml" id="satisfy"/>.
29
</para>
30

31
</section>
32

33

34
<section id="example" name="Пример конфигурации">
35

36
<para>
37
<example>
38
location / {
39
    deny  192.168.1.1;
40
    allow 192.168.1.0/24;
41
    allow 10.1.1.0/16;
42
    allow 2001:0db8::/32;
43
    deny  all;
44
}
45
</example>
46
</para>
47

48
<para>
49
Правила проверяются в порядке их записи до первого соответствия.
50
В данном примере доступ разрешён только для IPv4-сетей
51
<literal>10.1.1.0/16</literal> и <literal>192.168.1.0/24</literal>,
52
кроме адреса <literal>192.168.1.1</literal>,
53
и для IPv6-сети <literal>2001:0db8::/32</literal>.
54
Если правил много, то лучше воспользоваться переменными модуля
55
<link doc="ngx_http_geo_module.xml">ngx_http_geo_module</link>.
56
</para>
57

58
</section>
59

60

61
<section id="directives" name="Директивы">
62

63
<directive name="allow">
64
<syntax>
65
    <value>адрес</value> |
66
    <value>CIDR</value> |
67
    <literal>unix:</literal> |
68
    <literal>all</literal></syntax>
69
<default/>
70
<context>http</context>
71
<context>server</context>
72
<context>location</context>
73
<context>limit_except</context>
74

75
<para>
76
Разрешает доступ для указанной сети или адреса.
77
Если указано специальное значение <literal>unix:</literal> (1.5.1),
78
разрешает доступ для всех UNIX-сокетов.
79
</para>
80

81
<para>
82
На одном уровне может быть указано несколько директив <literal>allow</literal>.
83
Директивы наследуются с предыдущего уровня конфигурации при условии, что
84
на данном уровне не описаны свои директивы
85
<literal>allow</literal> и <literal>deny</literal>.
86
</para>
87

88
</directive>
89

90

91
<directive name="deny">
92
<syntax>
93
    <value>адрес</value> |
94
    <value>CIDR</value> |
95
    <literal>unix:</literal> |
96
    <literal>all</literal></syntax>
97
<default/>
98
<context>http</context>
99
<context>server</context>
100
<context>location</context>
101
<context>limit_except</context>
102

103
<para>
104
Запрещает доступ для указанной сети или адреса.
105
Если указано специальное значение <literal>unix:</literal> (1.5.1),
106
запрещает доступ для всех UNIX-сокетов.
107
</para>
108

109
<para>
110
На одном уровне может быть указано несколько директив <literal>deny</literal>.
111
Директивы наследуются с предыдущего уровня конфигурации при условии, что
112
на данном уровне не описаны свои директивы
113
<literal>allow</literal> и <literal>deny</literal>.
114
</para>
115

116
</directive>
117

118
</section>
119

120
</module>
121

122
Product

Resources

Company
