Files
frpc-console/update-logs.md
T
2026-07-30 12:48:29 +08:00

99 lines
5.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<<<<<<< HEAD
# frpc-console 更新日志
## 📌 版本说明
| 版本类型 | 标记 | 适用场景 |
|----------|------|----------|
| LTS 正式版 | `-lts` | 生产环境,长期维护 |
| 技术预览版 | `-preview` | 功能前瞻,建议测试环境验证 |
---
## 🚀 2.3-preview (2026-07-28)
> **技术预览版** —— 在 LTS 稳定核心(2.0)基础上,集成 2.1 与 2.2 的新特性,并完成基础设施层的全面加固。
### ✨ 新增特性
- **Ping 延迟检测** —— 顶部导航实时显示 frpc 到 frps 的延迟,状态图标 + ms 值,直观反映网络质量(2.1)
- **用户配置页独立** —— 账户管理与全局配置分离,用户信息与 frpc 配置各自独立管理(2.1)
- **声明式数据库迁移引擎** —— 基于 `db-history.go` 的 Schema 版本声明,对比新旧差异自动决定迁移路径(2.2)
### 🔧 改进与优化
- **401 统一拦截** —— API 请求返回 401 时自动清除认证状态并跳转登录页,避免页面卡死(2.1)
- **数据库路径统一** —— 数据库文件固定为 `./frpc-console.db`Docker 部署时挂载整个 `/app` 目录,所有运行时文件(db / toml / log / pid)完整持久化
- **`deploy.sh` 部署逻辑重构** —— 备份 → 拉代码 → 停容器 → 构建 → 启动,顺序闭环;移除宿主机编译,全部交由 Docker 多阶段构建处理
- **Dockerfile 多阶段构建** —— 自动处理 `go.mod` 降级兼容,安装 `sqlite` 辅助工具,便于部署脚本验证数据库状态
- **前端加载状态管理** —— 新增 `authLoading` 状态,首次访问时先完成用户检查再渲染页面,彻底解决刷新后登录/注册页状态错乱的竞态问题
- **`schema_version` 兜底写入** —— `InitDB()` 末尾强制补写 Schema 版本,确保每次启动都能识别已有数据,彻底解决升级后反复跳转注册页的问题
- **`docker-compose.yml` 配套工具** —— 简化开发调试流程,支持快速重建容器
### 🐛 修复
- 修复 `ExportTomlHandler` 模板渲染时缺少 `WireProtocolLine` 字段的问题
- 修复 `deploy.sh` 升级时用空文件覆盖旧数据库的问题
- 修复 Docker 镜像中 `sqlite3` 包名错误导致 `deploy.sh` 无法验证数据库的问题
- 修复首次访问刷新时登录/注册页显示异常的前端竞态问题
### 📦 部署变更
- 挂载方式:`-v ${DEPLOY_DIR}:/app`(整个 `/app` 目录)
- 数据库位置:`/opt/frpc-console/frpc-console.db`
- 备份目录:`/tmp/frpc-console/db-backups`
- 容器内工具:`sqlite` 已预装,便于调试
---
### 2.0-LTS 2026-07-27
=======
## 📝 更新日志
### 2.0-ReleaseLTS,跟随上游提供支持,frps 端现已正式发布,frpc 端测试中,敬请期待……)
>>>>>>> test
> 本次 LTS 版本聚焦于**稳定性兜底与协议能力对齐**,是 frp 0.70.0 LTS 的下游管理工具。
· 🚀 **frp v2 协议正式启用** —— `wireProtocol = "v2"` 配置项可用,灰标状态解除,实测稳定</br>
· 🔒 **数据库迁移引擎完整实现** —— 版本驱动的增量迁移 + 迁移前自动全量备份 + 失败可回滚,升级不再提心吊胆</br>
· 🧩 **配套工具 frps-console 同步发布** —— 同一套设计哲学,一个管理 frpc,一个管理 frps,版本号同步,LTS 同步
<<<<<<< HEAD
### 1.5-Preview (2026-07-25)non-LTS
=======
### 1.5-Release (2026-07-25)non-LTS
>>>>>>> test
> 本次更新聚焦于**WebUI 交互体验与基础工程能力**,为 2.0 LTS 铺路。
· ✨ **全局配置页面卡片式重构** —— 按“服务器连接 / 传输配置 / 日志配置”分组,告别折叠面板</br>
· ✨ **新增运行日志面板** —— WebUI 内实时查看 frpc 日志,8 秒自动轮询,最大 200 行,调试方便不少</br>
· ✨ **frp v2 配置占位** —— UI 开关已就绪(灰标禁用),为 2.0 的正式启用做好铺垫</br>
· 🔩 **数据库 Schema 迁移框架** —— 启动时自动检测并补全缺失列,升级不再依赖手动改表(2.0 在此基础上升级为完整备份 + 回滚)</br>
· 🔐 **默认配置脱敏** —— 移除个人服务端地址与令牌,改为通用占位符,避免开箱即连别人的服务器</br>
· 🎨 **样式拆分与优化** —— 按职责拆分为多个 CSS 文件,维护更清晰
<<<<<<< HEAD
### 1.0-Preview (2026-07-24)non-LTS
=======
### 1.0-Release (2026-07-24)non-LTS
>>>>>>> test
> 首次发布,核心功能全部就绪。
· 🎉 **首次发布**</br>
· 📋 **隧道全生命周期管理** —— 增删改查 + 一键启用/禁用</br>
· 📦 **TOML 导入/导出** —— 无缝迁移现有 frpc 配置</br>
· 🔄 **配置热加载** —— 修改即生效,无需重启 frpc</br>
· 🔐 **首次启动 Web 注册** —— 无需命令行交互</br>
· 🖥️ **多平台支持** —— Windows / Linux / ARM 全平台兼容</br>
· 🐳 **容器化就绪** —— Docker 镜像,开箱即用</br>
<<<<<<< HEAD
· 🎨 **深色磨砂玻璃 UI** —— 现代化视觉体验</br>
=======
· 🎨 **深色磨砂玻璃 UI** —— 现代化视觉体验</br>
>>>>>>> test