update README

This commit is contained in:
he2ss 2022-03-08 16:18:32 +01:00
parent e0d9cb1c10
commit eb0ca6bd3d

View file

@ -2,58 +2,8 @@
> Lua module to allow ip (or not) from CrowdSec API.
# Install & Config
This library is used by different bouncers :
`git clone https://github.com/crowdsecurity/lua-cs-bouncer.git`
## Install script
```
sudo ./install.sh
```
:warning: the installation script works only on Debian/Ubuntu
## From source
### Requirements
```
apt-get install lua5.3
apt-get install lua-sec
```
### With make
```
sudo make install
```
### Manually
- Create folder `/usr/local/lua/crowdsec/`:
```
mkdir -p /usr/local/lua/crowdsec/
```
- Copy the `lua-cs-bouncer/lib/*.lua` into `/usr/local/lua/crowdsec/`:
```
cp ./lua-cs-bouncer/lib/*.lua /usr/local/lua/crowdsec
```
- Copy the `lua-cs-bouncer/template.conf` into `/usr/local/lua/crowdsec/crowdsec.conf`:
```
cp ./lua-cs-bouncer/template.conf /usr/local/lua/crowdsec/crowdsec.conf
```
## Configuration
The configuration is located by default in `/usr/local/lua/crowdsec/crowdsec.conf`:
```
API_URL=http://localhost:8080 <-- the API url
API_KEY= <-- the API Key generated with `cscli bouncers add -n <bouncer_name>`
LOG_FILE=/var/log/crowdsec_lua_bouncer.log <-- path to log file
LOG_LEVEL=INFO <-- log level (INFO, WARN, DEBUG, ERROR, FATAL)
CACHE_EXPIRATION=1 <-- in seconds
CACHE_SIZE=1000 <-- cache size
REQUEST_TIMEOUT=0.2 <-- Maximum duration in seconds for a request to LAPI
```
* [Nginx Bouncer](https://docs.crowdsec.net/docs/next/bouncers/nginx)
* [OpenResty Bouncer](https://docs.crowdsec.net/docs/next/bouncers/openresty)
* [Ingress Nginx Bouncer](https://docs.crowdsec.net/docs/next/bouncers/ingress-nginx)