> For the complete documentation index, see [llms.txt](https://docs.toughradius.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.toughradius.net/introduction.md).

# introduction

## ToughRADIUS Handbook

Welcome to the **ToughRADIUS Handbook** — the canonical, in-repository, bilingual documentation site for the [ToughRADIUS](https://github.com/talkincode/toughradius) RADIUS server. It is built with [mdBook](https://rust-lang.github.io/mdBook/) and lives in the repository under `docs-site/`, so the documentation is versioned, reviewed, and validated by CI together with the code it describes.

![ToughRADIUS philosophy cover](/files/HHwRETMgp1VZ01y1AjxQ)

The handbook is organized into two mirrored language sections. Pick a language to begin:

* **English** — start with the [Overview](/overview.md).
* **中文** — 从[概述](/overview-1.md)开始。

Each chapter exists in both languages with a matching structure, and the pages cross-link to their counterparts so you can switch language at any point.

> **Relationship to the existing GitBook site.** This handbook is published to GitHub Pages at its custom domain <https://www.toughradius.net/>, while GitBook renders the same sources at `docs.toughradius.net`. The mdBook handbook **coexists** with GitBook from a single source of truth rather than replacing it; see [mdbook & GitBook Coexistence](/overview/gitbook-coexistence.md) / [mdbook 与 GitBook 并存](/overview-1/gitbook-coexistence.md) for the single-source-of-truth policy and the boundary between the two pipelines.

### Build it locally

```bash
# Install mdBook (https://rust-lang.github.io/mdBook/guide/installation.html)
cargo install mdbook            # or: brew install mdbook

# Build the static site into docs-site/book/
mdbook build docs-site

# Or serve with live reload at http://localhost:3000
mdbook serve docs-site
```

***

## ToughRADIUS 使用手册

欢迎来到 **ToughRADIUS 使用手册** —— 这是 [ToughRADIUS](https://github.com/talkincode/toughradius) RADIUS 服务器 随仓库维护的中英文双语文档站点。它基于 [mdBook](https://rust-lang.github.io/mdBook/) 构建，位于仓库的 `docs-site/` 目录下，因此文档与代码一起被版本化、评审，并由 CI 校验。

手册分为结构一一对应的两个语言区。请选择语言开始阅读：

* **English** — 从 [Overview](/overview.md) 开始。
* **中文** — 从[概述](/overview-1.md)开始。

每个章节都提供中英文两个版本且结构对应，页面之间相互交叉链接，方便随时切换语言。

> **与现有 GitBook 站点的关系。** 本手册部署到 GitHub Pages，使用自定义域名 <https://www.toughradius.net/> 对外服务；GitBook 则在 `docs.toughradius.net` 渲染同一份源文件。本 mdBook 手册基于单一事实来源与 GitBook **并存**而非替代； 单一事实来源策略与两套管线的边界详见 [mdbook 与 GitBook 并存](/overview-1/gitbook-coexistence.md) / [mdbook & GitBook Coexistence](/overview/gitbook-coexistence.md)。

### 本地构建

```bash
# 安装 mdBook（https://rust-lang.github.io/mdBook/guide/installation.html）
cargo install mdbook            # 或：brew install mdbook

# 将静态站点构建到 docs-site/book/
mdbook build docs-site

# 或开启热重载预览，访问 http://localhost:3000
mdbook serve docs-site
```