FRP-Panel 开源项目教程
1. 项目的目录结构及介绍
FRP-Panel 项目的目录结构如下:
|-- biz
| |-- client
| |-- master
| | |-- auth
| | |-- client
| | |-- server
| | `-- user
| `-- server
|-- cache
|-- cmd
|-- common
|-- conf
|-- dao
|-- doc
|-- idl
|-- middleware
|-- models
|-- pb
|-- rpc
目录结构介绍
- biz: 主要业务逻辑
- client: 客户端逻辑(这里指的是frp-panel的客户端)
- master: frp-panel 控制平面,负责处理前端请求并且使用rpc管理frp-panel的server和client
- auth: 认证模块,包含用户认证和客户端认证
- client: 客户端模块,包含前端管理客户端的各种API
- server: 服务端模块,包含前端管理服务端的各种API
- user: 用户模块,包含用户管理、用户信息获取等
- server: 服务端逻辑(这里指的是frp-panel的服务端)
- cache: 缓存,用于存储frps的认证token
- cmd: 命令行入口,main函数的所在地,负责按需启动各个模块
- common: 通用模块
- conf: 配置文件相关
- dao: data access object,任何和数据库相关的操作会调用这个库
- doc: 文档
- idl: idl定义
- middleware: api的中间件,包含JWT和context相关,用于处理api请求,鉴权通过后会把用户信息注入到context,可以通过common包获取
- models: 数据库模型,用于定义数据库表,同时包含实体定义
- pb: protobuf生成的pb文件
- rpc: 各种rpc的所在地,包含Client/Server调用Master的逻辑
2. 项目的启动文件介绍
项目的启动文件主要位于 cmd
目录下。以下是一些关键的启动文件:
- cmd/main.go: 这是项目的入口文件,负责初始化和启动各个模块。
- cmd/client.go: 客户端的启动文件,负责启动frp-panel的客户端。
- cmd/server.go: 服务端的启动文件,负责启动frp-panel的服务端。
启动文件介绍
- main.go: 这个文件包含了项目的初始化逻辑,它会根据配置文件和命令行参数来启动相应的服务(客户端或服务端)。
- client.go: 这个文件包含了客户端的启动逻辑,它会读取配置文件并启动frp-panel的客户端服务。
- server.go: 这个文件包含了服务端的启动逻辑,它会读取配置文件并启动frp-panel的服务端服务。
3. 项目的配置文件介绍
项目的配置文件主要位于 conf
目录下。以下是一些关键的配置文件:
- conf/app.conf: 这是主要的配置文件,包含了应用的各种配置参数,如端口号、数据库连接信息等。
- conf/client.conf: 客户端的配置文件,包含了客户端特有的配置参数。
- conf/server.conf: 服务端的配置文件,包含了服务端特有的配置参数。
配置文件介绍
- app.conf: 这个文件包含了应用的全局配置参数,如端口号、日志级别、数据库连接信息等。
- client.conf: 这个文件包含了客户端特有的配置参数,如客户端的连接信息、认证信息等。
- server.conf: 这个文件包含了服务端特有的配置参数,如服务端的监听端口、认证信息等。
以上是 FRP-Panel 开源项目的目录结构、启动文件和配置文件的介绍。希望这些信息能帮助你更好地理解和使用该项目。