webui4frpc/FRPC_FEATURES_AUDIT.md

webui4frpc 对 frpc 高级功能支持审查报告

审查基准：frp v0.71 的 frpc 配置能力（官方文档支持的 proxy 类型、认证、传输、插件等）。 审查范围：当前 webui4frpc 的画布数据模型（Local/Remote/Link）、渲染器（internal/render）能表达和输出什么。

一、总体结论

当前实现聚焦「最小可用」：TCP/HTTP 单端口转发 + token 认证 已打通并验证（多个远程节点、多对多连线、真实连通）。但 frpc 的大部分高级能力尚未建模，且已有能力因模型缺字段而不可配置。适合作为 1.0 基线，但要覆盖更广使用场景需系统性扩展。

二、能力支持矩阵

2.1 代理类型（proxy type）

类型	状态	说明
tcp	✅	完整支持（LocalIP/LocalPort/RemotePort）
udp	🟡 部分	渲染支持，但协处理器（KCP/加密等）未建模
http	🟡 部分	支持 customDomains 默认域名，但无法配置 locations/headers/负载均衡
https	🟡 部分	同 http，未建模证书/SNI
stcp	❌	加密点对点穿透完全不支持
sudp	❌	同 stcp
xtcp	❌	P2P TCP 模拟（依赖 kcp-go），不支持
tcpmux	❌	HTTP/2 多路复用（multiplexer/http2），不支持

2.2 认证（auth）

能力	状态	说明
服务端 token	✅	Remote 有 Token 字段
OIDC	❌	frpc 支持 openid connect（coreos/go-oidc），未建模
TLS 客户端证书	❌	未建模

2.3 传输（transport）

能力	状态	说明
tcp / kcp / websocket / quic	🟡	Remote 无 protocol 字段，无法选择
加密 / 压缩（useEncryption/useCompression）	❌	未建模
带宽限制（bandwidthLimit）	❌	未建模
连接池（poolCount）	❌	未建模
TLS 传输（transport.tls.enable）	❌	未建模
Connect Server 超时/重连	❌	未建模（有默认值）

2.4 负载均衡与健康检查

能力	状态	说明
多个 local 提供同一组（group/loadBalancer）	❌	未建模 group/groupKey
health check（tcp/http，失败剔除）	❌	未建模 HealthCheckConfig

2.5 域名与路由（http/https）

能力	状态	说明
customDomains 多域名	🟡	可输出，但画布 local 无域名字段（写死 name.local）
subdomain	🟡	render 支持生成，但依赖服务器 subdomain_host（演示环境未启用）
locations（路径路由）	❌	未建模
httpHeader 改写 / hostHeaderRewrite	❌	未建模
basicAuth（站点访问认证）	❌	未建模

2.6 插件（plugin）与虚拟 IP

能力	状态	说明
client plugin（http2https/static/server 等）	❌	未建模
vmnet（虚拟 IP）	❌	未建模

2.7 其它

能力	状态	说明
元数据 metadatas / annotations	❌	Remote 有 URL 但无 metadatas
start (enabled 控制)	✅	Remote 有 Enabled
全局配置（byteLimit 等）	❌	未建模

三、具体缺口细节

1. Local/Remote 模型过简：Local 只有 name/ip/port/protocol；缺 encryption/compression/bandwidth/plugin/metadatas/域名/路径/健康检查等。Remote 缺 protocol(kcp/quic/ws)、tls、oidc、pool 等。
2. 渲染器只输出 6 个字段：brpcProxy 仅 name/type/localIP/localPort/remotePort/customDomains/subdomain。transport 段只有空 protocol，frpc 其它传输参数全部缺失。
3. 画布节点编辑只暴露 ip/port/协议：连已有的 token/url 也只在部分入口可编辑，更别说高级字段。
4. udp 渲染无 UDPPacketSize 等、https 无证书流程。

四、用户实际会遇到的典型场景覆盖

场景	现状
内网 Web 服务对外（http+tcp）	✅ 覆盖
普通 TCP 服务（数据库/SSH/自建协议）	✅ 覆盖
加密内网通信（stcp/sudp）	❌ 若用户需要点对点加密穿透则无法完成
多域名多路径挂多个站点到一台 frps	🟡 部分（域名选择没做）
限速 / 压缩 / 加密传输	❌
负载均衡 / 健康检查	❌
kcp/quic 弱网优化	❌

五、优先级建议

优先级	项	理由
P0	画布冲突检查（本次已实现）	防止重复 remotePort / 域名重复导致配置直接失败
P0	Local 增加「连接参数」高级区：encryption / compression / bandwidthLimit / poolCount / metadatas	高频项，改动小（渲染器 + 表单）
P1	Remote 增加 transport 选择：protocol(tcp/quic/kcp/websocket) 、tls.enable、poolCount	让 kcp/quic/web 场景可用
P1	local http/https 增加域名字段（customDomains/subdomain 可编辑）+ locations	覆盖多站点部署
P2	健康检查 / 负载均衡（group）	中频
P2	插件 stub / 虚拟 IP	低频，且 UI 复杂
P3	OIDC / TLS 证书 / 高级插件	低频，可延后

六、结论

webui4frpc 已具备生产可用的核心（tcp/http 多节点多对多转发 + 状态页 + worker 管理），且面向「避免运维手写配置」的目标价值明确。但要覆盖 frpc 完整能力需分阶段补齐：先做 P0（冲突检查已做）+ P0 高级传输参数建模，再逐级推进，避免一上来堆字段导致画布复杂化。建议 UI 采用「折叠高级区」或「按类型动态显示字段」，保持画布简洁。