轻量级 frp 代理可视化管理平台

frp-agent 是一个基于 Web 的 frp（Fast Reverse Proxy）客户端配置管理平台，提供代理全生命周期管理能力——从服务器接入、代理创建、配置生成到一键部署脚本，帮助团队高效管理大规模 frp 内网穿透服务。

• 多服务器统一管理 — 接入多个 frps 服务端，统一查看状态，支持连接测试
• 代理实时同步 — 定时从 frps API 拉取代理状态（默认 30 分钟），自动发现新代理、更新在线/离线状态
• 代理全量管理 — 创建、编辑、删除代理配置，支持按服务器 / 分组 / 状态 / 关键词筛选和批量操作
• 端口自动管理 — 智能分配端口，冲突检测与自动递增，支持端口范围管理
• 端口自动识别 — 从代理名称中的关键字（ssh、http、mysql、redis 等 40+ 种协议）自动识别本地服务端口

• 配置文件生成 — 按分组或自定义代理列表生成标准 frpc 配置文件，支持 INI 和 TOML 两种格式
• 配置文件导入 — 支持上传或粘贴 INI / TOML 配置文件，自动解析并创建代理记录
• INI / TOML 格式互转 — 方便旧版配置向新版迁移
• 一键安装脚本 — 为分组生成交付脚本（Linux Bash / Windows PowerShell），自动下载 frpc 二进制 + 拉取配置文件
• systemd 服务文件生成 — 一键生成 Linux systemd 服务单元文件

• GitHub 自动同步 — 从 fatedier/frp 仓库同步各平台安装包，支持按版本 / 平台筛选
• 手动上传 — 支持上传自定义编译的 frpc 二进制文件
• 脚本模板自定义 — 可自定义各平台（Linux / Windows）的安装、升级脚本模板

• 认证系统 — 支持 Basic Auth（数据库用户）+ API Key（Bearer Token / URL 参数），首次登录强制修改默认密码
• 分组管理 — 从代理名称自动解析分组前缀（如 dlyy_ssh → dlyy），支持手动调整、批量端口重分配、一键安装
• 数据对比分析 — 对比 frps 实际代理与本地数据库记录，识别差异
• 代理历史记录 — 记录代理状态变更历史，便于问题追溯
• 版本检查 — 通过 Gitee Release API 自动检查更新

docker run -d \
  --name frp-agent \
  -p 8000:8000 \
  -v $(pwd)/data:/app/data \
  registry.cn-shanghai.aliyuncs.com/numen/frp-agent:latest

启动后访问 http://localhost:8000 进入管理界面。

git clone <repository-url> && cd frp-agent
mkdir -p data
docker compose up -d

• 用户名：admin
• 密码：admin

首次登录后系统会提示修改密码。

MIT License