mirror of https://github.com/Aidaho12/haproxy-wi
118 lines
4.8 KiB
Markdown
118 lines
4.8 KiB
Markdown
# 
|
||
Web interface(user-friendly web GUI, alerting, monitoring and secure) for managing HAProxy, Nginx and Keepalived servers. Leave your [feedback](https://github.com/hap-wi/roxy-wi/issues)
|
||
|
||
# Get involved
|
||
* [Youtube Demo video](https://www.youtube.com/channel/UCo0lCg24j-H4f0S9kMjp-_w)
|
||
* [Twitter](https://twitter.com/roxy_wi), subscribe!
|
||
* [Telegram Channel](https://t.me/haproxy_wi) about Roxy-WI, talks and questions are welcome
|
||
|
||
# Demo site
|
||
[Demo site](https://demo.roxy-wi.org) Login/password: admin/admin. Server resets every hour.
|
||
|
||
|
||
|
||
# Features:
|
||
1. Installation and updating HAProxy, Nginx and Keepalived with Roxy-WI
|
||
2. Installation and updating Grafana, Prometheus servers with Roxy-WI
|
||
3. Installation and updating HAProxy and Nginx exporters with Roxy-WI
|
||
4. Server provisioning on AWS, DigitalOcean and G-Core Labs
|
||
5. Downloading, updating and formatting GeoIP to the acceptable format for HAProxy with Roxy-WI
|
||
6. Dynamic change of Maxconn, Black/white lists and backend's IP address and port with saving changes to the config file
|
||
7. Configuring HAProxy, Nginx and Keepalived in a jiffy with Roxy-WI
|
||
8. Viewing and analysing the status of all Frontend/backend servers via Roxy-WI from a single control panel
|
||
9. Enabling/disabling servers through stats page without rebooting HAProxy
|
||
1. Viewing/Analysing HAProxy and Nginx logs right from the Roxy-WI web interface
|
||
1. Creating and visualizing the HAProxy workflow from Web Ui
|
||
1. Pushing Your changes to your HAProxy, Nginx and Keepalived servers with a single click via the web interface
|
||
1. Getting info on past changes, evaluating your config files and restoring the previous stable config at any time with a single click right from Web interface
|
||
1. Adding/Editing Frontend or backend servers via the web interface with a click
|
||
1. Editing the config of HAProxy, Nginx and Keepalived and push ingchanges to All Master/Slave servers by a single click
|
||
1. Adding Multiple server to ensure the Config Sync between servers
|
||
1. Managing the ports assigned to Frontend automatically
|
||
1. Evaluating the changes of recent configs pushed to HAProxy, Nginx and Keepalived instances right from the Web UI
|
||
1. Multiple User Roles support for privileged based Viewing and editing of Config
|
||
1. Creating Groups and adding/removing servers to ensure the proper identification for your HAProxy and Nginx Clusters
|
||
1. Sending notifications from Roxy-WI via Telegram, Slack and via the web interface
|
||
1. Supporting high Availability to ensure uptime to all Master slave servers configured
|
||
1. Support of SSL (including Let's Encrypt)
|
||
1. Support of SSH Key for managing multiple HAProxy and Nginx Servers straight from Roxy-WI
|
||
1. SYN flood protect
|
||
1. Alerting about сhanges of the state of HAProxy backends
|
||
1. Alerting about the state of HAProxy and Nginx service
|
||
1. Gathering metrics for incoming connections
|
||
1. Web acceleration settings
|
||
1. Firewall for web application
|
||
1. LDAP support
|
||
1. Keep active HAProxy and Nginx services
|
||
1. Possibility to hide parts of the config with tags for users with "guest" role: "HideBlockStart" and "HideBlockEnd"
|
||
1. Mobile-ready design
|
||
1. Simple port monitoring (SMON)
|
||
1. Backup HAProxy, Nginx and Keepalived config files through Roxy-WI
|
||
1. Managing OpenVPN3 as a client via Roxy-WI
|
||
|
||
|
||
|
||
|
||
|
||
# Install
|
||
|
||
## RPM
|
||
|
||
### Read instruction on the official [site](https://roxy-wi.org/installation.py#rpm)
|
||
|
||
## Manual install
|
||
|
||
### Read instruction on the official [site](https://roxy-wi.org/installation.py#manual)
|
||
|
||
# OS support
|
||
Roxy-Wi was tested on EL7, EL8 and all scripts too. Debian/Ubuntu OS support at 'beta' stage, may work not correct
|
||
|
||
|
||
|
||
# Database support
|
||
|
||
Default Roxy-WI use Sqlite, if you want use MySQL enable in config, and create database:
|
||
|
||
### For MySQL support:
|
||
|
||
### Read instruction on the official [site](https://roxy-wi.org/settings.py#db_settings)
|
||
|
||
|
||
|
||
# Settings
|
||
|
||
|
||
Login https://roxy-wi-server/users.py, and add: users, groups and servers. Default: admin/admin
|
||
|
||
### Read instruction on the official [site](https://roxy-wi.org/settings.py)
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
# Troubleshooting
|
||
If you have error:
|
||
```
|
||
Forbidden
|
||
You don't have permission to access /app/overview.py on this server.
|
||
```
|
||
|
||
Check owner(must be apache, or another user for apache)
|
||
|
||
If at first login you have:
|
||
```
|
||
Internal Server Error
|
||
```
|
||
|
||
Do this:
|
||
```
|
||
$ cd /var/www/haproxy-wi/app
|
||
$ ./create_db.py
|
||
```
|
||
and check executeble py files
|
||
|
||
If you see plain text, check section "Directory" in httpd conf
|