這份手冊依常見的部署情境,一步一步說明怎麼設定 rradius。每個情境都附一組可以直接啟動的設定檔、資料表和 Lua 腳本,放在 rradius-server/examples/scenarios/。所有欄位的完整說明在參考文件 docs/usage.md,手冊只講情境需要的部分,並標出對應的章節。
範例都有自動測試(rradius-server/tests/scenarios_test.rs):測試會照手冊的方式啟動每個情境,送出登入、計費、TACACS+ 和 CoA 請求,確認結果和手冊寫的一樣。所以範例改壞了,測試會失敗。測試做不到的部分(實體設備、真的漫遊聯盟、外部的服務),各章的「上線前」會寫明沒有測過什麼。
先讀這兩章
我要做什麼,看哪一章
| 我要… | 章 |
|---|---|
| 讓員工用帳號密碼或憑證連公司 Wi-Fi | 3,進階的撤銷和漫遊在 15 |
| 讓不會 802.1X 的設備連 Wi-Fi,但每人密碼不同 | 12 |
| 讓裝了自家 SIM 卡的設備連 Wi-Fi | 13 |
| 讓印表機、IP 電話這類設備上有線網路 | 4 |
| 讓 VPN 用公司的目錄登入,或加上驗證碼 | 5 |
| 管理誰能登入路由器、能下哪些指令 | 6,改用 TLS 在 16 |
| 經營寬頻:方案、同時上線數、踢人、計費 | 7 |
| 任何一台停機都不中斷服務 | 8 |
| 把別的單位的帳號轉給他們自己的伺服器 | 9,加入漫遊聯盟在 11 |
| NAS 在網際網路另一頭或 NAT 後面 | 10 |
| 管理幾百台常變動的 NAS | 14 |
| 帳號已經在別的系統裡,不想複製 | 目錄(LDAP/AD)看 5,HTTP API 看 18 |
| 從舊的認證系統搬過來,不想讓大家重設密碼 | 17 |
| 上線之後的日常工作 | 19 |
| 出了問題,從現象找原因 | 20 |
依情境
| 章 | 情境 | 用到的功能 | 範例目錄 |
|---|---|---|---|
| 3. 企業 Wi-Fi | 802.1X:公司電腦用憑證,員工手機用帳號密碼,依群組分 VLAN | EAP-TLS、PEAP、certificate_query、動態 VLAN | enterprise-wifi/ |
| 4. 有線網路 MAC 認證 | 印表機、IP 電話這類不會 802.1X 的設備 | Lua 腳本、網段 client | wired-mab/ |
| 5. 遠端存取 | VPN 用公司目錄(LDAP/AD)登入,跳板機加 TOTP 驗證碼 | LDAP、群組、具名串接、Access-Challenge | remote-access/ |
| 6. 網路設備管理 | 管理員登入路由器,依角色限制指令並記錄 | TACACS+ 認證、授權、計費、授權群組 | device-admin/ |
| 7. 寬頻業者 | PPPoE/IPoE:方案速率、同時上線數、帳務系統踢人 | all_accept、計費、CoA 轉送、計費暫存 | broadband/ |
| 8. 高可用叢集 | 三個節點,任一台停掉都能繼續服務 | hiqlite 叢集、WireGuard、migration | ha-cluster/ |
| 9. 依 realm 轉送 | 合作單位或總部的帳號轉給對方的伺服器 | [proxy]、容錯、RadSec 上游 | realm-proxy/ |
| 10. RadSec | NAS 經過不信任的網路或在 NAT 後面;踢人的請求走 NAS 自己的連線 | [radius.tls]、tls_name、CoA 走 RadSec、coa_sender | radsec/ |
| 11. 漫遊聯盟 | eduroam 這一類:來訪者轉給他的學校,自己的人從聯盟送回來 | [proxy.discovery](DNS)、負載平衡和比重、主動檢查、轉送計費的暫存 | roaming/ |
| 12. 每人一把 Wi-Fi 密碼 | 同一個 WPA2-PSK 的 SSID,每人自己的密碼,依人分 VLAN | [radius.dpsk]、dpsk-seal、依 MAC 回覆密碼 | psk-wifi/ |
| 13. 用 SIM 卡登入 Wi-Fi | 自己發的 USIM 卡,不用憑證也沒有密碼 | EAP-AKA’、aka-seal、主金鑰、頻率限制 | sim-wifi/ |
| 14. 幾百台分店的 NAS | NAS 寫在資料表,新增一台不必改設定檔 | [radius.dynamic_clients]、client 指令 | branch-nas/ |
| 15. 憑證的撤銷和快速重新連線 | 遺失的筆電要撤銷;設備漫遊時不要每次重做握手 | CRL、OCSP、resumption_ms、shared_tickets | wifi-certs/ |
| 16. TACACS+ over TLS | 設備管理從共用密碼移轉到 TLS 1.3 和設備憑證 | [tacacs.tls]、tls_name、tls_only | device-admin-tls/ |
| 17. 從舊系統搬帳號 | 舊的密碼雜湊原樣搬過來,之後逐步換成新格式 | 各種密碼格式、名稱正規化、[accounts] | migrate-users/ |
| 18. 帳號在別的系統 | 每次登入用 HTTPS 問會員系統的 API | [lua.http]、http_request、verifies_password | external-api/ |
上線之後
範例的共同約定
設定檔裡的相對路徑以設定檔所在目錄為準, 所以每個情境都能直接在 repo 裡啟動:
cd rradius-server cargo build --release ./target/release/rradius-server --config examples/scenarios/quick-start/rradius.toml用發行檔時, 解開
rradius-<版本>-<平台>.tar.gz,裡面的目錄結構和 repo 相同。進到其中的rradius-server/目錄,把各章的./target/release/rradius-server換成../bin/rradius-server,其他指令和路徑都一樣,也不用cargo build:cd rradius-0.1.0-linux-x86_64/rradius-server ../bin/rradius-server --config examples/scenarios/quick-start/rradius.toml有些情境要先執行一個腳本才能啟動, 因為憑證和金鑰不該放在 repo 裡:
腳本 情境 產生什麼 make-certs.shenterprise-wifi/、radsec/、roaming/、device-admin-tls/certs/裡示範用的 CA 和憑證setup.shpsk-wifi/、sim-wifi/、wifi-certs/金鑰檔(權限 0600),以及用它封存的示範資料或憑證 這些都只供測試。
setup.sh不會覆蓋已經有的檔案;要從頭再來,停止伺服器後刪掉它產生的檔案和data/。密碼檔(
*.secret)都是示範值, 內容寫明change-me。正式環境一定要換掉,見第 19 章。示範資料放在
migrations/2_demo_*.sql(搬帳號的情境是2_imported_users.sql),結構放在1_schema.sql。正式環境請刪掉示範資料的檔案,或在第一次啟動前換成自己的資料。檔案一旦套用就不能再改,見第 1 章。埠號用標準值(1812、1813、2083、3799、49、300)。在同一台機器上同時啟動兩個情境會衝突,一次啟動一個,或改埠。
啟動後產生的
data/、spool/、certs/和金鑰檔不進 git。 要從頭再來一次,停止伺服器後刪掉data/。NAS 的位址都是示範用的私有網段。 本機測試時要把 client 的
address改成127.0.0.1(快速開始已經是),否則請求會被當成不認得的來源而沒有回應。幾個情境共用檔案: 多數情境的計費用
quick-start/accounting.lua,device-admin-tls/用device-admin/的腳本和資料表。複製情境到別處時,把它引用的目錄一起帶走。