ToughRADIUS 项目安装与使用指南

1. 项目目录结构及介绍

ToughRADIUS 项目的目录结构如下：

toughradius/
├── scripts/
├── src/
├── .gitignore
├── CNAME
├── LICENSE
├── README.md
├── _config.yml
├── changelogs.md
├── pom.xml
└── release.sh

目录结构说明

• scripts/: 包含项目的脚本文件，用于自动化部署和管理。
• src/: 项目的源代码目录，包含主要的业务逻辑和功能实现。
• .gitignore: Git 忽略文件，指定哪些文件和目录不需要被版本控制。
• CNAME: 用于自定义域名的配置文件。
• LICENSE: 项目的开源许可证文件，本项目使用 AGPL-3.0 许可证。
• README.md: 项目的介绍文档，包含项目的概述、安装和使用说明。
• _config.yml: 项目的配置文件，用于定义项目的元数据和构建配置。
• changelogs.md: 项目的更新日志，记录每次版本更新的详细信息。
• pom.xml: Maven 项目的配置文件，定义项目的依赖和构建配置。
• release.sh: 项目的发布脚本，用于自动化发布流程。

2. 项目启动文件介绍

ToughRADIUS 项目的启动文件主要是 src/ 目录下的主程序文件。具体启动步骤如下：

1. 编译项目: 使用 Maven 编译项目，生成可执行的 JAR 文件。

   mvn clean package
   

2. 启动项目: 使用 Java 命令启动生成的 JAR 文件。

   java -jar target/toughradius-latest.jar
   

3. 指定配置文件: 可以通过命令行参数指定配置文件，例如：

   java -jar target/toughradius-latest.jar --spring.profiles.active=prod
   

3. 项目的配置文件介绍

ToughRADIUS 项目的配置文件主要包括以下几个部分：

3.1 数据库配置

数据库配置文件通常位于 src/main/resources/application-prod.properties 或 application-dev.properties 中。以下是一个示例配置：

spring.datasource.url=jdbc:mysql://127.0.0.1:3306/toughradius?serverTimezone=Asia/Shanghai&useUnicode=true&characterEncoding=utf-8&allowMultiQueries=true
spring.datasource.username=raduser
spring.datasource.password=radpwd
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

3.2 日志配置

日志配置文件通常位于 src/main/resources/logback-prod.xml 或 logback-dev.xml 中。以下是一个示例配置：

<configuration>
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss} %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <root level="INFO">
        <appender-ref ref="STDOUT" />
    </root>
</configuration>

3.3 其他配置

其他配置文件可能包括 Web 服务器配置、缓存配置等，具体配置项可以根据实际需求进行调整。

通过以上步骤，您可以顺利安装和启动 ToughRADIUS 项目，并根据需要进行配置和使用。