haproxy-protection/README.md

## haproxy-protection

A fork and further development of a proof of concept from https://github.com/mora9715/haproxy_ddos_protector, a HAProxy configuration and lua scripts allowing a challenge-response page where users solve a captcha and/or proof-of-work. Intended to stop bots, spam, ddos.

Integrates with https://gitgud.io/fatchan/haproxy-panel-next to add/remove/edit domains, protection rules, blocked ips, backend server IPs, etc during runtime.

#### Features / improvements in this fork:

- Implement a proof-of-work mode, in addition to the existing captcha only mode.
- Ability to choose between argon2 or sha256 proof of work modes.
- Sharing POW answers with storage events to prevent unnecessary re-solving when opening multiple tabs.
- Supports either hcaptcha or recaptcha.
- Support .onion/tor with the HAProxy PROXY protocol, using circuit identifiers as a substitute for IPs.
- Allow users without javascript to solve the POW by providing a shell script and html form inside `noscript` tags.
- Use HAProxy `http-request return` directive to directly serve files from the edge without a separate backend.
- Adjustable cookie validity lifetime.
- Adjustable "mode" ("none", "pow" or "pow+captcha") per domain or domain+path
- Improved the appearance of the challenge page.
- Add several useful maps & acls to the haproxy config:
  - Whitelist or blacklist IPs/subnets.
  - Maintenance mode page for selected domains.
- Fix multiple security issues.
- Many bugfixes.

#### Installation

See [INSTALLATION.md](INSTALLATION.md)

#### Screenshots

![nocaptcha](img/nocaptcha.gif "no captcha mode")
![captcha](img/captcha.gif "captcha mode (pow done asynchronously in background)")

## For generous people

Bitcoin (BTC): [`bc1q4elrlz5puak4m9xy3hfvmpempnpqpu95v8s9m6`](bitcoin:bc1q4elrlz5puak4m9xy3hfvmpempnpqpu95v8s9m6)

Monero (XMR): [`89J9DXPLUBr5HjNDNZTEo4WYMFTouSsGjUjBnUCCUxJGUirthnii4naZ8JafdnmhPe4NP1nkWsgcK82Uga7X515nNR1isuh`](monero:89J9DXPLUBr5HjNDNZTEo4WYMFTouSsGjUjBnUCCUxJGUirthnii4naZ8JafdnmhPe4NP1nkWsgcK82Uga7X515nNR1isuh)

Oxen (OXEN): `LBjExqjDKCFT6Tj198CfK8auAzBERJX1ogtcsjuKZ6AYWTFxwEADLgf2zZ8NHvWCa1UW7vrtY8DJmPYFpj3MEE69CryCvN6`
Rename POW vars to separately argon_ for argon2 stuff, improve readme and split out INSTALLATION into separate file 1 year ago			`## haproxy-protection`

			`A fork and further development of a proof of concept from https://github.com/mora9715/haproxy_ddos_protector, a HAProxy configuration and lua scripts allowing a challenge-response page where users solve a captcha and/or proof-of-work. Intended to stop bots, spam, ddos.`

			`Integrates with https://gitgud.io/fatchan/haproxy-panel-next to add/remove/edit domains, protection rules, blocked ips, backend server IPs, etc during runtime.`

			`#### Features / improvements in this fork:`

			`- Implement a proof-of-work mode, in addition to the existing captcha only mode.`
Update README & LICENSE, definitely belong here now :^) 1 year ago			`- Ability to choose between argon2 or sha256 proof of work modes.`
			`- Sharing POW answers with storage events to prevent unnecessary re-solving when opening multiple tabs.`
Rename POW vars to separately argon_ for argon2 stuff, improve readme and split out INSTALLATION into separate file 1 year ago			`- Supports either hcaptcha or recaptcha.`
			`- Support .onion/tor with the HAProxy PROXY protocol, using circuit identifiers as a substitute for IPs.`
			- Allow users without javascript to solve the POW by providing a shell script and html form inside `noscript` tags.
			- Use HAProxy `http-request return` directive to directly serve files from the edge without a separate backend.
			`- Adjustable cookie validity lifetime.`
			`- Adjustable "mode" ("none", "pow" or "pow+captcha") per domain or domain+path`
			`- Improved the appearance of the challenge page.`
			`- Add several useful maps & acls to the haproxy config:`
			`- Whitelist or blacklist IPs/subnets.`
			`- Maintenance mode page for selected domains.`
			`- Fix multiple security issues.`
			`- Many bugfixes.`

			`#### Installation`

			`See [INSTALLATION.md](INSTALLATION.md)`

			`#### Screenshots`

update images, make animated update email in license, duh 1 year ago			`![nocaptcha](img/nocaptcha.gif "no captcha mode")`
			`![captcha](img/captcha.gif "captcha mode (pow done asynchronously in background)")`
Rename POW vars to separately argon_ for argon2 stuff, improve readme and split out INSTALLATION into separate file 1 year ago
			`## For generous people`

			Bitcoin (BTC): [`bc1q4elrlz5puak4m9xy3hfvmpempnpqpu95v8s9m6`](bitcoin:bc1q4elrlz5puak4m9xy3hfvmpempnpqpu95v8s9m6)

			Monero (XMR): [`89J9DXPLUBr5HjNDNZTEo4WYMFTouSsGjUjBnUCCUxJGUirthnii4naZ8JafdnmhPe4NP1nkWsgcK82Uga7X515nNR1isuh`](monero:89J9DXPLUBr5HjNDNZTEo4WYMFTouSsGjUjBnUCCUxJGUirthnii4naZ8JafdnmhPe4NP1nkWsgcK82Uga7X515nNR1isuh)

			Oxen (OXEN): `LBjExqjDKCFT6Tj198CfK8auAzBERJX1ogtcsjuKZ6AYWTFxwEADLgf2zZ8NHvWCa1UW7vrtY8DJmPYFpj3MEE69CryCvN6`