-
2.4-lts Stable
lxh2875931338 released this
2026-08-02 00:00:14 +08:00 | 0 commits to main since this release🚀 2.4-lts (2026-08-01)
紧急修复版 —— 架构升级与部署流程重构
本次版本为 非正统 LTS 版本（2.4 在语义版本中不属于 LTS 序列），因
main分支在新架构迁移过程中出现编译阻塞，为快速恢复 LTS 通道可用性而发布。2.5-lts 将回归正常语义版本规则。🔧 核心变更
- 部署架构重构 —— 引入
run-deploy.sh独立入口，实现部署脚本与项目分支解耦 - 数据目录规范化 —— 所有运行时文件（数据库、配置、日志、PID）统一迁移至
/app/data子目录，挂载点从/app收窄至/app/data，彻底解决挂载覆盖二进制文件的问题 - 版本管理解耦 —— 二进制不再注入版本信息，版本由
deploy.sh在部署时写入version.ini文件 - PID 文件进程检测 —— frps 状态检测从
ps | grep改为基于 PID 文件，更加可靠 - 旧版本自动迁移 —— 检测到根目录存在旧数据文件时，自动迁移至
data/子目录，并保留备份
✨ 功能平行对齐
- 用户配置页独立（账户管理与全局配置分离）
- 401 统一拦截（认证过期自动跳转登录）
- 声明式数据库迁移引擎（基于
db-history.go） - frp v2 协议正式启用（
wireProtocol = "v2"） - 密码策略优化（不再强制要求特殊字符，改为长度 ≥ 8 + 大小写字母 + 数字）
📦 部署变更
变更项 旧方案 新方案 挂载点 -v ${DEPLOY_DIR}:/app-v ${DEPLOY_DIR}/data:/app/data数据库路径 /app/frps-console.db/app/data/frps-console.db配置文件 /app/frps.toml/app/data/frps.toml版本文件 编译时注入 -ldflags部署时写入 version.ini🐛 修复
- 修复
main分支因挂载覆盖导致二进制文件不可用的问题 - 修复
ps | grep进程检测在容器环境不可靠的问题 - 修复旧版本升级时数据库路径不兼容的问题
- 修复 Docker 构建缓存导致代码修改不生效的问题（引入
--no-cache强制重建） - 修复前端密码提示与后端校验规则不一致的问题
🔗 姊妹篇同步
本次更新与 frpc-console 2.4-LTS 同步发布，共享相同的架构升级与部署流程重构成果。
📌 版本说明
版本类型 标记 适用场景 LTS 正式版 -lts生产环境，长期维护 技术预览版 -preview功能前瞻，建议测试环境验证 📦 下载说明
根据你的平台选择对应的压缩包：
平台 文件 Linux x86-64 frps-console-linux-amd64Linux ARM64 frps-console-linux-arm64Linux ARMv7 / ARM-hf frps-console-linux-armv7Windows AMD64 / x86-64 frps-console-windows-amd64.exe🚀 快速开始
curl -sSL https://git.whitetop.xyz/lxh2875931338/frps-console/raw/main/run-deploy.sh | sudo bash详细安装指南请参阅：二进制安装指南 ｜ Docker 安装指南
Downloads
- 部署架构重构 —— 引入
-
2026-07-27 23:47:11 +08:00 | 5 commits to main since this release2.0-LTS：frps-console 首个更新，同时也是项目首个 LTS 更新
这是 frps-console 的首次正式发布。与 frpc-console 2.0-LTS 同步推出，同属 frp 0.70.0 LTS 的下游管理工具生态，共享同一套版本号规则与 LTS 维护周期。
🎯 核心定位
frps-console 是 frps（frp 服务端）的轻量级 Web 管理面板，与 frpc-console 形成姊妹篇：
工具 管理对象 适用场景 frpc-console frpc（客户端） 软路由、小主机、本地服务穿透 frps-console frps（服务端） VPS、云主机、轻量实例，负责流量中转 两个工具共享相同的设计哲学：SQLite 单文件存储、Vue CDN 无构建前端、Go 轻量后端、极致节省资源。
✨ 核心功能
- 🖥️ 服务端配置管理 —— 通过 WebUI 管理 frps 核心参数（
bindPort/token/log/tcpMux），告别手动编辑 TOML - 🚀 frp v2 协议就绪 —— frps 已升级至 0.70.0 LTS，原生支持 v2 协议（v2 开关在 frpc 侧开启，frps 侧无需额外配置）
- 📄 运行日志面板 —— WebUI 内实时查看 frps 运行日志，8 秒自动轮询，便于排查连接问题
- 🔄 配置热加载 —— 修改配置后一键热加载，无需重启 frps 服务
- 🔐 首次启动 Web 注册 —— 延续 frpc-console 的设计，无需命令行交互即可完成管理员账户创建
- 🖥️ 多平台支持 —— Linux AMD64 / ARM64 / ARMv7 与 Windows AMD64 平台兼容
- 🐳 容器化就绪 —— 提供 Docker 镜像与一键部署脚本（
deploy.sh），开箱即用 - 🎨 深色磨砂玻璃 UI —— 与 frpc-console 保持统一的视觉风格
🔒 与 frpc-console 相同的 LTS 承诺
- ✅ 数据库自动迁移 —— 升级时自动备份 + 迁移，数据零丢失
- ✅ 版本驱动的迁移引擎 —— 每次数据库变更都带有版本标记，升级路径清晰可控
- ✅ 同步版本号规则 —— frps-console 与 frpc-console 的版本号保持同步，后续 LTS 更新会同步发版
- ✅ 同步 LTS 维护周期 —— 跟随 frp 上游的 LTS 节奏，长期维护
🧩 姊妹篇协作关系
- 生态互引：已与 MoonProxy（跨平台 FRP 桌面客户端，面向 macOS / Windows）建立互引，桌面端与服务端管理形成完整工具链
- 场景覆盖：
- frpc-console：管理客户端隧道（本地部署）
- frps-console：管理服务端流量中转（云端部署）
- MoonProxy：桌面端图形化配置客户端（macOS / Windows 用户）
📦 下载说明
根据你的平台选择对应的压缩包：
平台 文件 Linux x86-64 frps-console-linux-amd64Linux ARM64 frps-console-linux-arm64Linux ARMv7/ARM-hf frps-console-linux-armv7🚀 快速开始
详细安装指南请参阅：二进制安装指南 ｜ Docker 安装指南
二进制方式：
tar -xzf frps-console-linux-amd64.tar.gz ./frps-console-linux-amd64Docker 方式（一键脚本）：
curl -sSL https://git.whitetop.xyz/lxh2875931338/frps-console/raw/main/deploy.sh | sudo bash首次访问
http://你的服务器IP:9365注册管理员账户即可开始使用。⚠️ 重要说明：v2 协议与 frps 的关系
frps 的 v2 协议支持不需要在 frps 配置中额外声明。只要 frps 二进制升级到 0.70.0 LTS 或更高版本，它就具备了 v2 协议协商能力。实际的 v2 配置开关在 frpc 侧（
transport.wireProtocol = "v2"），由客户端决定使用 v1 还是 v2 协议连接服务端。frps-console 的职责是确保 frps 版本足够新，并在状态概览中明确显示每个客户端的协议版本（v1 / v2），方便用户确认协议协商结果。
📝 版本说明
frps-console 没有 1.x 系列。 在 v1.x 阶段，frps-console 尚处于内部测试形态，从未公开发布。首次公开发布直接定为 2.0-LTS，与 frpc-console 的 LTS 版本对齐，后续版本号将与 frpc-console 保持同步。
Downloads
- 🖥️ 服务端配置管理 —— 通过 WebUI 管理 frps 核心参数（