/* SYSTEM: 内网穿透管理平台 · BLUEPRINT REV 0.5.5 */
基于官方 frps / frpc v0.70.1 构建

内网穿透
管理起来更简单_

Hylintech FRP 是围绕官方 frps / frpc 构建的管理后台与客户端 Agent。 后台统一保存设备与接入配置，Agent 主动连接后台并托管本机 frpc 进程—— FRP 数据流不经过后台 API，性能与官方一致。

下载客户端 查看架构图
AGENT v0.5.5 DESKTOP v0.5.5 FRP 0.70.1 NODE 22+ / 24+ CLIENT CLI · GUI · Desktop
FIG.01 — SYSTEM SCHEMATIC REV 0.5.5 SYS.WIDTH = 520u SERVER NODE.JS · PM2 ADMIN / API 控制面 SQLITE frps 数据面 GO 0.70.1 CLIENT / AGENT AGENT CLI / GUI / Tauri 自动注册设备 在线升级 sha256 frpc 本机托管 内网服务 Local Service 数据流 · 直连 加密控制流 PUBLIC ⇄ AUTHORIZED SERVICES
FIG.01 — 系统分解示意图SCALE 1:1 · UNIT: u
3
类客户端：CLI / GUI / Desktop
4
平台单文件：Win / macOS / Linux ×2
0
运行时依赖：server 与 client 均零依赖
90
天流量与审计日志自动保留
SHEET 02/06
02Architecture · 架构

控制面与数据面，分离设计

Agent 通过 HTTPS 控制连接与后台通信；frpc → frps 的业务数据流直连，不经过后台，保持官方 FRP 的原生转发能力。

公网用户
  • 浏览器 / App / 客户端
  • 访问已授权的内网业务
业务访问
授权直连
服务器 ONLINE
  • 管理后台 Web + REST API（Node.js，零依赖）
  • Agent 控制连接：登录 / 同步 / 调度
  • frps 主进程：由 runner 生成 frps.toml 托管
  • SQLite 存储：设备、接入配置、用户、流量、审计
frpc → frps
业务数据直连
内网客户端机器
  • Agent：CLI / 本地 GUI / Tauri 桌面
  • 自动注册设备、托管本机 frpc 进程
  • 无需公网 IP、无需开放入站规则
  • 目标：本机或内网服务（如 192.168.1.10:8080）
◈ 控制流：Agent → 服务器 API（HTTPS 加密），用于登录换 Token、设备注册/同步、配置下发和流量上报；业务数据始终走 frpc ↔ frps。
SHEET 03/06
03Featured · 精选能力

精选能力，一图看全

从后台管理到免安装分发，再到流量统计与在线升级，一条链路全部覆盖。

ADMIN · 管理端

集中管理后台

用户、设备、接入配置一站式管理：创建用户与资源额度、重置密码、批量下发配置、审计日志，全部通过自带 Web 后台完成。

  • 普通用户只能看到和管理自己的设备与接入配置
  • 管理员可随时修改额度、重置密码或删除用户
  • 删除用户会级联删除其设备与接入配置
用户列表 · USERS
用户额度状态
admin管理员
cokin普通
iot-ops普通
frp-lab普通
TRAFFIC · 流量

流量统计

每 5 分钟采样 frps 管理 API，按日归档并保留 90 天；后台 7/30 天趋势柱状图，客户端面板实时展示今日流量。

  • 防回跳抖动：重启后 3 轮采样仍低则判定计数重置并收敛
  • 全局与个人 ↑入 ↓出 今日流量双色展示
  • 按日期补零，跨天自然翻页，历史可查
流量趋势 · 7 DAYS
一
二
三
四
五
六
日
入站流量出站流量峰值 · 周六
SECURITY · 安全

安全加固

口令哈希 + 会话/设备 Token 鉴权、登录失败限流、安全响应头与 CSP、异常统一响应不泄露细节，SQLite 每日一致性快照备份。

  • 15 分钟窗口内 10 次失败即锁定，支持反向代理取真实 IP
  • 网页 CSP：default-src 'self'，API 全量安全头
  • 审计日志、会话、流量自动过期清理（默认 90 天）
安全基线 · CHECKLIST
  • ✓Token 鉴权 · 会话 8h
  • ✓失败限流 · 锁定 15min
  • ✓CSP + 安全响应头
  • ✓每日快照备份
  • ✓审计日志 90 天
DEPLOY · 分发

免安装单文件

Rust Agent 编译为免 Node.js 的单文件，内嵌 frpc；Linux x64 / ARM64 / ARMv7 可直接从本页下载。目标机器零安装。

  • 首次运行自动生成配置模板，登录后即可注册并托管本机 Agent
  • Tauri 桌面应用：双击图标，窗口内直接登录注册
  • 构建：build-client-cli.sh / build-client-desktop.mjs 分别生成 CLI 与桌面包
hylintech-frp · linux-x64
$ ./client/dist/hylintech-frp-linux-x64
✔ 生成 config.json 模板（JSONC）
# 编辑后重启
✔ 登录管理后台 → 注册设备 AAA01
✔ frpc 0.70.1 已解压到 agent-data/bin/
✔ Agent 已上线，本机服务托管就绪
SHEET 04/06
04More · 更多能力

更多能力，逐项核验

完整能力清单，像图纸明细表一样逐项核对。

01

设备自动注册

按「用户 + Host ID + 系统主机名」自动注册 / 复用设备；同一主机重登即刷新 Token，旧 Token 立即失效。

Auto Register多端登录
02

零入站暴露

客户端主动连接后台，内网无需公网 IP，也无需开放入站防火墙规则。

内网友好Outbound Only
03

在线升级

启动 8 秒后自动检查更新，之后每 24 小时轮询；SHA-256 校验后替换并自动重启，支持 CLI 与桌面内嵌版。

Auto UpdateSHA-256
04

本地 GUI 与桌面

本地控制面板仅 127.0.0.1 可访问并带随机 Token 鉴权；Tauri 桌面应用双击即用，窗口内完成登录注册。

Local GUITauri
SHEET 05/06
05Download · 客户端下载

选择系统架构，直接获取

Linux 版本为内嵌 frpc 的免安装单文件，下载后添加执行权限即可运行。Windows x64 安装包与 macOS Apple Silicon 安装镜像已发布。

Linux
Available
ARMv7 · 32-bit

适用于 armv7 / armhf Linux 设备。

下载 ARMv7
Linux
Available
x64 · x86_64

适用于常见 64 位 x86 服务器与主机。

下载 x64
Linux
Available
ARM64 · aarch64

适用于 ARM64 服务器、开发板与 NAS。

下载 ARM64
Windows
Available
x64 · Setup ZIP

适用于 64 位 Windows 桌面系统的安装包。

下载 Windows x64
macOS
Available
Apple Silicon · aarch64 · DMG

适用于 Apple Silicon（M 系列）Mac 的安装镜像。

下载 macOS ARM64
LINUXcurl -fsSL <下载地址> -o hylintech-frp && chmod +x hylintech-frp && ./hylintech-frp --tui
WINDOWS 注意事项Windows Defender 可能拦截或隔离 frp。如无法启动，请在「Windows 安全中心 → 病毒和威胁防护 → 管理设置 → 排除项」中放行 Hylintech FRP 安装目录及 frp 相关程序，然后重新运行。
SHEET 06/06
06Quick Start · 快速开始

下载后直接上手

客户端接入、单文件与桌面应用构建，任选其一。

预编译 Linux 单文件 — 下载并启动 Rust AgentREV A
# 1. 下载对应架构的单文件（这里以 Linux x64 为例）
curl -fsSL https://public.hylintech.com/hylintech/tools/frp/hylintech-frp-linux-x64-musl \
  -o hylintech-frp

# 2. 添加执行权限；首次运行打开 TUI 并自动生成配置
chmod +x hylintech-frp
./hylintech-frp --tui
Rust Agent 身份AUTO
设备唯一 ID：Linux 优先使用 machine-id 的 SHA-256；其他平台自动生成持久化 Host ID
设备名称：自动读取系统 hostname，不接受手工覆盖
设备状态：登录后注册 / 复用设备，Token 保存在 Agent 数据目录
TIPSCLI、GUI、Windows/macOS Agent 与 Tauri 桌面端共享同一个 Rust 核心；提供 TUI 与本地控制面板，可在窗口内完成登录、注册与本机托管配置。
scripts/ — 构建免 Node.js Rust 单文件REV A
./scripts/build-client-cli.sh --linux-x64 # Rust CLI；产物：release/client/cli/linux-x64/

# 目标机器直接运行，首次运行自动生成 config.json 模板
./release/client/cli/linux-x64/hylintech-frp-linux-x64-musl --tui
scripts/ — CLI 与桌面端分开构建REV A
./scripts/build-client-cli.sh --linux-x64
# ARM64: ./scripts/build-client-cli.sh --linux-arm64
# macOS/Windows 桌面端：
./scripts/build-client-desktop.mjs --macos-arm64
TIPS单文件内嵌 frpc，目标机器无需安装 Node.js；桌面应用基于 Tauri，双击图标即可打开内置控制面板并登录注册本机。
SHEET 07/07
07Tech Stack · 技术栈

精简而现代的技术栈

客户端运行时零依赖；构建期只引入必要的打包工具。

FRP
frpc 0.70.1
官方 Go 版 FRP 客户端组件，由 Agent 内嵌托管
TAU
Tauri 2 + Rust
macOS / Windows 桌面应用，体积小启动快
RUST
Rust + Cargo
CLI、GUI、桌面端共用原生 Agent 核心，内嵌 frpc
TST
Rust Tests
Rust Agent 单元测试覆盖核心逻辑