# ToughRADIUS

**Repository Path**: zhangf/ToughRADIUS

## Basic Information

- **Project Name**: ToughRADIUS
- **Description**: ToughRADIUS is a radius server
- **Primary Language**: Unknown
- **License**: BSD-2-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 58
- **Created**: 2015-03-02
- **Last Updated**: 2024-06-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

ToughRADIUS简介
====================================

ToughRADIUS是一个开源的Radius服务软件，基于BSD许可协议发布。

ToughRADIUS支持标准RADIUS协议，提供完整的AAA实现。支持灵活的策略管理，支持各种主流接入设备并轻松扩展，具备丰富的计费策略支持。

ToughRADIUS支持使用Oracle, MySQL, PostgreSQL, MSSQL等主流数据库存储用户数据，并支持数据缓存，极大的提高了性能。
ToughRADIUS支持Windows，Linux，BSD跨平台部署，部署使用简单。

ToughRADIUS提供了RADIUS核心服务引擎与Web管理控制台,用户自助服务三个子系统，核心服务引擎提供高性能的认证计费服务，Web管理控制台提供了界面友好，功能完善的管理功能。用户自助服务系统提供了一个面向终端用户的网上服务渠道。

ToughRADIUS网站：http://www.toughradius.net

ToughRADIUS文档: http://docs.toughradius.net/build/html/



Linux环境安装
====================================


安装系统依赖(centos6/7)
--------------------------------------

::

    $ yum update -y
     
    # centos 6
    $ yum install -y  mysql-devel python-devel python-setuptools MySQL-python
     
    #centos7
    $ yum install -y  mariadb-devel python-devel python-setuptools MySQL-python
     
    
   
安装toughradius
----------------------------------------

安装完成后，toughctl命令可用。

::

    $ pip install toughradius
    

创建配置文件
----------------------------------------

请确保你的mysql服务器已经安装运行，根据提示配置正确的数据库连接信息。

::

    $ toughctl --config
    
    [INFO] - set config...
    [INPUT] - set your config file path,[ /etc/radiusd.conf ]
    [INFO] - set default option
    [INPUT] - set debug [false]:
    [INPUT] - time zone [ CST-8 ]:
    [INFO] - set database option
    [INPUT] - database type [mysql]:
    [INPUT] - database dburl [sqlite:////tmp/toughradius.sqlite3]:
    [INPUT] - database echo [false]:
    [INPUT] - database pool_size [30]:
    [INPUT] - database pool_recycle(second) [300]:
    [INFO] - set radiusd option
    [INPUT] - radiusd authport [1812]:
    [INPUT] - radiusd acctport [1813]:
    [INPUT] - radiusd adminport [1815]:
    [INPUT] - radiusd cache_timeout (second) [600]:
    [INPUT] - log file [ logs/radiusd.log ]:/var/log/radiusd.log
    [INFO] - set mysql backup ftpserver option
    [INPUT] - backup ftphost [127.0.0.1]:
    [INPUT] - backup ftpport [21]:
    [INPUT] - backup ftpuser [ftpuser]:
    [INPUT] - backup ftppwd [ftppwd]:
    [INFO] - set admin option
    [INPUT] - admin http port [1816]:
    [INPUT] - log file [ logs/admin.log ]:/var/log/admin.log
    [INFO] - set customer option
    [INPUT] - customer http port [1817]:
    [INPUT] - log file [ logs/customer.log ]:/var/log/customer.log
    [SUCC] - config save to /etc/radiusd.conf


初始化数据库
----------------------------------------

注意此操作会重建所有数据库表，请注意备份重要数据。

::

    $ toughctl --initdb 


运行服务
----------------------------------------

::

    #radius认证计费服务
    $ toughctl --radiusd
     
    #radius管理控制台服务
    $ toughctl --admin
     
    #radius用户自助服务
    $ toughctl --customer
    
    #通过一个进程运行所有服务
    $ toughctl --standalone
    

以守护服务模式运行
----------------------------------------

当启动standalone模式时，只会启动一个进程

::

    # 参数选择 [all|radiusd|admin|customer|standalone]
    
    $ toughctl --start all 
     
    #设置开机启动
    
    $ echo "toughctl --start all" >> /etc/rc.local
    
    
web管理控制台的使用
================================

当安装部署完成后可使用浏览器进入管理控制台进行操作。

默认地址与端口：http://serverip:1816 
 
默认管理员与密码：admin/root


自助服务系统的使用
================================

自助服务系统运行于一个独立的进程。

默认地址与端口:http://serverip:1817