Repository navigation
Releases
Releases · Derrors/podux
v0.2.12
新功能
- 服务器表单的「frps 管理面板」新增「通过公网 HTTPS 探测」开关。frps 前面有 HTTPS 反向代理、vhost 端口不对外开放时打开,http/https 代理改为探测其域名的 443 端口(http 代理发送 HTTPS 请求),不再连接 frps 的 vhost 端口。
- 反向代理透传 frps 的 404 页面,或返回 502/503/504 时,仍判定为不可达;不校验证书,只确认隧道有应答。
- 该开关只是 Podux 自己的设置,不会写入 frpc 配置,切换时也不会重启 frpc。
升级说明
- 新增数据库迁移
1794051661_server_probe_public_https,为服务器增加probePublicHTTPS字段,默认关闭,已有服务器的探测方式不变;回滚迁移只删除该字段。 - 容器或进程重启会短暂中断隧道。升级前建议备份数据目录,升级完成后刷新浏览器以加载新界面。
文档:https://derrors.github.io/podux/
Full Changelog: v0.2.11...v0.2.12
v0.2.11
界面修复
- 网络拓扑恢复完整的多服务器总览,直接展示所有代理与访问端连接,移除服务器筛选、默认折叠和每页 10 条连接的限制。
- 移除内嵌拓扑上方新增的工具栏及分页区域,恢复原来的展示布局与节点尺寸;页面内滚轮和触摸仍用于滚动页面。
- 全屏保留拖动、缩放、连接状态说明及完整表格视图,修复窄屏下表格撑宽全屏弹窗的问题。
回归保障
- 保留拓扑懒加载、未变数据复用、可视区域渲染及根错误边界,不撤回 v0.2.10 的后端安全与稳定性修复。
- 增加完整拓扑、全屏切换、全部连接表格以及 Radix 字号、间距和组件尺寸等价测试。
- 与 v0.2.9 的桌面/窄屏、亮色/暗色页面对照中,公共字号和组件尺寸保持一致;本次不引入额外的全局缩放。
升级说明
- 从 v0.2.10 升级无新增数据库迁移;升级前仍建议备份数据目录。
- 容器或进程重启会短暂中断隧道。升级完成后刷新浏览器以加载新界面。
文档:https://derrors.github.io/podux/
Full Changelog: v0.2.10...v0.2.11
v0.2.10
修复与安全加固
- 修复首次初始化、并发代理/访问端保存及临时代理续期的竞态,避免重复初始化、冲突配置落库或旧快照覆盖新设置。
- 统一 frpc 配置转换、默认值和敏感字段处理;修复日志及默认导出中的凭据泄露,关闭 TLS 后不再导出残留密钥。
- 插件证书采用记录 ID 和内容摘要命名、受限目录及原子写入;证书更新能够触发插件重建。
- 修复 token-only 认证导入、覆盖导入残留插件/回退配置,以及同文件私密代理与访问端目标名称映射。
- 修复启动期间配置变更丢失;运行状态由生命周期统一维护,配置保存不再覆盖较新的运行状态。
稳定性与性能
- frps 管理面板改为后台有界刷新,仪表盘、状态和 Prometheus 请求读取缓存快照,不再等待慢远端;刷新失败保留上次数据并返回刷新状态。
- 移除监控及服务器选项的 500 条截断,增加分页、有界并发、批量写入和取消等待;延迟热缓存读取不再扫描历史数据。
- 指标增加时间索引和持久化聚合水位,启动时补算已完成的小时/日数据,补算成功后才清理来源数据。
- 备份恢复改为持久后台任务,明确区分排队、运行、重启、成功和失败,不再用健康检查误判恢复成功。
- 通知使用有界队列和固定工作线程,避免异常期间无限创建后台任务。
界面优化
- 新增应用错误边界;失效的 JS/CSS 资源支持手动刷新恢复,不会自动刷新循环。
- 仪表盘统计与拓扑独立加载,拓扑支持按服务器选择、折叠和分页,并提供表格视图。
- 拆分图表依赖并裁剪未使用的 Radix 色系,CSS gzip 总体积由约 88.66 kB 降至 69.57 kB(减少 21.5%)。
升级说明
- 启动时自动执行新增迁移,添加指标聚合水位、延迟地址变更边界及索引。升级前请备份整个数据目录;回滚版本时同时恢复升级前的数据备份。
- 修改运行中服务器的地址、认证、传输等公共配置会自动重启对应 frpc,隧道短暂中断;代理/访问端配置仍使用热重载。
- 覆盖导入会清除文件中省略的原生可选配置,不再只合并非空字段;Podux 备注和自动连接设置保持不变。
- 恢复接口返回任务信息,自定义客户端应查询恢复任务状态,而不是轮询健康检查;等待超时不表示恢复已取消。在线恢复仍不支持 Windows。
- 已通过全量 Go 竞态测试、前端 158 项测试、隔离真实 frps 端到端和迁移升级/回滚回归;尚未进行生产数据副本验收或生产规模压测。
文档:https://derrors.github.io/podux/
Full Changelog: v0.2.9...v0.2.10
v0.2.9
新功能
- 新增按代理控制的「外网可达性探测」开关,默认开启;可单独关闭 SSH 等代理的公网探测,保留穿透、本地 healthCheck、流量统计和历史。
- 关闭探测后取消在途任务、清理旧结果和相关告警,列表显示「探测已关闭」,不再输出该代理的可达性指标;重新开启后从新一轮重新探测。
- 单独切换探测开关不会重载 frpc;编辑和复制代理会保留开关状态。
优化与修复
- 公网探测按服务器错峰执行,最多 4 并发,启动间隔至少 250ms,减少集中短连接引起的 FRP 工作连接池溢出;慢轮次不重叠、不追赶补发。
- 服务停止时取消并等待探测退出,取消不再误报为不可达;防止关闭后迟到结果恢复旧状态。
- 修复子域名代理未按 frps 的 subdomainHost 展示完整域名。
升级说明
- 启动时自动添加 probeDisabled 字段,旧代理默认仍开启探测;升级前建议备份数据目录。
- 如需停止 SSH 公网探测:编辑对应 TCP 代理,在「网络配置」中关闭「外网可达性探测」。此选项独立于 frpc 的 healthCheck。
文档:https://derrors.github.io/podux/
Full Changelog: v0.2.8...v0.2.9
v0.2.8
新功能
- API Key 与 Prometheus 指标:在「设置 → API」中创建只读或读写的 API Key,供脚本、Home Assistant 或 Prometheus 使用;Key 只保存哈希,只显示一次
- 只读 Key 可读取
/api/metrics、仪表盘统计和代理状态;读写 Key 还可以启动、停止、重载 frpc 和批量操作代理 - Key 不能当作登录身份,无法访问设置、备份、集合接口和 Key 管理,拿不到 frps token 等敏感配置
/api/metrics提供服务器运行状态和延迟、代理在线和外网可达性,配置了 frps 管理面板时还有今日流量和连接数;设置页可一键复制抓取配置
- 只读 Key 可读取
- 服务器认证支持 OIDC:客户端凭据模式登录 frps,可配置 Scope、附加请求参数、令牌端点的 CA 证书和跳过证书校验;保存前按 frp 的规则校验
- 附加认证范围:token 和 OIDC 都可以让心跳、新建工作连接也携带认证信息,对应 frps 的
auth.additionalScopes
修复
- frpc 启动日志中的 OIDC 客户端密钥未脱敏
- 导入 frpc.toml 时
[auth.oidc]配置丢失;现在会一起导入 - 切换认证方式后,另一种方式的旧配置仍会发给 frp 并出现在导出中
- 设置页在手机上没有适配,内容超出屏幕;现在侧栏会变成顶部标签
- 导入说明和提示中过时的「不支持 TCPMUX」
文档:https://derrors.github.io/podux/
Full Changelog: v0.2.7...v0.2.8
v0.2.7
优化
- 仪表盘的网络拓扑不再拦截页面滚动:在图上滚动鼠标滚轮、触控板或手机手势时页面正常滚动,不会误触缩放
- 网络拓扑右上角新增「全屏查看」,在全屏中可拖动画布、滚轮或双指缩放,并提供放大、缩小、适应画布按钮;按 Esc 关闭
文档:https://derrors.github.io/podux/
Full Changelog: v0.2.6...v0.2.7
v0.2.6
修复
- 仪表盘的统计卡片高度不一致:未配置 frps 管理面板时,"今日流量"卡片的提示文字换行,把卡片撑高
- "今日流量"同时显示入站和出站时放不下卡片,会被截断;现在显示今日总流量,入站和出站的拆分在悬停时显示
- 所有统计卡片统一撑满行高,过长的数值会截断,同一行不再参差不齐
文档:https://derrors.github.io/podux/
Full Changelog: v0.2.5...v0.2.6
v0.2.5
新功能
- HTTP 代理进阶设置:访问密码(HTTP Basic)、按用户分流、改写 Host、按路径分流、自定义请求头和响应头
- TCPMUX 代理:多个 TCP 服务按域名共用 frps 的一个端口
- 负载均衡:TCP、HTTP、TCPMUX 代理可加入分组,同组代理共用端口或域名,配合健康检查实现主备
- 插件:新增 HTTP Proxy、Static File、Unix Socket、HTTP2HTTP、HTTP2HTTPS、HTTPS2HTTP、HTTPS2HTTPS、TLS2Raw;HTTPS 类插件可直接粘贴证书
- XTCP 回退:直连失败时自动改走 STCP 访问端;STCP 访问端可设为不监听端口
- 临时代理:设置有效期,到期自动停用并通知
- 批量操作与复制:代理列表批量启用、停用、迁移、删除(全部成功或全部不改),一键复制代理
- 流量统计:配置 frps 管理面板后,显示每个代理的今日流量、连接数和近 7 天流量图,以及 frps 状态
- 外网可达性探测:每分钟从外部探测 TCP/HTTP/HTTPS 代理,连续 3 次失败时告警
- 备份与恢复:在设置中立即备份、定时备份、上传、下载和恢复
- 日志:按级别筛选、搜索、下载,新增"全部日志"页面
- 仪表盘:显示访问端和今日流量,拓扑图加入访问端
修复
- 每日监控汇总只保存了平均值,最大值和最小值未写入
升级
- PocketBase 升级到 v0.41.1,Go 模块已迁到 ganigeorgiev.com(PocketBase 已离开 GitHub)
- 启动时自动迁移数据库:端口字段改为数字,删除未使用的 fh_version 集合,合并重复的监控记录并加唯一约束,新增代理选项、有效期、访问端回退和 frps 面板字段。回滚到 v0.2.4 时请同时恢复升级前的数据备份
- CI 新增端到端测试,使用真实 frps 验证隧道、插件、备份恢复和告警
文档:https://derrors.github.io/podux/
Full Changelog: v0.2.4...v0.2.5
v0.2.4
新功能
- STCP / SUDP / XTCP 代理:不在 frps 上开放公网端口,只有持有相同密钥的访问端才能连接;XTCP 会尝试点对点直连
- 访问端(visitor):新增"访问端"页面,在本机监听端口访问其他机器发布的 STCP/SUDP/XTCP 代理;可以从 Podux 里已有的代理一键填入
- 限速与健康检查:代理表单可设置带宽限制(本机或 frps 限速)和 TCP/HTTP 健康检查
- 冲突检查:保存或启用代理时,检查同一服务器上的远程端口、子域名、自定义域名是否重复;访问端检查本机监听端口是否重复,并指出冲突对象
- 告警通知:frps 不可达、延迟过高、代理掉线、frpc 意外退出时发送通知,恢复后再通知一次;支持 Webhook(通用 JSON、企业微信、钉钉、飞书)、Telegram、Bark、邮件,可发送测试消息
- 导出配置:在服务器详情页把当前配置导出为原生 frpc 可用的 frpc.toml,敏感信息默认打码
- 导入:TOML 导入支持 STCP/SUDP/XTCP 代理、[[visitors]] 访问端、健康检查和限速
修复
- 设置页始终显示默认值,保存的延迟和位置检测间隔从未生效
- 保存"常规"设置会丢失安装时选择的默认语言
升级
- PocketBase 升级到 v0.40.6(包含上游安全修复),编译要求 Go 1.27
- 启动时会自动迁移数据库:代理新增类型和字段、新增访问端集合、设置新增通知配置。回滚到 v0.2.3 时请同时恢复升级前的数据备份
文档:https://derrors.github.io/podux/
Full Changelog: v0.2.3...v0.2.4
v0.2.3
修复
- 代理的"描述"填写后保存不下来:数据库缺少这个字段,现在通过迁移补上
- 服务器页搜索包含
%时,列表显示全部服务器,与总数不一致
改进
- 文档站发布到 https://derrors.github.io/podux/ 。README 精简,安装、升级、兼容性、数据与备份等内容移到文档站,新增贡献指南(CONTRIBUTING)
- 修正文档里会导致部署出错的说明:systemd 示例没有指定
--dir,数据会写到程序所在目录;挂载的./data目录需要属于 UID 1000;PocketBase 超级管理员的创建方式 deploy/docker-compose.yml改为 host 网络和./data挂载,与文档一致- 开放 GitHub Issues,提供问题反馈和功能建议模板
- 移除文档站里上游的推广链接、侧边栏广告和访问统计脚本
- 清理服务器列表接口和个人资料页里不存在的字段
- 新增 HTTP 接口测试,CI 增加文档站构建
升级提示
- 启动时会自动迁移数据库(为代理新增描述字段)。回滚到 v0.2.2 时,请同时恢复升级前的数据备份
Full Changelog: v0.2.2...v0.2.3