服务端 + 客户端分布式架构，集中管控多台 Linux 服务器的 IP 封禁、UA 拦截、地区封锁与端口规则。内置 AI 助手，兼容宝塔面板。
Linux 服务器 root 权限一键安装
curl -sSL https://fhq.x.kpt.cn/install.sh | bash
也可先下载再执行：curl -o install.sh https://fhq.x.kpt.cn/install.sh && bash install.sh
curl -sSL https://fhq.x.kpt.cn/install.sh | bash -s server
export FHQ_SERVER_URL=http://你的服务端:33022
curl -sSL https://fhq.x.kpt.cn/install.sh | bash -s client
curl -sSL https://fhq.x.kpt.cn/install.sh | bash -s client http://你的服务端:33022
curl -sSL https://fhq.x.kpt.cn/install.sh | bash -s reinstall-server
curl -sSL https://fhq.x.kpt.cn/install.sh | bash -s reinstall-client
curl -sSL https://fhq.x.kpt.cn/install.sh | bash -s reinstall
curl -sSL https://fhq.x.kpt.cn/install.sh | bash -s uninstall
fhq update
fhq update --check
fhq update server
curl -sSL https://fhq.x.kpt.cn/update.sh | bash
已自动使用当前域名 https://fhq.x.kpt.cn，详见 完整安装说明
一站式防火墙管理，从 IP 封禁到 AI 智能分析，满足企业级安全需求
手动或批量封禁恶意 IP，支持 CIDR 段，实时同步到所有客户端 iptables
按 User-Agent 特征匹配拦截，支持通配符，nginx map 真正阻断请求
按国家/地区批量封锁，内置 GeoIP 数据库，可视化地图选择
灵活配置端口开放/关闭规则，监控端口连接，异常自动告警
基于访问频率、失败次数等条件自动封禁，可配置阈值与时长
实时 IP 访问统计与排行，可视化图表展示流量趋势
集成 DeepSeek AI，智能分析日志、提取 UA 特征、生成封禁建议
一台服务端管控多台客户端，规则统一下发，状态实时监控
与宝塔面板和平共存，不影响现有 nginx/iptables 配置
集中收集客户端访问日志，支持搜索、过滤与导出
被封禁用户看到自定义 HTML 拦截页面，支持品牌化展示
fhq 命令行工具，支持 status/info/uninstall 等快捷操作
Server + Client 分布式设计，服务端集中管控，客户端执行防火墙规则
浏览器访问 :33022
Go 后端 + React 管理 UI
SQLite 数据库 · JWT 认证
规则同步 · 日志上报
类似宝塔面板，root 权限执行以下命令即可交互式选择安装服务端或客户端
以下命令已自动使用当前域名 https://fhq.x.kpt.cn
curl -sSL https://fhq.x.kpt.cn/install.sh | bash
也可先下载再执行：curl -o install.sh https://fhq.x.kpt.cn/install.sh && bash install.sh
curl -sSL https://fhq.x.kpt.cn/install.sh | bash -s server
export FHQ_SERVER_URL=http://你的服务端:33022
curl -sSL https://fhq.x.kpt.cn/install.sh | bash -s client
curl -sSL https://fhq.x.kpt.cn/install.sh | bash -s client http://你的服务端:33022
curl -sSL https://fhq.x.kpt.cn/install.sh | bash -s reinstall-server
curl -sSL https://fhq.x.kpt.cn/install.sh | bash -s reinstall-client
curl -sSL https://fhq.x.kpt.cn/install.sh | bash -s reinstall
curl -sSL https://fhq.x.kpt.cn/install.sh | bash -s uninstall
fhq update
fhq update --check
fhq update server
curl -sSL https://fhq.x.kpt.cn/update.sh | bash
安装过程支持逐步输入：安装目录、端口、管理员密码、服务端地址等。旧版无在线更新功能的用户请使用「覆盖安装」Tab 升级；已支持 fhq update 的用户也可运行 fhq update 或 fhq reinstall
已安装 FHQ 的服务器可通过以下命令一键升级到最新版本
fhq update
fhq update --check
fhq update server
fhq update client
curl -sSL https://fhq.x.kpt.cn/update.sh | bash
更新源默认 https://fhq.x.kpt.cn，可通过环境变量 FHQ_UPDATE_URL 自定义
下载部署包，root 权限执行安装脚本，即可开始使用
在一台 Linux 服务器上安装管理服务端
tar xf fhq-server.tar.gz
cd server
chmod +x install.sh
./install.sh
在需要防护的服务器上安装客户端 Agent
tar xf fhq-client.tar.gz
cd client
chmod +x install.sh
./install.sh
浏览器访问管理界面，添加客户端并开始防护
http://服务端IP:33022/admin/
默认账号: admin
确保您的服务器满足以下最低配置要求
CentOS 7.9+ 推荐
支持 systemd 的 Linux 发行版
安装脚本需要 root 权限
用于配置 systemd 和 iptables
iptables-services
nginx（UA 拦截功能可选）