Metadata-Version: 2.0
Name: toughradius
Version: 0.9.4
Summary: RADIUS Server
Home-page: https://github.com/talkincode/ToughRADIUS
Author: jamiesun
Author-email: jamiesun.net@gmail.com
License: BSD
Keywords: radius,authentication
Platform: UNKNOWN
Classifier: Development Status :: 6 - Mature
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Systems Administration :: Authentication/Directory
Requires-Dist: argparse
Requires-Dist: DBUtils (>=1.1)
Requires-Dist: MySQL-python (>=1.2.5)
Requires-Dist: Mako (>=0.9.0)
Requires-Dist: Beaker (>=1.6.4)
Requires-Dist: MarkupSafe (>=0.18)
Requires-Dist: PyYAML (>=3.10)
Requires-Dist: SQLAlchemy (>=0.9.8)
Requires-Dist: Twisted (>=13.0.0)
Requires-Dist: autobahn (>=0.9.3-3)
Requires-Dist: bottle (>=0.12.7)
Requires-Dist: six (>=1.8.0)
Requires-Dist: tablib (>=0.10.0)
Requires-Dist: zope.interface (>=4.1.1)
Requires-Dist: pycrypto (==2.6.1)
Requires-Dist: sh (==1.11)
Requires-Dist: pyOpenSSL (==0.14)
Requires-Dist: service-identity

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 [0/1] [0]:
    [INPUT] - time zone [ CST-8 ]:
    [INFO] - set database option
    [INPUT] - database type [mysql]:
    [INPUT] - database host [127.0.0.1]:
    [INPUT] - database port [3306]:
    [INPUT] - database dbname [toughradius]:
    [INPUT] - database user [root]:
    [INPUT] - database passwd []:
    [INPUT] - db pool maxusage [30]:
    [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


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

::

    #还未创建数据库，使用参数 initdb 1 或 initdb 2
    $ toughctl --initdb 1

    #已创建数据库，使用参数 initdb 3
    $ toughctl --initdb 3

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

::

    #radius认证计费服务
    $ toughctl --radiusd

    #radius管理控制台服务
    $ toughctl --admin

    #radius用户自助服务
    $ toughctl --customer


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

::

    # 参数选择 [all|radiusd|admin|customer]

    $ toughctl --start all 

    #设置开机启动

    $ echo "toughctl --start all" >> /etc/rc.local


web管理控制台的使用
================================

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

默认地址与端口：http://serverip:1816 

默认管理员与密码：admin/root


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

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

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


