https://github.com/webserver-llc/angie
Angie - drop-in replacement for nginx
https://github.com/webserver-llc/angie
adc apache http http3 https load-balancer nginx quic reverse-proxy
Last synced: about 1 month ago
JSON representation
Angie - drop-in replacement for nginx
- Host: GitHub
- URL: https://github.com/webserver-llc/angie
- Owner: webserver-llc
- License: bsd-2-clause
- Created: 2022-10-26T08:37:07.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2025-12-18T08:24:08.000Z (about 2 months ago)
- Last Synced: 2025-12-20T21:44:22.155Z (about 2 months ago)
- Topics: adc, apache, http, http3, https, load-balancer, nginx, quic, reverse-proxy
- Language: C
- Homepage: https://en.angie.software/angie/docs/
- Size: 32.9 MB
- Stars: 1,703
- Watchers: 43
- Forks: 81
- Open Issues: 37
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGES
- License: LICENSE
Awesome Lists containing this project
- awesome-nginx - Angie
- stars - angie - drop-in replacement for nginx | webserver-llc | 2194 | (C)
README
.. image:: misc/logo.gif
:alt: Angie logo
:target: https://en.angie.software/
Angie
=====
**Angie** /ˈendʒi/
is an efficient, powerful, and scalable web server
that was forked from **nginx** to act as a drop-in replacement,
so you can use existing setups
without major changes to module layout or configuration.
The project was conceived by ex-devs from the original **nginx** team
to venture beyond the earlier vision.
Getting Started
---------------
To start using **Angie**, see the official documentation in
`English `__,
`Russian `__,
`Chinese `__,
`Spanish `__, or
`Portuguese `__:
- `Installation `_
(`ru `__,
`cn `__,
`es `__,
`pt `__)
- `Runtime configuration `_
(`ru `__,
`cn `__,
`es `__,
`pt `__)
- `Troubleshooting and feedback channels `_
(`ru `__,
`cn `__,
`es `__,
`pt `__)
- `Development and contribution `_
(`ru `__,
`cn `__,
`es `__,
`pt `__)
Features
--------
On top of all the capabilities of
`nginx 1.27 `_,
**Angie** adds a number of its own advantages, including these:
- Supporting `HTTP/3
`_
for client connections, as well as for `proxied server
`_
connections, with the ability to independently use different protocol versions
(HTTP/1.x, HTTP/2, HTTP/3) on opposite sides.
- Automatic HTTPS provisions TLS certificates using built-in `ACME
`_ support.
- Simplifying configuration: the `location` directive can define several
matching expressions at once, which enables `combining
`_
blocks with shared settings.
- Exposing basic information about the web server, its `configuration
`_,
as well as `metrics
`_
of proxied servers, client connections, shared memory zones, and many other
things via a RESTful `API
`_
interface in JSON format.
- Exporting statistics in `Prometheus
`_
format with `customizable templates
`_.
- Monitoring the server through the browser with the `Console Light
`_ visual
monitoring tool. See the online demo: https://console.angie.software/
- Dynamic updating of upstream groups based on events and labels from `Docker containers
`_
(or similar tools like Podman) without server reload.
- Flushing the shared memory zone in `proxy_cache_path
`_
on disk preserves the cache index contents between restarts and updates,
which eliminates the cache load delay and brings the server online even
faster.
- `Session binding
`_
mode, which directs all requests within one session to the same proxied
server.
- Recommissioning upstream servers after a failure smoothly using the
`slow_start` option of the `server
`_
directive.
- Limiting the `MP4 file transfer rate
`_
proportionally to its bitrate, thus reducing the bandwidth load.
- Extending authorization and balancing capabilities for the MQTT protocol with
the `mqtt_preread
`_
directive under `stream`.
- Informing balancing decisions with RDP protocol's session cookies via the
`rdp_preread
`_
directive under `stream`.
- Pre-built `binary packages
`_
for many popular third-party modules.
- `Server
`_-
and `client-side
`_
support for NTLS when using the `TongSuo
`_ TLS library, enabled `at build
time `_.