lxh2875931338/frps-console
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 2 Wiki Activity

2 Releases 2 Tags

RSS Feed
  • 2.4-lts 848062da84
    Compare

    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-amd64
    Linux ARM64 frps-console-linux-arm64
    Linux ARMv7 / ARM-hf frps-console-linux-armv7
    Windows 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