tgbyte/freeradius

Freeradius for Raspberry Pi Docker镜像文档

镜像概述

本镜像为树莓派（ARM架构）优化的Freeradius服务器Docker镜像，基于官方Freeradius项目构建，专为在树莓派设备上快速部署RADIUS服务设计。镜像体积轻量，资源占用低，适合树莓派的硬件环境，可作为小型网络中的认证授权核心组件。

核心功能与特性

• RADIUS协议支持：完整实现RADIUS协议栈，支持认证（Authentication）、授权（Authorization）和计费（Accounting）核心功能
• ARM架构优化：针对树莓派的ARMv7/ARM64架构编译，确保在低功耗设备上高效运行
• 轻量级设计：基于精简基础镜像，最小化资源占用，适配树莓派有限的CPU和内存资源
• 配置灵活性：支持通过挂载外部配置文件自定义RADIUS策略，兼容Freeradius标准配置格式
• 持久化支持：可通过数据卷挂载实现配置文件、证书和日志的持久化存储
• 标准端口映射：默认开放RADIUS标准UDP端口（1812/1813），支持自定义端口映射

使用场景

• 家庭网络：控制智能家居设备、WiFi接入点的访问权限
• 小型企业：管理员工网络接入认证（如***、交换机端口访问控制）
• 教育场景：网络实验环境中的RADIUS协议教学与实践
• 边缘计算：树莓派作为边缘节点的网络身份验证服务
• IoT设备管理：为物联网设备提供统一的接入认证机制

使用方法

基本运行

通过docker run命令快速启动服务：

bash
docker run -d \
  --name freeradius-rpi \
  --restart always \
  -p 1812:1812/udp \  # 认证端口
  -p 1813:1813/udp \  # 计费端口
  -v /path/to/local/config:/etc/freeradius \  # 挂载自定义配置
  -v freeradius-data:/var/log/freeradius \    # 日志持久化
  your-registry/freeradius-rpi:latest

Docker Compose配置

创建docker-compose.yml简化部署：

yaml
version: '3'
services:
  freeradius:
    image: your-registry/freeradius-rpi:latest
    container_name: freeradius-rpi
    restart: always
    ports:
      - "1812:1812/udp"
      - "1813:1813/udp"
    volumes:
      - ./freeradius-config:/etc/freeradius  # 本地配置目录
      - freeradius-log:/var/log/freeradius   # 日志数据卷
    environment:
      - LOG_LEVEL=info  # 日志级别：debug/info/warn/error
      - MAX_CLIENTS=100 # 最大客户端连接数
    networks:
      - radius-network

volumes:
  freeradius-log:

networks:
  radius-network:

配置参数说明

端口映射

环境变量

配置文件结构

挂载的配置目录需包含Freeradius标准配置文件，核心目录结构：

/etc/freeradius/
  ├── clients.conf    # 客户端配置（允许接入的网络设备）
  ├── users           # 用户认证信息
  ├── sites-available/  # 站点配置模板
  └── mods-available/   # 模块配置（如SQL、LDAP集成）

持久化与数据管理

• 配置持久化：通过-v /local/config:/etc/freeradius挂载自定义配置，避免容器重建丢失配置
• 日志持久化：使用命名卷（如freeradius-data）保存日志文件，便于问题排查
• 证书管理：若启用TLS（如EAP-TLS认证），需将证书文件挂载至/etc/freeradius/certs目录

注意事项

• 树莓派需运行支持Docker的系统（如Raspberry Pi OS 64位版）
• 首次启动需等待配置初始化，可通过docker logs freeradius-rpi查看启动状态
• 客户端设备需配置正确的RADIUS服务器IP（树莓派IP）和共享密钥（在clients.conf中定义）
• 高并发场景下建议调整树莓派的UDP缓冲区大小，避免丢包

扩展说明

如需集成数据库（如MySQL）或LDAP认证，可通过修改mods-available/sql或mods-available/ldap配置文件，并挂载相应模块配置至容器。详细配置参考Freeradius官方文档。