Angie

https://angie.software/angie/docs/
Admin
Angie — эффективный, мощный и масштабируемый веб-сервер с открытым исходным кодом, форк nginx,...
Tokens:884,486
Snippets:5,151
Trust Score:9.3
Update:1 week ago
Show doc for...
Tokens:
Raw
### Example Angie Perl Configuration

Source: https://angie.software/angie/docs/configuration/modules/http/http_perl

A complete example showing the setup of Perl modules, requirements, variable handlers using perl_set, and location handlers.

```nginx
http {

    perl_modules perl/lib;
    perl_require hello.pm;

    perl_set $msie6 '

        sub {
            my $r = shift;
            my $ua = $r->header_in("User-Agent");

            return "" if $ua =~ /Opera/;
            return "1" if $ua =~ / MSIE [6-9]\.\d+/;
            return "";
        }

    ';

    server {
        location / {
            perl hello::handler;
        }
    }
```

--------------------------------

### Install Angie on openSUSE

Source: https://angie.software/angie/docs/installation/oss_packages

Install the Angie package.

```console
$ sudo zypper install -y angie
```

--------------------------------

### Install Angie PRO and optional components on Debian/Ubuntu

Source: https://angie.software/angie/docs/installation/pro_packages

Install the main package and optional extras.

```console
$ sudo apt-get install -y angie-pro
```

```console
$ sudo apt-get install -y <ИМЯ ПАКЕТА>
```

--------------------------------

### Install openSUSE extras

Source: https://angie.software/angie/docs/installation/oss_packages

Install optional add-on packages.

```console
$ sudo zypper install -y <ИМЯ ПАКЕТА>
```

--------------------------------

### Install Angie PRO on Alt

Source: https://angie.software/angie/docs/installation/pro_packages

Install the main Angie PRO package.

```console
$ sudo apt-get install -y angie-pro
```

--------------------------------

### Install Angie on FreeBSD

Source: https://angie.software/angie/docs/installation/oss_packages

Install the Angie package from the configured repository.

```console
$ sudo pkg install -r angie -y angie
```

--------------------------------

### Install Angie PRO on FreeBSD

Source: https://angie.software/angie/docs/installation/pro_packages

Install the Angie PRO package.

```console
$ sudo pkg install -r angie -y angie-pro
```

--------------------------------

### Install FreeBSD extras

Source: https://angie.software/angie/docs/installation/oss_packages

Install optional add-on packages.

```console
$ sudo pkg install -r angie -y <ИМЯ ПАКЕТА>
```

--------------------------------

### HTTP Request with start argument

Source: https://angie.software/angie/docs/configuration/modules/http/http_mp4

Example of an HTTP request to a server for an MP4 file starting at a specific time in seconds.

```none
http://example.com/elephants_dream.mp4?start=238.88
```

--------------------------------

### Install angie-pro-headers on Debian and Ubuntu

Source: https://angie.software/angie/docs/installation/external-modules

Install the matching version of angie-pro-headers for the installed angie-pro package to provide necessary build configuration and headers.

```console
$ sudo apt install "angie-pro-headers=$(dpkg-query -W -f='${Version}' angie-pro)"
```

--------------------------------

### GZip Configuration Example

Source: https://angie.software/angie/docs/configuration/modules/http/http_gzip

A basic configuration example enabling GZip, setting a minimum length, defining proxied conditions, and specifying MIME types to compress.

```nginx
gzip            on;
gzip_min_length 1000;
gzip_proxied    expired no-cache no-store private auth;
gzip_types      text/plain application/xml;
```

--------------------------------

### VTS configuration example

Source: https://angie.software/angie/docs/configuration/modules/external-modules/vts

A basic configuration example showing how to enable the traffic status zone and expose the status dashboard via a location block.

```nginx
http {
    # ...
    vhost_traffic_status_zone;

    server {
        listen 80;
        server_name localhost;

        root  /usr/share/angie/html;
        index index.html index.htm;

        location = /status.html {
            root  /usr/share/angie-module-vts;
        }

        location /status {
            vhost_traffic_status_display;
            vhost_traffic_status_display_format html;
        }
    }
}
```

--------------------------------

### Configuration example for DAV Ext

Source: https://angie.software/angie/docs/configuration/modules/external-modules/dav-ext

Example configuration enabling DAV methods and DAV Ext methods in a server block. It sets up a lock zone and enables PROPFIND, OPTIONS, LOCK, UNLOCK methods.

```nginx
dav_ext_lock_zone zone=lock_zone:10m;
server {
    listen 80 default_server;

    location / {
        root /usr/share/angie/html;

        dav_methods PUT DELETE MKCOL COPY MOVE;
        dav_ext_methods PROPFIND OPTIONS LOCK UNLOCK;
        dav_ext_lock zone=lock_zone;
    }
}
```

--------------------------------

### HTTP Request with start and end arguments

Source: https://angie.software/angie/docs/configuration/modules/http/http_mp4

Example of an HTTP request specifying both start and end times for the video stream.

```none
http://example.com/elephants_dream.mp4?start=238.88&end=555.55
```

--------------------------------

### Switch from nginx to Angie

Source: https://angie.software/angie/docs/configuration/migration

Stop the nginx service and start Angie to minimize downtime, then enable Angie to start on boot.

```console
$ sudo systemctl stop nginx && sudo systemctl start angie
```

```console
$ sudo systemctl enable angie
```

--------------------------------

### RealIP Configuration Example

Source: https://angie.software/angie/docs/configuration/modules/http/http_realip

Example configuration showing how to define trusted addresses and specify the header used for address replacement.

```nginx
set_real_ip_from  192.168.1.0/24;
set_real_ip_from  192.168.2.1;
set_real_ip_from  2001:0db8::/32;
real_ip_header    X-Forwarded-For;
real_ip_recursive on;
```

--------------------------------

### Echo Module Configuration Example

Source: https://angie.software/angie/docs/configuration/modules/external-modules/echo

Example configuration demonstrating various directives like echo_before_body, echo_after_body, echo_sleep, echo_duplicate, and subrequest handling.

```nginx
server {
    listen       80;
    server_name  localhost;

    location /echo {
        echo_before_body 'These lines are inserted';
        echo_before_body 'by the echo_before_body directive';
        echo_after_body 'These lines are added';
        echo_after_body 'by the echo_after_body directive';
        proxy_pass $scheme://127.0.0.1:$server_port$request_uri/more;
    }

    location /echo/more {
        set $val 'value';
        echo '======== Start backend answer =========';
        echo 'Backend answer body';
        echo "val is set on $val";
        echo '======== End backend answer ===========';
    }

    location /echo_with_sleep {
        echo hello;
        echo_flush;
        echo_sleep   2.5;
        echo world;
    }

    location /dup {
        echo_duplicate 3 "--";
        echo_duplicate 1 " END ";
        echo_duplicate 3 "--";
        echo;
    }

    location /subr {
        echo_reset_timer;
        echo_location /sub1;
        echo_location /sub2;
        echo "took $echo_timer_elapsed sec for total.";
    }

    location /subr_async {
        echo_reset_timer;
        echo_location_async /sub1;
        echo_location_async /sub2;
        echo "took $echo_timer_elapsed sec for total.";
    }

    location /sub1 {
        echo_sleep 2;
        echo hello;
    }

    location /sub2 {
        echo_sleep 1;
        echo world;
    }
}
```

--------------------------------

### Copy ModSecurity Configuration Examples

Source: https://angie.software/angie/docs/configuration/modules/external-modules/modsecurity

Copy the necessary example configuration files for the ModSecurity ruleset.

```console
$ sudo cp coreruleset/crs-setup.conf.example coreruleset/crs-setup.conf
$ sudo cp coreruleset/rules/REQUEST-900-EXCLUSION-RULES-BEFORE-CRS.conf.example \
      coreruleset/rules/REQUEST-900-EXCLUSION-RULES-BEFORE-CRS.conf
$ sudo cp coreruleset/rules/RESPONSE-999-EXCLUSION-RULES-AFTER-CRS.conf.example \
      coreruleset/rules/RESPONSE-999-EXCLUSION-RULES-AFTER-CRS.conf
```

--------------------------------

### fastcgi_index configuration example

Source: https://angie.software/angie/docs/configuration/modules/http/http_fastcgi

Example showing how to set the index file name and the SCRIPT_FILENAME parameter for FastCGI requests.

```nginx
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name;
```

--------------------------------

### SSL Configuration Example

Source: https://angie.software/angie/docs/configuration/modules/http/http_ssl

Example configuration demonstrating optimized SSL settings, including session cache configuration and protocol selection.

```nginx
worker_processes auto;

http {

    # ...

    server {
        listen              443 ssl;
        keepalive_timeout   70;

        ssl_protocols       TLSv1.2 TLSv1.3;
        ssl_ciphers         AES128-SHA:AES256-SHA:RC4-SHA:DES-CBC3-SHA:RC4-MD5;
        ssl_certificate     /usr/local/angie/conf/cert.pem;
        ssl_certificate_key /usr/local/angie/conf/cert.key;
        ssl_session_cache   shared:SSL:10m;
        ssl_session_timeout 10m;

        # ...
    }
```

--------------------------------

### Stream Proxy Configuration Example

Source: https://angie.software/angie/docs/configuration/modules/stream/stream_proxy

Example configuration demonstrating proxying for TCP, UDP, and UNIX sockets.

```nginx
server {
    listen 127.0.0.1:12345;
    proxy_pass 127.0.0.1:8080;
}

server {
    listen 12345;
    proxy_connect_timeout 1s;
    proxy_timeout 1m;
    proxy_pass example.com:12345;
}

server {
    listen 53 udp reuseport;
    proxy_timeout 20s;
    proxy_pass dns.example.com:53;
}

server {
    listen [::1]:12345;
    proxy_pass unix:/tmp/stream.socket;
}
```

--------------------------------

### Install Angie on OSnova

Source: https://angie.software/angie/docs/installation/oss_packages

Install the main Angie package.

```console
$ sudo apt-get install -y angie
```

--------------------------------

### UserID Configuration Example

Source: https://angie.software/angie/docs/configuration/modules/http/http_userid

A basic configuration example showing how to enable the UserID module and set common parameters like cookie name, domain, path, expiration, and P3P policy.

```nginx
userid         on;
userid_name    uid;
userid_domain  example.com;
userid_path    /;
userid_expires 365d;
userid_p3p     'policyref="/w3c/p3p.xml", CP="CUR ADM OUR NOR STA NID"';
```

--------------------------------

### Install Angie PRO on Alpine

Source: https://angie.software/angie/docs/installation/pro_packages

Install the main Angie PRO package.

```console
$ sudo apk add angie-pro
```

--------------------------------

### Install Angie PRO package

Source: https://angie.software/angie/docs/installation/pro_packages

Install the Angie PRO package using yum or dnf.

```console
$ sudo yum install -y angie-pro
$ # -- ИЛИ --
$ sudo dnf install -y angie-pro
```

--------------------------------

### Install Alpine Helper Packages

Source: https://angie.software/angie/docs/installation/oss_packages

Install necessary packages for repository configuration on Alpine.

```console
$ sudo apk update
$ sudo apk add curl ca-certificates
```

--------------------------------

### Install Angie on Alpine

Source: https://angie.software/angie/docs/installation/oss_packages

Install the Angie package on Alpine.

```console
$ sudo apk add angie
```

--------------------------------

### limit_conn configuration example

Source: https://angie.software/angie/docs/configuration/modules/stream/stream_limit_conn

Example showing how to define a shared memory zone and apply a connection limit of one per IP address.

```nginx
limit_conn_zone $binary_remote_addr zone=addr:10m;

server {
    ...
    limit_conn addr 1;
}
```

--------------------------------

### dav_access configuration examples

Source: https://angie.software/angie/docs/configuration/modules/http/http_dav

Sets access permissions for created files and directories. The first example specifies permissions for user, group, and all, while the second omits user permissions.

```nginx
dav_access user:rw group:rw all:r;
```

```nginx
dav_access group:rw all:r;
```

--------------------------------

### Install Angie Extras on Alpine

Source: https://angie.software/angie/docs/installation/oss_packages

Install additional Angie packages on Alpine.

```console
$ sudo apk add <ИМЯ ПАКЕТА>
```

--------------------------------

### listen IPv4 and Hostname Examples

Source: https://angie.software/angie/docs/configuration/modules/mail

Examples of defining IPv4 addresses, ports, and hostnames for the listen directive.

```nginx
listen 127.0.0.1:110;
listen *:110;
listen 110;     # то же, что и *:110
listen localhost:110;
```

--------------------------------

### Install Angie PRO package

Source: https://angie.software/angie/docs/installation/pro_packages

Install the main Angie PRO package using the zypper package manager.

```console
$ sudo zypper install -y angie-pro
```

--------------------------------

### Example status output

Source: https://angie.software/angie/docs/configuration/modules/http/http_stub_status

This is an example of the output displayed when accessing the configured status location.

```console
Active connections: 291
server accepts handled requests
 16630948 16630948 31070465
Reading: 6 Writing: 179 Waiting: 106
```

--------------------------------

### Stream JS Configuration Example

Source: https://angie.software/angie/docs/configuration/modules/external-modules/stream_js

Example configuration showing how to import a JavaScript file and use directives like js_set, js_preread, js_access, and js_filter within a stream block.

```nginx
stream {
    js_import stream.js;

    js_set $bar stream.bar;
    js_set $req_line stream.req_line;

    server {
        listen 12345;

        js_preread stream.preread;
        return     $req_line;
    }

    server {
        listen 12346;

        js_access  stream.access;
        proxy_pass 127.0.0.1:8000;
        js_filter  stream.header_inject;
    }
}

http {
    server {
        listen 8000;
        location / {
            return 200 $http_foo\n;
        }
    }
}
```

--------------------------------

### fastcgi_no_cache configuration examples

Source: https://angie.software/angie/docs/configuration/modules/http/http_fastcgi

Examples of setting conditions for the fastcgi_no_cache directive using variables.

```nginx
fastcgi_no_cache $cookie_nocache $arg_nocache$arg_comment;
fastcgi_no_cache $http_pragma    $http_authorization;
```

--------------------------------

### Basic listen directive examples

Source: https://angie.software/angie/docs/configuration/modules/http

Examples of defining listening addresses and ports using IP addresses, hostnames, or port numbers.

```nginx
listen 127.0.0.1:8000;
listen 127.0.0.1;
listen 8000;
listen *:8000;
listen localhost:8000;
```

--------------------------------

### Example configuration for status monitoring

Source: https://angie.software/angie/docs/configuration/modules/http/http_api

A complete configuration example including resolver, upstream, cache, limit_conn, limit_req, and status API location blocks.

```nginx
http {

    resolver 127.0.0.53 status_zone=resolver_zone;
    proxy_cache_path /var/cache/angie/cache keys_zone=cache_zone:2m;
    limit_conn_zone $binary_remote_addr zone=limit_conn_zone:10m;
    limit_req_zone $binary_remote_addr zone=limit_req_zone:10m rate=1r/s;

    upstream upstream {
        zone upstream 256k;
        server backend.example.com service=_example._tcp resolve max_conns=5;
       keepalive 4;
    }

    server {
        server_name www.example.com;
        listen 443 ssl;

        status_zone http_server_zone;
        proxy_cache cache_zone;
        proxy_cache_valid 200 10m;

        access_log /var/log/access.log main;

        location / {
            root /usr/share/angie/html;
            status_zone location_zone;
            limit_conn limit_conn_zone 1;
            limit_req zone=limit_req_zone burst=5;
        }
        location /status/ {
            api /status/;

            allow 127.0.0.1;
            deny all;
        }

    }
}
```

--------------------------------

### open_file_cache configuration example

Source: https://angie.software/angie/docs/configuration/modules/http

Example configuration for enabling and tuning the file cache, including cache size, inactivity timeout, validation interval, minimum uses, and error caching.

```nginx
open_file_cache          max=1000 inactive=20s;
open_file_cache_valid    30s;
open_file_cache_min_uses 2;
open_file_cache_errors   on;
```

--------------------------------

### Create CGI bin directory with sudo install

Source: https://angie.software/angie/docs/configuration/modules/external-modules/cgi

Creates the /usr/share/angie/cgi-bin directory, which is not created during module installation.

```console
$ sudo install -d /usr/share/angie/cgi-bin
```

--------------------------------

### proxy_temp_path configuration example

Source: https://angie.software/angie/docs/configuration/modules/http/http_proxy

Example configuration for proxy_temp_path and the resulting temporary file path structure.

```nginx
proxy_temp_path /spool/angie/proxy_temp 1 2;
```

```nginx
/spool/angie/proxy_temp/7/45/00000123457
```

--------------------------------

### Basic map configuration example

Source: https://angie.software/angie/docs/configuration/modules/http/http_map

Demonstrates mapping hostnames and user agents to specific values.

```nginx
map $http_host $name {
    hostnames;

    default       0;

    example.com   1;
    *.example.com 1;
    example.org   2;
    *.example.org 2;
    .example.net  3;
    wap.*         4;
}

map $http_user_agent $mobile {
    default       0;
    "~Opera Mini" 1;
}
```

--------------------------------

### GET Requests for Upstream Servers

Source: https://angie.software/angie/docs/configuration/modules/http/http_api

Examples of GET requests to retrieve server information from the API.

```console
$ curl http://127.0.0.1/config/http/upstreams/backend/servers/backend.example.com/max_conns
$ curl http://127.0.0.1/config/http/upstreams/backend/servers/backend.example.com
$ curl http://127.0.0.1/config/http/upstreams/backend/servers
$ # ...
$ curl http://127.0.0.1/config
```

--------------------------------

### Stream Access Configuration Example

Source: https://angie.software/angie/docs/configuration/modules/stream/stream_access

An example showing how to define access rules within a server block. Rules are processed sequentially, and the first match determines the access status.

```nginx
server {
    ...
    deny  192.168.1.1;
    allow 192.168.1.0/24;
    allow 10.1.1.0/16;
    allow 2001:0db8::/32;
    deny  all;
}
```

--------------------------------

### js_shared_dict_zone configuration examples

Source: https://angie.software/angie/docs/configuration/modules/external-modules/http_js

Examples of defining shared memory zones with various parameters like timeout, eviction, type, and state persistence.

```nginx
example.conf:
    # Создается словарь размером 1Мб со строковыми значениями,
    # пары "ключ-значение" удаляются при отсутствии активности в течение 60 секунд:
    js_shared_dict_zone zone=foo:1M timeout=60s;

    # Создается словарь размером 512Кб со строковыми значениями,
    # удаляется самая старая пара "ключ-значение" при переполнении зоны:
    js_shared_dict_zone zone=bar:512K timeout=30s evict;

    # Создается постоянный словарь размером 32Кб с числовыми значениями:
    js_shared_dict_zone zone=num:32k type=number;

    # Создается словарь размером 1Мб со строковыми значениями и постоянным состоянием:
    js_shared_dict_zone zone=persistent:1M state=/tmp/dict.json;
```

--------------------------------

### Enable FreeBSD service autostart

Source: https://angie.software/angie/docs/installation/oss_packages

Configure Angie to start automatically on boot.

```console
$ sudo sysrc angie_enable=YES
```

--------------------------------

### Example PAM configuration for LDAP

Source: https://angie.software/angie/docs/configuration/modules/external-modules/auth-pam

An example of a PAM configuration file located at /etc/pam.d/angie for authenticating users against an LDAP server.

```none
auth    required     /lib/security/pam_ldap.so
account required     /lib/security/pam_ldap.so
```

--------------------------------

### Stream Metric Configuration Example

Source: https://angie.software/angie/docs/configuration/modules/stream/stream_metric

A complete example showing how to define a metric zone in the stream block and expose it via the API in the http block.

```nginx
stream {
    metric_zone connections:1m count;

    server {
        listen 12345;

        metric connections $remote_addr on=connect;
    }
}

http {
    server {
        listen 80;

        location /status/ {
            allow 127.0.0.1;
            deny all;
            api /status/;
        }
    }
}
```

--------------------------------

### listen IPv6 Examples

Source: https://angie.software/angie/docs/configuration/modules/mail

Examples of defining IPv6 addresses for the listen directive using square brackets.

```nginx
listen [::1]:110;
listen [::]:110;
```

--------------------------------

### Configure ACME client and certificate retrieval

Source: https://angie.software/angie/docs/configuration/modules/http/http_acme

This example demonstrates setting up an ACME client named 'example' to automatically manage certificates for 'example.com' and 'www.example.com' using the default HTTP challenge.

```nginx
http {

    acme_client example https://acme-v02.api.letsencrypt.org/directory;

    server {

        listen 80; # Необязательно, если нет сервера,
                   # слушающего порт HTTP‑проверки
                   # (см. директиву 'acme_http_port')

        listen 443 ssl;

        server_name example.com www.example.com;
        acme example;

        ssl_certificate $acme_cert_example;
        ssl_certificate_key $acme_cert_key_example;
    }
}
```

--------------------------------

### limit_req directive usage example

Source: https://angie.software/angie/docs/configuration/modules/http/http_limit_req

Example demonstrating the basic setup of a shared memory zone and applying the limit_req directive to a location.

```nginx
limit_req_zone $binary_remote_addr zone=one:10m rate=1r/s;

server {
    location /search/ {
        limit_req zone=one burst=5;
    }
```

--------------------------------

### Configure disable_symlinks with from parameter

Source: https://angie.software/angie/docs/configuration/modules/http

Example of enabling symlink restriction starting from the document root path.

```nginx
disable_symlinks on from=$document_root;
```

--------------------------------

### Install Angie PRO and optional components on Astra SE

Source: https://angie.software/angie/docs/installation/pro_packages

Install the main package and optional extras. Includes steps for ZPS mode.

```console
$ sudo apt-get install -y angie-digsig-key
```

```console
$ sudo update-initramfs -uk all
```

```console
$ sudo shutdown -r now
```

```console
$ sudo apt-get install -y angie-pro
```

```console
$ sudo apt-get install -y <ИМЯ ПАКЕТА>
```

--------------------------------

### uwsgi_ssl_certificate_cache configuration example

Source: https://angie.software/angie/docs/configuration/modules/http/http_uwsgi

Example configuration for caching SSL certificates and keys when using variables in their paths. This setup caches up to 1000 items with a 20-second inactivity timeout and 1-minute validity period.

```nginx
uwsgi_ssl_certificate       /etc/angie/ssl/$host.crt;
uwsgi_ssl_certificate_key   /etc/angie/ssl/$host.key;
uwsgi_ssl_certificate_cache max=1000 inactive=20s valid=1m;
```

--------------------------------

### Create FreeBSD repository directories

Source: https://angie.software/angie/docs/installation/oss_packages

Prepare the directory structure for the Angie repository.

```console
$ sudo mkdir -p /usr/local/etc/pkg/angie/ /usr/local/etc/pkg/repos/
```

--------------------------------

### limit_except method restriction

Source: https://angie.software/angie/docs/configuration/modules/http

Restricts HTTP methods within a location block. In this example, access is allowed for the specified IP range for all methods except GET and HEAD.

```nginx
limit_except GET {
  allow 192.168.1.0/32;
  deny  all;
}
```

--------------------------------

### Configuration Example for map

Source: https://angie.software/angie/docs/configuration/modules/stream/stream_map

This example demonstrates using the map directive to define a variable $limit based on the client's IP address, which is then used in a limit_conn_zone directive.

```nginx
map $remote_addr $limit {
    127.0.0.1    "";
    default      $binary_remote_addr;
}

limit_conn_zone $limit zone=addr:10m;
limit_conn addr 1;
```

--------------------------------

### ssl_certificate with data: prefix and literal newlines

Source: https://angie.software/angie/docs/configuration/modules/http/http_ssl

Example of providing a PEM certificate directly in the configuration using literal newlines. Note that each subsequent line must start at the first position without indentation.

```nginx
ssl_certificate     'data:-----BEGIN CERTIFICATE-----
MIIBszCCAVmgAwIBAgIU...
-----END CERTIFICATE-----';
ssl_certificate_key /etc/angie/ssl/example.com.key;
```

--------------------------------

### Redis2 configuration example

Source: https://angie.software/angie/docs/configuration/modules/external-modules/redis2

Full nginx configuration demonstrating redis2 usage: setting and getting keys, using query parameters, pipelining multiple commands, and executing arbitrary commands via raw query. Note that redis2_pass does not allow variables in its parameter, unlike proxy_pass.

```nginx
upstream redis_upstream {
    server 127.0.0.1:6379;
}

server {
    listen       80;
    server_name  localhost;

    # Установить значение ключа
    location /foo {
        set $value 'first';
        redis2_query set one $value;
        redis2_pass redis_upstream;
    }

    # Получить значение по ключу
    location /bar {
        redis2_query get one;
        redis2_pass redis_upstream;
    }

    # Установить значение ключа из параметров запроса
    location /set {
        set_unescape_uri $key $arg_key;
        set_unescape_uri $val $arg_val;
        redis2_query set $key $val;
        redis2_pass 127.0.0.1:6379;
    }

    # Получить значение по ключу из параметров запроса
    location /get {
        set_unescape_uri $key $arg_key;
        redis2_query get $key;
        redis2_pass 127.0.0.1:6379;
    }

    # Выполнение нескольких конвейерных команд
    location /pipeline {
        set $value 'first';
        redis2_query set one $value;
        redis2_query get one;
        redis2_query set one 'first first';
        redis2_query get one;
        redis2_pass 127.0.0.1:6379;
    }

    # Выполнение произвольной команды, переданной в параметре запроса
    location /cmd {
        set_unescape_uri $cmd $arg_command;
        redis2_raw_query "$cmd\r\n";
        redis2_pass 127.0.0.1:6379;
    }
}
```

--------------------------------

### feedback directive configuration example

Source: https://angie.software/angie/docs/configuration/modules/stream/stream_upstream

Complete nginx configuration demonstrating the feedback directive with factor and account parameters, along with map blocks to define feedback values and condition variables. The example categorizes servers by protocol and includes active probe traffic based on $upstream_probe.

```nginx
upstream backend {

    zone backend 1m;

    feedback $feedback_value factor=80 account=$condition_value;

    server backend1.example.com:1935  weight=1;
    server backend2.example.com:1935  weight=2;
}

map $protocol $feedback_value {
    "TCP"                      100;
    "UDP"                      75;
    default                    10;
}

map $upstream_probe $condition_value {
    "high_priority" "1";
    "low_priority"  "0";
    default         "1";
}
```

--------------------------------

### Demonstrate set-misc functionality

Source: https://angie.software/angie/docs/configuration/modules/external-modules/set-misc

Example curl commands and their corresponding outputs for the configured locations.

```console
$ curl localhost/ifempty/?a=100

  arg_a = '100'
  a = '100'

$ curl localhost/ifempty

  arg_a = ''
  a = '56'

$ curl localhost/unescape/?a=Hello%20world!

  arg_a = 'Hello%20world!'
  a = 'Hello world!'
  b = 'Hello%20world!'

$ curl localhost/base32/?a=abcde

  arg_a = 'abcde'
  a = 'c5h66p35'
  b = 'abcde'

$ curl localhost/hex/?a=abcde

  arg_a = 'abcde'
  a = '6162636465'
  b = 'abcde'
```

--------------------------------

### Stream GeoIP Configuration Example

Source: https://angie.software/angie/docs/configuration/modules/stream/stream_geoip

Example configuration showing how to define GeoIP databases and use the resulting variables within a map block to route traffic.

```nginx
stream {
    geoip_country         GeoIP.dat;
    geoip_city            GeoLiteCity.dat;

    map $geoip_city_continent_code $nearest_server {
        default        example.com;
        EU          eu.example.com;
        NA          na.example.com;
        AS          as.example.com;
    }
#   ...
}
```

--------------------------------

### Basic Mirror Configuration

Source: https://angie.software/angie/docs/configuration/modules/http/http_mirror

Example of setting up a mirror location to send requests to a test backend.

```nginx
location / {
    mirror /mirror;
    proxy_pass http://backend;
}

location = /mirror {
    internal;
    proxy_pass http://test_backend$request_uri;
}
```

--------------------------------

### Configuration example with headers-more directives

Source: https://angie.software/angie/docs/configuration/modules/external-modules/headers-more

Full nginx configuration demonstrating more_clear_headers, more_set_headers, and more_set_input_headers. Includes two server blocks: one for the main server and one for the upstream backend.

```nginx
http {
    server {
        listen 80;

        root  /usr/share/angie/html;
        index index.html index.htm;

        location /clear {
            more_clear_headers 'Content-Type';
            proxy_pass http://127.0.0.1:8081;
        }

        location /settype {
            more_set_headers 'Content-Type: text/plain';
            proxy_pass http://127.0.0.1:8081;
        }

        location /changetype {
            more_set_headers -t 'text/plain text/css' 'Content-Type: text/newtype';
            proxy_pass http://127.0.0.1:8081;
        }

        location /newheader {
            more_set_headers -t 'text/plain text/css' 'New-Header: foo';
            proxy_pass http://127.0.0.1:8081;
        }

        location /404 {
            more_set_headers -s '400 404 500 503' 'Upstream-Status: $upstream_status';
            proxy_pass http://127.0.0.1:8081;
        }

        location /input {
            set $my_host 'my.host';
            more_set_input_headers 'Host: $my_host';
            more_set_input_headers -t 'text/plain' 'X-Foo: bar';

            echo "Host: $host";
            echo "X-foo: $http_x_foo";
        }
    }

    server {
        listen 8081;
        default_type text/css;

        location / {
            return 200 "OK\n";
        }

        location /404 {
            return 404 "Done\n";
        }
    }
}
```

--------------------------------

### Hostname mask examples

Source: https://angie.software/angie/docs/configuration/modules/http/http_map

Examples of using hostname masks for matching.

```nginx
*.example.com 1;
example.*     1;
```

--------------------------------

### Configure Angie PRO repository file

Source: https://angie.software/angie/docs/installation/pro_packages

Create the repository configuration file at /etc/zypp/repos.d/angie.repo with the provided baseurl and certificate paths.

```ini
[angie-pro]
enabled=1
autorefresh=1
baseurl=https://download.angie.software/angie-pro/opensuse/$releasever_major?ssl_clientcert=/etc/ssl/angie/angie-repo-bundle.crt&ssl_verify=peer
gpgcheck=1
gpgkey=https://angie.software/keys/angie-signing.gpg.asc
```

--------------------------------

### proxy_pass variable example

Source: https://angie.software/angie/docs/configuration/modules/stream/stream_proxy

Example of using a variable to define the proxy_pass address.

```nginx
proxy_pass $upstream;
```

--------------------------------

### proxy_pass group example

Source: https://angie.software/angie/docs/configuration/modules/stream/stream_proxy

Example of using a server group name in proxy_pass.

```nginx
proxy_pass backend:8443;
```

--------------------------------

### PHP site configuration example

Source: https://angie.software/angie/docs/configuration/processing

A sample server block configuration for a PHP site, demonstrating the use of prefix and regular expression locations for handling static files and PHP scripts.

```nginx
server {

    listen 80;
    server_name example.org www.example.org;
    root /data/www;

    location / {

        index index.html index.php;
    }

    location ~* \.(gif|jpg|png)$ {

        expires 30d;
    }

    location ~ \.php$ {

        fastcgi_pass localhost:9000;
        fastcgi_param SCRIPT_FILENAME
        $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}
```

--------------------------------

### Configure repository authentication on Astra SE

Source: https://angie.software/angie/docs/installation/pro_packages

Create the apt configuration file to use the SSL certificate and key.

```console
Acquire::https::download.angie.software::Verify-Peer "true";
Acquire::https::download.angie.software::Verify-Host "true";
Acquire::https::download.angie.software::SslCert     "/etc/ssl/angie/angie-repo.crt";
Acquire::https::download.angie.software::SslKey      "/etc/ssl/angie/angie-repo.key";
```

--------------------------------

### Example Upstream Configuration

Source: https://angie.software/angie/docs/configuration/modules/http/http_api

An example upstream block configuration required for API access.

```nginx
upstream backend {
    server backend.example.com:8080 service=_example._tcp resolve;
    server 127.0.0.1:12345;
    zone backend 1m;
}
```

--------------------------------

### zlib Compression and Decompression Example

Source: https://angie.software/angie/docs/configuration/njs-reference

Demonstrates importing the zlib module and using deflateSync and inflateSync to compress and decompress a string.

```javascript
import zlib from 'zlib';

const deflated = zlib.deflateSync('Hello World!');
const inflated = zlib.inflateSync(deflated);

console.log(inflated.toString()); // 'Hello World!'
```

--------------------------------

### Install Angie Package on RPM-based Systems

Source: https://angie.software/angie/docs/installation/oss_packages

Use yum or dnf to install the Angie package.

```console
$ sudo yum install -y angie
$ # -- ИЛИ --
$ sudo dnf install -y angie
```

--------------------------------

### uwsgi_no_cache configuration examples

Source: https://angie.software/angie/docs/configuration/modules/http/http_uwsgi

Examples of setting conditions under which a response will not be saved to the cache using variables.

```nginx
uwsgi_no_cache $cookie_nocache $arg_nocache$arg_comment;
uwsgi_no_cache $http_pragma    $http_authorization;
```

--------------------------------

### Configure Alt APT repository settings

Source: https://angie.software/angie/docs/installation/pro_packages

Create the APT configuration file to use SSL certificates for the repository.

```console
$ ( echo 'Acquire::https::Verify-Peer "true";';
    echo 'Acquire::https::Verify-Host "true";';
    echo 'Acquire::https::SslCert     "/etc/ssl/angie/angie-repo.crt";';
    echo 'Acquire::https::SslKey      "/etc/ssl/angie/angie-repo.key";';
  )  | sudo tee -a /etc/apt/apt.conf >/dev/null
```

--------------------------------

### scgi_no_cache configuration examples

Source: https://angie.software/angie/docs/configuration/modules/http/http_scgi

Examples of setting conditions under which responses will not be cached using the scgi_no_cache directive.

```nginx
scgi_no_cache $cookie_nocache $arg_nocache$arg_comment;
scgi_no_cache $http_pragma    $http_authorization;
```

--------------------------------

### Configure FreeBSD repository

Source: https://angie.software/angie/docs/installation/oss_packages

Create the angie.conf file to define the repository settings.

```console
angie: {
   url: "https://download.angie.software/angie/freebsd/${VERSION_MAJOR}/${ARCH}",
   signature_type: "pubkey",
   pubkey: "/usr/local/etc/pkg/angie/angie-signing.rsa",
   enabled: yes
}
```

--------------------------------

### Example C function implementation

Source: https://angie.software/angie/docs/developer_guide

Demonstrates the standard indentation and naming conventions for a C function in the project.

```c
size_t
ngx_utf8_length(u_char *p, size_t n)
{
    u_char  c, *last;
    size_t  len;

    last = p + n;

    for (len = 0; p < last; len++) {

        c = *p;

        if (c < 0x80) {
            p++;
            continue;
        }

        if (ngx_utf8_decode(&p, last - p) > 0x10ffff) {
            /* invalid UTF-8 */
            return n;
        }
    }

    return len;
}
```

--------------------------------

### Install auxiliary packages on Astra SE

Source: https://angie.software/angie/docs/installation/pro_packages

Update package lists and install dependencies required for the repository.

```console
$ sudo apt-get update
$ sudo apt-get install -y apt-transport-https lsb-release \
               ca-certificates curl gnupg2
```

--------------------------------

### Install Angie Extras on RPM-based Systems

Source: https://angie.software/angie/docs/installation/oss_packages

Use yum or dnf to install additional Angie packages.

```console
$ sudo yum install -y <ИМЯ ПАКЕТА>
$ # -- ИЛИ --
$ sudo dnf install -y <ИМЯ ПАКЕТА>
```

--------------------------------

### Configure learn mode for sticky sessions

Source: https://angie.software/angie/docs/configuration/modules/http/http_upstream

This example shows how to create a session based on a cookie set by the proxied server and look up existing sessions using the same cookie name.

```nginx
upstream backend {
    zone backend 1m;
    server backend1.example.com:8080;
    server backend2.example.com:8080;

    sticky learn
        create=$upstream_cookie_examplecookie
        lookup=$cookie_examplecookie
        zone=client_sessions:1m;
}
```

--------------------------------

### Start Docker services

Source: https://angie.software/angie/docs/configuration/oidc

Command to initialize the services required for the OIDC environment.

```console
$ docker-compose up -d
```

--------------------------------

### Configuring multiple client blocks

Source: https://angie.software/angie/docs/configuration/modules/http

Example demonstrating the use of multiple client blocks to group settings for specific named locations, avoiding configuration duplication.

```nginx
client {

    proxy_set_header Host docker.example.com;
    proxy_set_header Authorization "Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==";

    location @docker_events {

    }

    location @docker_containers {

    }
}

client {

    proxy_method GET;
    proxy_set_header Host backend.example.com;
    proxy_set_header X-Real-IP $remote_addr;

    location @health_check {

        proxy_pass http://upstream-server/health;
    }
}
```

--------------------------------

### DAV Configuration Example

Source: https://angie.software/angie/docs/configuration/modules/http/http_dav

A sample location block configuration enabling WebDAV methods and setting access permissions for file management.

```nginx
location / {
    root                  /data/www;

    client_body_temp_path /data/client_temp;

    dav_methods PUT DELETE MKCOL COPY MOVE;

    create_full_put_path  on;
    dav_access            group:rw  all:r;

    limit_except GET {
        allow 192.168.1.0/32;
        deny  all;
    }
}
```

--------------------------------

### proxy_cache_path configuration example

Source: https://angie.software/angie/docs/configuration/modules/http/http_proxy

An example of configuring the cache path with hierarchy levels and a shared memory zone.

```nginx
proxy_cache_path /data/angie/cache levels=1:2 keys_zone=one:10m;
```

--------------------------------

### listen UNIX Socket Example

Source: https://angie.software/angie/docs/configuration/modules/mail

Example of defining a UNIX socket for the listen directive using the unix: prefix.

```nginx
listen unix:/var/run/angie.sock;
```

--------------------------------

### Example: Creating a chain with two buffers (ngx_get_my_chain)

Source: https://angie.software/angie/docs/developer_guide

Shows how to allocate chain links and buffers from a pool, set up a read-only memory buffer and a temporary buffer, and link them into a chain. The function returns the head of the chain. Error handling is indicated by comments.

```c
ngx_chain_t *
ngx_get_my_chain(ngx_pool_t *pool)
{
    ngx_buf_t    *b;
    ngx_chain_t  *out, *cl, **ll;

    /* first buf */
    cl = ngx_alloc_chain_link(pool);
    if (cl == NULL) { /* error */ }

    b = ngx_calloc_buf(pool);
    if (b == NULL) { /* error */ }

    b->start = (u_char *) "foo";
    b->pos = b->start;
    b->end = b->start + 3;
    b->last = b->end;
    b->memory = 1; /* read-only memory */

    cl->buf = b;
    out = cl;
    ll = &cl->next;

    /* second buf */
    cl = ngx_alloc_chain_link(pool);
    if (cl == NULL) { /* error */ }

    b = ngx_create_temp_buf(pool, 3);
    if (b == NULL) { /* error */ }

    b->last = ngx_cpymem(b->last, "foo", 3);

    cl->buf = b;
    cl->next = NULL;
    *ll = cl;

    return out;
}
```

--------------------------------

### Configure openSUSE repository

Source: https://angie.software/angie/docs/installation/oss_packages

Create the angie.repo file to define the repository.

```ini
[angie]
name=Angie repo
baseurl=https://download.angie.software/angie/opensuse/$releasever_major/
gpgcheck=1
enabled=1
gpgkey=https://angie.software/keys/angie-signing.gpg.asc
```

--------------------------------

### SSI echo Command Example

Source: https://angie.software/angie/docs/configuration/modules/http/http_ssi

Example of using the echo command with a default value, which is equivalent to an if-else structure.

```html
<!--# echo var="name" default="нет" -->
```

```html
<!--# if expr="$name" --><!--# echo var="name" --><!--#
     else -->нет<!--# endif -->
```

--------------------------------

### Wasmtime Configuration Example

Source: https://angie.software/angie/docs/configuration/modules/wasm/wasm_wasmtime

A basic configuration block for the Wasmtime module, demonstrating how to set the stack size, enable WASI, and load a WASM module.

```nginx
wasm_modules {

    wasmtime_stack_size 8k;

    wasmtime_enable_wasi on;

    load fft_transform.wasm id=fft;
}
```

--------------------------------

### Nginx rewrite directive example

Source: https://angie.software/angie/docs/configuration/modules/http/http_rewrite

Example of using the rewrite directive within a server block to modify URIs.

```nginx
server {
#    ...
    rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 last;
    rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra  last;
    return  403;
#    ...
}
```

--------------------------------

### Index internal redirection example

Source: https://angie.software/angie/docs/configuration/modules/http/http_index

Example showing how an index file can trigger an internal redirect to a different location.

```nginx
location = / {
    index index.html;
}

location / {
#    ...
}
```

--------------------------------

### GZip Static Configuration Example

Source: https://angie.software/angie/docs/configuration/modules/http/http_gzip_static

Enables the GZip static module and configures proxy behavior for compressed files.

```nginx
gzip_static  on;
gzip_proxied expired no-cache no-store private auth;
```

--------------------------------

### location block example for merge_slashes

Source: https://angie.software/angie/docs/configuration/modules/http

Example of a location block that would not match a request like //scripts/one.php if merge_slashes is disabled.

```nginx
location /scripts/ { }
```

--------------------------------

### Stream Pass Configuration Example

Source: https://angie.software/angie/docs/configuration/modules/stream/stream_pass

Example showing the stream module passing a connection to an HTTP server after SSL/TLS processing.

```nginx
stream {

    server {

        listen 8000 default_server;
        ssl_preread on;
        # ...
    }

    server {

        listen 8000;
        server_name foo.example.com;
        pass 127.0.0.1:8001; # to HTTP
    }

    server {

        listen 8000;
        server_name bar.example.com;
        # ...
    }
}

http {

    server {

        listen 8001 ssl;
        # ...

        location / {

            root html;
        }
    }
}
```

--------------------------------

### Configure Angie Repository for AlmaLinux

Source: https://angie.software/angie/docs/installation/oss_packages

Create /etc/yum.repos.d/angie.repo with this content for AlmaLinux.

```ini
[angie]
name=Angie repo
baseurl=https://download.angie.software/angie/almalinux/$releasever/
gpgcheck=1
enabled=1
gpgkey=https://angie.software/keys/angie-signing.gpg.asc
```

--------------------------------

### Basic XSLT Configuration

Source: https://angie.software/angie/docs/configuration/modules/http/http_xslt

Example configuration showing how to define XML entities and apply multiple XSLT stylesheets within a location block.

```nginx
location / {
    xml_entities    /site/dtd/entities.dtd;
    xslt_stylesheet /site/xslt/one.xslt param=value;
    xslt_stylesheet /site/xslt/two.xslt;
}
```

--------------------------------

### http_rewrite directive compilation example

Source: https://angie.software/angie/docs/configuration/modules/http/http_rewrite

Example of Nginx configuration directives that are compiled into internal stack-based virtual machine instructions.

```nginx
location /download/ {
    if ($forbidden) {
        return 403;
    }

    if ($slow) {
        limit_rate 10k;
    }

    rewrite ^/(download/.*)/media/(.*)\..*$ /$1/mp3/$2.mp3 break;
}
```

```console
переменная $forbidden
проверка на ноль
    возврат 403
    завершение всего кода
переменная $slow
проверка на ноль
проверка регулярного выражения
копирование "/"
копирование $1
копирование "/mp3/"
копирование $2
копирование ".mp3"
завершение регулярного выражения
завершение всего кода
```

--------------------------------

### Configure Keyval with Redis

Source: https://angie.software/angie/docs/configuration/modules/external-modules/keyval

Example configuration using Redis as the storage backend for key-value pairs.

```nginx
keyval_zone_redis zone=oneredis;
keyval $arg_key $value zone=oneredis;

server {
    listen       80;
    server_name  localhost;

    location /get {
        return 200 "key '$arg_key' has value = '$value'\n";
    }

    location /set {
        set $value $arg_value;
        return 200 "'$arg_key' key added with '$arg_value' value\n";
    }
}
```

--------------------------------

### js_fetch_keepalive Configuration Example

Source: https://angie.software/angie/docs/configuration/modules/external-modules/http_js

Example of configuring keepalive connections and trusted certificates for a location block using the Fetch API.

```nginx
location /fetch {
    js_fetch_keepalive 32;
    js_fetch_trusted_certificate /path/to/ISRG_Root_X1.pem;
    js_content main.fetch_handler;
}
```

--------------------------------

### Request execution example: RU IP

Source: https://angie.software/angie/docs/configuration/modules/external-modules/geoip2

Example request for a Russian IP address showing the returned geolocation data.

```console
$ curl -H'X-Forwarded-For: 77.88.44.242' http://127.0.0.1

ip = 77.88.44.242
code = RU
name = Россия
```
Tokens:
Raw