Brak opisu

Roberto Bertó 86e2c67184 finished firewall		5 lat temu
.github	b9c572f9d0 vycenter is being changed to vycontrol	5 lat temu
vycontrol	99da7ee81a done add msg feature to static add/edit/list to increase user msg output #101	5 lat temu
.dockerignore	b927f53f93 docker	5 lat temu
.gitignore	7a7488488a interface rename && firewall basic add rules	5 lat temu
Dockerfile	f5f3417a34 changed vycenter to vycontrol	5 lat temu
LICENSE	1d0c199366 fixed license	5 lat temu
README.md	86e2c67184 finished firewall	5 lat temu
docker-compose.yml	b927f53f93 docker	5 lat temu
requirements.txt	4d9181aae3 first API working version	5 lat temu

VyControl

VyControl is a single frontend interface to manage a single or multiple VyoS servers. Only download VyOS Rolling Release, since VyControl needs the latest VyOS API.

Still in 2020, the most important functionalities that until then were only possible through CLI (command line interface), will be possible through a friendly web interface developed in Django / Python.

Standalone VyoS installations can now have a control panel.

Datacenter installations with multiple VyoS will be able to offer their customers (with users, groups and granular control) firewall as a service.

Main links

VyControl website
VyOS linux firewall website (only compatible with rolling release / 1.3 VyOS)

Plan to use VyControl?

Subscribe to our announce list at https://vycontrol.com/
Join Slack Channel https://vycontrol.slack.com/archives/C012ZRMB8VB
Add new enhancement requests at https://github.com/vycontrol/vycontrol/issues

Plan to develop VyControl?

Solve Issues at https://github.com/vycontrol/vycontrol/issues
Forks and pull requests are welcome!
Discussion VyControl at VyOS forum https://forum.vyos.io/t/vycenter-alpha-stage-announcement-vyos-web-interface/5221/4

roadmap

current version

20.05.04.1000 - improve error returns to end users

changelog

20.05.02.1000 - working firewall without zones
20.05.01 - version created to start project framework, organize permission systems and concept test with some firewall and interface functions and statics routes

future versions

firewall and vycontrol base

IPSEC / OpenVPN focus

vlans, interfaces and system users

basic dynamic routing features

30.10.20.1000 - OSPF features

addons features

versions convention

Note that versions numbers are not related to dates.

major eg 20
- minor eg 05
- feature eg 05
  - build eg 1010

Will give 20.05.05.1010

lifecycle

initially LTS (Long Term Support) versions will be supported by 6 months just to bugfixes
in the future we will extend the time span of LTS versions

installation

for your security edit SECRET_KEY in inside Django settings.py and change to something random, maybe using
```
openssl rand -hex 32
```

by dockerhub

latest VyControl is being autobuilt at dockerhub https://hub.docker.com/r/robertoberto/vycontrol

docker pull robertoberto/vycontrol

by docker composer

Right now we are using db.sqlite3, but I used composer so we can change to mySQL if needed.

docker-compose build
docker-compose  up

manual install instructions

setup virtual env and pip requirements

virtualenv env
source env/bin/activate
pip3 install -r requirements.txt

setup initial database

cd vycenter
python3 manage.py migrate

run webserver

python3 manage.py runserver

access webpage

http://127.0.0.1:8000/

setup vyos new instance

click on Add new instance
configure vyos services like explained here https://docs.vyos.io/en/latest/appendix/http-api.html
click on List Instances
click on Test Connection

references

screenshoots (keep in mind we're in early alpha stages)

Install VyControl

List Users

List VyOS Instances

Add VyOS Instances

List Interfaces

List Firewall

Add Firewall Rule

List Static Routes

Sponsoring

VyControl is being tested at Under a Brazilian provider of Cloud Computing and Datacenters.

README.md