vassio/keycloak-radius-plugin

Keycloak Radius服务器Docker镜像

镜像概述和主要用途

该镜像用于在Docker环境中运行Keycloak Radius服务器，将Radius认证功能集成到Keycloak单点登录(SSO)系统中，实现基于Keycloak用户体系的Radius认证与授权服务。

核心功能和特性

• 支持RADIUS UDP协议，可配置认证和记账端口
• 支持RadSec协议，需配置RSA私钥和证书
• 支持CoA（Change of Authorization）消息，会话过期时可发送断开连接通知
• 通过环境变量灵活配置共享密钥、端口等参数
• 与Keycloak SSO深度集成，复用Keycloak用户管理和认证机制

使用场景和适用范围

适用于需要将Radius认证与Keycloak统一身份管理结合的场景，如：

• 网络设备（路由器、交换机）的Radius认证
• ***接入的Radius身份验证
• 企业网络中需统一身份认证的Radius客户端环境

详细的使用方法和配置说明

安装Docker

首先在Linux服务器上https://docs.docker.com/engine/install/%E3%80%82

下载镜像

从Docker Hub获取可信构建：

bash
docker pull vassio/keycloak-radius-plugin

环境变量配置

该镜像使用以下环境变量，可通过env文件配置（示例）：

bash
RADIUS_SHARED_SECRET="secret"
RADIUS_UDP=true
RADIUS_UDP_AUTH_PORT=1812
RADIUS_UDP_ACCOUNT_PORT=1813
RADIUS_RADSEC=false
RADIUS_RADSEC_PRIVATEKEY="/config/private.key"
RADIUS_RADSEC_CERTIFICATE="/config/public.crt"
RADIUS_COA=false
RADIUS_COA_PORT="3799"

变量说明：

• RADIUS_SHARED_SECRET：Radius共享密钥
• RADIUS_UDP：是否启用RADIUS UDP协议（认证和记账）
• RADIUS_UDP_AUTH_PORT：UDP认证端口（RADIUS_UDP=true时生效）
• RADIUS_UDP_ACCOUNT_PORT：UDP记账端口（RADIUS_UDP=true时生效）
• RADIUS_RADSEC：是否启用RadSec协议
• RADIUS_RADSEC_PRIVATEKEY：RadSec协议使用的RSA私钥路径
• RADIUS_RADSEC_CERTIFICATE：RadSec协议使用的证书路径
• RADIUS_COA：是否在Keycloak会话过期时发送断开连接消息
• RADIUS_COA_PORT：CoA端口（Mikrotik设备默认3799，Cisco设备默认1700）

Keycloak配置

参考https://github.com/keycloak/keycloak-containers/blob/master/server/README.md%E8%BF%9B%E8%A1%8CKeycloak%E5%9F%BA%E7%A1%80%E9%85%8D%E7%BD%AE%E3%80%82

启动Keycloak Radius服务器

使用以下命令创建并启动容器（替换./.radius.env为实际env文件路径）：

bash
docker run -d --name keycloak-radius-plugin --env-file ./.radius.env --restart=always -p 8080:8080 vassio/keycloak-radius-plugin

使用Docker Compose运行

bash
docker network create docker_default
docker-compose -f docker/docker-compose-keycloak.yaml create
docker-compose -f docker/docker-compose-keycloak.yaml start

RadSec配置

1. 生成私钥和公钥
2. 在docker-compose-keycloak.yaml中配置：

yaml
RADIUS_RADSEC: 'true'
RADIUS_RADSEC_PRIVATEKEY: /config/private.key
RADIUS_RADSEC_CERTIFICATE: /config/public.crt

示例Radius Realm

使用示例：

1. 使用testUser/testUser登录http://localhost:8090/auth/realms/Radius-Realm-example/protocol/openid-connect/auth?client_id=account&redirect_uri=http%3A%2F%2Flocalhost%3A8090%2Fauth%2Frealms%2FRadius-Realm-example%2Faccount%2Flogin-redirect?path%3Dapplications&state=0%2F84406c9b-2682-4af3-b367-d9ae37e9a34f&response_type=code&scope=openid
2. 重置Radius密码

日志查看

bash
docker logs keycloak-radius-plugin -f

容器内Bash访问

在运行的容器中启动Bash会话：

bash
docker exec -it keycloak-radius-plugin bash

本地构建和运行

bash
docker stop keycloak-radius-plugin
docker rm keycloak-radius-plugin
set -e
cp -r ../cli ./cli
docker build -t keycloak-radius-plugin .
docker run --env-file ./example.radius.env -e KEYCLOAK_PASSWORD="admin" -e KEYCLOAK_USER="admin" -e KEYCLOAK_IMPORT="/config/realm-example.json" --name=keycloak-radius-plugin keycloak-radius-plugin

部署新版本到Docker Hub

bash
./docker.publish.sh