Skip to content

什么是 Podux? ​

Podux 是一个现代化的 frpc 管理平台,基于 PocketBase 和 React 构建,提供可视化界面来管理内网穿透服务。

名称由来 ​

Podux = proxy + port + dux(拉丁语:领导者、引导者)

这个名字本身就是一份宣言:不只是一个工具的前端,而是一个统一管理隧道工具的平台。

为什么从 frpc-hub 改名? ​

Podux 的前身是 frpc-hub,最初专为管理 frpc 而生。随着项目的成长,目标逐渐清晰 —— 不只是 frp,而是成为支持多种隧道工具的统一管理平台。

frpc-hub 这个名字将项目与单一工具绑定,无法承载更大的愿景。Podux 代表的是面向未来的设计:一个可以容纳更多隧道协议与工具的统一入口。

改名发生于 2026 年 3 月,仓库地址及所有相关引用均已同步更新。

背景 ​

frp 是目前最流行的开源内网穿透工具之一,其客户端 frpc 通过配置文件(.toml / .ini)与服务端 frps 建立隧道,将内网服务暴露到公网。

然而,原生 frpc 的使用方式存在一些痛点:

  • 纯配置文件驱动:每次修改都需要手动编辑文件并重启进程
  • 多服务器管理困难:同时维护多个 frps 服务端时,配置容易混乱
  • 缺乏可视化监控:无法直观查看连接状态和延迟情况
  • 运维成本高:升级、备份、迁移全靠手动操作

Podux 正是为解决这些问题而生。

核心能力 ​

服务器管理 ​

集中管理多个 frps 服务器,支持:

  • 每台服务器对应一个独立的 frpc 实例,可单独启动、停止
  • token 与 OIDC 认证;tcp、kcp、quic、websocket、wss 传输协议,可配置 TLS 证书
  • 开启"自动连接"的服务器在 Podux 启动时自动上线
  • 定时探测延迟并保留历史曲线,显示服务器地理位置
  • 删除服务器时一并清理其代理和监控数据

代理管理 ​

通过可视化表单创建和管理代理隧道,支持以下代理类型:

类型说明
TCP通用 TCP 端口转发
UDPUDP 流量转发
HTTPHTTP 反向代理
HTTPSHTTPS 反向代理
STCP / SUDP不开放公网端口,只有持有密钥的访问端才能连接
XTCP同上,并尝试点对点直连,流量不经过 frps
TCPMUX多个 TCP 服务按域名共用 frps 的一个端口

每个代理还可以设置加密、压缩、限速、健康检查、HTTP 访问认证与路径分流、负载均衡分组、插件(SOCKS5、静态文件、HTTPS2HTTP 等)和有效期,见代理进阶设置。保存时会检查端口和域名冲突,并在表单中指出冲突的代理;代理列表支持批量启用、停用、迁移和删除。

访问端 ​

在本机监听端口,访问其他机器发布的 STCP/SUDP/XTCP 代理,见 STCP/XTCP 与访问端。

告警与导出 ​

  • 读取 frps 管理面板显示每个代理的流量,并从外部探测代理是否真的可以访问,见流量与可达性
  • 服务器不可达、延迟过高、代理掉线或外网不可达、frpc 意外退出时,通过 Webhook(含企业微信、钉钉、飞书)、Telegram、Bark 或邮件通知,见告警通知
  • 把服务器的配置导出为原生 frpc 可用的 frpc.toml,见导出配置
  • 用 API Key 让脚本和 Home Assistant 调用,/api/metrics 提供 Prometheus 指标,见 API 与指标
  • 在界面中备份、定时备份和恢复全部数据,见数据与备份

热重载 ​

修改代理或访问端后,Podux 会自动触发 frpc 重载,无需手动重启。只有配置发生变化的代理会重启,同一服务器上的其他代理不受影响。

现代化界面 ​

基于 Radix UI 组件库和 Tailwind CSS 构建,界面简洁美观,支持中英文切换。

技术架构 ​

text
浏览器 (React)  ──HTTP──▶  Podux (PocketBase + 内嵌 frpc)  ──隧道──▶  frps(自行部署)
                                    │
                                    └── pb_data/:SQLite 数据库、frpc 日志与证书
  • 前端:React + Radix UI + Tailwind CSS,打包后嵌入可执行文件
  • 后端:PocketBase,内置 SQLite,负责账号、数据存储和 API
  • frpc:作为 Go 库内嵌在 Podux 进程中,每台服务器一个实例,不需要单独安装 frpc

Podux 以单一可执行文件的形式分发,内嵌了 PocketBase 后端与前端资源,开箱即用,无需额外依赖。

与手动管理对比 ​

对比项手动管理 frpcPodux
配置方式编辑 .toml 文件可视化表单
重载配置手动重启进程自动热重载
多服务器维护多份配置文件统一界面管理
状态监控查看日志实时监控面板
跨平台部署需配置环境单文件,开箱即用

适用场景 ​

  • 开发者:快速将本地开发环境(Web 服务、数据库、SSH 等)暴露到公网进行调试或演示
  • 运维人员:统一管理多台机器的内网穿透配置,降低运维复杂度
  • 个人用户:无需记忆复杂的配置语法,通过界面轻松配置家庭服务器、NAS、远程桌面等

与上游的关系 ​

  • Podux 最初由 luckjiawei(刘嘉伟)创建,前身名为 frpc-hub。Derrors/podux 以上游 v0.1.6 之后的代码为基础分出,从 v0.2.0 开始独立维护。
  • 之后的功能、修复与版本节奏由本仓库自行决定,不保证与上游行为或版本号一致,也不会定期合并上游改动。
  • 本仓库的 Docker 镜像为 ghcr.io/derrors/podux,与上游镜像不同;从上游版本迁移时,沿用原有的数据目录即可。
  • 感谢原作者的工作。项目沿用 Apache 2.0 许可证,原有版权声明保持不变。

下一步 ​

基于 Apache 2.0 协议开源