情境: 地區寬頻業者,用戶透過 BNG(寬頻接取閘道)撥接 PPPoE 或 IPoE 上網。
- 每個用戶有一個方案:方案決定速率和同時上線數(家用 1 個,企業 4 個)。
- 欠費的用戶停權,不能再登入。
- 計費記下每個 session 的時間、流量和配到的 IP。
- 帳務系統停權時要立刻把人踢下線,但它不知道用戶在哪台 BNG、session ID 是什麼,也沒有 BNG 的共用密碼。
- 資料庫短暫出問題時,計費不能遺失。
範例目錄:rradius-server/examples/scenarios/broadband/
| 檔案 | 內容 |
|---|---|
rradius.toml | all_accept 串接、CoA 轉送、計費暫存 |
accounting.lua | 計費:每個 session 一列,記下 NAS 和 IP |
session-limit.lua | 同時上線數的檢查 |
migrations/1_schema.sql | plans、plan_reply、subscribers、accounting |
migrations/2_demo_data.sql | 兩個方案、三個用戶(一個停權) |
流程
登入:BNG ──► sql 處理器(密碼、方案屬性)──► session-limit.lua(還有名額嗎)──► Accept + 速率
計費:BNG ──► accounting.lua ──► accounting 表
踢人:帳務系統 ──Disconnect-Request(只有 User-Name)──► rradius
rradius 用 session_query 查 accounting 表 ──► 找到的每個 session 轉給它的 BNG
同時上線數和踢人都讀同一張 accounting 表,所以只要計費正確,兩個功能就正確。
步驟
1. 改 client 並啟動
本機測試時,把 bng-1 的 address 和 billing 的 address 都改成 127.0.0.1,bng-1 的 coa_port 改成 3800(否則轉給 BNG 的請求會送回 rradius 自己的 3799 埠)。
cd rradius-server
./target/release/rradius-server --config examples/scenarios/broadband/rradius.toml
2. 登入和同時上線數
S=bng-shared-secret-change-me
radtest home0001 home0001-password 127.0.0.1 0 $S
# Access-Accept:Mikrotik-Rate-Limit = "100M/100M"、Acct-Interim-Interval = 300
echo 'User-Name=home0001,Acct-Session-Id=bb-1,Acct-Status-Type=Start,Framed-IP-Address=100.64.0.9' \
| radclient 127.0.0.1:1813 acct $S
radtest home0001 home0001-password 127.0.0.1 0 $S
# Access-Reject:家用方案只能一個 session,記錄有 too many sessions
radtest home0002 ... 一律被拒絕,它的 status 是 suspended。
3. 帳務系統踢人
帳務系統只送 User-Name,用自己的共用密碼簽章,送到 rradius 的 3799 埠:
echo 'User-Name=home0001' | radclient 127.0.0.1:3799 disconnect billing-coa-secret-change-me
rradius 查出 home0001 還開著的 session(bb-1,在 bng-1),把 Disconnect-Request 加上 Acct-Session-Id = bb-1 轉給 bng-1 的 coa_port,再把 BNG 的回答傳回帳務系統。本機沒有真的 BNG 在 3800 埠回答,所以重試完(預設 1 秒 × 3 次)後收到 NAK,Error-Cause 是 505;對沒有 session 的用戶送,會收到 NAK 503(Session Context Not Found)。
設定說明
先比對密碼,再檢查名額
[auth]
policy = "all_accept"
[[auth.handlers]]
type = "sql"
user_query = "SELECT password FROM subscribers WHERE username = ? AND status = 'active'"
reply_query = "SELECT r.attribute, r.value FROM subscribers s JOIN plan_reply r ON r.plan = s.plan WHERE s.username = ?"
[[auth.handlers]]
type = "lua"
script = "session-limit.lua"
all_accept: 每個處理器都要接受。sql拒絕(密碼錯、停權)就不會跑腳本;sql接受後腳本才檢查名額。- 不要用
first_match: 那樣sql查不到名稱時會交給腳本,腳本只檢查名額,不存在的帳號就不用密碼通過了。 reply_query依方案回屬性。 範例用 MikroTik 的Mikrotik-Rate-Limit;其他廠商的 BNG 用各自的屬性,例如 Cisco 的Cisco-AVPair、Juniper 的ERX-*,在plan_reply換成你的 BNG 認得的名稱和值。Acct-Interim-Interval = 300要求 BNG 每 5 分鐘回報一次。session-limit.lua的STALE_AFTER和[radius.coa]的session_query都把超過 900 秒沒回報的 session 當成已經離線(BNG 當機不會送 Stop),所以這個間隔一定要比 900 秒短。要改 900 秒時,兩個地方一起改。
[auth.username]
lowercase = true
allowed = "[a-z0-9._@-]+"
HOME0001 和 home0001 是同一個人,否則各算各的名額。accounting.lua 也把名稱轉小寫。
session-limit.lua
SELECT p.max_sessions AS allowed,
(SELECT count(*) FROM accounting a
WHERE a.username = s.username AND a.stopped IS NULL AND a.updated > ?) AS online
FROM subscribers s JOIN plans p ON p.name = s.plan
WHERE s.username = ?
- 名額從 Accounting-Start 才算。兩個同時進來的登入可能都通過, 這是所有「看計費算名額」做法的共同限制。
- 叢集裡讀的是本機副本,可能比剛寫入的計費慢一點。
auth_user是串接正規化後的名稱(小寫)。
accounting.lua
和快速開始的相同(Start、Interim、Stop 寫進同一列,可以重複執行,NAS 重開機時結束它的 session),另外:
nas欄: 送 CoA 要去的地方,取 NAS 回報的NAS-IP-Address或NAS-IPv6-Address,都沒有時用 client 名稱。framed_ip欄: 配給用戶的 IP,後來的 Interim-Update 沒帶時保留原值。客服查「這個 IP 剛才是誰」時用得到。
CoA 轉送
[radius.coa]
port = 3799
session_query = "SELECT nas, session_id FROM accounting WHERE username = ? AND stopped IS NULL AND updated > strftime('%s', 'now') - 900 ORDER BY updated DESC"
[[radius.coa.clients]]
name = "billing"
address = "10.20.0.5"
secret_file = "billing.secret"
[[radius.coa.clients]]是可以要求踢人的系統, 和 NAS 的名單分開。- 請求有指定 NAS(
NAS-IP-Address等)時直接轉給那台, 只有User-Name時才用session_query查。查詢只有一個?,代入User-Name,所以帳務系統沒辦法注入 SQL。 - 回覆: 任一台 BNG 回 ACK 就回 ACK;全部拒絕時傳回其中一個 NAK;查不到 session 回 NAK 503;查到的 NAS 都不是設定的 client 回 502;查詢失敗或 BNG 都沒回應回 505。一個用戶最多轉給 32 個 session。
- BNG 要開 CoA(RFC 5176), 接受 rradius 的來源位址,埠是 client 的
coa_port(預設 3799,有些設備用 1700)。 - 只有
User-Name的請求在多台 BNG 時很方便, 但查詢依賴計費:BNG 沒送 Start,就查不到。 - 想自己從腳本或命令列踢人,見 usage 4.8 節的
send_disconnect和rradius-server disconnect指令。
計費暫存
[radius.accounting_spool]
dir = "spool"
資料庫寫不進去(叢集失去多數節點、逾時)時,計費先寫到本機目錄並回覆 BNG,恢復後由 accounting.lua 重放。腳本可以重複執行,所以重放不會重複計算。暫存檔含個人資料,目錄權限是 0700;磁碟壞掉時還沒重放的就遺失了。見 usage 2.11 節。
- 只暫存資料庫造成的失敗。 腳本自己的錯誤、回傳
'reject'都不暫存,和沒有這個區段時一樣不回覆,錯誤不會被藏起來。 - 重放時腳本看得出來: 全域變數
replayed是true,Acct-Delay-Time已經加上待在暫存裡的時間。 - 恢復前,依賴計費的功能看不到這些資料: 同時上線數和踢人都讀
accounting表。rradius_acct_spool_bytes大於 0 就代表有落後,拿它告警。 query_timeout_ms決定多久才進暫存。 叢集沒有多數節點時,寫入要等到[lua] query_timeout_ms(預設 5 秒)才算失敗,這段時間 BNG 收不到回覆。比 BNG 的重送間隔長時調低它。- 重放的速度(
replay_window): 預設一次重放一筆、依寫入順序,每秒約幾千筆。停機很久、累積很多時可以設replay_window = 8同時重放;但同一個 session 的 Start、Interim、Stop 可能同時執行或順序顛倒。範例的accounting.lua把三種寫進同一列、數字取較大的值,順序顛倒也沒關係;你的腳本靠先後順序時維持 1。 - 重放卡住時:
rejected.log、.corrupt檔怎麼看,見第 20 章。
上線前
- 方案和用戶的資料從哪裡來? 範例的示範用戶來自 migration 檔。範例設定已有
[accounts],可以用rradius-server user add|passwd|disable管理用戶(停用就是把status改成suspended);帳務系統也可以呼叫這些指令同步,見第 19 章。 - IP 位址池: 範例由 BNG 自己配發。要由 RADIUS 配發時參考
examples/ip-pool.lua,它在整個叢集內保證同一個位址不會同時給兩個人。 - 時間配額和可上網時段: 參考
examples/quota-and-hours.lua。 accounting表會一直變大, 清除舊資料見第 19 章。- 多台 BNG、多台 rradius 時,見第 8 章。每台 BNG 都要能收到每個 rradius 節點送的 CoA。
- BNG 在 NAT 後面、或中間是不信任的網路時, BNG 用 RadSec 連進來,踢人的請求走它自己開的那條連線,見第 10 章。
- 用戶資料在帳務系統裡、不想複製一份時, 可以每次登入問帳務系統的 API,見第 18 章。
常見問題
| 現象 | 原因 |
|---|---|
| 用戶下線了還是被說「太多 session」 | BNG 沒送 Stop(當機、斷線),要等 900 秒;或 BNG 重開機時沒送 Accounting-On |
| 踢人回 503 | 查不到開著的 session:BNG 沒送計費、名稱大小寫不同、超過 900 秒沒回報 |
| 踢人回 505 | BNG 沒回應:沒開 CoA、埠不對、不接受 rradius 的來源位址、共用密碼不同 |
| 踢人的請求沒有任何回應 | 送出端不在 [[radius.coa.clients]],或密碼不對,計入 rradius_coa_relay_discarded_total |