agstr/freeradius-rest

agstr/freeradius-rest 镜像说明

镜像概述

agstr/freeradius-rest是集成FreeRadius与REST API的Docker镜像，专为PHPNuxBill计费系统设计，实现Radius协议的认证、授权和计费功能，帮助用户快速部署网络认证服务。

核心功能

• 支持标准Radius协议（UDP端口1812认证、1813记账）
• 与PHPNuxBill通过REST API对接，同步用户信息与计费数据
• 可配置时区、SSH访问密码及Radius服务参数
• 日志大小限制，避免存储占用过高
• 容器重启策略保障服务稳定性

使用场景

• 小型ISP宽带接入认证与计费
• 企业内部网络设备认证管理
• Wi-Fi热点、酒店网络用户认证
• 其他需要Radius服务的网络计费系统集成

配置说明

通过环境变量配置关键参数：

• TIME_ZONE: 容器时区（如Asia/Shanghai）
• ROOT_PASSWORD: SSH root用户密码
• RADIUS_SECRET: Radius服务共享密钥
• RADIUS_CLIENT: 允许访问的客户端IP（默认0.0.0.0）
• RADIUS_DEBUG: 是否开启调试模式（yes/no）
• REST_API: PHPNuxBill系统的Radius对接接口地址

部署示例

使用Docker Compose部署：

yaml
services:
  freeradiusrest:
    image: agstr/freeradius-rest:latest
    container_name: FREERADIUSREST
    ports:
          - 1812-1813:1812-1813/udp
          - 1222:22
    restart: unless-stopped
    logging:
        driver: "json-file"
        options: 
            max-size: "1m"
            max-file: "3"
    privileged: true
    environment:
        # 设置时区
          - TIME_ZONE=Asia/Jakarta
          
        # SSH root密码
          - ROOT_PASSWORD=***

        # FreeRadius配置
          - RADIUS_SECRET=mysecretradius
          - RADIUS_CLIENT=0.0.0.0
          - RADIUS_DEBUG=no
          - REST_API=[***]