Vulpes - Sistema de gerenciamento para provedores

          Pessoal, há um certo tempo na minha empresa desenvolvemos um software para gerenciamento para provedores bem legal, pena que o projeto parou na versão 0.3. Vulpes é um sistema de gerenciamento de acesso para gateways/proxies. Licenciado sob o GPLv3. 

Segue passos para instalação:

Pre-requisitos

• Linux (Testado no Ubuntu 6.06+/Debian 4.0+)
• Apache 2.0 ou superior
• PHP 5 ou superior
• MySQL 5.0 ou superior
• ISC DHCP Server versão 3
• Sudo

Instalação

0. Primeiro é importante decidir onde vai colocar o vulpes.

Durante essa guia vamos usar um variável do ambiente:

export VULPES_PATH="/var/www/vulpes"

Se você deseja instalar o Vulpes em um outro caminho, modifique essa variável. IMPORTANTE: Se você fecha o terminal antes de terminar essa guia, lembre-se de exportar essa variável de novo.

1. Instalar Dependências:

sudo apt-get install apache2 mysql-server php5 php5-mysql php5-cli dhcp3-server

2. Baixar e descompactar o Vulpes:

sudo wget http://launchpad.net/vulpes/0.3.1/0.3.1/+download/vulpes-0.3.1.tar.gz
sudo tar xvf vulpes-0.3.1.tar.gz
sudo mv vulpes-0.3.1 $VULPES_PATH

3. Ativar mod_rewrite no apache:

sudo a2enmod rewrite

4. Configurar apache para escutar nas portas 80 e 82:

sudo nano /etc/apache2/ports.conf

5. Colocar captive portal na porta 82

Primeiro modifica a configuração default para usar porta 80:

sudo nano /etc/apache2/sites-enabled/000-default

[remover a primeira regra (NameVirtualHost *)]
[mudar '' para ''] 

Depois criar um link símbolico para o apache.conf do Vulpes, 

sudo cp $VULPES_PATH/backend/apache_dist.conf $VULPES_PATH/backend/apache.conf 
sudo nano $VULPES_PATH/backend/apache.conf 
sudo ln -s $VULPES_PATH/backend/apache.conf /etc/apache2/sites-enabled/001-vulpes

e depois editar ele e mudar os IPs para o IP do teu servidor. 


6. Cria backup do dhcpd.conf:

sudo cp /etc/dhcp3/dhcpd.conf /etc/dhcp3/dhcpd.conf-old

7. Mudar permissões de dhcpd.conf:

sudo chown www-data:www-data /etc/dhcp3/dhcpd.conf
sudo chmod 664 /etc/dhcp3/dhcpd.conf

8. Criar /etc/firewall com permissões para www-data:

sudo touch /etc/firewall
sudo chown www-data:www-data /etc/firewall

9. Criar /etc/tcrc com permissões para www-data:

sudo touch /etc/tcrc
sudo chown www-data:www-data /etc/tcrc
sudo chmod +x /etc/tcrc

10. Mudar permissões do access.log do squid:

sudo chown proxy:www-data /var/log/squid/access.log

11. Liberar iptables, iptables-restore, tc e dhcp3-server para apache no sudo:

sudo visudo

Adicione as seguintes regras:

www-data        ALL=(ALL) NOPASSWD: /sbin/iptables
www-data        ALL=(ALL) NOPASSWD: /sbin/iptables-restore
www-data        ALL=(ALL) NOPASSWD: /sbin/tc
www-data        ALL=(ALL) NOPASSWD: /etc/init.d/dhcp3-server

12. Configurar o cron:

Primeiro modifica o cron.sh para configurar o caminho:

sudo cp $VULPES_PATH/backend/cron_dist.sh $VULPES_PATH/backend/cron.sh
sudo nano $VULPES_PATH/backend/cron.sh
sudo chmod +x $VULPES_PATH/backend/cron.sh

Depois adicionar cron.sh no crontab:

sudo crontab -e

Adicione seguinte regra (modifica o caminho de acordo com a instalação do vulpes):

*/5 *  *   *   *     /var/www/vulpes/backend/cron.sh

13. Preparar banco de dados:

mysql -u root -p < $VULPES_PATH/backend/vulpes.sql

14. Configurar o backend para usar o banco de dados:

sudo cp $VULPES_PATH/backend/config_dist.php $VULPES_PATH/backend/config.php
sudo nano $VULPES_PATH/backend/config.php

15. Confgurar o frontend para usar o backend:

sudo cp $VULPES_PATH/config-dist.xml $VULPES_PATH/config.xml
sudo nano $VULPES_PATH/config.xml

16. Acesse o Vulpes:

Agora pode acessar o Vulpes corsac no seu servidor no caminho:
http://10.0.0.1/vulpes/
Onde 10.0.0.1 é o IP do seu servidor.

O login e senha padrão para acesso são: admin e admin.