6.0 KiB
6.0 KiB
📌 版本说明
| 版本类型 | 标记 | 适用场景 |
|---|---|---|
| LTS 正式版 | -lts |
生产环境，长期维护 |
| 技术预览版 | -preview |
功能前瞻，建议测试环境验证 |
🚀 2.4-lts (2026-07-30)
紧急修复版 —— 架构升级与部署流程重构
本次版本为 非正统 LTS 版本（2.4 在语义版本中不属于 LTS 序列），因
main分支在新架构迁移过程中出现编译阻塞，为快速恢复 LTS 通道可用性而发布。2.5-lts 将回归正常语义版本规则。
🔧 核心变更
- 部署架构重构 —— 引入
run-deploy.sh独立入口，实现部署脚本与项目分支解耦 - 数据目录规范化 —— 所有运行时文件（数据库、配置、日志、PID）统一迁移至
/app/data子目录，挂载点从/app收窄至/app/data，彻底解决挂载覆盖二进制文件的问题 - 版本管理解耦 —— 二进制不再注入版本信息，版本由
deploy.sh在部署时写入version.ini文件 - PID 文件进程检测 —— frpc 状态检测从
ps | grep改为基于 PID 文件，更加可靠 - 旧版本自动迁移 —— 检测到根目录存在旧数据文件时，自动迁移至
data/子目录，并保留备份
✨ 功能完整
- Ping 延迟检测（顶部导航实时显示）
- 用户配置页独立（账户管理与全局配置分离）
- 401 统一拦截（认证过期自动跳转登录）
- 声明式数据库迁移引擎（基于
db-history.go） - frp v2 协议正式启用（
wireProtocol = "v2"）
📦 部署变更
| 变更项 | 旧方案 | 新方案 |
|---|---|---|
| 挂载点 | -v ${DEPLOY_DIR}:/app |
-v ${DEPLOY_DIR}/data:/app/data |
| 数据库路径 | /app/frpc-console.db |
/app/data/frpc-console.db |
| 配置文件 | /app/frpc.toml |
/app/data/frpc.toml |
| 版本文件 | 编译时注入 -ldflags |
部署时写入 version.ini |
🐛 修复
- 修复
main分支因挂载覆盖导致二进制文件不可用的问题 - 修复
ps | grep进程检测在容器环境不可靠的问题 - 修复旧版本升级时数据库路径不兼容的问题
🚀 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 正式版 —— 与 frps-console 2.0-lts 同步发布，共享版本号与 LTS 维护周期。
- 🚀 frp v2 协议正式启用 ——
wireProtocol = "v2"配置项可用，实测稳定 - 🔒 数据库迁移引擎完整实现 —— 版本驱动的增量迁移 + 迁移前自动全量备份 + 失败可回滚
- 🧩 frps-console 同步发布 —— 同一套设计哲学，一个管理 frpc，一个管理 frps
🧪 1.5-release (2026-07-25) (non-LTS)
非长期支持版本，建议用于尝鲜测试，生产环境请使用 2.0-lts 及后续 LTS 版本。
- ✨ 全局配置页面卡片式重构（服务器连接 / 传输配置 / 日志配置）
- ✨ 新增运行日志面板（8 秒轮询，最大 200 行）
- ✨ frp v2 配置占位（UI 灰标禁用，为 2.0 铺路）
- 🔩 数据库 Schema 迁移框架（启动时自动补全缺失列）
- 🔐 默认配置脱敏（通用占位符，避免开箱即连他人服务器）
- 🎨 样式拆分与优化（style-3.css / style-4.css）
🎉 1.0-release (2026-07-24) (non-LTS)
首次公开发布，核心功能全部就绪。
- 🎉 首次发布
- 📋 隧道全生命周期管理（增删改查 + 启用/禁用）
- 📦 TOML 导入/导出（无缝迁移现有 frpc 配置）
- 🔄 配置热加载（修改即生效，无需重启 frpc）
- 🔐 首次启动 Web 注册（无需命令行交互）
- 🖥️ 多平台支持（Windows / Linux / ARM 全平台）
- 🐳 容器化就绪（Docker 镜像，开箱即用）
- 🎨 深色磨砂玻璃 UI