-Fonu/CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

[v1.5.1] - 2026-09-28

变更

• P1-1 共享 Nginx 模板包：新增纯生成包 internal/nginxtmpl，统一 TLS 指令、安全响应头、allow / deny、WebSocket 头、限流指令与 zone 命名；本机 internal/nginx 与公网 Agent 均改为调用共享函数，重复模板实现已删除
• 安全响应头对齐：两端统一输出 HSTS、X-Content-Type-Options、X-Frame-Options、Referrer-Policy，本机此前缺少 Referrer-Policy
• 访问控制顺序统一：统一为黑名单 deny → 仅大陆规则 → 白名单 allow → deny all，黑名单优先匹配
• TLS 指令显式化：两端统一显式输出 ssl_protocols TLSv1.2 TLSv1.3 或 TLSv1.3
• 版本号提升到 1.5.1；AgentVersion 0.14.0 → 0.14.1，内嵌 amd64 / arm64 二进制已重编；VPS 上需点一次「升级 Agent」才会生效

测试

• internal/nginxtmpl：新增共享函数的 TLS、安全头、访问控制、限流、zone 与 WebSocket 特征化测试
• internal/nginx：本机生成测试继续通过；internal/agent：新增 vhost 顺序与共享语义测试

[v1.5.0] - 2026-09-28

新增

• HTTPS 直连端口自动选择：Agent 在 7443 / 8443 / 9443 中逐个尝试可用端口，每轮都会写配置、reload 并做本机证书自检；全部失败时返回每个端口的具体原因。显式传入端口时仍按指定值执行，443 可通过接口显式指定
• 证书自动轮换：证书有效期 365 天，剩余 30 天时后台自动生成新证书并通过当前连接安装；过渡期 7 天内客户端同时接受新旧 pin，避免轮换瞬间连接失败。旧记录缺少到期信息时，先从 Agent 读取当前证书到期时间再决定是否轮换
• 主机防火墙辅助：Agent 新增防火墙检测与显式放行接口，支持 ufw / firewalld 自动放行；nftables / iptables 只检测和提示，不自动修改规则。Agent 页增加「检测主机防火墙 / 放行主机防火墙」
• 隧道后台保活与重连：隧道启动后每 30 秒保活，断线按 1 秒到 60 秒指数退避重建，不再只在有流量时才尝试重连
• 传输详细状态接口：GET /api/frpmulti/servers/{id}/agent/transport 返回 transport、状态、端口、pin、证书到期时间与防火墙状态
• 审计记录：transport 切换、证书轮换、防火墙放行写入 AUDIT 日志，包含 admin_id、server_id 与来源地址
• 证书 SAN 校验：pin 校验同时校验证书 SAN 与连接主机一致

变更

• 版本号提升到 1.5.0；web/package.json 与 web/package-lock.json 同步对齐
• AgentVersion 0.13.3 → 0.14.0，内嵌 amd64 / arm64 二进制已重编；VPS 上需点一次「升级 Agent」才会生效
• Agent 页轮询改用 useVisibilityPolling，页面隐藏时暂停

测试

• internal/frp：新增多 pin 过渡、SAN 拒绝、端口解析与轮换兼容测试
• internal/agent：新增 ufw 解析与候选端口测试
• internal/frp：隧道退避策略单元测试

[v1.4.6] - 2026-09-28

修复

• HTTPS 直连证书指纹不匹配可定位：nginx 配置校验通过、但公网 7443 返回的证书与刚写入的不一致时，原来只提示“证书指纹不匹配”，无法判断是 nginx 未生效还是端口被其他服务接管。现在 HTTPS server 使用 default_server 绑定，Agent 会在 reload 后从本机 127.0.0.1:<端口> 握手自检并重试 5 秒；指纹不一致时回滚，并回报实际指纹与 ss -tlnp 端口占用进程
• 公网链路错误提示：主程序在 Agent 本机自检通过、但公网地址校验失败时，会明确提示检查 7443 的端口转发、防火墙或其他服务接管

变更

• 版本号提升到 1.4.6；web/package.json 与 web/package-lock.json 同步对齐
• AgentVersion 0.13.2 → 0.13.3，内嵌 amd64 / arm64 二进制已重编；VPS 上需重新点一次「升级 Agent」才会生效

测试

• internal/agent：新增证书 PEM 指纹计算测试

[v1.4.5] - 2026-09-28

修复

• Agent 探测阶段无法自愈 nginx 残留目录：0.13.1 的迁移只在配置目录已知或 nginx -t 校验前执行；当 nginx -T 在探测目录阶段就因 .versions 目录失败时，Agent 仍返回 nginx -T 执行失败: exit status 1。现在会先从 nginx -T 报错文本解析出 <配置>.versions 路径并迁移，再重试一次；安装 / 升级 Agent 的脚本也会先把 sites-enabled、conf.d 下的旧 .versions 目录移出 include 范围

变更

• 版本号提升到 1.4.5；web/package.json 与 web/package-lock.json 同步对齐
• AgentVersion 0.13.1 → 0.13.2，内嵌 amd64 / arm64 二进制已重编；VPS 上需重新点一次「升级 Agent」才会生效

测试

• internal/agent：新增从 nginx 报错文本解析并迁移旧版本目录的测试
• scripts/agent-install.sh：bash -n 语法校验通过

[v1.4.4] - 2026-09-28

修复

• Agent nginx 版本目录被误加载：切换 HTTPS 直连时，配置备份会写到 <配置文件>.versions 目录；该目录位于 sites-enabled 时会被 nginx 的 include .../sites-enabled/* 当成配置文件读取，导致 nginx -t 报 pread() ".../fonuagent-https.conf.versions" failed (21: Is a directory)。现在版本目录改为隐藏目录 .<文件名>.versions，include * 不再匹配；旧目录会在读取、备份或 nginx -t 前自动迁移，历史版本内容保留

变更

• 版本号提升到 1.4.4；web/package.json 与 web/package-lock.json 同步对齐
• AgentVersion 0.13.0 → 0.13.1，内嵌 amd64 / arm64 二进制已重编；VPS 上需点一次「升级 Agent」才会生效

测试

• internal/fsutil：新增隐藏版本目录与旧目录迁移测试
• internal/agent：新增 migrateLegacyVersionDirs 迁移测试

[v1.4.3] - 2026-09-28

修复

• HTTPS 直连旧地址自愈：从 SSH 隧道切换到「HTTPS + 证书固定」后，历史实例的 agent_url 可能仍为已失效的 http://127.0.0.1:17701，隧道关闭后直接报 connection refused。现在读取 HTTPS transport 时会依据 ssh_host 与 agent_listen_addr 自动重建 https://<host>:<port>，并在地址变化时回写数据库；切回 SSH 隧道也使用同一重建逻辑，无需手工修改地址

变更

• 版本号提升到 1.4.3；web/package.json 与 web/package-lock.json 同步对齐
• AgentVersion 保持 0.13.0

测试

• internal/frp：新增 TestAgentHTTPSBaseURL，覆盖旧隧道地址重建、已是 HTTPS 地址保持、默认端口回退与缺少 SSH 主机的情况

[v1.4.2] - 2026-09-28

修复

• 切换 HTTPS 后 Agent URL 未更新：启用 HTTPS 直连时只更新了 transport 和证书 pin，数据库里的 agent_url 仍保留旧的 http://127.0.0.1:17701。隧道关闭后仍访问旧本地地址，导致 connect: connection refused。现在 transport、URL、端口和 pin 同批更新，并在切换后清理旧 AgentClient 缓存
• 切回 SSH 隧道时同步恢复本地 URL：恢复隧道会重新写入 http://127.0.0.1:<localPort>，避免残留 HTTPS 地址影响后续状态读取

变更

• 版本号提升到 1.4.2；web/package.json 与 web/package-lock.json 同步对齐
• AgentVersion 保持 0.13.0

测试

• internal/frp：transport 切换与缓存失效编译验证

[v1.4.1] - 2026-09-28

修复

• SSH 隧道端口分配竞态：原来先探测端口再关闭 listener，随后才真正启动隧道，两个安装动作或残留占用可能在两步之间抢到同一端口，报 bind: Only one usage of each socket address。现在改为分配端口时直接持有 listener 并交给隧道使用；17700 被占用时自动尝试后续端口

变更

• 版本号提升到 1.4.1；web/package.json 与 web/package-lock.json 同步对齐
• AgentVersion 保持 0.13.0

测试

• internal/frp：隧道 listener 复用、端口占用与释放回归测试

[v1.4.0] - 2026-09-28

新增

• Agent 默认监听回环：fonu-agent 默认改为 127.0.0.1:7700；监听非回环地址必须显式设置 FONU_AGENT_ALLOW_REMOTE=1，状态接口新增监听地址、监听范围和传输安全字段
• SSH 隧道自动接入：中央 Fonu 安装或升级 Agent 后自动分配 17700-18700 范围内的本地回环端口，通过现有 SSH 凭据建立隧道访问 VPS 的 127.0.0.1:7700，无需新增公网端口、证书或防火墙规则
• 隧道生命周期管理：应用启动后自动恢复 tunnel transport；应用退出时统一关闭；每个服务端支持单独的「重启隧道」操作
• 旧公网 HTTP 自动迁移：旧 Agent 点击「升级 Agent」后安装脚本会备份旧 agent.env、改写为回环监听并自动建立隧道；隧道验证失败时恢复旧监听配置
• 可选 HTTPS 直连 + 证书指纹固定：安装后可从 SSH 隧道切换到 HTTPS 直连。Fonu 自动生成 ECDSA 自签名证书、通过现有安全连接下发，VPS Agent 自动写入独立 Nginx TLS 反代；后续连接按证书 SHA-256 pin 校验，不使用 InsecureSkipVerify 裸跳过
• 防火墙提示边界：HTTPS 模式明确提示云安全组需放行 TCP 7443；Fonu 不自动修改云安全组，主机防火墙自动处理仍留在后续阶段

变更

• 数据库新增 Agent transport / 本地端口 / TLS pin / 监听地址 / 连接状态 / 连接错误字段（迁移 028）
• 前端「公网 Agent」页显示传输方式、隧道状态、本地入口和 Agent 监听地址；旧公网 HTTP 显示迁移警告
• 版本号提升到 1.4.0；web/package.json 与 web/package-lock.json 同步对齐
• AgentVersion 0.12.9 → 0.13.0，内嵌 amd64 / arm64 二进制已重编；VPS 上需升级 Agent

测试

• internal/agent：回环默认值与远程监听保护
• internal/frp / internal/app：隧道生命周期、transport 存储、证书生成与 pin 校验测试

[v1.3.9] - 2026-09-28

修复

• 限流状态损坏时拒绝覆盖：readLimitState 原来忽略 JSON 解析错误并返回空 map，保存任一规则时可能把其他域名的限流配置清空。现在文件不存在仍视为空状态，读取失败、空文件或 JSON 损坏则返回错误，applyLimitState / clearLimitState 会保留原文件与现有 Nginx zone，不再覆盖
• 一键升级宿主机目录自动发现：当 Compose 标签里的 working_dir 是 /workspace 这类容器路径时，不再直接把它当宿主机目录；优先使用 project.config_files 推导真实目录，无法得到宿主机路径时明确报错，避免 helper 挂载 /workspace:/workspace 后找不到 Compose 文件

变更

• 版本号提升到 1.3.9；web/package.json 与 web/package-lock.json 同步对齐
• AgentVersion 0.12.8 → 0.12.9，内嵌 amd64 / arm64 二进制已重编；VPS 上需点一次「升级 Agent」才会生效

测试

• internal/agent：新增限流状态文件缺失、正常解析、空文件、截断 JSON、null 内容与失败后原文件不变的测试

[v1.3.8] - 2026-09-28

新增

• 示例页面 v1.3.8 验证标识：页面版本提示、「本次升级验证」区块、页面状态和验证标识同步更新为 v1.3.8-example-page，用于再次验证线上升级后的前端资源切换

变更

• 版本号提升到 1.3.8；web/package.json 与 web/package-lock.json 同步对齐
• AgentVersion 保持 0.12.8

测试

• 前端类型检查、单元测试与生产构建

[v1.3.7] - 2026-09-28

新增

• 示例页面新增独立升级验证区块：页面增加「本次升级验证」高亮区块，显示 v1.3.7，验证标识更新为 v1.3.7-example-page，用于直观确认升级后的前端资源已切换

修复

• 复用原 Compose 项目名重建容器：updater 在通过 helper 容器执行 docker compose 时，先从现有 fonu 容器读取 com.docker.compose.project 标签，并显式传入同一个项目名，避免 Compose 将现有容器视为另一个项目后重新创建网络、数据卷并撞上 /fonu 容器名冲突。现有容器不是 Compose 管理时，updater 会拒绝升级并提示按 Compose 方式重新部署，避免误建空数据卷

变更

• 版本号提升到 1.3.7；web/package.json 与 web/package-lock.json 同步对齐
• AgentVersion 保持 0.12.8

测试

• 前端类型检查、单元测试与生产构建

[v1.3.6] - 2026-09-28

修复

• 自动定位宿主机 Compose 目录：当 updater 容器内的 /workspace 没有挂载到真实 Compose 目录时，不再直接失败。updater 会从 fonu 容器的 com.docker.compose.project.working_dir / project.config_files 标签读取宿主机路径，并通过临时 helper 容器挂载真实目录执行 docker compose。FONU_UPDATE_HOST_DIR 仍可作为显式覆盖
• 示例页验证标识更新为 v1.3.6-example-page

变更

• 版本号提升到 1.3.6；web/package.json 与 web/package-lock.json 同步对齐
• AgentVersion 保持 0.12.8

测试

• internal/updater：覆盖 Compose 文件直挂载与宿主机目录 helper 模式

[v1.3.5] - 2026-09-28

新增

• 示例页面升级验证内容：页面版本提示与验证标识更新为 v1.3.5-example-page，新增「页面状态」统计卡和「本次示例页变化」说明，便于确认升级后的前端资源已经切换

变更

• 版本号提升到 1.3.5；web/package.json 与 web/package-lock.json 同步对齐
• AgentVersion 保持 0.12.8

测试

• 前端类型检查、单元测试与生产构建

[v1.3.4] - 2026-09-28

修复

• 一键升级找不到 Compose 文件：fnOS 或 Docker UI 启动 Compose 时，updater 的 .:/workspace 可能解析到错误目录，构建时报 open /workspace/docker-compose.hub.yml: no such file or directory。Compose 文件现支持用 FONU_UPDATE_HOST_DIR 显式指定宿主机 Compose 目录，并在状态接口中提前报告缺少 Compose 文件，避免排到升级后才失败
• 示例页验证标识更新为 v1.3.4-example-page，用于确认升级后的前端资源确实生效

变更

• 版本号提升到 1.3.4；web/package.json 与 web/package-lock.json 同步对齐
• AgentVersion 保持 0.12.8

测试

• internal/updater：补充 Compose 文件缺失检查

[v1.3.3] - 2026-09-27

新增

• 示例页面升级验证标识：示例页面新增固定的 v1.3.3-example-page 验证标识与展示项，升级后可直接通过标识区分新旧前端资源，确认页面、路由和静态资源均已更新

变更

• 版本号提升到 1.3.3；web/package.json 与 web/package-lock.json 同步对齐
• AgentVersion 保持 0.12.8，本次无 Agent 行为变化

测试

• 前端类型检查、单元测试与生产构建

[v1.3.2] - 2026-09-27

修复

• 一键升级无法读取远端版本：fonu-updater 检查更新时原来会 git clone --depth 1 整个仓库，而状态接口的父级超时只有 20 秒，克隆未完成即被 signal: killed，表现为 fatal: early EOF，前端因此一直不显示「一键升级」。现改为优先通过 Gitea API / raw 地址或 GitHub raw 读取 VERSION，显著降低检查耗时，不再依赖完整克隆

变更

• 版本号提升到 1.3.2；web/package.json 与 web/package-lock.json 同步对齐
• AgentVersion 保持 0.12.8，本次无 Agent 行为变化
• fonu-updater 位于 sidecar，不能通过自身升级自身；已有部署需要先手动重建一次 updater 服务，之后该修复才生效

测试

• internal/updater：新增 Gitea API / raw 地址解析、文本与 base64 JSON 版本内容解析测试

[v1.3.1] - 2026-09-27

新增

• 示例页面（在线升级验证页）：新增 /example 页面与侧栏「示例页面」入口，页面实时读取 /api/version，展示当前版本、验证步骤和验证结果，用于确认一键升级后前端路由、菜单与后端版本均已更新

变更

• 版本号提升到 1.3.1；web/package.json 与 web/package-lock.json 同步对齐
• AgentVersion 保持 0.12.8，本次无 Agent 行为变化

测试

• 前端类型检查、单元测试与生产构建

[v1.3.0] - 2026-09-27

新增

• Web 一键升级（Docker Compose）：新增受限的 fonu-updater 升级 sidecar，支持 docker-compose.yml（本机源码构建）与 docker-compose.hub.yml（Git 仓库构建）两种部署。主程序只通过共享 Unix Socket 调用 sidecar，不直接挂载 Docker Socket；升级时只重建 fonu 服务，构建或健康检查失败会自动尝试回滚到升级前的镜像 tag
• 前端侧栏在检测到可升级版本时显示「一键升级」入口，升级弹窗展示当前版本、目标版本、升级方式、阶段消息与最近日志；服务重启期间浏览器会自动等待恢复
• 新增 docs/system-upgrade.md，说明首次部署 sidecar、安全边界、升级流程、回滚和常见问题

变更

• 版本号提升到 1.3.0；web/package.json 与 web/package-lock.json 同步对齐
• AgentVersion 保持 0.12.8，本次无 Agent 行为变化

注意

• 已经运行旧版本的实例，需要先手动更新 Compose 文件并执行一次 docker compose up -d --build，让 fonu-updater sidecar 启动。此后才可以在 Web 页面一键升级

测试

• internal/updater：版本比较、compose 路径白名单、配置校验

[v1.2.21] - 2026-09-27

修复

• Agent Bearer Token 改为常量时间比较：internal/agent 原来用普通字符串比较校验 Token，现将 Authorization 解析与 Token 比较拆分，改用 crypto/subtle.ConstantTimeCompare，避免认证路径上的长度与内容时序泄漏

变更

• 版本号提升到 1.2.21；web/package.json 与 web/package-lock.json 同步对齐
• AgentVersion 0.12.7 → 0.12.8，内嵌 amd64 / arm64 二进制已重编；VPS 上需点一次「升级 Agent」才会生效

测试

• internal/agent：新增认证测试，覆盖正确 Token、大小写 Bearer、多余空白、错误 Token、长度不同、缺失 Authorization、错误认证方案

[v1.2.20] - 2026-09-27

修复

• DDNS 页 FRP 提示恢复：DdnsView.vue 原来调用已退役的 /api/frp，请求失败后会把 frpEnabled 固定为 false，导致“FRP 内网穿透已启用”提示不再出现。现改用 /api/frpmulti/status，仅在“已配置服务端且存在启用规则”时显示，并补充判定函数单元测试

变更

• 版本号提升到 1.2.20；web/package.json 与 web/package-lock.json 同步对齐
• 本轮不涉及 Go 与 agent 行为，AgentVersion 仍为 0.12.7

[v1.2.19] - 2026-09-27

新增

• 数据目录可选（默认行为不变）：三个 compose 的挂载改为 ${FONU_DATA_PATH:-fonu-data}:/data——默认仍是命名卷 fonu-data，老用户升级后不受影响；在同层 .env 里写 FONU_DATA_PATH=/vol1/docker/fonu-data 即可让数据落到指定宿主机目录（以 / 或 . 开头的写法会被 compose 当成 bind mount，其余字符串仍是命名卷）
• 新增 docs/container-deploy-and-data.md（容器部署与数据指南）：三个编排文件的分工与选择、干净机器单文件部署、数据目录（默认卷 / 指定目录 / 从卷迁移）、备份与恢复的三条注意、升级与回滚、环境变量速查、常见问题（401 加速器、FONU_SESSION_SECRET 报错、fonu Pulling 超时、换目录后「数据没了」、仪表盘三张卡为空）、与原生安装之间的迁移

变更

• 版本号提升到 1.2.19；web/package.json 同步对齐
• 本轮不涉及 Go 代码（只改 compose 与文档），因此安装包未重出，dist/ 里 1.2.17 的包仍可用；AgentVersion 仍为 0.12.7

[v1.2.18] - 2026-09-27

修复

• 国内加速器上构建失败（401 Unauthorized）：Dockerfile 顶部原来显式写了 # syntax=docker/dockerfile:1，这会让 BuildKit 额外去拉 docker/dockerfile 镜像，而在飞牛的 docker.fnnas.com 这类加速器上会被拦成 401（resolve image config for docker-image://docker/dockerfile:1 失败）。该行已移除：RUN --mount=type=cache 由 Docker 内建的 BuildKit frontend 已支持，不需要显式指定，缓存挂载保持不变
• compose 无谓地尝试拉镜像：docker-compose.hub.yml 增加 pull_policy: build，跳过日志里那条 "fonu Pulling"（国内直连 Docker Hub 的超时告警），直接构建

变更

• 版本号提升到 1.2.18；web/package.json 同步对齐
• 本轮不涉及 Go 代码（只改 Dockerfile 与 compose），因此安装包未重出，dist/fonu-1.2.17-linux-*.tar.gz 仍可用；AgentVersion 仍为 0.12.7

[v1.2.17] - 2026-09-27

新增

• 会话密钥自动生成：FONU_SESSION_SECRET 未配置时，应用首次启动会在数据目录里生成 32 字节随机密钥（64 字符）并持久化到 <数据目录>/session_secret（权限 0600，先写临时文件再改名；读到损坏内容会重新生成）。启动日志会写明密钥来源（环境变量 / 文件路径 / 仍在使用历史默认值的提示）
• compose 改为「留空即自动」：三个 compose 统一 FONU_SESSION_SECRET: ${FONU_SESSION_SECRET:-}；docker-compose.hub.yml 的单文件部署现在只要 docker compose up -d --build，不再需要预先准备 .env

变更

• FONU_SESSION_SECRET 的默认值由固定的 change-me-in-production 改为空（空 = 未配置 → 自动生成）
• 不会自动替换已配置的值：这个密钥同时是 secret.NewBox 的加密密钥，替换会让库里已加密的凭据（frp token、通知密码等）无法解密；对仍在使用历史默认值的实例只提示、不改数据
• .gitignore 补上 .env 与 .env.local（.env.example 这类模板仍可入库）
• 版本号提升到 1.2.17；web/package.json 同步对齐
• 本轮不含 agent 行为变更，AgentVersion 仍为 0.12.7

测试

• internal/config：密钥生成与复用、文件权限（类 Unix 上校验 0600）、显式配置优先且不写文件、历史默认值保留并提示、损坏文件重新生成

[v1.2.16] - 2026-09-27

改进

• docker-compose.hub.yml 改为「单文件从仓库拉取源码构建」：build.context 直接用 Git 地址（http://45.207.223.190:10082/mrlee/-Fonu.git#main），由 BuildKit 自己克隆后再构建——干净机器上只需要这一个 compose 文件 + 一个 .env，不必先手动 git clone。升级也是回该目录重跑 docker compose up -d --build（会重新拉 main 的当前代码）。文件头补齐了完整用法
• 会话密钥不再静默回退：这一份把 FONU_SESSION_SECRET 写成必填（${FONU_SESSION_SECRET:?...}），没在 .env 里给值就直接拒绝启动并给出生成命令，避免用 change-me-in-production 直接跑在公网

变更

• 版本号提升到 1.2.16；web/package.json 同步对齐
• 本轮不含 agent 行为变更，AgentVersion 仍为 0.12.7
• 三个 compose 的分工：docker-compose.yml（本地源码上下文）、docker-compose.hub.yml（从仓库拉取）、docker-compose.host.yml（host 网络，仍需本地源码）

[v1.2.15] - 2026-09-27

新增

• 仪表盘「实时流量」支持切换数据源（本机 / 公网）：本机读 Fonu 管理的本机 Nginx 访问日志；公网读 frps 侧逐规则的 today_traffic_in/out 与 cur_conns（速率由后端两次采样算出，口径与「公网反代」页的当前上传/下载一致）。切换时会清空 5 分钟曲线，避免两个来源的采样混在一张图里；还没有穿透规则时「公网」按钮禁用并给出说明

改进

• 容器交付：升级改为在部署机（NAS）上直接构建（不再需要 save / 传文件 / load 镜像包）
  • Dockerfile：加 # syntax=docker/dockerfile:1 + 四处 RUN --mount=type=cache（npm 与 Go 模块/编译缓存跨次构建复用，重复构建从几分钟降到几十秒）
  • 三个 compose 统一 name: fonu（否则改了目录名/项目名后 compose 会把它当成新项目，fonu-data 变成新空卷，现象就是「数据丢了」）与 image: fonu:${FONU_VERSION:-local}（镜像 tag 随版本走，便于回滚）；.host.yml 补上原本缺失的 image:
  • 新增 scripts/upgrade.sh：一条命令完成「拉代码 → 构建 → 重建 → 健康检查」，支持 --no-pull、--rollback <tag>（不重新构建）与 COMPOSE_FILE=（host 网络那仃）

变更

• 版本号提升到 1.2.15；web/package.json 同步对齐
• 本轮不含 agent 行为变更，AgentVersion 仍为 0.12.7

[v1.2.14] - 2026-09-27

新增

• 证书颁发机构：LiteSSL 替换 Buypass。LiteSSL（亚数 TrustAsia 的公益免费 DV 证书，90 天，官方支持单域名 / 通配符 / 多域名）已接入，ACME 目录 https://acme.litessl.com/acme/v2/directory。该目录里 meta.externalAccountRequired = true，所以强制 EAB：在 FreeSSL 平台「证书自动化 → EAB 管理」创建后，把 Kid 与 HMAC 填进设置即可（不需要像 ZeroSSL 那样用 API Key 去换取）。EAB HMAC 只回掩码。 Buypass 保留常量与展示元数据（历史证书记录仍能正常显示），但不再可选，直接提交会被拦下并提示替代项。域名若有 CAA 记录，需允许 trustasia.com。

修复

• frps 安装一直报 HTTP 404：frp 官方的校验文件名始终是 frp_sha256_checksums.txt（不带版本号，v0.52.3 / v0.58.1 / v0.62.1 / v0.71.0 实测均如此），而代码拼的是 frp_<版本>_sha256sums.txt——任何版本、任何网络环境下都装不上。现改为按候选名依次尝试（旧名保留兜底），失败信息里列出尝试过的文件名。 同一条 bug 也在本机下载 frpc 的路径上，一并修复；SHA-256 校验逻辑本身一行未改。
• Nginx 探测两处（均在 agent）：
  • nginxPath() 探测不到时不再回落到配置里的裸名字 nginx：那会让「未安装」被误判为「配置校验未通过（nginx -t 执行失败）」，且「VPS 未安装 Nginx」告警与一键安装按钮永远不会出现。
  • vhost 目录探测不再要求被加载文件以 .conf 结尾：Debian/Ubuntu 的 sites-enabled/default 不带后缀、而 nginx.conf 里是 include .../sites-enabled/*，过滤掉它之后只剩主配置目录可试，报「在 1 个被加载目录中均无法放置完整 server 配置」；现在失败信息会带上最后一次的具体原因与常见显式指定目录。
• 前端申请证书弹窗的颁发机构卡片改为前端可控清单：原先硬编码为 Let's Encrypt / ZeroSSL / Buypass，后端 /api/certs/options 的结果不参与渲染，导致后端增删 CA 时弹窗不变（本次 LiteSSL 替换就是这幺被发现的）。现在卡片为 Let's Encrypt / ZeroSSL / LiteSSL。

测试

• internal/frp：校验文件候选名顺序、sha256sum 格式解析（含 * 前缀与不存在的文件负例）
• internal/acme：LiteSSL 目录地址 / 展示名 / 别名归一化、通配符与多域名不被拦、Buypass 停用提示里含替代项

变更

• AgentVersion 0.12.4 → 0.12.7（0.12.5 修 frps 校验文件名；0.12.6 修 nginxPath；0.12.7 修 vhost 目录探测），双架构内嵌二进制已重编；VPS 上需点一次「升级 Agent」
• 版本号提升到 1.2.14；web/package.json 同步对齐

[v1.2.13] - 2026-09-27

新增

• Linux 原生安装包：scripts/build-linux.ps1 一条命令产出 fonu-<版本>-linux-{amd64,arm64}.tar.gz（内含二进制、migrations、systemd 安装脚本、前端运行时资源与 sha256 校验文件，无需 Docker/WSL，依赖纯 Go 的 modernc.org/sqlite）；scripts/fonu-install.sh 负责目标机安装与卸载：装到 /opt/fonu、数据在 /var/lib/fonu、环境变量在 /etc/fonu/fonu.env（首次生成随机会话密钥，重装保留）并注册 fonu.service
• --reset-admin：忘了管理员口令时清空 admins/sessions 后重启，启动流程会重新生成随机口令；装完也会直接打印初始口令（以前只提示访问地址，用户找不到口令）
• Cloudflare Tunnel 融合方案文档 docs/cloudflared-integration-plan.md：同类项目对比、两种托管模型、可复用面盘点、参考实现分析（含用户自有项目 cf-tunnel-manager）与 IP 优选可行性边界
• 设置页「ACME 证书」新增 **DNS 解析器（高级）**设置项

修复

• 证书申请：DNS-01 传播检查用错解析器：lego 默认读系统 /etc/resolv.conf，容器里那是 Docker 的 127.0.0.11，它不返回权威 NS，于是报 could not determine authoritative nameservers。现在显式传入 dns01.AddRecursiveNameservers（默认 223.5.5.5:53,1.1.1.1:53,8.8.8.8:53，可用 acme_dns_resolvers 覆盖，填 system 回到系统解析器；配置无效时报明确错误而不是静默降级）
• Buypass 下线：该 CA 已于 2025-10-15 停止签发、2026-04-15 终止 ACME 服务，已从可选 CA 列表移除；历史记录仍可展示，直接提交会被拦下并给出中文原因（不再让用户面对一个看不懂的 ACME 报错）
• ZeroSSL 报错信息不全：返回 422 时把 ZeroSSL 的 error.type / error.code 带进错误；非 JSON 响应退回压平截断的正文，便于定位
• 密钥泄露：ZeroSSL EAB 请求失败时，url.Error 里带 access_key 的完整 URL 会被写进任务日志与 <数据目录>/logs/app.log；现在只保留底层错误原因

测试

• internal/acme：递归解析器列表解析（分隔符/自动补 53/上限 8 条/默认值可用）；ZeroSSL EAB 四条（成功、422 带错误类型、非 JSON 退回正文、网络错误不泄露密钥）

变更

• 版本号提升到 1.2.13；web/package.json 同步对齐
• 本轮不含 agent 行为变更，AgentVersion 仍为 0.12.4

[v1.2.12] - 2026-09-25

修复

• frps.toml 同源配置预览泄露明文密钥：FRPSServerConfig 是对外预览入口，之前直接把 builder 输出返回，而模板里含解密后的 auth.token——「即将下发的内容」弹窗拿到的是明文，与同文件「密钥不入其他 API 响应」的约定矛盾。现在预览统一走 maskFRPSSecrets（auth.token / auth.oidc.clientSecret 的值换成 ********，键名与行结构保留、注释行不动）；真正下发路径不受影响（PushFRPSConfigToAgent 与安装流程仍用未脱敏内容）。预览弹窗补了说明，「复制」改为「复制（已脱敏）」
• 规则详情「日志」页签改为倒序：加载后反转，最新一条在最上面（与日志页「FRP 日志」页签一致）

改进

• 日志页「FRP 日志」的来源列不再显示 frpc 的 Go 源码文件行号（如 client/control.go:174），改为中文模块名（登录 / 连接 / 代理 / 服务 / 配置 / 健康检查 / 服务端）；认不出来的值（包括回落到的组件名）原样保留
• 「公网服务端」日志弹窗改为显示 VPS 上的 frps 服务日志（该页职责是管理 frps 端），标题与说明同步；本机 frpc 日志仍在日志页「FRP 日志」页签
• frps 日志从写死 6 行改为最近 20 行、最新在最上面，并把 2026-09-22T18:43:34+08:00 RainYun-XXX systemd[1]: … 重写成 2026-09-22 18:43:34 systemd[1]: …（去掉 T 分隔、时区偏移与每行重复的主机名）；frps/action 失败时带回的日志一并统一格式

测试

• internal/frp：maskFRPSSecrets 脱敏（明文不出现、非敏感行不被误伤）与注释行不被改写

变更

• agent 行为变更：AgentVersion 0.12.2 → 0.12.4（0.12.3：20 行 + 倒序 + ISO；0.12.4：重写日期格式），双架构内嵌二进制已重编；**需在 VPS 上点一次「升级 Agent」**才生效
• 版本号提升到 1.2.12；web/package.json 同步对齐

[v1.2.11] - 2026-09-25

新增

• 定时自动备份 + 保留策略：每天自动备份一份到 <DataDir>/backups，超过保留份数自动清理最旧的；重启不会重复备份（按「最新备份是否在 24 小时内」判定）。设置页「数据」卡可开关、改份数、立即备份，并列出/下载/恢复/删除备份，恢复前先校验归档
• 健康检查持续化 + 公开状态页：规则的四段健康结论按状态变更落库（采样间隔即巡检轮次），由此推导可用率与不可用区间；设置页「高级」新增「公开状态页」——默认关闭，可设访问码（只存 SHA-256、不下发明文），按 IP 限流，只暴露域名与可用率
• 指标历史与趋势图：新增纵向点表 metrics_samples，记录本机 CPU / 内存 / 磁盘与每条规则的上行/下行速率（采样跟随巡检，30 天保留）；仪表盘新增「资源与流量趋势」卡，支持 1 小时 / 24 小时 / 7 天
• 告警事件新增「自动备份失败」（默认开启）

修复

• 隧道探活：「判不了」不再当成「不通」：RouteHealthCandidate 新增 tunnel_known，frps 管理接口未配置或不可用时不再把 tunnel_ok=false 当成故障——此前会对这类用户误报「隧道连续不通」
• 健康汇总同样区分「无法判定」与「不通」：新增 tunnel_unknown 计数，规则表徽标用警告色并说明「不代表隧道不通」，「无法判定」不再算作不健康

改进

• 巡检每轮只采一次主机资源，同时喂给「资源阀值告警」与「指标历史」（CPU 占用率靠两次采样的差值，采两次会互相干扰）
• 流量聚合抽出 aggregateHostKeys，端点聚合与按域名聚合共用同一套速率算法，避免两处漂移
• 仪表盘：新增趋势卡；「运行状态」并入顶部统计区（运行时长补进「服务」卡）；「性能」并入系统资源那一行，整行 4 列
• 趋势图：图例与绘图区留白调整；点少时画点（此前只有一两个点时线根本画不出来）；空桶断开而不是补 0

测试

• internal/backup：导出 + 校验往返、校验拒绝非 gzip、列表/剪枝/名称白名单、到期判断
• internal/metrics：分桶平均与空桶不产点、窗口外的点、退化输入
• internal/frp：可用率推导（区间 + unknown、仍在持续、无记录不出结果）、健康汇总的 unknown 用例
• internal/api：状态页限流与访问码哈希
• internal/app：monitor 与 frp 两侧状态字面量的翻译

变更

• 新增迁移 026_route_health.sql、027_metrics_samples.sql（启动时自动执行）
• agent 无改动，AgentVersion 保持 0.12.2，本轮不需要在 VPS 上重新升级 Agent
• 版本号提升到 1.2.11；web/package.json 同步对齐

[v1.2.10] - 2026-09-25

新增

• 告警事件新增三项巡检（默认关闭，设置页「告警事件 → 系统」）：
  • 公网服务端掉线：服务端进程没在跑、或隧道连不上 frps 时通知，恢复时再通知一次；只对「用户要它运行」的服务端判定，手动停止的不报
  • 公网 agent 不可达：VPS 上的 fonu-agent 连续无响应（重启后没起来最常见），恢复时再通知一次；没配 agent 的服务端不参与判定
  • 配置漂移：VPS 上的 vhost 与 Fonu 记录不一致（被手工改过、或 agent 重装后没重部署）时通知，漂移清空时补一条恢复
• 通知图标与分类补齐：📈 系统（资源占用）、🔌🛑📡 隧道（隧道 / 服务端 / agent）、🧭 配置（漂移）
• 通知方式的 Webhook 改名为「Webhook / IM 机器人」：企业微信、钉钉、飞书机器人挂在 Webhook 预设下，原标签没说明白

改进

• 巡检改为 Source 接口（Routes / Servers / Agents / Drift），internal/app/monitor_source.go 负责把 frp 服务适配进来，internal/monitor 因此不依赖 frp 包
• 「连续 N 次失败」抽成共用的 failureTransition（原 tunnelTransition 泛化）：三条新巡检与原有隧道巡检共用「刚好达标报一次、恢复报一次」；漂移不是连续失败型，单独用冷却（默认 24 小时，可配）
• 避免误报的三条约定：服务端只在「用户要它运行」时判定；ConnectionState 为 unknown 按健康处理；没配 agent 的服务端不参与可达性判定
• 开关关闭时连数据采集都跳过（关掉的功能不该有后台开销）；所有 notify.Alert 一律在锁外调用
• 新增设置项：notify_on_frps_down / notify_on_agent_unreachable / notify_on_route_drift，以及 notify_frps_fail_threshold(2) / notify_agent_fail_threshold(3) / notify_drift_cooldown_hours(24)

测试

• internal/monitor/monitor_test.go 增加 serverDown（手动停止不报、进程未运行或连接断开要报、连接状态未知不误报）、serverLabel、stateOr 用例

变更

• 版本号提升到 1.2.10（版本单一来源仍是根目录 VERSION）；web/package.json 同步对齐
• agent 无改动，AgentVersion 保持 0.12.2，本轮不需要在 VPS 上重新升级 Agent

[v1.2.9] - 2026-09-24

新增

• 配置版本历史 / 对比 / 回滚：主 nginx.conf 每次保存前留一份版本（<path>.versions/，保留最近 10 次内容有变化的改动，内容相同自动去重）；设置页「Nginx 全局配置」内可看版本列表、逐行差异并一键回滚——回滚先过语法校验与 nginx -t，不过关不覆盖当前配置
• 公网反代页的「查看配置」弹窗内可看该域名在 VPS 上的历史版本、与当前配置做差异对比并回滚（需 agent ≥ 0.12.2）
• 通知渠道补齐：新增企业微信机器人、钉钉机器人、飞书机器人（钉钉正文以「Fonu · 」开头，机器人用「自定义关键词 = Fonu」即可命中；加签方式暂不支持）
• 阈值型告警（默认关闭）：CPU / 内存 / 磁盘持续超阈值、隧道连续 N 次未在 frps 上注册时通知，恢复时再通知一次；阈值与开关在设置页「告警事件」里配置
• API Token：新增 api_tokens 表与 Authorization: Bearer <token> 认证，供脚本 / HomeAssistant / 手机快捷指令调用；设置页「高级」可签发（明文只显示一次）、查看最近使用时间与撤销

修复

• agent 写 vhost 时 nginx -t 校验失败不再直接删文件（那等于把在跑的站点从磁盘上抹掉），改为恢复上一个可用版本
• 配置版本名做路径校验，拒绝带 / 或 .. 的名称，避免接口被用来读版本目录以外的文件
• 通知：切换 Webhook 预设时服务地址自动换成该预设默认值（此前会把 Bark 的 api.day.app 带到企业微信上）
• API Token 的令牌管理、改密、退出只允许登录会话——否则一个 write 令牌能给自己提权或无限续期

改进

• internal/fsutil 新增 BackupVersioned / ListVersions / ReadVersion；internal/nginx 的回滚与 Apply 共用抽出的 activate()，两条路径行为一致
• 新增 internal/monitor 巡检包（每 2 分钟一轮，注册进 internal/scheduler）；资源类告警同一项 30 分钟静默期，回落到阈值以下即清冷却，开关关闭时连采集与探测都跳过
• providerUsesKey() 收敛「凭据放 Key 还是 WebhookSecret」的判定；前端新增 ConfigDiffView.vue 与 utils/diff.ts（LCS 行级差异，超长文本退化为整体替换）
• API Token 的 last_used_at 限频回写（1 分钟一次），单连接 SQLite 上不做每请求写

测试

• internal/auth/token_test.go（令牌生命周期 / 过期 / 非法输入 / 明文不落盘）、internal/api/middleware_test.go（只读令牌只读、写令牌可写、令牌不能管理令牌、错误凭据 401）
• internal/monitor/monitor_test.go（连续失败只报一次、恢复报一次、未达阈值静默）
• internal/notify/push_test.go 增加企业微信 / 钉钉 / 飞书三家的端点与 payload 用例；internal/fsutil 增加版本列表 / 内容去重 / 路径校验用例

变更

• AgentVersion 0.12.1 → 0.12.2（域名 vhost 的版本列表 / 对比 / 回滚端点，写配置前留版本）；内嵌 fonu-agent-linux-amd64 与 -arm64 已重编，VPS 上需点「升级 Agent」才会生效
• 版本号提升到 1.2.9（版本单一来源仍是根目录 VERSION）；web/package.json 同步对齐
• 新增 docs/feature-benchmark-2026-09-24.md：同类项目对标与增补建议，含 §九 本轮 P0 实施状态

[v1.2.8] - 2026-09-24

修复

• 公网服务端：frps 启停失败不再假成功——之前忽略 systemctl 的 err 后无条件写「frps.service 已启动」，现在失败时返回 ok:false 与 stderr，运维不会误以为服务在跑
• frps 配置写入：.bak 备份失败时立即中止并删除 .verify，不再覆盖唯一副本（旧配置得留退路）
• 安装 frps 后下发同源 frps.toml 失败不再静默吞掉：结果里带 config_warning 并追加到 notes
• 请求体解析：证书申请 / 续期、DDNS 测试改为严格 400；frps 安装允许空请求体（走默认版本）但拒绝 JSON 语法错误
• 会话与登录：同一 IP 在 5 分钟内失败 5 次后返回 429（成功后清零，带过期清理与上限）；改密码只失效该账号的其他会话，不再把当前会话一并踢掉；会话 cookie 按 r.TLS / X-Forwarded-Proto 决定是否加 Secure（默认明文部署不加，否则浏览器丢 cookie 导致登不进去），clearSessionCookie 补 SameSite=Lax
• 后台下载改为继承应用 ctx（新增 Service.SetBaseContext），App 关闭时随之中止；scheduler 每个任务包 recover()，单个任务 panic 不再带走整个进程，且建表时跳过非正间隔（time.NewTicker 会 panic）
• 两个 http.Server 补 ReadTimeout / IdleTimeout（agent 60s/2min；应用 5min/2min，不设 WriteTimeout——否则日志 SSE 会被中途切断）
• 公网反代页：refreshAll 的 7 个独立接口由串行 await 改为 Promise.all，每次刷新不再等于 7 个往返相加
• 内网穿透页：删除 74 条随服务端 UI 迁走的死样式；公网服务端页合并逐字重复的样式块
• 文档与工程：修正 README / DEPLOYMENT / frps_template.go 中「Docker 镜像内置 frpc 0.71.0」的不准确说法（镜像不预装、按需下载）；.dockerignore 删掉两行已失效的归档排除项并修掉 docs 的前导空格

改进

• 新增 internal/fsutil：WriteFileAtomic（同目录随机名临时文件 + rename + 显式 chmod）与 Backup（文件不存在视为无需备份），收敛 agent / frp / nginx / chinacidr 各处自建的 .tmp 与 .bak 逻辑（其中 nginx 原来用固定 .tmp 名，并发写同一路径会互相踩）
• 流量采集：notify.RecordAccessHit（写库 + 判断通知）从写锁内移到锁外，不再顶住 /api/proxies/traffic 与 /clients 的读
• internal/frp 的 agent 客户端改为按 serverID 缓存（指纹 = AgentURL + Token 密文），批量同步 N 条路由不再新建 N 个连接池与 TLS 握手
• 前端新增 useVisibilityPolling()：标签页隐藏时暂停轮询、回前台立即补一次；公网反代页与内网穿透页已接入，仪表盘流量轮询加 in-flight 互斥避免堆积并发请求
• 新增 docs/README.md 文档索引；给 agent-capability-plan / agent-view-design / -v2 / upstream-sync-plan 加实施状态与时效说明

测试

• Go 新增 4 个测试文件：backup（../ 逃逸与 ../data-other/ 同前缀绕过、还原权限固定）、scheduler（非正间隔跳过、panic 后继续）、frp（shellPath 单引号转义、isELFBinary）、agent（validateRoute 表驱动、nginxRoute 关键行、fileSHA256）
• 前端引入 vitest（npm test = vitest run），新增 13 个单测覆盖 utils/format.ts 与 utils/status.ts（含一条守住「n-tag 的 type 值不能当状态值」的回归用例）；CI 增加「Run web unit tests」一步

变更

• AgentVersion 0.12.0 → 0.12.1（frps 启停失败如实回报、HTTP 服务补超时）；内嵌 fonu-agent-linux-amd64 与 -arm64 已重编，VPS 上需点「升级 Agent」才会生效
• 版本号提升到 1.2.8（版本单一来源仍是根目录 VERSION）；web/package.json 的版本同步对齐，本地构建不再显示 1.0.2

[v1.2.7] - 2026-09-24

修复

• 安全（P0）：备份恢复的上传文件名不再拼进临时路径，改用 os.CreateTemp——此前 multipart 文件名完全可控，../../root/.ssh/authorized_keys 之类可逃出临时目录（internal/api/backup_handler.go）
• 安全（P0）：备份还原的条目路径校验从「字符串前缀比较」改为 filepath.Rel 判定并拒绝 ..——此前 DataDir=/data 时条目 ../data-other/x 能通过前缀匹配写到 DataDir 之外；同时不再照搬归档里的权限位（固定文件 0o640 / 目录 0o750），避免构造的归档造出 0777 或带执行位的文件
• 安全（P0）：agent 安装 frps 时 proxy 参数改走白名单（与「FRP 下载加速代理」同一组前缀），且改为先取官方 frp_<version>_sha256sums.txt、下载后比对 SHA-256 通过才解压安装——此前该参数未校验就拼进下载地址，等于可让 VPS 拉取任意地址的二进制并装成 frps
• 安全（P0）：SSH 不再 InsecureIgnoreHostKey()，改为 known_hosts + TOFU——首次连接把主机指纹记到 <DataDir>/ssh_known_hosts（新增 config.SSHKnownHostsPath()），之后指纹不一致直接拒绝连接，错误里带上「期望 / 实际」指纹与处理提示
• 安全（P0）：GET /api/settings 不再回传 ZeroSSL API Key 明文，改为只回 ******** 掩码（前端以「非空」判断是否已配置，保存时仅在重新输入才会提交该字段）
• 安全（P0）：agent 环境探测不再回传 Agent Token 明文，改为 agent_token_configured + agent_token_hint（末 4 位）
• 安全（P0）：反代自动生成的 Basic Auth 密码不再写进 nginx 配置注释（此前会被「查看配置」永久读到），改为在部署响应里一次性返回、页面上提示「仅显示这一次」；部署失败会丢弃刚生成的凭据
• 公网服务端页：服务端详情弹窗的状态点恒为灰色——serverStartupType() 返回的是 n-tag 的 type 值，被当成状态值传给 StatusBadge :value 后落到 unknown；新增返回 StatusKind 的 serverStartupKind() 并改用 :kind
• 仪表盘：域名卡与证书卡的徽标固定显示「正常」，后端返回异常状态时会出现「红/灰点 + 正常」的矛盾，改为按状态值推导文案并在无值时隐藏

变更

• AgentVersion 0.11.0 → 0.12.0（frps 安装校验 + Basic Auth 密码处理），内嵌 fonu-agent-linux-amd64（10.4 MB）与 -arm64（9.7 MB）已重编，VPS 上需点「升级 Agent」才会生效
• 新增 .github/workflows/ci.yml：push / PR 触发，按「前端构建 → 同步 dist 到 cmd/fonu/web/dist → go vet → go test ./... -count=1 → go build ./...」执行（顺序不可颠倒：cmd/fonu 用 //go:embed all:web/dist，干净检出缺该目录时编译直接失败）；gofmt 卡口待全仓格式化后再开
• web/package.json 版本由 1.0.2 对齐到 VERSION，并声明 packageManager: npm@10.9.4（与 Dockerfile 的 node:22-alpine 一致）；删除 web/pnpm-workspace.yaml（占位残留，仓库并无 pnpm 锁文件）
• 版本号提升到 1.2.7（版本单一来源仍是根目录 VERSION）

[v1.2.6] - 2026-09-24

改进

• 公网服务端页（/frp-agent）改为 DDNS 页那样的左列表 + 右详情：左侧是服务端列表（名称 / 启动状态 / 主机:端口 / 延迟与位置 / TLS·Token·Agent·SSH 标签，点行即选中并高亮），右侧是选中服务端的详情；原列表行内操作（启动·停止 / 查看 / 日志 / 测速 / 校验 / 编辑 / 删除）移到右侧工具条，顶部「选择服务端」下拉去掉（左侧列表本身就是选择器），页面标题改「公网服务端」，≤1100px 收成一列
• 内网穿透页（/frp）改为左：服务端列表 / 右：该服务端的穿透规则：左侧点服务端即筛选（显示规则数与启用数），右侧保留原来的穿透规则表格（:data 按选中服务端过滤、去掉冗余的「服务端」列、:scroll-x 2020 → 1890），工具条显示当前服务端与规则条数；规则详情仍是弹窗（表格「详情」按钮），实时速率采样只在弹窗打开期间进行
• 服务端列表从内网穿透页整体并入公网服务端页：服务端表单 / 服务端日志 / 服务端详情 / frps.toml 同源配置四个弹窗随列表一起迁移；内网穿透页不再持有服务端的增删改与启停
• 内网穿透页规则区在「尚未配置服务端」时给出指向「公网服务端」页的空态（原来只剩一个被禁用的「添加规则」按钮）
• 日志中心「公网 FRP」页签改为时间倒序（新日期在前），分页与筛选跟着一致

变更

• 「Agent 管理」跳转改为深链：内网穿透页点某台服务端直接落到该台详情（/frp-agent?server=<id>，id 不存在时回落为第一台）
• 服务端列表不再按「已配 Agent / SSH」过滤——未配的服务端也要能在本页编辑与删除
• 版本号提升到 1.2.6（版本单一来源仍是根目录 VERSION）

[v1.2.5] - 2026-09-24

新增

• 公网 Agent 能力扩展（agent 0.11.0）：新增 GET /api/v1/certs（VPS 证书清单——遍历证书目录、用标准库 crypto/x509 解析 fullchain.pem 的到期时间、按剩余天数排序、解析失败的单条记入 warnings 不中断整轮）与 POST /api/v1/nginx/reload（显式校验并重载 Nginx，分别回传 nginx -t 与 reload 的失败原因；成功后让可用性探测缓存失效，避免页面继续显示旧结论）
• 公网 Agent 页：新增「VPS 证书」卡（域名 / 剩余天数 / Fonu 证书库 / 到期时间），与 Fonu 证书库交叉核对（含通配符匹配），宝塔自行申请的证书也能看到；剩余不足 30 天转橙、已过期转红加粗
• 公网 Agent 页：Nginx 卡片新增「重载 Nginx」按钮，校验 / 重载失败原因（nginx -t 输出或 reload 的 stderr）直接显示在卡内

改进

• 公网 Agent 页布局：「VPS 资源」与「VPS 证书」改为并排各占半行——dep-grid 由 3 列改为 6 列并按 span 分配（原有三张卡仍每行三张），半宽下资源三项指标等分、平均负载与运行时长落到卡底一行，证书表列宽收紧；≤1199px 复位跨度避免 span 在列数变少后撑破网格
• 应用侧对 agent 端点的版本要求提升到 ≥ 0.11.0（旧 agent 仍按 404/405 统一降级为「请升级 Agent」提示）

变更

• AgentVersion 0.10.0 → 0.11.0；内嵌 fonu-agent-linux-amd64（10.0 MB）与 -arm64（9.3 MB）已重编，VPS 上需点「升级 Agent」才会生效
• 版本号提升到 1.2.5（版本单一来源仍是根目录 VERSION）

[v1.2.4] - 2026-09-24

新增

• 公网 Agent 能力扩展（agent 0.10.0）：新增三个只读端点——GET /api/v1/metrics（VPS 主机资源：CPU / 内存 / 磁盘 / 负载 / 运行时长，CPU 用两次采样差值，1 秒内的重复请求直接复用上次结果）、GET /api/v1/logs/nginx（access / error 日志尾部，路径只从 nginx -T 实际生效配置、FONU_AGENT_NGINX_LOG_DIR 或默认目录取；按 32KB 块倒读，单行 4KB 截断，上限 2000 行）、GET /api/v1/frps/config（frps.toml 回读，256KB 上限，文件不存在返回 exists: false）
• 公网 Agent 页：新增「VPS 资源」横排带（CPU / 内存 / 磁盘三项并排 + 进度条 + 右侧平均负载与运行时长），占满「环境与依赖」整行，不做单独占格
• 日志中心：新增「公网 Nginx」页签（服务端 / 访问或错误日志 / 行数 200·500·2000 + 关键词搜索 + 分页），并显示 agent 解析出的实际日志路径与「仅显示尾部」标记
• 公网服务端「frps.toml 同源配置」弹窗：新增「比对 VPS 实际文件」——去注释与空行后逐行比对，一致给出绿色说明，不一致指出第一个差异行（下发值 / VPS 值）

改进

• internal/sysinfo 补 LoadAvg() 与 UptimeSeconds()：Linux 读 /proc/loadavg、/proc/uptime，Windows 用 GetTickCount64，其它平台返回空值
• 老版本 agent 的降级：三个新端点遇到 HTTP 404/405 时统一转成「VPS 上的 agent 版本过低，不支持该接口（需 ≥ 0.10.0），请在服务端详情里升级 Agent」的可操作提示，而不是原始 HTTP 错误

变更

• AgentVersion 0.9.2 → 0.10.0；内嵌 fonu-agent-linux-amd64（9.9 MB）与 -arm64（9.2 MB）已用新代码重编，VPS 上需点「升级 Agent」才会生效
• 版本号提升到 1.2.4（版本单一来源仍是根目录 VERSION）

[v1.2.3] - 2026-09-24

新增

• 仪表盘：新增「公网穿透」统计卡，并在「运行状态」面板增加「公网反代」行——数据来自新增的 GET /api/frpmulti/routes/summary（逐台服务端采集四段健康后聚合，单台失败只记名不中断）
• 仪表盘：新增「性能」面板（今日异常 / 平均响应，/api/status 早已返回但页面从未展示），「实时流量」面板新增「流量 Top 5」（直接复用已有的逐规则流量轮询）
• 仪表盘：新增一行三卡「系统资源 / 中国 IP 段 / 通知通道」；系统资源来自新增的跨平台采集包 internal/sysinfo（Linux /proc、Windows kernel32，无新增依赖；容器内为宿主机视角）
• 公网反代：新增部署漂移清单（未部署 / 孤儿配置 / 未生效 / 内容不一致）与「重新部署全部」——逐条下发、单条失败不中断；新增 GET /api/frpmulti/servers/{id}/agent/routes/drift 与 POST .../agent/routes/redeploy
• 公网 Agent：端口矩阵补端口含义提示；「frps 运行时」新增「启动一致性」核对（systemd 实际启动命令 vs 配置的二进制与配置文件，检出「Fonu 写入的 frps.toml 不是 frps 实际加载的那份」）
• 新增 docs/agent-capability-plan.md：fonu-agent 能力扩展方案（12 个端点现状盘点、P0–P2 分批设计、agent 侧与应用侧改动流程、验收与风险回滚）

改进

• 仪表盘「服务」卡：原先写死「正常 / 4 个」，现按 Fonu / Nginx / DDNS / 证书四项实际状态聚合，异常时点名并把徽标降级为 warning/error（此前 Nginx 停止、DDNS 异常时该卡仍显示「正常」，与右侧「运行状态」面板自相矛盾）
• 仪表盘轮询：/api/status 每 15 秒刷新一次（CPU 占用率需要两次采样才有意义），并在页面隐藏时暂停「实时流量」与「状态」两个轮询
• 公网反代健康列：证书徽标补「证书来源」——Fonu 证书库：有（剩余 N 天） 或 无（需先在证书管理申请），用于区分「没有证书可推送」与「VPS 上证书过期或未覆盖」

修复

• FRP：frpc 版本读不出来——RuntimeStatus.Version 带 omitempty，frpc --version 探测失败时字段被整体省略，前端只能显示「未检测 / 未知」；现回落为按 <FrpDir>/bin/<版本>/ 目录名推导（与「FRP 应用配置」弹窗的 active_version 同源），并改为逐台服务端探测版本（原先只探测默认那台）
• 仪表盘：删除死样式（.dashboard / .stat-highlight / .proxy-metric*）

变更

• 版本号提升到 1.2.3（版本单一来源仍是根目录 VERSION）

[v1.2.2] - 2026-09-23

新增

• 日志中心：新增「FRP 日志」Tab——把 frpc 运行日志解析为 时间 / 级别 / 来源 / 消息 四列，支持关键词与级别筛选、分页、错误/警告行着色，与系统日志、访问日志、Nginx 日志同一套交互（对齐上游 1.0.3）
• 新增 web/src/utils/clipboard.ts：统一的剪贴板复制工具（异步剪贴板 API 优先，失败或非安全上下文时回退 execCommand）

改进

• 剪贴板复制在非 HTTPS 环境可用：Fonu 常以 http://内网IP:6893 访问，属非安全上下文，此时 navigator.clipboard 为 undefined，复制必然失败；公网反代（复制域名 / 复制配置）、公网 Agent（配置查看）、DDNS、本地反向代理（复制访问链接）共 5 处调用点统一改用上述工具（对齐上游 1.0.4）
• 容器时区：Dockerfile 新增 TZ=Asia/Shanghai 并在运行时阶段安装 tzdata（只设 TZ 而镜像内无 zoneinfo 时 Go 仍会回落 UTC），三个 compose 文件均支持 TZ 覆盖——通知消息时间按系统时区显示（对齐上游 1.0.4）
• 反代配置查看弹窗：补齐内容区内边距（与头部 24px 对齐），新增来源说明（由 VPS 上的 fonu-agent 生成、文件名 fonu-<域名>.conf、手工修改会被下次部署覆盖），并改为说明固定 + 代码块内部滚动
• 反向代理：复制规则不再自动追加「-复制」后缀，保留原名称与域名、由用户在表单里确认修改（原先一点复制就得到一个改过名的副本，容易误建同名规则）（对齐上游 1.0.5）
• FRP 穿透页：frps 同源配置弹窗新增「VPS 防火墙 / 安全组放行 TCP 远程端口」提示，端口列表由已启用的 TCP/UDP 规则实时推导（与 frps 的 allowPorts 同源；未放行时隧道连不上，但日志不会点明原因）（对齐上游 1.0.3）
• 通知：Telegram 代理地址只填 host:port 时自动补全 http://，并校验 scheme 仅支持 http / https / socks5，错误信息带上原始地址便于自查（对齐上游 1.0.3）

修复

• 通知：单个通道密文解密失败不再让整份配置加载失败——原先 SMTP / Webhook / Telegram 任一密文损坏（例如更换过加密密钥）都会直接返回错误，导致其它已配置通道一并无法告警；现改为仅把该通道标记为「未配置」并继续解析其它通道（对齐上游 1.0.5）
• 反向代理：监听占用冲突提示写明占用方——优先规则备注名，其次该规则首个域名，最后回落 规则 #id；原先只说「已被其他规则使用」，用户得自己翻列表找是哪一条
• 反向代理：手动（custom）Nginx 配置的监听占用纳入校验。custom 配置的正本在文件系统（数据库只记 nginx_mode 开关），其 listen / server_name 原先完全不参与校验，与其它规则「同域名 + 同端口」的冲突只会在 Nginx reload 时静默失效（第一个 server 块生效、后面的被忽略）；现于保存 / 回滚时解析并写入新表 proxy_custom_endpoints，与表单规则共用同一条判定（对齐上游 1.0.5）
• 反向代理：并发下修改监听端口可能绕过保存前校验（UPDATE proxy_hosts 的唯一约束冲突此前直接抛出原始 SQL 错误），现改为按域名复检并给出带规则名的提示

变更

• 新增 docs/upstream-sync-plan.md：上游 1.0.2 → 1.0.5 的逐版本对照方案，含 8 项待核对项的代码级核实结论、不照搬项及原因、以及「可增加项清单」（11 项，按价值排序）
• 新增迁移 024_proxy_custom_endpoints.sql（手动 Nginx 配置的占用表，UNIQUE(rule_id, hostname, listen_port) + ON DELETE CASCADE），解析器 internal/nginx/endpoints.go（ParseServerEndpoints，保守解析：include 片段 / 正则 server_name / listen unix: 一律忽略，宁可漏报不误报）与 internal/proxy/custom_endpoints.go
• 补测试：internal/nginx/endpoints_test.go（多 server 块、[::] 写法、通配与正则、无 listen 默认 80）、internal/proxy/custom_endpoints_test.go（走真实迁移建内存库：冲突含规则名、排除自身、同域名不同端口放行、custom 占用对表单规则可见、级联清理）
• docs/upstream-sync-plan.md 补 §八「第 5 项详细整理」：Nginx 端口占用语义（一条规则占用哪些端口）、现有校验链逐跳、三处真实缺口与方案 A/B/C 对比、实施记录与未覆盖边界

[v1.2.1] - 2026-09-23

改进

• 公网 Agent 页：按「功能清单」重排为五段分区（运行状态 / 环境与依赖 / frps 控制 / Agent 生命周期 / 输出与日志）；4 张状态卡统一为标准 .stats-row + .stat-card 规格；补齐 5 项「数据已返回但页面未显示」的能力——Agent 凭据状态、8080 端口、已注册反代路由数、最后检查时间、Nginx 可用性
• 公网 Agent 页：「环境与依赖」改为三列并排（Fonu Agent / Nginx / frps 运行时），卡内短字段双列、长路径整行；「frps 控制」与「Agent 生命周期」两列并排；新增「配置查看」按钮（只读弹窗展示即将下发的 frps 配置，含复制），卸载（含数据）增加二次确认
• 公网反代页：规则台账改用 n-data-table（与本地反向代理页一致，表头与数据天然对齐），列为 规则/域名（含复制与打开按钮）、协议、上游/回源、健康（DNS·证书·隧道·服务）、连接、当前上传、当前下载、总上传、总下载、更新时间、操作
• 公网反代页：新增统计区（可部署规则 / 已生效 / 健康通过 / 当前连接）与环境与 Nginx 卡（4 列）；「使用说明」整卡改为页面级提示与入口行；部署设置弹窗对齐本地反向代理页规格（900px、三段式、页脚分隔线、开关行底色）并新增右侧「配置说明」栏
• 公网反代页：协议列改为按部署设置的「启用 HTTPS」自动识别（规则 type 恒为 http，不能代表入口协议），HTTPS 绿色 / HTTP 灰色并带悬停说明
• FRP 穿透页：4 张状态卡统一为标准统计区；公网服务端列表由自建网格改为 n-data-table（8 列，含启动/停止/查看/日志/测速/校验/Agent 管理/编辑/删除）
• FRP 穿透页：6 个弹窗统一到同一外壳（.frp-card-modal / .frp-detail-card），运行日志、导出配置、frps 同源配置、FRP 应用配置的头部/滚动区/页脚一致
• 统一设计令牌：清理硬编码色值（公网反代页 6 处、FRP 穿透页 13 处）与内联样式，删除死样式；统计区、弹窗、表格单元格全部走 --fonu-* 令牌与共享组件（StatusBadge / EmptyState / LoadError / FonuCard）
• 表格与列表交互：数字列右对齐、操作按钮右对齐并按行禁用、长文本换行、单元格内容垂直居中；窄屏按 1200 / 900 / 760 断点降列

修复

• FRP 穿透页「运行中」状态显示为灰色：statusKind 返回 'success' 却被当作 value 传给 StatusBadge（utils/status.ts 不识别该值，落到 unknown），且其中含非法的 'default'；现改为返回合法 StatusKind 并改用 :kind，服务端详情弹窗同类问题一并修复
• 表格单元格样式整体失效：n-data-table 的 render 函数用 h() 创建的节点不带 scoped 属性，导致 table-muted / type-chip / mono 与各 cell-* 样式未生效（表现为「上游/回源」两行变一行、域名与按钮错位、徽标无间距）；统一改用 :deep() 选择器
• 公网反代页刷新失败静默：loadErrorMsg 此前写入但从未渲染，现改为顶部可见提示，并让单个接口失败不再中断整轮数据加载
• 公网反代页切换服务端残留上一台数据、轮询在页面隐藏时仍请求、loading 粒度粗（任一操作全页按钮转圈）等问题修复

变更

• 新增设计文档：docs/agent-view-design-v2.md（公网 Agent 页）、docs/proxy-remote-design.md（公网反代页），以及被取代留档的 docs/agent-view-design.md、docs/agent-view-refactor-plan.md
• 新增页面 UI 标准 skill（工作区级 .breezell/skills/fonu-page-ui，不在仓库内）：页面骨架、共享组件契约、设计令牌、类名约定、弹窗标准结构、脚本约定与验收清单

[v1.2.0] - 2026-09-23

新增

• FRP 公网反代：独立「公网反代」页（/public-proxy）——服务端选择、规则列表（名称 / 域名 / 内网目标 / 回源端口）、部署与移除、配置查看、15 秒自动刷新
• FRP 公网反代：部署后回源自检——agent 写入配置后模拟 Nginx 回源（Host: 域名 → 127.0.0.1:<vhost 端口>）并分级提示：0=连接不上 vhost、404=隧道未注册、5xx=内网服务异常，不再出现「部署成功但打开 502」
• FRP 公网反代：状态徽章实时化——基于 nginx -T 同时判定「文件存在 / 语法通过 / 实际被加载」，展示已生效 / 已写入未加载 / 语法错误 / 未部署
• FRP 公网反代：配置查看——GET /api/v1/routes/{domain}/conf 直读 VPS 上生成的 nginx 配置，排障无需 SSH
• FRP 公网反代：五段健康检查（逐规则）——DNS 指向、证书覆盖与剩余天数、隧道注册、内网服务探活、反代生效态；任一断点红标 + 悬停显示原因
• FRP 公网反代：流量列——当前连接 / 当前上传 / 当前下载 / 总上传 / 总下载（取自 frps dashboard 聚合）
• FRP 公网反代：「部署设置」弹窗（与本地反向代理弹窗同构，三 Tab）
  • 基础：启用 HTTPS（显式开关）、HTTP 强制跳转、WebSocket、上传大小限制、代理读超时
  • 安全：IP 白名单、IP 黑名单、Basic Auth（用户名 + 自定义密码，留空首次自动生成）、仅中国大陆 IP
  • 高级：安全响应头（HSTS / X-Frame-Options / X-Content-Type-Options / Referrer-Policy）、仅 TLS 1.3、请求限流（速率 / 突发）、每 IP 连接数上限
• FRP 公网反代：限流与连接数落地——agent 生成 fonuagent-limits.conf（http 上下文 zone 定义，由状态文件驱动增删），server 内输出 limit_req_status 429 / limit_conn_status 503
• FRP 公网反代：仅中国大陆 IP——Fonu 把本地维护的中国 IP 段下发到 agent（PUT /api/v1/china-cidr），agent 生成 geo $fonu_china_client；IP 段未更新时部署显式报错，不产出半成品配置
• FRP 公网 Agent：新增独立「公网 Agent」页（/frp-agent）——agent 状态面板、frps 配置下发、frps 版本安装 / 升级、frps 启停与重启、frps 管理入口、日志、SSH 生命周期与诊断
• FRP 公网 Agent：Nginx 状态卡片——状态徽标（正常 / 未安装 / 配置校验未通过 / 已安装未运行）、版本、可执行路径、vhost 配置目录、nginx -t 结果、80/443 监听、反代配置文件数
• FRP 公网 Agent：一键安装 Nginx——agent 识别 apt-get / dnf / yum / apk 非交互安装并启动，回写探测结果（需 agent 以 root 运行）
• FRP 公网反代：兼容 frps v0.68 与 v0.71+——新版走 GET /api/v2/proxies，旧版走 GET /api/proxies/{user.name} 逐条查询

改进

• FRP 公网反代：部署选项（WebSocket / 强制跳转 / IP 白名单 / Basic Auth 等）从穿透规则弹窗迁移到公网反代页「部署设置」，语义归位（这些是公网反代属性，与隧道无关）
• FRP 公网反代：隧道匹配优先按域名（spec.http.customDomains），比按代理名猜测可靠；同时兼容 user 前缀（admin.<规则名>）与裸规则名
• FRP 公网反代：frps 管理接口调用失败时把具体原因透出到前端悬停（请求 URL、状态码、响应体、密码读取 / 解密环节），不再笼统提示「接口不可用」
• FRP 公网反代：部署预检——未安装 Nginx 时直接提示「VPS 未安装 Nginx，请先安装（apt install nginx / yum install nginx）」，替代 nginx config rejected 技术堆栈
• FRP：agent 部署接口由 10 个位置参数改为 RouteSpec 结构体（SyncRouteSpec），SyncRouteEx 保留为兼容包装
• FRP：agent 版本递增至 0.9.1，状态新增 nginx_ok / nginx_missing / nginx_running / nginx_path / nginx_version / nginx_error
• FRP：agent 0.9.2——Basic Auth 哈希改为纯 Go apr1（与 openssl passwd -apr1 输出逐字节一致，已用参考向量做单元测试），安装脚本 token 改用 /dev/urandom：agent 与安装流程彻底去除对 VPS 上 openssl 的依赖（原先缺 openssl 时会静默写入空 token、导致 Fonu 无法认证 agent）

修复

• FRP 公网反代：隧道状态误报 ✗——RouteHealth 静默忽略 dashboard 密码解密错误导致空密码 401，现逐环节记录并透出
• FRP 公网反代：隧道检测端点错配——旧代码请求 /api/proxies（405）或按类型子端点（404），现按 frps 版本自适应并解析 V2 的 data.items
• FRP 公网反代：流量恒为 0——V2 返回的键是 admin.ssssss 而代码只查裸规则名，现按「裸名 / user 前缀名 / 域名索引」三级匹配
• FRP 公网反代：列表健康徽标样式丢失（此前无样式渲染）
• 修复被外部进程清空的 internal/frp/store.go、internal/api/ddns_handler.go、web/src/views/DdnsView.vue

变更

• FRP 公网反代管理从「公网 Agent」页拆分为独立页面（/public-proxy），侧栏新增「公网反代」
• 新增 agent 端点：GET /api/v1/routes/{domain}/conf、PUT /api/v1/china-cidr、POST /api/v1/nginx/install
• 新增 Fonu 接口：GET /api/frpmulti/servers/{id}/agent/routes/health、GET /api/frpmulti/servers/{id}/agent/routes/{proxyID}/conf、POST /api/frpmulti/servers/{id}/agent/nginx/install
• 明确不做（已写入 docs/agent-proxy-settings-plan.md）：公网反代不使用「目标 Host 头」（会破坏 frps vhost 路由导致 404）、不做「忽略后端 TLS 校验」（回源为明文 HTTP）、不做公网侧自定义 upstream 覆盖（会绕过隧道）

[v1.1.0] - 2026-09-19

新增

• FRP：新增公网 fonu-agent 服务端管理基础能力——VPS 侧提供 Bearer Token API，Fonu 本地可测试 Agent、读取状态、下发 frps.toml，并在 HTTP/HTTPS 规则保存后同步公网 Nginx 反代路由
• FRP：服务端新增「Agent 管理」弹窗——API 状态面板（连接/frps/Nginx/80-443 端口监听/已注册路由）与 SSH 生命周期操作（探测环境、一键安装/升级/卸载、SSH 诊断），安装后自动回填 Agent 地址与 Token；agent 二进制内嵌随主程序分发，无需单独下载
• FRP：模块整体升级为多服务端管理——支持添加多台 frps（独立启动 / 停止 / 日志 / 测速 / 校验），穿透规则支持全部 8 种类型（tcp / udp / http / https / tcpmux / stcp / sudp / xtcp）与插件（static_file / socks5 / https2http 等，按插件类型校验必填字段）
• FRP：服务端详情五项独立诊断（TCP 可达 / frpc 登录 / 代理可达 / DNS 解析 / 归属地），含最近 30 分钟可用率与延迟曲线
• FRP：frps.toml 同源生成——服务端「详情」一键生成与 frpc 侧配置同源的服务端配置（bindPort / 认证 / webServer / 传输参数 / vhost 端口 / 防火墙放行清单）；支持 token / 无认证 / OIDC 三种方式；格式对齐官方 frps_full_example.toml（v0.52.0+ TOML，v0.63.0+ 均适用）
• FRP：穿透规则实时流量与连接数展示（需在 frps 配置 webServer 管理接口）
• FRP：「应用配置」旁新增「使用说明」——配置流程、DDNS / 反向代理 / 证书组合说明与十个组合场景详解（双标签页 + 手风琴折叠展示）
• FRP：frpc 客户端多版本管理（「应用配置」弹窗内下载 / 启用 / 删除 / 配置下载代理）
• DDNS：新增「自定义 IP」——按任务设置固定 IPv4 / IPv6（如公网服务器 IP），更新时直接使用该 IP，不再检测本机出口 IP；须为公网地址，否则拒绝更新

改进

• FRP：脱敏令牌完整闭环——Token / OIDC 客户端密钥 / frps 管理密码掩码往返保护，回传掩码不会覆盖真实凭据；表单统一「已配置」标识
• FRP：服务端详情「配置」面板重新分组排版（描述 / 连接与认证 / 诊断）
• 前端：使用说明弹窗对齐「添加穿透规则」弹窗的自绘外壳样式

变更

• FRP：旧「Nginx 网关模式」退役——原 5 条 /api/frp 接口移除，由 /api/frpmulti 接管；旧实现归档为 internal/frp-1.0.2（不参与运行、可整目录删除）；旧网关配置（settings 键值）保留但不再读取，升级后需在「FRP 穿透」页重新配置服务端
• 数据库：新增迁移 015–021（FRP 多服务端核心表）与 022（DDNS 自定义 IP 字段），升级后首次启动自动应用

[v1.0.2] - 2026-09-18

新增

• 证书：支持火山引擎 DNS 的 ACME DNS-01 验证

[v1.0.1] - 2026-09-18

新增

• DDNS：支持火山引擎 DNS（AccessKey / Secret Access Key）
• DDNS：委托子域与多层子域名 Zone 自动匹配（最长后缀优先，如 a.zzz.com）

改进

• DDNS：解析记录统一展示完整域名；任务列表仅显示记录条数
• DDNS：保存时校验域名格式（非法字符、标签长度、连字符位置）
• 证书：火山引擎 DNS 任务申请证书时给出明确不支持 DNS-01 的提示

修复

• DDNS：多层子域名（如 aaaa.vvv.bbb.com、www.a.zzz.com）保存后被截断的问题
• DDNS：同一任务混用多根域/委托子域时 Zone 解析错误

[v1.0.0] - 2026-09-18

新增

• 通知：支持 SMTP 邮件、Webhook 预设（Bark / ntfy / Gotify / 自定义）与 Telegram 机器人（可选 HTTP 代理），全局仅可启用一种方式
• 设置页新增「测试通知」按钮，无需保存即可验证当前配置
• 告警事件：DDNS / 证书 / 安全 / 系统分组，含 IP 变更、续签成功/失败、登录异常、Nginx 重载失败等
• 设置页改为「常规 / 通知 / 安全 / 高级」分栏，减轻单页信息密度
• 日志中心：系统日志、访问日志、Nginx 错误日志三 Tab；移除实时日志 SSE
• 凭据类字段统一「已配置」标识与「留空表示不修改」占位（SMTP / Webhook / Telegram / DDNS / FRP / Basic Auth 等）

改进

• 旧版 notify_webhook_url 自动迁移为「自定义 Webhook」
• 通知密钥加密存储，接口不再返回明文；保存后表单状态与服务端同步
• 系统日志中文展示（历史英文日志兼容翻译）
• 仪表盘与反代详情「最近访问」展示反代服务名而非域名
• README 界面截图更新为原图，两列排版展示

修复

• 通知 / 系统设置保存后刷新丢失的问题

[v0.1.31] - 2026-09-18

新增

• 反向代理 Nginx：支持单条规则自动/手动编辑、备份与回滚；详情页只读预览，编辑弹窗内配置
• 设置页 Nginx 全局片段：http 块自定义编辑，默认上传大小 50M 片段与框架说明
• Nginx 编辑器：CodeMirror 语法高亮；自动生成配置附带中文注释
• 保存 Nginx 时基础语法校验（无 nginx 可执行文件时亦可拦截明显错误）

改进

• 反代日志面板：移除「隐藏轮询」开关，简化日志工具栏

[v0.1.30] - 2026-09-17

修复

• 反向代理 Basic Auth：htpasswd 文件补充 nginx 可读权限与 bcrypt 前缀兼容，修复认证后 500 错误
• 反代连接数：按「域名 + 监听端口」统计，修复同域名多规则互相串数的问题
• 仪表盘「今日请求」：排除错误页与 favicon 噪音，趋势改为较昨日对比

新增

• 反代详情日志：支持全屏查看实时访问日志

[v0.1.29] - 2026-09-17

修复

• 反向代理 Basic Auth：修复密码哈希在 Nginx 重载前被剥离导致认证不生效的问题
• 反代上传：全局默认 client_max_body_size 50m，修复大文件上传 413 错误

改进

• README 更新界面截图（v0.1.28）并补充开源地址与协议说明

[v0.1.28] - 2026-09-16

修复

• 仪表盘「今日请求」：改为今日 0–24 时固定坐标轴（00:00–22:00），未来时段为空

改进

• FRP Token：保存后显示「已保存」状态，说明不显示明文的原因
• FRP Web 穿透：移除重复域名输入框，统一在「已同步域名」弹窗中编辑保存

[v0.1.27] - 2026-09-16

修复

• FRP：移除无效的 pidFile 配置项，修复 frpc 启动即退出（exit status 1）
• FRP：关闭穿透时保存按钮不可用，导致无法真正关闭
• FRP：frps 配置随连接设置实时生成，不再展示静态示例
• 仪表盘「今日请求」：改为滚动最近 24 小时统计，修复当前时段无数据

改进

• Docker 镜像内置 frpc 升级至 v0.71.0

[v0.1.26] - 2026-09-16

新增

• FRP 内网穿透（Nginx 网关模式）：独立「内网穿透」页面配置 frps 连接，自动穿透本地 Nginx HTTP/HTTPS 端口
• Docker 镜像内置 frpc v0.66.x（amd64 / arm64）
• DDNS 页：FRP 启用时提示将域名解析到 VPS 公网 IP

[v0.1.25] - 2026-09-15

新增

• DDNS 与证书 DNS-01：支持腾讯云 DNS（SecretId + SecretKey，区别于 DNSPod ID+Token）

[v0.1.24] - 2026-09-14

修复

• 中国 IP 段更新后 nginx 重载失败：校验用临时文件，应用配置时改用正式的 china_cidr.conf
• 仪表盘「今日请求」图表：从完整 access.log 按小时统计，不再仅用最近 10 条访问记录

[v0.1.23] - 2026-09-14

修复

• 自定义错误页插图无法显示：图片路径改为公开 location，浏览器可正常加载 error.png / 429.png

[v0.1.22] - 2026-09-14

改进

• 仅中国大陆：内网 IP（10/8、172.16/12、192.168/16 等）默认放行，无需手动加白名单
• 自定义错误页图片内嵌进二进制，Docker 镜像补充 web/assets/image 资源目录

修复

• 错误页目录权限：生成后自动 chmod/chown，避免 nginx（www-data）无法读取导致回退默认 403 页
• 中国 IP 段未就绪时，仅中国大陆规则改为只拦截非公网内网地址

[v0.1.21] - 2026-09-14

新增

• 反代安全设置：IP 黑/白名单、仅中国大陆、Basic Auth、速率/连接数限制
• 设置页：信任代理（CDN Real IP）、全局 IP 黑名单、中国 IP 段定时更新
• 自定义 Nginx 错误页（403 / 404 / 429 / 500 / 503）
• 高级选项：上游 TLS 校验跳过、目标 Host 头、TLS 1.3 仅、HTTPS 安全响应头

改进

• 中国 IP 段：同步更新 API、ghfast 镜像回退、多源下载与状态展示
• 反代编辑/详情弹窗 UI 重构；列表域名访问链接与复制
• 仅中国大陆 + 白名单：白名单 IP 正确豁免大陆限制（geo + 变量组合）

修复

• 白名单模式开启但未填 IP 时的校验
• API 测试依赖 settings 包导入

[v0.1.20] - 2026-09-13

改进

• 反代详情改为弹窗展示，概览布局重排（信息条 + 图表/指标 + 最近访问）
• 标题栏显示当前连接数；最近访问列表支持纵向滚动
• 反代详情日志结构化展示（时间、方法、路径、状态码等分列）

文档

• README 默认反代端口更新为 18080 / 9443

[v0.1.19] - 2026-09-13

修复

• 反代详情日志：修复无法滚动的问题，悬停显示滚动条，默认跟随最新日志

[v0.1.18] - 2026-09-13

改进

• 反代详情：概览 / 日志 Tab 切换，默认概览；日志区域撑满侧栏
• 反代列表：状态列改为开关，可直接启用/停用
• 反代「复制」改为填入新建表单（名称加 -复制 后缀）
• README Docker 徽章按 semver 排序，避免显示 -amd64 标签

移除

• 反代详情「设置」Tab 与拖动排序提示文案

[v0.1.17] - 2026-09-13

新增

• 反代规则「备注」改为「名称」，列表以名称优先展示
• 反代规则复制当前信息到剪贴板
• 反代列表拖动排序（无筛选时）

[v0.1.16] - 2026-09-13

改进

• 证书申请：首次未配置 ACME 邮箱时提示填写，前后端校验邮箱格式
• 证书列表空状态与反代/DDNS 页风格统一

[v0.1.15] - 2026-09-13

修复

• Docker 发版：amd64/arm64 均构建完成后再推送 latest 与版本多架构 manifest
• 补全 web/assets/image 品牌图片资源，同步仪表盘 banner

改进

• arm64 镜像构建：前端与 Go 在 BUILDPLATFORM 编译，缩短 QEMU 构建时间

[v0.1.14] - 2026-09-13

新增

• ZeroSSL 证书申请支持
• 反代规则备注字段；域名+端口唯一约束
• 可配置默认反代监听端口（FONU_NGINX_HTTP_PORT / FONU_NGINX_HTTPS_PORT），适配飞牛 host 部署
• docker-compose.host.yml 飞牛 host 模式部署示例
• 全新 Web UI：品牌视觉、仪表盘、证书/DDNS/反代/设置页重构

改进

• README 重写：飞牛 fnOS 部署说明、界面截图、Docker Hub 徽章
• /api/version 返回默认反代端口配置
• 移除仓库内 scripts/、cmd/seed 本地开发辅助

[v0.1.13] - 2026-09-13

修复

• 修复证书页 TypeScript 类型错误导致 Docker 构建失败

[v0.1.12] - 2026-09-12

新增

• DDNS：单任务支持多根域名，列表按域名展示解析 IP 与同步状态
• 证书：申请进度弹窗与实时日志（SSE 异步任务）；列表支持下载证书/私钥/ZIP
• 反代：按规则实时访问日志、流量统计（累计/速率）与当前连接 IP 查看
• 日志：访问/错误/运行日志分页；实时日志预载最近 100 条 Nginx 记录

修复

• 实时日志 SSE 因中间件未转发 Flush 导致始终为空
• Vite 开发代理对 SSE 流的缓冲问题
• 证书申请：同一 DDNS 凭证管理多个根域（如 roven.cc + chiak.cc）时校验失败
• 首次启动自动创建管理员并在运行日志输出初始密码（移除独立初始化页）
• 证书申请失败写入 last_error 并在列表展示
• 系统日志过滤无意义 API 轮询噪音

改进

• 仪表盘/证书/DDNS 列表加载优化（轻量接口与缓存刷新）
• Nginx 访问日志增加 request_length / bytes_sent 供流量统计
• 反代与证书页操作按钮横排布局

[v0.1.11] - 2026-09-12

修复

• Vite 开发服务器允许经 Nginx 反代用自定义域名访问（server.allowedHosts）

[v0.1.10] - 2026-09-12

修复

• Windows 本地 Nginx：证书/日志使用绝对路径，HTTPS 块先于 HTTP 重定向，修复 ssl_certificate 校验失败
• Windows 进程检测与启动：修复 isPIDAlive 误判、启动阻塞及重复拉起 Nginx 导致端口冲突
• 系统日志写入 app.log，API 请求记录状态码；实时日志连接时预载最近条目
• 未设置 FONU_DATA_DIR 时默认使用当前目录 .data

改进

• 新增 scripts/dev.ps1、scripts/clean-data.ps1 便于 Windows 本地开发
• 测试与文档示例域名统一为 example.com，移除个人域名硬编码

[v0.1.9] - 2026-09-12

修复

• 反代保存/删除不再因 Nginx 重载卡住 30 秒：优先 SIGHUP 信号重载，失败时快速强制重启
• 保存/更新规则先落库再重载 Nginx，避免超时后规则未写入
• 部分成功（规则已保存但 Nginx 失败）时前端仍关闭弹窗并刷新列表

[v0.1.8] - 2026-09-12

修复

• 修复反代规则删除无反应：删除失败时显示错误提示；Nginx 重载失败时不再回滚已删除的规则

[v0.1.7] - 2026-09-12

改进

• 界面左下角版本号随发版标签注入，与 Docker 镜像版本一致（不再固定显示 v0.1.0）
• 新增 GET /api/version 接口；发版时更新根目录 VERSION 文件

[v0.1.6] - 2026-09-12

修复

• 为 Nginx 校验/重载/启动命令增加 15 秒超时，避免反代保存时无限转圈
• 前端 API 请求增加 30 秒超时，超时后显示明确错误提示
• Nginx 重载失败时先尝试优雅停止再重启，降低端口占用导致的卡死

[v0.1.5] - 2026-09-12

修复

• 反代证书匹配改为读取证书库记录与磁盘文件，导入证书可正确用于 Nginx HTTPS
• 启用 HTTPS 但域名未匹配证书时，返回明确错误（含当前证书覆盖范围）而非 Nginx 校验失败
• 修复 HTTPS 配置生成时可能遗漏 HTTP 回退的问题

[v0.1.4] - 2026-09-12

修复

• 修复启用 HTTPS 但证书文件不可用时，Nginx 生成 listen ... ssl 却缺少 ssl_certificate 导致反代保存失败
• 仅在证书文件完整存在时生成 HTTPS 配置，否则自动降级为 HTTP

[v0.1.3] - 2026-09-12

新增

• 反代多域名：一条规则支持多个前端域名、自定义监听端口，以及 IPv4/IPv6 监听开关
• 单域名独立端口：前端地址可写 example.com:6893 覆盖规则默认端口

改进

• 本地开发未安装 Nginx 时，保存反代规则仍写入配置并跳过校验，便于调试 UI

数据库迁移

• 006_proxy_multi_host.sql — 反代规则多域名与监听配置

[v0.1.2] - 2026-09-12

修复

• 修复 Nginx PID 文件为空或进程已退出时仍尝试重载，导致反代规则保存失败

[v0.1.1] - 2026-09-12

修复

• 修复全新部署时 API 返回 null 导致仪表盘/日志等页面空白、map 报错
• 修复 Nginx 重载使用错误 PID 路径（/run/nginx.pid）导致反代保存失败
• 公网 IP 检测增加多个备用服务，降低 Docker 环境下单点失败概率
• 修复 SPA 路由刷新时未正确回退到 index.html

[v0.1.0] - 2026-09-12

新增

• DDNS 多域名：支持多条 DDNS 配置，独立管理根域名与记录
• 证书多域名：申请/续签支持多域名与通配符（*.example.com）
• ACME 颁发机构：申请与续签时可选择 Let's Encrypt 正式/测试环境
• 证书导入：支持粘贴 PEM 或指定文件路径导入自签/已有证书
• Docker 发版：推送 v* 标签自动分架构推送镜像（latest / 0.1.0 / 0.1.0-amd64 / 0.1.0-arm64）
• 表格操作规范：所有列表操作按钮平铺展示（renderTableRowActions）

改进

• 仪表盘：全新布局，ECharts 图表，状态卡片与日志预览
• 日志页：分页（20 条/页），支持 ?tab= 跳转，统一时间格式
• 证书页：概览统计、申请弹窗优化、表格自适应宽度
• 布局：顶栏时间靠左、操作靠右，内容区铺满主区域
• 主题：深色模式与组件样式统一

数据库迁移

• 003_ddns_multi.sql — DDNS 多配置
• 004_cert_acme_ca.sql — 证书 ACME CA 字段
• 005_cert_domains.sql — 证书多域名