81 lines
4.7 KiB
Markdown
81 lines
4.7 KiB
Markdown
# 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）
|
||
|
||
> 本次 LTS 版本聚焦于**稳定性兜底与协议能力对齐**，是 frp 0.70.0 LTS 的下游管理工具。
|
||
|
||
· 🚀 **frp v2 协议正式启用** —— `wireProtocol = "v2"` 配置项可用，灰标状态解除，实测稳定</br>
|
||
· 🔒 **数据库迁移引擎完整实现** —— 版本驱动的增量迁移 + 迁移前自动全量备份 + 失败可回滚，升级不再提心吊胆</br>
|
||
· 🧩 **配套工具 frps-console 同步发布** —— 同一套设计哲学，一个管理 frpc，一个管理 frps，版本号同步，LTS 同步
|
||
|
||
|
||
### 1.5-Preview (2026-07-25)（non-LTS）
|
||
|
||
> 本次更新聚焦于**WebUI 交互体验与基础工程能力**，为 2.0 LTS 铺路。
|
||
|
||
· ✨ **全局配置页面卡片式重构** —— 按“服务器连接 / 传输配置 / 日志配置”分组，告别折叠面板</br>
|
||
· ✨ **新增运行日志面板** —— WebUI 内实时查看 frpc 日志，8 秒自动轮询，最大 200 行，调试方便不少</br>
|
||
· ✨ **frp v2 配置占位** —— UI 开关已就绪（灰标禁用），为 2.0 的正式启用做好铺垫</br>
|
||
· 🔩 **数据库 Schema 迁移框架** —— 启动时自动检测并补全缺失列，升级不再依赖手动改表（2.0 在此基础上升级为完整备份 + 回滚）</br>
|
||
· 🔐 **默认配置脱敏** —— 移除个人服务端地址与令牌，改为通用占位符，避免开箱即连别人的服务器</br>
|
||
· 🎨 **样式拆分与优化** —— 按职责拆分为多个 CSS 文件，维护更清晰
|
||
|
||
|
||
### 1.0-Preview (2026-07-24)（non-LTS）
|
||
|
||
> 首次发布，核心功能全部就绪。
|
||
|
||
· 🎉 **首次发布**</br>
|
||
· 📋 **隧道全生命周期管理** —— 增删改查 + 一键启用/禁用</br>
|
||
· 📦 **TOML 导入/导出** —— 无缝迁移现有 frpc 配置</br>
|
||
· 🔄 **配置热加载** —— 修改即生效，无需重启 frpc</br>
|
||
· 🔐 **首次启动 Web 注册** —— 无需命令行交互</br>
|
||
· 🖥️ **多平台支持** —— Windows / Linux / ARM 全平台兼容</br>
|
||
· 🐳 **容器化就绪** —— Docker 镜像，开箱即用</br>
|
||
· 🎨 **深色磨砂玻璃 UI** —— 现代化视觉体验</br>
|