Skip to content
DerrorsPublic
forked from luckjiawei/podux

About

A web UI for frpc: manage multiple frps servers, proxies and visitors, with monitoring, alerts, backups and Prometheus metrics. Built on PocketBase and React. Independently maintained fork of luckjiawei/podux.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

 
 

Repository files navigation

简体中文 | English
Logo

Podux

frpc 的 Web 管理面板:在一个界面里管理多台 frps 服务器、全部代理、连接状态和运行日志,不用再手动编辑配置文件。

Release Docker Go frp License

🚀 快速开始  ·  📖 文档  ·  📦 版本发布  ·  🐛 问题反馈

Note

本仓库是 luckjiawei/podux 的独立维护分支,从 v0.2.0 起独立迭代,不再与上游同步。版本、安装包与 Docker 镜像(ghcr.io/derrors/podux)均从这里发布,问题与建议请在本仓库提交。详见与上游的关系。

简介

frp 是常用的开源内网穿透工具,但原生 frpc 只能靠配置文件驱动:每次改动都要编辑 .toml 再重启,同时连多台 frps 时配置容易混乱,也看不到连接状态和延迟。

Podux 把 frpc 作为库内嵌在程序里,后端基于 PocketBase(内置 SQLite),前端基于 React。整个应用打包成一个可执行文件,也提供多架构 Docker 镜像,部署后在浏览器里完成全部配置。

功能特性

  • 多服务器:同时连接多台 frps,每台对应一个独立的 frpc 实例;支持 token / OIDC 认证,tcp、kcp、quic、websocket、wss 传输与 TLS;可开机自动连接
  • 代理管理:可视化配置 TCP、UDP、HTTP、HTTPS、TCPMUX、STCP、SUDP、XTCP 代理,支持子域名与自定义域名、HTTP 访问认证与路径分流、负载均衡、加密压缩、限速、健康检查、9 种插件和有效期;保存时检查端口和域名冲突;支持批量操作和复制;修改后自动热重载,只重启配置有变化的代理
  • 访问端:在本机监听端口,访问其他机器发布的 STCP/SUDP/XTCP 代理,不用在 frps 上开放公网端口
  • 监控与告警:仪表盘与拓扑图;延迟历史曲线和地理位置;读取 frps 管理面板显示每个代理的流量;从外部探测代理是否真的可访问;frpc 日志实时推送、筛选和下载;服务器不可达、代理掉线或外网不可达等异常通过 Webhook(含企业微信、钉钉、飞书)、Telegram、Bark 或邮件通知
  • API 与指标:只读或读写的 API Key,供脚本和 Home Assistant 调用;/api/metrics 提供 Prometheus 指标,可接入 Grafana
  • 导入、导出与备份:导入现有 frpc 的 TOML 配置,导入前可预览并识别重复项;把服务器配置导出为原生 frpc 可用的 frpc.toml;在界面中备份、定时备份和恢复
  • 其他:首次访问引导创建管理员,登录限流;中英文界面、深浅色主题、适配手机

目前不支持 VirtualNet 插件和访问端插件,完整的支持范围见兼容性。

界面截图

仪表盘

更多截图
服务器管理 代理管理
服务器管理:实时延迟与地理位置 代理管理
运行日志 导入 TOML
实时连接日志 导入 TOML 配置
添加代理
添加代理表单

快速开始

创建 docker-compose.yml:

services:
  podux:
    image: ghcr.io/derrors/podux:latest
    container_name: podux
    restart: unless-stopped
    # 使用宿主机网络:代理里的 127.0.0.1 指向宿主机本身
    network_mode: host
    volumes:
      - ./data:/app/pb_data
    environment:
      - TZ=Asia/Shanghai
# 容器以 UID 1000 运行,数据目录需要先交给它
mkdir -p data && sudo chown 1000:1000 data
docker compose up -d

启动后访问 http://<主机>:8090,首次进入会引导创建管理员账号,之后添加服务器和代理即可。

Tip

使用默认的 bridge 网络(-p 8090:8090)时,代理"本地地址"里的 127.0.0.1 指向的是容器自身,而不是宿主机。要转发宿主机上的服务,请使用 host 网络,或在代理中填写宿主机的局域网 IP。

也可以直接运行二进制文件(Linux、macOS、Windows),或参考 Docker 安装使用 docker run。

文档

入门 什么是 Podux · 快速开始 · 兼容性
功能 代理进阶设置 · STCP/XTCP 与访问端 · 流量与可达性 · 告警通知 · API 与指标 · 导出配置
安装 Docker · 二进制
运维 数据与备份 · 升级:Docker / 二进制
问题 常见问题 · Issues
版本 Releases:每个版本的变化说明
开发 贡献指南 · 设计文档

参与贡献

欢迎通过 Issues 反馈问题或提出建议,也欢迎提交 Pull Request。从源码构建、本地开发和提交前检查见贡献指南。

License

Apache License 2.0

(回到顶部)

About

A web UI for frpc: manage multiple frps servers, proxies and visitors, with monitoring, alerts, backups and Prometheus metrics. Built on PocketBase and React. Independently maintained fork of luckjiawei/podux.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages