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: 6 months 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 (about 3 years ago)
• Default Branch: master
• Last Pushed: 2025-05-08T08:21:33.000Z (6 months ago)
• Last Synced: 2025-05-08T09:30:30.228Z (6 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.4 MB
• Stars: 1,376
• Watchers: 46
• Forks: 71
• Open Issues: 43
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGES
  • License: LICENSE

Awesome Lists containing this project

• awesome-nginx - Angie

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:

- Installation: https://en.angie.software/angie/docs/installation/

- Runtime configuration: https://en.angie.software/angie/docs/configuration/

- Troubleshooting and feedback channels: https://en.angie.software/angie/docs/troubleshooting/

- Development and contribution: https://en.angie.software/angie/docs/development/

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/

- Automatically `updating

  `_

  lists of proxied servers matching a domain name or `retrieving

  `_

  such lists from SRV DNS records.

- 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 `_.