Merge branch 'test' of https://git.whitetop.xyz/lxh2875931338/frpc-console into test

Dockerfile

@@ -1,48 +1,30 @@
-# ============================================================
-# 构建阶段
-# ============================================================
+# 多阶段构建
 FROM golang:alpine AS builder
 
 WORKDIR /app
 
-# 复制依赖文件
 COPY go.mod go.sum ./
+
+RUN sed -i 's/go 1.2[6-9].*/go 1.21/' go.mod && go mod tidy
 RUN go env -w GOPROXY=https://goproxy.cn,direct
 RUN go mod download
 
-# 复制源码（确保 bin/ 和 static/ 目录存在）
 COPY . .
 
-# 编译 Linux 版（CGO_ENABLED=0 保证静态编译）
+# 编译时不注入任何版本信息（纯净二进制）
 RUN CGO_ENABLED=0 GOOS=linux go build \
     -ldflags="-s -w" \
     -o frpc-console .
 
-# ============================================================
-# 运行阶段
-# ============================================================
 FROM alpine:latest
 
-# 安装 ca-certificates 和 tzdata（确保 HTTPS 和时区正常）
-RUN apk add --no-cache ca-certificates sqlite tzdata
+RUN apk --no-cache add ca-certificates tzdata sqlite
 
 WORKDIR /app
 
-# 从构建阶段复制编译好的二进制
 COPY --from=builder /app/frpc-console /app/frpc-console
+COPY static/ /app/static/
 
-# 创建数据目录（用于持久化 db 和日志）
-RUN mkdir -p /app/data
-
-# 暴露端口（默认 9300）
 EXPOSE 9300
 
-# 环境变量
-ENV PORT=9300
-ENV TZ=Asia/Shanghai
-
-# 数据卷（持久化数据库、配置、日志）
-VOLUME ["/app/data"]
-
-# 启动
 ENTRYPOINT ["/app/frpc-console"]

api.go

@@ -4,13 +4,10 @@ import (
 	"bytes"
 	"embed"
 	"fmt"
-	"io"
 	"io/fs"
 	"net"
 	"net/http"
-	"os"
 	"strconv"
-	"strings"
 	"text/template"
 	"time"
 
@@ -399,7 +396,8 @@ func getFrpcStatusHandler(c *gin.Context) {
 // ========== 日志 Handler ==========
 
 func getFrpcLogHandler(c *gin.Context) {
-	lines, err := readTailLog("./frpc.log", 200)
+	// readTailLog 在 frp.go 中定义，读取 ./data/frpc.log
+	lines, err := readTailLog("./data/frpc.log", 200)
 	if err != nil {
 		c.JSON(http.StatusOK, gin.H{
 			"code": 0,
@@ -420,88 +418,6 @@ func getFrpcLogHandler(c *gin.Context) {
 	})
 }
 
-// readTailLog 读取文件末尾 n 行（倒序读取，返回正序）
-func readTailLog(filePath string, n int) ([]string, error) {
-	file, err := os.Open(filePath)
-	if err != nil {
-		return nil, err
-	}
-	defer file.Close()
-
-	// 获取文件大小
-	info, err := file.Stat()
-	if err != nil {
-		return nil, err
-	}
-	fileSize := info.Size()
-	if fileSize == 0 {
-		return []string{}, nil
-	}
-
-	// 从末尾开始读
-	const chunkSize = 4096
-	var lines []string
-	var leftover []byte
-	offset := fileSize
-
-	for len(lines) < n && offset > 0 {
-		// 计算读取起点
-		readSize := chunkSize
-		if offset < int64(chunkSize) {
-			readSize = int(offset)
-		}
-		offset -= int64(readSize)
-
-		// 读取这一块
-		buf := make([]byte, readSize)
-		_, err := file.ReadAt(buf, offset)
-		if err != nil && err != io.EOF {
-			return nil, err
-		}
-
-		// 将当前块与之前剩下的拼接
-		data := append(buf, leftover...)
-		leftover = nil
-
-		// 按行分割（从后往前）
-		start := 0
-		for i := len(data) - 1; i >= 0; i-- {
-			if data[i] == '\n' {
-				if i+1 < len(data) {
-					line := string(data[i+1:])
-					if line != "" {
-						lines = append([]string{line}, lines...)
-						if len(lines) >= n {
-							break
-						}
-					}
-				}
-				start = i
-			}
-		}
-
-		// 如果还没凑够，把未处理的部分留到下一轮
-		if len(lines) < n && start > 0 {
-			leftover = data[:start]
-		}
-	}
-
-	// 处理最后剩余部分（文件开头）
-	if len(lines) < n && len(leftover) > 0 {
-		parts := strings.Split(string(leftover), "\n")
-		for i := len(parts) - 1; i >= 0; i-- {
-			if parts[i] != "" {
-				lines = append([]string{parts[i]}, lines...)
-				if len(lines) >= n {
-					break
-				}
-			}
-		}
-	}
-
-	return lines, nil
-}
-
 // ========== Ping Handler ==========
 
 func pingHandler(c *gin.Context) {
@@ -619,7 +535,6 @@ func ExportTomlHandler(c *gin.Context) {
 		}
 	}
 
-	// 构建与 GenerateFrpcConfig 一致的数据结构
 	data := struct {
 		*GlobalConfig
 		Proxies          []Proxy

db.go

@@ -17,17 +17,7 @@ import (
 
 var DB *sql.DB
 
-// ============================================================
-// 数据库版本常量
-// ============================================================
-
-const (
-	SchemaVersion = "v2" // 当前数据库 Schema 版本
-)
-
-// ============================================================
-// 数据模型
-// ============================================================
+const SchemaVersion = "v2"
 
 type GlobalConfig struct {
 	ID                int    `json:"id"`
@@ -61,12 +51,15 @@ type User struct {
 	CreatedAt    string `json:"createdAt"`
 }
 
-// ============================================================
-// 数据库初始化
-
 func InitDB() error {
+	// 确保 data 目录存在
+	if err := os.MkdirAll("./data", 0755); err != nil {
+		return fmt.Errorf("创建数据目录失败: %w", err)
+	}
+
+	dbPath := "./data/frpc-console.db"
 	var err error
-	DB, err = sql.Open("sqlite", "./frpc-console.db")
+	DB, err = sql.Open("sqlite", dbPath)
 	if err != nil {
 		return err
 	}
@@ -87,12 +80,7 @@ func InitDB() error {
 	return nil
 }
 
-// ============================================================
-// 建表
-// ============================================================
-
 func createTables() error {
-	// 用户表
 	_, err := DB.Exec(`
         CREATE TABLE IF NOT EXISTS users (
             id INTEGER PRIMARY KEY AUTOINCREMENT,
@@ -106,7 +94,6 @@ func createTables() error {
 		return err
 	}
 
-	// 全局配置表
 	_, err = DB.Exec(`
         CREATE TABLE IF NOT EXISTS global_config (
             id INTEGER PRIMARY KEY CHECK (id = 1),
@@ -128,7 +115,6 @@ func createTables() error {
 		return err
 	}
 
-	// 隧道表
 	_, err = DB.Exec(`
         CREATE TABLE IF NOT EXISTS proxies (
             id INTEGER PRIMARY KEY AUTOINCREMENT,
@@ -146,7 +132,6 @@ func createTables() error {
 		return err
 	}
 
-	// 应用配置表
 	_, err = DB.Exec(`
         CREATE TABLE IF NOT EXISTS app_config (
             key TEXT PRIMARY KEY,
@@ -158,7 +143,6 @@ func createTables() error {
 		return err
 	}
 
-	// 初始化默认配置
 	var count int
 	DB.QueryRow("SELECT COUNT(*) FROM global_config").Scan(&count)
 	if count == 0 {
@@ -178,10 +162,6 @@ func createTables() error {
 	return nil
 }
 
-// ============================================================
-// 迁移引擎
-// ============================================================
-
 func getCurrentSchemaVersion() string {
 	var version string
 	err := DB.QueryRow("SELECT value FROM app_config WHERE key = 'schema_version'").Scan(&version)
@@ -209,13 +189,13 @@ func setSchemaVersion(version string) error {
 }
 
 func backupDatabase() (string, error) {
-	src := "./frpc-console.db"
+	src := "./data/frpc-console.db"
 	if _, err := os.Stat(src); os.IsNotExist(err) {
 		return "", nil
 	}
 
 	timestamp := time.Now().Format("20060102_150405")
-	dst := fmt.Sprintf("./frpc-console.db.pre-%s.%s", SchemaVersion, timestamp)
+	dst := fmt.Sprintf("./data/frpc-console.db.pre-%s.%s", SchemaVersion, timestamp)
 
 	srcFile, err := os.Open(src)
 	if err != nil {
@@ -244,7 +224,7 @@ func restoreDatabase(backupPath string) error {
 	}
 	defer srcFile.Close()
 
-	dstFile, err := os.Create("./frpc-console.db")
+	dstFile, err := os.Create("./data/frpc-console.db")
 	if err != nil {
 		return err
 	}
@@ -265,7 +245,6 @@ func runMigrations() error {
 	log.Printf("📌 当前数据库 Schema: %s, 目标版本: %s", currentVer, targetVer)
 
 	if currentVer == targetVer {
-		// 检查数据库是否包含有效数据
 		var userCount int
 		err := DB.QueryRow("SELECT COUNT(*) FROM users").Scan(&userCount)
 		if err != nil || userCount == 0 {
@@ -295,7 +274,6 @@ func runMigrations() error {
 
 	if currentSchema == nil || schemaVersionsEqual(currentSchema, targetSchema) {
 		log.Println("  迁移类型: 轻量复制（Schema 无变更）")
-		// 验证数据库是否有效
 		var userCount int
 		err := DB.QueryRow("SELECT COUNT(*) FROM users").Scan(&userCount)
 		if err != nil || userCount == 0 {
@@ -441,10 +419,6 @@ func buildInsertSQL(oldTable, newTable string, oldDef, newDef *SchemaVersionDef)
 	), nil
 }
 
-// ============================================================
-// JWT 密钥管理
-// ============================================================
-
 func ensureJwtSecret() error {
 	var value string
 	err := DB.QueryRow("SELECT value FROM app_config WHERE key = 'jwt_secret'").Scan(&value)
@@ -477,10 +451,6 @@ func GetJwtSecret() (string, error) {
 	return secret, nil
 }
 
-// ============================================================
-// 全局配置 CRUD
-// ============================================================
-
 func GetGlobalConfig() (*GlobalConfig, error) {
 	var cfg GlobalConfig
 	err := DB.QueryRow(`
@@ -516,10 +486,6 @@ func UpdateGlobalConfig(cfg *GlobalConfig) error {
 	return err
 }
 
-// ============================================================
-// 隧道 CRUD
-// ============================================================
-
 func GetProxies() ([]Proxy, error) {
 	rows, err := DB.Query(`
         SELECT id, name, type, local_ip, local_port, remote_port, enabled
@@ -582,10 +548,6 @@ func DeleteProxy(id int) error {
 	return err
 }
 
-// ============================================================
-// 用户 CRUD
-// ============================================================
-
 func GetUserByUsername(username string) (*User, error) {
 	var u User
 	err := DB.QueryRow(`

deploy.sh

@@ -1,67 +1,41 @@
 #!/bin/bash
 
 # ============================================================
-# frpc-console 一键部署脚本（Docker 优先）
-# 支持：Linux x86_64 / ARM64 / ARMv7
-# 自动安装：git / curl / wget / Docker
-# 
+# frpc-console 一键部署脚本 (Docker 优先)
 # 用法:
-#   ./deploy.sh           # 完整交互流程
-#   ./deploy.sh --yes     # 跳过确认，直接执行
-#   ./deploy.sh --check   # 只检测环境，不执行
-#   ./deploy.sh --dry-run # 显示将执行的操作，不实际执行
+#   run-deploy.sh 引导后自动执行
 # ============================================================
 
 set -e
 
 # ---------- 颜色检测 ----------
 if [ -t 1 ]; then
-    RED='\033[0;31m'
-    GREEN='\033[0;32m'
-    YELLOW='\033[1;33m'
-    BLUE='\033[0;34m'
-    CYAN='\033[0;36m'
-    MAGENTA='\033[0;35m'
-    NC='\033[0m'
+    RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'
+    BLUE='\033[0;34m'; CYAN='\033[0;36m'; MAGENTA='\033[0;35m'; NC='\033[0m'
 else
-    RED=''
-    GREEN=''
-    YELLOW=''
-    BLUE=''
-    CYAN=''
-    MAGENTA=''
-    NC=''
+    RED=''; GREEN=''; YELLOW=''; BLUE=''; CYAN=''; MAGENTA=''; NC=''
 fi
 
 # ---------- 配置 ----------
 REPO_URL="https://git.whitetop.xyz/lxh2875931338/frpc-console.git"
-BRANCH="main"
 WORK_DIR="/tmp/frpc-console-build"
 DEFAULT_PORT=9300
 DEFAULT_DEPLOY_DIR="/opt/frpc-console"
 IMAGE_NAME="frpc-console"
+KEEP_IMAGES=3
 
 # ---------- 状态变量 ----------
-OS=""
-OS_VERSION=""
-ARCH=""
-HAS_GIT=false
-HAS_CURL=false
-HAS_WGET=false
-HAS_DOCKER=false
-NEED_INSTALL_GIT=false
-NEED_INSTALL_CURL=false
-NEED_INSTALL_WGET=false
+OS=""; OS_VERSION=""; ARCH=""
+HAS_GIT=false; HAS_CURL=false; HAS_WGET=false; HAS_DOCKER=false
+NEED_INSTALL_GIT=false; NEED_INSTALL_CURL=false; NEED_INSTALL_WGET=false
 PORT=${DEFAULT_PORT}
 DEPLOY_DIR=${DEFAULT_DEPLOY_DIR}
 DATA_DIR="${DEPLOY_DIR}/data"
-CONTAINER_EXISTS=false
-CONTAINER_RUNNING=false
-SKIP_CONFIRM=false
-CHECK_ONLY=false
-DRY_RUN=false
+CONTAINER_EXISTS=false; CONTAINER_RUNNING=false
+SKIP_CONFIRM=false; CHECK_ONLY=false; DRY_RUN=false
+CHANNEL=""; BRANCH=""; TARGET_VERSION=""; IMAGE_TAG=""
+CURRENT_VERSION=""
 
-# ---------- 打印函数 ----------
 print_info() { echo -e "${BLUE}[INFO]${NC} $1"; }
 print_success() { echo -e "${GREEN}[✓]${NC} $1"; }
 print_warn() { echo -e "${YELLOW}[⚠]${NC} $1"; }
@@ -79,29 +53,18 @@ parse_args() {
             --dry-run) DRY_RUN=true ;;
             --help|-h)
                 echo "用法: ./deploy.sh [选项]"
-                echo ""
                 echo "选项:"
-                echo "  --yes, -y     跳过所有确认提示，直接执行"
+                echo "  --yes, -y     跳过所有确认提示"
                 echo "  --check       只检测环境，不执行部署"
                 echo "  --dry-run     显示将执行的操作，不实际执行"
                 echo "  --help, -h    显示帮助信息"
-                echo ""
-                echo "示例:"
-                echo "  ./deploy.sh           # 完整交互流程"
-                echo "  ./deploy.sh --yes     # 无人值守部署"
-                echo "  ./deploy.sh --check   # 只检测环境"
                 exit 0
                 ;;
-            *)
-                print_error "未知选项: $arg"
-                echo "使用 --help 查看帮助"
-                exit 1
-                ;;
+            *) print_error "未知选项: $arg"; exit 1 ;;
         esac
     done
 }
 
-# ---------- 检查 root ----------
 check_root() {
     if [ "$EUID" -ne 0 ]; then
         print_error "请使用 root 权限运行此脚本"
@@ -110,19 +73,16 @@ check_root() {
     fi
 }
 
-# ---------- 检测操作系统 ----------
 detect_os() {
     if [ -f /etc/os-release ]; then
         . /etc/os-release
-        OS=$ID
-        OS_VERSION=$VERSION_ID
+        OS=$ID; OS_VERSION=$VERSION_ID
     else
         print_error "无法识别操作系统"
         exit 1
     fi
 }
 
-# ---------- 检测 CPU 架构 ----------
 detect_arch() {
     ARCH=$(uname -m)
     case $ARCH in
@@ -136,7 +96,6 @@ detect_arch() {
     esac
 }
 
-# ---------- 检测工具 ----------
 check_tools() {
     command -v git &> /dev/null && HAS_GIT=true || NEED_INSTALL_GIT=true
     command -v curl &> /dev/null && HAS_CURL=true || NEED_INSTALL_CURL=true
@@ -144,7 +103,6 @@ check_tools() {
     command -v docker &> /dev/null && HAS_DOCKER=true
 }
 
-# ---------- 检查容器状态 ----------
 check_container() {
     if docker ps -a --format '{{.Names}}' 2>/dev/null | grep -q "^frpc-console$"; then
         CONTAINER_EXISTS=true
@@ -154,7 +112,89 @@ check_container() {
     fi
 }
 
-# ---------- 检测结果汇总 ----------
+# ---------- 版本管理 ----------
+read_version_from_remote() {
+    local branch="$1"
+    local version_url="https://git.whitetop.xyz/lxh2875931338/frpc-console/raw/${branch}/version.ini"
+    local content
+    content=$(curl -sSL "$version_url" 2>/dev/null)
+    if [ -z "$content" ]; then
+        print_error "无法从远程读取 version.ini: $version_url"
+        return 1
+    fi
+    SEMVER=$(echo "$content" | grep -v "^[;#]" | head -1 | awk '{print $1}')
+    echo "$SEMVER"
+}
+
+generate_target_version() {
+    local channel="$1"
+    local branch="${2:-$BRANCH}"
+    SEMVER=$(read_version_from_remote "$branch")
+    if [ -z "$SEMVER" ]; then
+        print_error "读取语义版本失败"
+        exit 1
+    fi
+    local minor="${SEMVER#*.}"
+    if [ "$minor" = "0" ] || [ "$minor" = "5" ]; then
+        CHANNEL_TYPE="lts"
+    else
+        CHANNEL_TYPE="preview"
+    fi
+    if [ "$channel" = "lts" ] || [ "$CHANNEL_TYPE" = "lts" ]; then
+        TARGET_VERSION="${SEMVER}-lts-$(date +%Y%m%d)"
+        IMAGE_TAG="${SEMVER}-lts-$(date +%Y%m%d)"
+    else
+        TIMESTAMP=$(date +%Y%m%d-%H%M%S)
+        TARGET_VERSION="${SEMVER}-preview-${TIMESTAMP}"
+        IMAGE_TAG="preview-${TIMESTAMP}"
+    fi
+}
+
+get_current_version() {
+    local version_file="${DEPLOY_DIR}/data/version.ini"
+    if [ -f "$version_file" ]; then
+        grep -v "^[;#]" "$version_file" | head -1 | tr -d '\n'
+    else
+        if [ "$CONTAINER_EXISTS" = true ]; then
+            docker exec frpc-console cat /app/data/version.ini 2>/dev/null | grep -v "^[;#]" | head -1 | tr -d '\n' || echo ""
+        else
+            echo ""
+        fi
+    fi
+}
+
+# ---------- 通道选择 ----------
+select_channel() {
+    if [ -n "$DEPLOY_CHANNEL" ] && [ -n "$DEPLOY_BRANCH" ]; then
+        CHANNEL="$DEPLOY_CHANNEL"
+        BRANCH="$DEPLOY_BRANCH"
+        print_info "使用环境变量: ${CHANNEL} 通道 (${BRANCH} 分支)"
+        return
+    fi
+    if [ -n "$CHANNEL" ]; then
+        if [ "$CHANNEL" != "lts" ] && [ "$CHANNEL" != "preview" ]; then
+            print_error "无效通道: $CHANNEL"
+            exit 1
+        fi
+        BRANCH="$([ "$CHANNEL" = "preview" ] && echo "test" || echo "main")"
+        return
+    fi
+    echo ""
+    echo -e "${CYAN}请选择部署通道:${NC}"
+    echo "  1. LTS (稳定版) [默认] → main 分支"
+    echo "  2. Preview (技术预览版) → test 分支"
+    echo ""
+    read -p "请选择 [1]: " CHANNEL_INPUT </dev/tty
+    CHANNEL_INPUT=${CHANNEL_INPUT:-1}
+    case $CHANNEL_INPUT in
+        1|"") CHANNEL="lts"; BRANCH="main" ;;
+        2) CHANNEL="preview"; BRANCH="test" ;;
+        *) print_error "无效选择"; exit 1 ;;
+    esac
+    print_info "已选择: ${CHANNEL} 通道 (${BRANCH} 分支)"
+}
+
+# ---------- 环境汇总 ----------
 print_environment_summary() {
     print_title
     print_subtitle "环境检测结果"
@@ -185,28 +225,23 @@ print_environment_summary() {
     else
         echo "    docker  ❌ 未安装"
         print_error "Docker 未安装，请先安装 Docker"
-        echo ""
-        echo "  快速安装:"
-        echo "    curl -fsSL https://get.docker.com | bash"
-        echo "    systemctl enable --now docker"
-        echo ""
         exit 1
     fi
-
     if [ "$CONTAINER_EXISTS" = true ]; then
         echo ""
         echo "  ${CYAN}容器状态:${NC}"
         if [ "$CONTAINER_RUNNING" = true ]; then
-            echo -e "    frpc-console  ✅ 运行中 (将停止并重建)"
+            echo -e "    frpc-console  ✅ 运行中"
         else
-            echo -e "    frpc-console  ⏸️  已停止 (将重建)"
+            echo -e "    frpc-console  ⏸️  已停止"
         fi
-        echo -e "    ${YELLOW}数据目录中的数据库文件将被保留${NC}"
+        CURRENT_VERSION=$(get_current_version)
+        [ -n "$CURRENT_VERSION" ] && echo -e "  ${CYAN}当前版本:${NC} $CURRENT_VERSION"
     fi
     echo ""
 }
 
-# ---------- 生成操作列表 ----------
+# ---------- 部署计划 ----------
 generate_plan() {
     PLAN=""
     if [ "$NEED_INSTALL_GIT" = true ] || [ "$NEED_INSTALL_CURL" = true ] || [ "$NEED_INSTALL_WGET" = true ]; then
@@ -217,14 +252,14 @@ generate_plan() {
         PLAN="${PLAN}  • 安装必要工具:${pkgs}\n"
     fi
     PLAN="${PLAN}  • 拉取 frpc-console 源码 (${BRANCH} 分支)\n"
-    PLAN="${PLAN}  • 构建 Docker 镜像（源码内编译）\n"
+    PLAN="${PLAN}  • 构建 Docker 镜像: ${IMAGE_NAME}:${IMAGE_TAG}\n"
+    PLAN="${PLAN}  • 目标版本: ${TARGET_VERSION}\n"
     if [ "$CONTAINER_EXISTS" = true ]; then
         PLAN="${PLAN}  • 停止并删除旧容器\n"
     fi
-    PLAN="${PLAN}  • 启动 frpc-console 容器"
+    PLAN="${PLAN}  • 启动 frpc-console 容器 (端口 ${PORT})"
 }
 
-# ---------- 展示部署计划 ----------
 print_deployment_plan() {
     print_title
     print_subtitle "部署计划"
@@ -236,23 +271,19 @@ print_deployment_plan() {
     echo -e "    ────────────────────────────────────"
     echo -e "    监听端口      : ${PORT}"
     echo -e "    部署目录      : ${DEPLOY_DIR}"
-    echo -e "    数据目录      : ${DATA_DIR}"
+    echo -e "    目标版本      : ${TARGET_VERSION}"
+    echo -e "    镜像标签      : ${IMAGE_TAG}"
+    echo -e "    源码分支      : ${BRANCH}"
     echo -e "    ────────────────────────────────────"
-
     if [ "$CONTAINER_EXISTS" = true ]; then
         echo ""
         echo -e "  ${YELLOW}⚠ 检测到已存在的 frpc-console 容器${NC}"
-        if [ "$CONTAINER_RUNNING" = true ]; then
-            echo -e "    状态: 运行中 → 将被停止并重新创建"
-        else
-            echo -e "    状态: 已停止 → 将被删除并重新创建"
-        fi
-        echo -e "    ${YELLOW}数据目录中的数据库文件将被保留${NC}"
+        echo -e "    当前版本: ${CURRENT_VERSION}"
+        echo -e "    目标版本: ${TARGET_VERSION}"
     fi
     echo ""
 }
 
-# ---------- 确认部署 ----------
 confirm_deploy() {
     if [ "$SKIP_CONFIRM" = true ]; then
         echo -e "${GREEN}▶ 已启用 --yes，自动确认${NC}"
@@ -266,7 +297,6 @@ confirm_deploy() {
     esac
 }
 
-# ---------- 自定义配置 ----------
 custom_config() {
     print_title
     print_subtitle "自定义配置"
@@ -292,28 +322,58 @@ do_deploy() {
     print_subtitle "开始部署"
     echo ""
 
-    # ----- 事务前钩子：备份数据库 -----
-    print_step "备份数据库..."
-    BACKUP_DIR="/tmp/frpc-console/db-backups"
-    mkdir -p "$BACKUP_DIR"
-    DB_FILE="${DEPLOY_DIR}/frpc-console.db"
-    if [ -f "$DB_FILE" ]; then
+    # ----- 事务前钩子：备份数据库（仅降级时） -----
+    BACKUP_DIR=""
+    if [ -n "$CURRENT_VERSION" ] && [ -n "$TARGET_VERSION" ]; then
+        CUR_SEMVER=$(echo "$CURRENT_VERSION" | sed -E 's/^([0-9]+\.[0-9]+).*$/\1/')
+        TGT_SEMVER=$(echo "$TARGET_VERSION" | sed -E 's/^([0-9]+\.[0-9]+).*$/\1/')
+        if [ "$TGT_SEMVER" \< "$CUR_SEMVER" ] 2>/dev/null; then
+            print_warn "检测到降级操作: $CURRENT_VERSION → $TARGET_VERSION"
+            echo ""
+            echo -e "${YELLOW}⚠ 降级可能导致数据不兼容${NC}"
             TIMESTAMP=$(date +%Y%m%d_%H%M%S)
-        BACKUP_FILE="$BACKUP_DIR/frpc-console.db.$TIMESTAMP"
-        cp "$DB_FILE" "$BACKUP_FILE"
-        print_info "已备份: $BACKUP_FILE"
-        if command -v sqlite3 &> /dev/null; then
-            if ! sqlite3 "$DB_FILE" "SELECT COUNT(*) FROM sqlite_master WHERE type='table' AND name='users';" 2>/dev/null | grep -q "^1$"; then
-                print_warn "数据库文件无效，将删除，由容器全新初始化"
-                rm -f "$DB_FILE"
+            BACKUP_DIR="/opt/frpc-console-backups/${TIMESTAMP}_${CHANNEL}"
+            echo -e "${CYAN}备份目录: ${BACKUP_DIR}${NC}"
+            read -p "确认执行降级? [y/N]: " CONFIRM_DOWNGRADE </dev/tty
+            if [[ ! "$CONFIRM_DOWNGRADE" =~ ^[Yy]$ ]]; then
+                print_info "已取消降级操作"
+                exit 0
+            fi
+            print_step "执行降级前备份..."
+            mkdir -p "$BACKUP_DIR"
+            if [ -d "$DEPLOY_DIR" ]; then
+                cp -r "$DEPLOY_DIR" "$BACKUP_DIR/frpc-console"
+                print_success "备份完成: $BACKUP_DIR"
             else
-                print_info "数据库有效，保留"
+                print_warn "部署目录不存在，跳过备份"
+            fi
         fi
     else
-            print_warn "sqlite3 未安装，无法检查数据库有效性，保留原文件"
+        print_info "首次部署，跳过版本比对"
     fi
-    else
-        print_info "数据库文件不存在，跳过备份"
+
+    # ----- 安装必要工具 -----
+    if [ "$NEED_INSTALL_GIT" = true ] || [ "$NEED_INSTALL_CURL" = true ] || [ "$NEED_INSTALL_WGET" = true ]; then
+        print_step "安装必要工具..."
+        local pkgs=""
+        [ "$NEED_INSTALL_GIT" = true ] && pkgs="${pkgs} git"
+        [ "$NEED_INSTALL_CURL" = true ] && pkgs="${pkgs} curl"
+        [ "$NEED_INSTALL_WGET" = true ] && pkgs="${pkgs} wget"
+        case $OS in
+            opensuse*|suse*|opensuse-tumbleweed|opensuse-slowroll|opensuse-leap)
+                if [ "$NEED_INSTALL_GIT" = true ]; then
+                    zypper install -y git-core
+                    pkgs=$(echo "$pkgs" | sed -E 's/(^| )git( |$)/ /g' | sed 's/  */ /g' | sed 's/^ //;s/ $//')
+                fi
+                [ -n "$pkgs" ] && zypper install -y $pkgs
+                ;;
+            ubuntu|debian|linuxmint) apt update -qq && apt install -y $pkgs ;;
+            centos|rhel|fedora|rocky|almalinux) yum install -y $pkgs ;;
+            alpine) apk add $pkgs ;;
+            arch|manjaro|endeavouros) pacman -S --needed --noconfirm $pkgs ;;
+            *) print_error "无法识别包管理器"; exit 1 ;;
+        esac
+        print_success "必要工具安装完成"
     fi
 
     # ----- 拉取代码 -----
@@ -322,9 +382,9 @@ do_deploy() {
     git clone --depth 1 --branch "$BRANCH" "$REPO_URL" "$WORK_DIR"
     cd "$WORK_DIR"
     mkdir -p bin static
-    print_success "代码拉取完成"
+    print_success "代码拉取完成 (分支: ${BRANCH})"
 
-    # ----- 停止旧容器（拉取代码之后）-----
+    # ----- 停止旧容器 -----
     if [ "$CONTAINER_EXISTS" = true ]; then
         print_step "停止旧容器..."
         if [ "$CONTAINER_RUNNING" = true ]; then
@@ -338,16 +398,72 @@ do_deploy() {
     print_step "准备部署目录..."
     mkdir -p "$DEPLOY_DIR"
     mkdir -p "$DATA_DIR"
-    if [ -f "$DB_FILE" ]; then
-        print_info "数据库文件存在，将保留"
+
+    # ----- 检测并迁移旧版本文件（从根目录迁移到 data/）-----
+    print_step "检测旧版本文件..."
+
+    OLD_DB="${DEPLOY_DIR}/frpc-console.db"
+    OLD_TOML="${DEPLOY_DIR}/frpc.toml"
+    OLD_LOG="${DEPLOY_DIR}/frpc.log"
+    OLD_PID="${DEPLOY_DIR}/frpc.pid"
+    OLD_VERSION="${DEPLOY_DIR}/version.ini"
+    NEW_DB="${DATA_DIR}/frpc-console.db"
+
+    if [ -f "$OLD_DB" ] && [ ! -f "$NEW_DB" ]; then
+        print_warn "检测到旧版本数据库文件在根目录，将迁移到 data/ 子目录"
+
+        BACKUP_OLD_DIR="${DEPLOY_DIR}/.old_backup_$(date +%Y%m%d_%H%M%S)"
+        mkdir -p "$BACKUP_OLD_DIR"
+
+        for file in frpc-console.db frpc.toml frpc.log frpc.pid version.ini; do
+            if [ -f "${DEPLOY_DIR}/${file}" ]; then
+                cp "${DEPLOY_DIR}/${file}" "${BACKUP_OLD_DIR}/" 2>/dev/null || true
+                print_info "  已备份: ${file}"
+            fi
+        done
+
+        for file in frpc-console.db frpc.toml frpc.log frpc.pid version.ini; do
+            if [ -f "${DEPLOY_DIR}/${file}" ]; then
+                cp "${DEPLOY_DIR}/${file}" "${DATA_DIR}/" 2>/dev/null || true
+                print_info "  已迁移: ${file} → data/"
+            fi
+        done
+
+        print_success "旧文件已迁移到 data/ 目录"
+        print_info "旧文件备份位置: ${BACKUP_OLD_DIR}"
+        print_info "确认服务正常后，可手动删除备份目录"
     else
-        print_info "数据库文件不存在，容器启动时将自动创建"
+        print_info "未检测到需要迁移的旧文件"
     fi
 
-    # ----- 构建 Docker 镜像（内部自动处理 go.mod 降级）-----
+    # ----- 构建 Docker 镜像 -----
     print_step "构建 Docker 镜像..."
-    docker build -t "${IMAGE_NAME}:latest" .
-    print_success "Docker 镜像构建完成: ${IMAGE_NAME}:latest"
+    docker build --no-cache \
+        -t "${IMAGE_NAME}:${IMAGE_TAG}" \
+        .
+    if [ $? -ne 0 ]; then
+        print_error "Docker 构建失败"
+        exit 1
+    fi
+    print_success "Docker 镜像构建完成: ${IMAGE_NAME}:${IMAGE_TAG}"
+
+    # 验证镜像内容
+    print_step "验证镜像内容..."
+    if docker run --rm --entrypoint ls "${IMAGE_NAME}:${IMAGE_TAG}" -l /app/frpc-console 2>/dev/null; then
+        print_success "二进制文件存在于镜像中"
+    else
+        print_error "镜像中缺少 /app/frpc-console"
+        exit 1
+    fi
+
+    # 标记通道标签
+    if [ "$CHANNEL" = "lts" ]; then
+        docker tag "${IMAGE_NAME}:${IMAGE_TAG}" "${IMAGE_NAME}:lts"
+        print_info "已标记 ${IMAGE_NAME}:lts"
+    else
+        docker tag "${IMAGE_NAME}:${IMAGE_TAG}" "${IMAGE_NAME}:preview"
+        print_info "已标记 ${IMAGE_NAME}:preview"
+    fi
 
     # ----- 启动新容器 -----
     print_step "启动 frpc-console 容器..."
@@ -355,10 +471,10 @@ do_deploy() {
         --name frpc-console \
         --restart=always \
         --network host \
-        -v ${DEPLOY_DIR}:/app \
+        -v ${DEPLOY_DIR}/data:/app/data \
         -e PORT=${PORT} \
         -e TZ=Asia/Shanghai \
-        ${IMAGE_NAME}:latest
+        ${IMAGE_NAME}:${IMAGE_TAG}
 
     if docker ps | grep -q frpc-console; then
         print_success "容器启动成功！"
@@ -367,48 +483,99 @@ do_deploy() {
         exit 1
     fi
 
-    # ----- 检查 frpc 子进程 -----
+    # ----- 写入版本文件 -----
+    print_step "写入版本文件..."
+    echo "$TARGET_VERSION" > "${DEPLOY_DIR}/data/version.ini"
+    print_success "版本写入: ${TARGET_VERSION}"
+
+    # ----- 检查 frpc 子进程（基于 PID 文件）-----
     print_step "检查 frpc 状态..."
     sleep 3
-    if docker ps --format '{{.Names}}' | grep -q "^frpc-console$"; then
-        if docker exec frpc-console ps aux 2>/dev/null | grep -q "[f]rpc -c"; then
-            print_success "frpc 进程运行正常"
+
+    PID_FILE="${DEPLOY_DIR}/data/frpc.pid"
+    if [ -f "$PID_FILE" ]; then
+        PID=$(cat "$PID_FILE" 2>/dev/null | tr -d ' \n')
+        if [ -n "$PID" ] && kill -0 "$PID" 2>/dev/null; then
+            print_success "frpc 进程运行正常 (PID: $PID)"
         else
-            print_warn "frpc 进程未运行（可能配置为空，请在 WebUI 中导入 TOML）"
+            print_warn "frpc 进程未运行（PID 文件存在但进程已退出，可能配置为空）"
         fi
     else
-        print_error "frpc-console 容器未运行，请检查日志"
-        exit 1
+        print_warn "frpc 进程未运行（PID 文件不存在，请导入 TOML 后重试）"
     fi
 
     # ----- 事务后钩子：检测数据库 -----
     print_step "验证数据库状态..."
-    if docker exec frpc-console sqlite3 /app/frpc-console.db "SELECT COUNT(*) FROM users;" 2>/dev/null | grep -q "^[0-9]"; then
+    if docker exec frpc-console sqlite3 /app/data/frpc-console.db "SELECT COUNT(*) FROM users;" 2>/dev/null | grep -q "^[0-9]"; then
         print_success "数据库可用"
     else
         print_warn "数据库为空或不可用，请通过 WebUI 注册管理员账户"
     fi
 
+    # ----- 验证版本 -----
+    print_step "验证版本..."
+    sleep 1
+    CONTAINER_VERSION=$(docker exec frpc-console cat /app/data/version.ini 2>/dev/null | grep -v "^[;#]" | head -1 | tr -d '\n' || echo "unknown")
+    echo -e "  容器版本: ${CONTAINER_VERSION}"
+    echo -e "  目标版本: ${TARGET_VERSION}"
+    if [ "$CONTAINER_VERSION" = "$TARGET_VERSION" ]; then
+        print_success "版本写入成功"
+    else
+        print_warn "版本不匹配，请检查"
+    fi
+
+    # ----- 清理旧镜像 -----
+    print_step "清理旧镜像..."
+    CURRENT_IMAGE_ID=$(docker images -q "${IMAGE_NAME}:${IMAGE_TAG}" 2>/dev/null)
+    if [ -n "$CURRENT_IMAGE_ID" ]; then
+        ALL_IMAGES=$(docker images "${IMAGE_NAME}:*" --format "{{.ID}} {{.CreatedAt}}" 2>/dev/null | sort -k2 -r | awk '{print $1}')
+        COUNTER=0
+        TO_DELETE=""
+        for IMG_ID in $ALL_IMAGES; do
+            if [ "$IMG_ID" = "$CURRENT_IMAGE_ID" ]; then
+                continue
+            fi
+            COUNTER=$((COUNTER + 1))
+            if [ $COUNTER -le $KEEP_IMAGES ]; then
+                continue
+            fi
+            TO_DELETE="$TO_DELETE $IMG_ID"
+        done
+        if [ -n "$TO_DELETE" ]; then
+            docker rmi -f $TO_DELETE 2>/dev/null || true
+            print_info "已清理旧镜像"
+        else
+            print_info "无需清理，镜像数量未超过保留策略"
+        fi
+    fi
+
+    # ----- 备份目录提示 -----
+    if [ -n "$BACKUP_DIR" ]; then
+        echo ""
+        print_warn "降级前数据已备份到: $BACKUP_DIR"
+        echo "  如需回退: cp -r $BACKUP_DIR/frpc-console/* $DEPLOY_DIR/"
+    fi
+
     # ----- 清理临时文件 -----
     print_step "清理临时文件..."
     rm -rf "$WORK_DIR"
     print_success "临时文件已清理"
 
-    # ----- 输出信息 -----
+    # ----- 输出 -----
     print_title
     print_success "frpc-console 部署完成！"
     print_title
     echo ""
     echo -e "  ${CYAN}📍 访问地址:${NC} http://$(hostname -I | awk '{print $1}'):${PORT}"
     echo -e "  ${CYAN}📂 数据目录:${NC} ${DEPLOY_DIR}"
-    echo -e "  ${CYAN}📦 备份目录:${NC} /tmp/frpc-console/db-backups"
     echo -e "  ${CYAN}🐳 容器名称:${NC} frpc-console"
+    echo -e "  ${CYAN}🏷️  版本:${NC} ${TARGET_VERSION}"
+    echo -e "  ${CYAN}🌿  分支:${NC} ${BRANCH}"
     echo ""
     echo -e "  ${CYAN}常用命令:${NC}"
     echo "    docker logs frpc-console      # 查看日志"
     echo "    docker restart frpc-console   # 重启服务"
-    echo "    docker stop frpc-console      # 停止服务"
-    echo "    docker start frpc-console     # 启动服务"
+    echo "    cat ${DEPLOY_DIR}/data/version.ini # 查看当前版本"
     echo ""
     echo -e "  ${YELLOW}首次访问需要注册管理员账户${NC}"
     echo ""
@@ -427,20 +594,23 @@ main() {
     check_tools
     check_container
 
+    select_channel
+    generate_target_version "$CHANNEL" "$BRANCH"
+
+    CURRENT_VERSION=""
+    if [ "$CONTAINER_EXISTS" = true ]; then
+        CURRENT_VERSION=$(get_current_version)
+    fi
+
     print_environment_summary
 
     if [ "$CHECK_ONLY" = true ]; then
-        print_info "环境检测完成（--check 模式，不执行部署）"
+        print_info "环境检测完成（--check 模式）"
         exit 0
     fi
 
     if [ "$HAS_DOCKER" = false ]; then
-        print_error "Docker 未安装，请先安装 Docker"
-        echo ""
-        echo "  快速安装:"
-        echo "    curl -fsSL https://get.docker.com | bash"
-        echo "    systemctl enable --now docker"
-        echo ""
+        print_error "Docker 未安装"
         exit 1
     fi
 
@@ -449,6 +619,7 @@ main() {
 
     if ! confirm_deploy; then
         custom_config
+        generate_plan
         print_deployment_plan
         if ! confirm_deploy; then
             print_info "已取消部署"
@@ -457,7 +628,7 @@ main() {
     fi
 
     if [ "$DRY_RUN" = true ]; then
-        print_info "演练模式（--dry-run），不实际执行部署"
+        print_info "演练模式（--dry-run）"
         exit 0
     fi
 

frp.go

@@ -4,6 +4,7 @@ import (
 	"bytes"
 	"embed"
 	"fmt"
+	"io"
 	"log"
 	"os"
 	"os/exec"
@@ -27,10 +28,6 @@ var (
 	frpcPathMutex  sync.Mutex
 )
 
-// ============================================================
-// 获取 frpc 路径
-// ============================================================
-
 func getFrpcPath() (string, error) {
 	frpcPathMutex.Lock()
 	defer frpcPathMutex.Unlock()
@@ -61,14 +58,12 @@ func getFrpcPath() (string, error) {
 		return "", fmt.Errorf("不支持的平台: %s/%s", runtime.GOOS, runtime.GOARCH)
 	}
 
-	// 优先级1：本地 ./bin/
 	localPath := filepath.Join(".", "bin", fileName)
 	if _, err := os.Stat(localPath); err == nil {
 		cachedFrpcPath = localPath
 		return localPath, nil
 	}
 
-	// 优先级2：embed 解压
 	data, err := embeddedFrpc.ReadFile("bin/" + fileName)
 	if err == nil {
 		tmpPath := filepath.Join(os.TempDir(), "frpc")
@@ -85,7 +80,6 @@ func getFrpcPath() (string, error) {
 		}
 	}
 
-	// 优先级3：系统 PATH
 	path, err := exec.LookPath("frpc")
 	if err == nil {
 		cachedFrpcPath = path
@@ -95,10 +89,6 @@ func getFrpcPath() (string, error) {
 	return "", fmt.Errorf("未找到 frpc 文件")
 }
 
-// ============================================================
-// 生成 frpc.toml（v2.0 支持 wireProtocol）
-// ============================================================
-
 func GenerateFrpcConfig() error {
 	cfg, err := GetGlobalConfig()
 	if err != nil {
@@ -117,24 +107,21 @@ func GenerateFrpcConfig() error {
 		}
 	}
 
-	// 构建模板数据
 	data := struct {
 		*GlobalConfig
 		Proxies          []Proxy
-		WireProtocolLine string // v2 协议配置行（为空则不输出）
+		WireProtocolLine string
 	}{
 		GlobalConfig: cfg,
 		Proxies:      activeProxies,
 	}
 
-	// v2.0: 如果启用 v2 协议，生成配置行
 	if cfg.WireProtocolV2 {
 		data.WireProtocolLine = `wireProtocol = "v2"`
 	} else {
-		data.WireProtocolLine = "" // 不输出，使用默认 v1
+		data.WireProtocolLine = ""
 	}
 
-	// 读取模板
 	var tmplContent string
 	if _, err := os.Stat("frpc.tmpl"); err == nil {
 		content, readErr := os.ReadFile("frpc.tmpl")
@@ -157,19 +144,19 @@ func GenerateFrpcConfig() error {
 		return fmt.Errorf("渲染模板失败: %w", err)
 	}
 
-	if err := os.WriteFile("./frpc.toml", buf.Bytes(), 0644); err != nil {
+	if err := os.MkdirAll("./data", 0755); err != nil {
+		return fmt.Errorf("创建 data 目录失败: %w", err)
+	}
+
+	if err := os.WriteFile("./data/frpc.toml", buf.Bytes(), 0644); err != nil {
 		return fmt.Errorf("写入配置文件失败: %w", err)
 	}
 
 	return nil
 }
 
-// ============================================================
-// frpc 进程管理
-// ============================================================
-
 func isFrpcRunning() bool {
-	pidData, err := os.ReadFile("./frpc.pid")
+	pidData, err := os.ReadFile("./data/frpc.pid")
 	if err != nil {
 		return false
 	}
@@ -200,7 +187,11 @@ func StartFrpc() error {
 		return fmt.Errorf("获取 frpc 路径失败: %w", err)
 	}
 
-	if _, err := os.Stat("./frpc.toml"); os.IsNotExist(err) {
+	if err := os.MkdirAll("./data", 0755); err != nil {
+		return fmt.Errorf("创建 data 目录失败: %w", err)
+	}
+
+	if _, err := os.Stat("./data/frpc.toml"); os.IsNotExist(err) {
 		if err := GenerateFrpcConfig(); err != nil {
 			return fmt.Errorf("生成配置文件失败: %w", err)
 		}
@@ -210,13 +201,13 @@ func StartFrpc() error {
 		return nil
 	}
 
-	os.Remove("./frpc.pid")
+	os.Remove("./data/frpc.pid")
 
-	cmd := exec.Command(frpcPath, "-c", "./frpc.toml")
+	cmd := exec.Command(frpcPath, "-c", "./data/frpc.toml")
 	setWindowHide(cmd)
 	setSysProcAttr(cmd)
 
-	logFile, err := os.OpenFile("./frpc.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
+	logFile, err := os.OpenFile("./data/frpc.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
 	if err != nil {
 		return fmt.Errorf("打开日志文件失败: %w", err)
 	}
@@ -227,7 +218,16 @@ func StartFrpc() error {
 		return fmt.Errorf("启动 frpc 失败: %w", err)
 	}
 
-	if err := os.WriteFile("./frpc.pid", []byte(fmt.Sprintf("%d", cmd.Process.Pid)), 0644); err != nil {
+	// 回收子进程（防止僵尸进程）
+	go func() {
+		if err := cmd.Wait(); err != nil {
+			log.Printf("frpc 子进程退出: %v", err)
+		}
+		// 子进程退出后清理 PID 文件
+		os.Remove("./data/frpc.pid")
+	}()
+
+	if err := os.WriteFile("./data/frpc.pid", []byte(fmt.Sprintf("%d", cmd.Process.Pid)), 0644); err != nil {
 		return fmt.Errorf("保存 PID 失败: %w", err)
 	}
 
@@ -240,11 +240,11 @@ func StopFrpc() error {
 		if err := cmd.Run(); err != nil && !strings.Contains(err.Error(), "not found") {
 			return fmt.Errorf("停止 frpc 失败: %w", err)
 		}
-		os.Remove("./frpc.pid")
+		os.Remove("./data/frpc.pid")
 		return nil
 	}
 
-	pidData, err := os.ReadFile("./frpc.pid")
+	pidData, err := os.ReadFile("./data/frpc.pid")
 	if err != nil {
 		cmd := exec.Command("pkill", "-f", "frpc")
 		if err := cmd.Run(); err != nil && !strings.Contains(err.Error(), "no process") {
@@ -256,7 +256,7 @@ func StopFrpc() error {
 	pid, _ := strconv.Atoi(strings.TrimSpace(string(pidData)))
 	process, err := os.FindProcess(pid)
 	if err != nil {
-		os.Remove("./frpc.pid")
+		os.Remove("./data/frpc.pid")
 		return nil
 	}
 
@@ -264,7 +264,7 @@ func StopFrpc() error {
 		return fmt.Errorf("杀死进程失败: %w", err)
 	}
 
-	os.Remove("./frpc.pid")
+	os.Remove("./data/frpc.pid")
 	return nil
 }
 
@@ -283,7 +283,7 @@ func ReloadFrpc() error {
 		return fmt.Errorf("获取 frpc 路径失败: %w", err)
 	}
 
-	cmd := exec.Command(frpcPath, "reload", "-c", "./frpc.toml")
+	cmd := exec.Command(frpcPath, "reload", "-c", "./data/frpc.toml")
 	_, err = cmd.CombinedOutput()
 	if err != nil {
 		log.Printf("⚠️  热加载失败 (%v)，自动降级为重启 frpc", err)
@@ -297,3 +297,77 @@ func ReloadFrpc() error {
 	}
 	return nil
 }
+
+// readTailLog 读取文件末尾 n 行
+func readTailLog(filePath string, n int) ([]string, error) {
+	file, err := os.Open(filePath)
+	if err != nil {
+		return nil, err
+	}
+	defer file.Close()
+
+	info, err := file.Stat()
+	if err != nil {
+		return nil, err
+	}
+	fileSize := info.Size()
+	if fileSize == 0 {
+		return []string{}, nil
+	}
+
+	const chunkSize = 4096
+	var lines []string
+	var leftover []byte
+	offset := fileSize
+
+	for len(lines) < n && offset > 0 {
+		readSize := chunkSize
+		if offset < int64(chunkSize) {
+			readSize = int(offset)
+		}
+		offset -= int64(readSize)
+
+		buf := make([]byte, readSize)
+		_, err := file.ReadAt(buf, offset)
+		if err != nil && err != io.EOF {
+			return nil, err
+		}
+
+		data := append(buf, leftover...)
+		leftover = nil
+
+		start := 0
+		for i := len(data) - 1; i >= 0; i-- {
+			if data[i] == '\n' {
+				if i+1 < len(data) {
+					line := string(data[i+1:])
+					if line != "" {
+						lines = append([]string{line}, lines...)
+						if len(lines) >= n {
+							break
+						}
+					}
+				}
+				start = i
+			}
+		}
+
+		if len(lines) < n && start > 0 {
+			leftover = data[:start]
+		}
+	}
+
+	if len(lines) < n && len(leftover) > 0 {
+		parts := strings.Split(string(leftover), "\n")
+		for i := len(parts) - 1; i >= 0; i-- {
+			if parts[i] != "" {
+				lines = append([]string{parts[i]}, lines...)
+				if len(lines) >= n {
+					break
+				}
+			}
+		}
+	}
+
+	return lines, nil
+}

install_docker.md

@@ -132,7 +132,7 @@ docker run -d \
   --name frpc-console \
   --restart=always \
   --network host \
-  -v /opt/frpc-console/data:/app/data \
+  -v /opt/frpc-console/data:/app\
   -e PORT=9300 \
   -e TZ=Asia/Shanghai \
   frpc-console:latest

main.go

@@ -2,15 +2,29 @@ package main
 
 import (
 	"log"
+	"os"
+	"strings"
 	"time"
 )
 
 func main() {
+	// 确保 data 目录存在
+	if err := os.MkdirAll("./data", 0755); err != nil {
+		log.Printf("⚠️  创建 data 目录失败: %v", err)
+	}
+
+	// 读取 version.ini 显示版本
+	if data, err := os.ReadFile("./data/version.ini"); err == nil {
+		version := strings.TrimSpace(string(data))
+		log.Printf("📌 版本: %s", version)
+	} else {
+		log.Printf("📌 版本: (未记录)")
+	}
+
 	if err := InitDB(); err != nil {
 		log.Fatal("❌ 数据库初始化失败:", err)
 	}
 
-	// 启动时生成配置并启动 frpc
 	if err := GenerateFrpcConfig(); err != nil {
 		log.Println("⚠️  生成配置文件失败:", err)
 	}
@@ -19,7 +33,6 @@ func main() {
 		log.Println("⚠️  启动 frpc 失败:", err)
 	}
 
-	// ✅ 启动 Watchdog：每 30 秒检查一次 frpc 状态，挂了自动重启
 	go startWatchdog()
 
 	r := SetupRouter()
@@ -32,7 +45,6 @@ func main() {
 	}
 }
 
-// Watchdog 协程：定期检查 frpc 是否存活
 func startWatchdog() {
 	ticker := time.NewTicker(30 * time.Second)
 	defer ticker.Stop()

readme.md

@@ -2,10 +2,70 @@
   <img src="static/logo.svg" alt="frpc-console" width="360" />
 </p>
 
+# frpc-console
+
+[![Release](https://img.shields.io/gitea/v/release/lxh2875931338/frpc-console?gitea_url=https://git.whitetop.xyz)](https://git.whitetop.xyz/lxh2875931338/frpc-console/releases)
+[![Go Version](https://img.shields.io/badge/Go-1.21+-00ADD8?style=flat&logo=go)](https://golang.org/)
+[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+**Designed for Long-Term FRP Deployment.**
+
+A lightweight lifecycle console built from real-world engineering practice.
+
+**安装一次。配置一次。然后忘记它。**
+
+---
+
+## 📖 Documents
+
+|  |  |
+|---|---|
+| 📖 Engineering Philosophy | 为什么它会长成今天这样 |
+| 🚀 Deployment Guide | Docker、Binary、ARMHF |
+| 🔄 Update Strategy | Preview / LTS |
+| 🏗 Architecture | 整体架构 |
+| ⚙ Design Decisions | 为什么没有 CI？为什么叫 Console？ |
+| 🌐 Edge Node | 为什么支持 BusyBox、ARMHF |
+
+---
+
+> *“The best infrastructure tool is the one you rarely notice.”*
+
+Read the full [Engineering Philosophy →](docs/engineering-philosophy.md)
+
+---
+
+## 🚀 Quick Start
+
+选择适合您环境的部署方法
+
+[二进制安装指南](./INSTALL_BINARY.md)
+
+[Docker 安装指南](./INSTALL_DOCKER.md)
+
+首次访问注册管理员账户
+
+导入你的 `frpc.toml`
+
+然后——
+
+**忘记它。**
+
+---
+
+**MIT License © 2026 lxh2875931338（XHLiang0）** · [GitHub](链接) · [致谢](链接)
+
+---
+
+
+
+
+
+
 
 # frpc-console
 
-> 轻量级 frpc 管理面板 —— 为你的内网穿透插上翅膀
+**A lightweight console for managing FRP, designed for real-world deployment.**
 
 [![Release](https://img.shields.io/gitea/v/release/lxh2875931338/frpc-console?gitea_url=https://git.whitetop.xyz)](https://git.whitetop.xyz/lxh2875931338/frpc-console/releases)
 [![Go Version](https://img.shields.io/badge/Go-1.21+-00ADD8?style=flat&logo=go)](https://golang.org/)
@@ -13,46 +73,169 @@
 
 ---
 
-## 📖 简介
+frpc-console 并不是另一个 FRP WebUI。
 
-**frpc-console** 是一个专为 [frp](https://github.com/fatedier/frp) 设计的轻量级管理工具。本项目旨在以无限接近原生占用的情况下，实现完全图形化的控制工具（毕竟 WebUI 也算图形化，对吧？）
+它更像是一个生命周期管理工具。
 
-### ✨ 核心特性
+它不会重新定义 FRP，也不会试图接管 FRP。
 
-- 🔐 **首次启动引导** —— Web 端完成管理员注册，无需 CLI 交互
-- 📋 **隧道全生命周期管理** —— 增删改查 + 一键启用/禁用
-- 📦 **导入/导出 TOML** —— 无缝迁移现有 frpc 配置
-- 🔄 **配置热加载** —— 修改即生效，无需重启 frpc
-- 🖥️ **多平台支持** —— Windows / Linux / ARM 全平台兼容
-- 🐳 **容器化就绪** —— 提供 Docker 镜像，开箱即用
-- 🎨 **深色磨砂玻璃 UI** —— 现代化视觉体验，日夜皆宜
+它只是希望：
+
+**让 FRP 更容易部署、更容易维护，也更容易被忘记。**
 
 ---
 
-## 🚀 快速开始
+## 为什么会有这个项目？
 
-### 🐧 二进制安装（推荐）
+最初，这只是一个给自己 Homelab 用的小工具。
 
-适用于 Linux / Windows，无需 Docker，单文件运行。
+我需要一套简单、可靠的方式管理本地运行的 frpc。
 
-👉 详见：([二进制安装指南](https://git.whitetop.xyz/lxh2875931338/frpc-console/src/branch/main/install_binary.md))
+后来，在不断使用、不断重构的过程中，我意识到：
 
-### 🐳 Docker 部署（一键脚本）
+真正的问题，从来不是"有没有一个管理页面"。
 
-适用于 Linux 服务器，自动编译 + 自动部署。
+而是：
 
-> ⚠️ **注意**：Docker 版直接从源码构建，使用的是当前 `main` 分支的最新代码，更新进度会远快于 Release 版本。⚠️</br>
-> 如需使用特定版本（如 LTS），请查看 [Releases](https://git.whitetop.xyz/lxh2875931338/frpc-console/releases) 确认版本号，并通过二进制方式部署指定版本。
+**如果 FRP 是一项长期运行的基础设施，它应该长什么样？**
+
+于是，这个项目开始慢慢偏离最初的方向。
+
+它不再只是一个 Web 面板，而是开始关注：
+
+- 生命周期管理
+- 长期维护
+- 多种部署方式
+- 极简运行环境
+- 用户真实的使用场景
+
+直到今天。
+
+---
+
+## 设计目标
+
+frpc-console 希望成为这样一种工具：
+
+**安装。配置。运行。然后，忘记它。**
+
+真正优秀的基础设施，不应该每天提醒用户自己的存在。
+
+它应该像交换机、路由器、UPS 一样——平时不会想到它，但需要的时候，它一直在那里。
+
+---
+
+## 稳定性与可观测性
+
+"安装、配置、运行，然后忘记它"。
+
+但请记住：**忘记，不等于失控。**
+
+frpc-console 在设计上始终保持一个原则：
+
+**工具自身的开销，不应该成为需要被关注的对象。**
+
+所以：
+
+- 主进程在 idle 状态下 CPU 占用接近 0%
+- 内存占用控制在 20MB 以内
+- 没有额外的后台守护进程
+- 没有定期轮询的健康检查
+- 不会主动写入日志文件，除非你明确开启
+
+下图是在真实设备上同时运行 frpc 和 frpc-console 的资源占用情况：
+
+![resource-usage]()
+
+你可以看到：
+
+- frpc：CPU 0.45%，内存 13.25MB
+- frpc-console：CPU 0.00%，内存 15.64MB
+
+两者加起来不到 30MB。
+
+这意味着：
+
+**你可以忘记它。**
+
+但如果有一天，你想知道它是否还在正常工作——
+
+打开浏览器，看一眼。
+
+然后，继续忘记它。
+
+如果它真的出了什么问题，它的表现也很简单：
+
+要么进程还在，要么进程不在了。
+
+没有中间状态。
+
+没有僵尸进程。
+
+没有需要手动清理的残留文件。
+
+因为对于基础设施来说：
+
+**确定性，比灵活性更重要。**
+
+---
+
+## 界面与核心能力
+
+frpc-console 提供的是一个**图形化的生命周期管理工具**，而不是一个功能堆砌的控制台。
+
+它只做这几件事：
+
+- **首次启动引导**：Web 端完成管理员注册，无需 CLI 交互
+- **隧道全生命周期管理**：增删改查 + 一键启用/禁用
+- **导入/导出 TOML**：无缝迁移现有 frpc 配置
+- **配置热加载**：修改即生效，无需重启 frpc
+- **配置备份与恢复**
+- **进程管理**
+- **数据库维护工具**
+
+功能并不追求数量，而是追求：
+
+**真正有用。**
+
+界面采用深色磨砂玻璃视觉风格，设计目标是：
+
+**当你需要它的时候，它清晰易用；当你不需要它的时候，它不打扰你。**
+
+---
+
+## 快速开始
+
+### 一键部署（推荐，Linux）
 
 ```bash
-curl -sSL https://git.whitetop.xyz/lxh2875931338/frpc-console/raw/main/deploy.sh | sudo bash
+curl -sSL https://git.whitetop.xyz/lxh2875931338/frpc-console/raw/main/run-deploy.sh | sudo bash
 ```
 
-👉 详见：([Docker 安装指南](https://git.whitetop.xyz/lxh2875931338/frpc-console/src/branch/main/install_docker.md))
+脚本会引导你选择 LTS 或 Preview 通道，然后自动完成全部部署。
 
-### 🔧 源码编译
+### Docker 手动部署
 
-适合开发者或需要自定义配置的用户。
+```bash
+docker run -d \
+  --name frpc-console \
+  --restart=always \
+  --network host \
+  -v /opt/frpc-console/data:/app/data \
+  -e PORT=9300 \
+  -e TZ=Asia/Shanghai \
+  frpc-console:lts
+```
+
+### 二进制部署
+
+适用于 Linux / Windows，单文件运行，无需 Docker。
+
+从 [Releases](https://git.whitetop.xyz/lxh2875931338/frpc-console/releases) 下载对应平台的二进制文件，直接运行即可。
+
+首次访问 `http://localhost:9300` 注册管理员账户，然后导入你的 `frpc.toml` 开始使用。
+
+### 源码编译
 
 ```bash
 git clone https://git.whitetop.xyz/lxh2875931338/frpc-console.git
@@ -62,206 +245,230 @@ go build -o frpc-console .
 ./frpc-console
 ```
 
-首次访问 `http://localhost:9300` 注册管理员账户，然后导入你的 `frpc.toml` 即可开始使用。
+---
+
+## 部署哲学：
+
+### 没有 CI/CD 的 CI/CD
+
+这个项目没有复杂的 CI/CD 发布流程。
+
+不是做不到，而是选择不做。
+
+因为每一次部署，都应该在真实环境中被验证。
+
+所以，部署脚本就是发布流水线：
+
+- 拉取代码 → 构建镜像 → 启动容器 → 写入版本 → 检查进程
+- 支持 `--dry-run` 预览、`--check` 环境检测
+- 降级前自动备份数据库
+- 保留最近 3 个镜像，便于回滚
+
+开发过程中使用的更新链路，就是最终用户使用的更新链路。
+
+没有特权通道，没有隐藏开关。
+
+你用的，就是我用的。
+
+因此，每一次更新，实际上都在验证整个部署流程。
+
+这也是为什么，很多部署细节都是在真实环境中一点一点演化出来的。
+
+### 阴阳模式：面板可以挂，隧道不能停
+
+这是 frpc-console 与同类项目最核心的区别。
+
+**大多数管理工具走的是"阳阴模式"：**
+面板是大脑，业务是肢体。大脑一旦停止工作，肢体也就瘫痪了。
+
+**frpc-console 走的是"阴阳模式"：**
+业务是根基，面板是工具。
+
+- **阴**：看不见的业务流（frpc 进程、TOML 配置文件）
+- **阳**：看得见的管理面板（Web 界面、API 服务）
+
+#### 二进制部署
+
+frpc-console 启动时，通过 `Setsid` 为 frpc 创建独立会话，使其完全脱离父进程的生命周期控制。
+
+即使 SSH 断开导致 console 退出，frpc 也会被 init 进程（PID 1）接管，继续稳定运行。
+
+#### Docker 部署
+
+容器使用 `--restart=always`，console 退出时 Docker 自动重启并重新拉起 frpc。
+
+数据目录通过卷挂载持久化，配置不丢失。
+
+两种部署方式的本质一致：
+
+**面板是"阳"，服务于"阴"；"阴"不依赖"阳"而存在。**
+
+> **管理面板可以丢，业务功能打死不能停。**
 
 ---
 
-## 🗂️ 项目结构
-```txt
-frpc-console/
-├── main.go                   # 入口
-├── api.go                    # HTTP 路由 & Handler
-├── db.go                     # SQLite 数据库操作
-├── auth.go                   # JWT 认证 & 密码管理
-├── frp.go                    # frpc 管理核心逻辑
-├── toml_parser.go            # TOML 解析器
-├── static/                   # 前端静态资源
-│   ├── index.html
-│   ├── app.js
-│   ├── style-1.css           # 全局基础样式
-│   ├── style-2.css           # 登录页样式
-│   ├── style-3.css           # 主界面样式
-    └── style-4.css
-├── bin/                      # 内嵌 frpc 二进制 (多平台)
-│   ├── frpc_windows_amd64.exe
-│   ├── frpc_linux_amd64
-│   ├── frpc_linux_arm64
-│   └── frpc_linux_arm_hf
-├── frpc.tmpl            # frpc 配置模板
-├── Dockerfile
-└── go.mod
-```
+## 为什么支持 ARMHF？
 
-## ⚙️ 配置说明
+因为很多时候，真正需要这种工具的，并不是性能很强的服务器。
 
-### 环境变量
+而是一块全志 H3、RK3506，或者老旧 ARM 开发板——放在弱电箱里的边缘节点。
 
-| 变量 | 说明 | 默认值 |
-|---|---|---|
-| PORT | 监听端口 | 9300 |
+它们可能没有 Docker，没有 systemd，甚至只有：
 
+- Kernel
+- BusyBox
+- init
 
-### 数据存储
+但它们依然承担着网络基础设施的工作。
 
-· 数据库文件：./frpc-console.db</br>
-· frpc 配置文件：./frpc.toml</br>
-· frpc 日志文件：./frpc.log</br>
+对于这些设备来说，图形化管理反而比高性能服务器更重要。
 
 ---
 
-## 🛠️ 开发指南
+## Design Philosophy
 
-```bash
-# 克隆项目
-git clone https://github.com/lxh2875931338/frpc-console.git
-cd frpc-console
+### 工具应该降低复杂度，而不是增加复杂度
 
-# 安装依赖
-go mod tidy
+GUI 的意义，并不是隐藏配置文件，而是**降低维护成本**。
 
-# 开发模式运行
-go run .
+如果一个图形界面最终比命令行更复杂，那么它已经偏离了存在的意义。
 
-# 编译生产版本
-go build -ldflags="-s -w" -o frpc-console .
-```
+### 每增加一个功能，都意味着新的维护成本
 
-## 前端开发
+功能不是越多越好。
 
-前端使用 Vue 3 CDN + Naive UI，无需额外构建工具。修改 static/ 目录下的文件后，刷新浏览器即可预览效果。
+一个功能只有在真正改善体验时才值得存在。否则，宁可不做。
 
+这也是为什么：有些别人认为"理所当然"的功能，这里没有。不是不会，而是不值得。
+
+### 用户不是测试员
+
+这个项目的大多数设计，都来自于真实使用。
+
+开发者，也是第一个用户。
+
+如果一个设计连我自己都不愿意每天面对，那么它不会进入正式版本。
+
+### Docker 不是目标
+
+Docker 很重要，Binary 同样重要。
+
+真正重要的是：**无论运行在哪里，体验应该保持一致。**
+
+Docker、x86、ARM64、ARMHF，甚至极简 Linux——都应该拥有同样的管理体验。
+
+### Real World First
+
+这个项目的很多设计，都来自于真实部署，而不是 Demo。
+
+例如：
+
+- Docker 更新顺序
+- Git 拉取时机
+- 编译流程
+- 边缘部署
+- 二进制运行
+- BusyBox 环境
+
+很多看起来"奇怪"的实现，其实都来自于**踩坑**。
+
+不是设计出来的，而是试出来的。
+
+### 存储换内存，在嵌入式平台上不是交易，是生存策略
+
+镜像可以大几十 MB，但内存必须省。
+
+因为内存卡便宜，内存颗粒贵。
+
+对于 RK3506（128/256MB 版本共存）或全志 H3（256/512MB 并存）这类平台——
+
+牺牲一点存储空间（镜像大了几十 MB），换来 50MB 以内的内存占用，这笔账怎么算都不亏。
 
 ---
 
-## 🔧 常见问题
+## 关于版本
 
-#### Q: 如何修改管理员密码？
+项目采用 **Preview / LTS** 双线开发模式：
+
+- **Preview**：用于验证新的设计与实现（test 分支）
+- **LTS**：保持稳定，并持续滚动维护（main 分支）
+
+某些修复不会等待下一个大版本。
+
+因为对于基础设施而言，**稳定比版本号更重要**。
+
+---
+
+## What This Project Is Not
+
+这个项目：
+
+- 不追求成为功能最多的 FRP 管理平台
+- 不追求重新定义 FRP
+- 不追求构建自己的生态
+- 不追求让用户每天打开它
+
+它只是希望：
+
+**把复杂留给软件，把简单留给用户。**
+
+---
+
+## 常见问题
+
+**Q：如果 frpc-console 进程挂了，frpc 本身会受影响吗？**
+
+不会。这就是"阴阳模式"的意义。详见上文。
+
+**Q：如何修改管理员密码？**
 
 登录后，在「全局配置」页面顶部找到「账户管理」区域，输入当前密码和新密码即可。
 
-#### Q: 如何导入现有的 frpc.toml？
+**Q：如何导入现有的 frpc.toml？**
 
 在「隧道列表」页面点击「导入 TOML」，选择你的 frpc.toml 文件即可。
 
-#### Q: frpc 启动失败怎么办？
+**Q：frpc 启动失败怎么办？**
 
-如果是首次启动，console 会自动生成一份符合官方规范的 `frps.toml` 配置文件，通常不需要额外操作。
+如果是首次启动，console 会自动生成一份符合官方规范的 `frpc.toml` 配置文件，通常不需要额外操作。
 
-如果在使用过程中遇到启动失败，可以按以下步骤排查：
+如果使用中遇到启动失败：
+1. 在「全局配置」页面重新配置服务端参数，或导入已有的 `frpc.toml`
+2. 查看 `frpc.log` 日志文件定位具体报错原因
 
-1. **检查配置是否正确** —— 在「全局配置」页面重新配置一次服务端参数，或导入已有的 `frpc.toml` 配置文件，console 会自动应用并尝试重启
-2. **查看日志定位问题** —— 若上述操作后仍然失败，请查看 `./frpc.log` 日志文件，定位具体报错原因
+日志文件位置：与二进制同级目录下的 `frpc.log`。Docker 部署时通过 `docker logs frpc-console` 查看。
 
-> 日志文件的位置：与 `frpc-console` 二进制同级目录下的 `frpc.log`。Docker 部署时，可通过 `docker logs frpc-console` 查看容器输出。
+**Q：支持哪些 frp 版本？**
 
-#### Q: 支持哪些 frp 版本？
-
-目前支持情况如下：
-
-| 系统 | 架构版本 | 版本号 |
+| 系统 | 架构 | 版本 |
 |---|---|---|
 | Linux | AMD64/x86-64 | 0.70.0 |
 | Linux | ARM64/Aarch64 | 0.70.0 |
 | Linux | ARM_hf/ARMv7l | 0.70.0 |
 | Windows | AMD64/x86-64 | 0.70.0 |
 
-> 行了行了，Windows 版和 Linux 版版本号已同步。不用再等了。
-
-#### Q: 为什么不用 / 不推荐 Podux？
-
-Podux 是个好项目，理念上和我们是一致的：用 Web 界面管理 frpc</br>
-但它的设计取向和我们完全不同：
-
-| 对比项 | frpc-console | Podux |
-|---|---|---|
-| 数据库 | SQLite（单文件，几 MB） | PocketBase（带 Admin UI、用户系统、全套 API） |
-| 前端 | Vue CDN | React + Webpack |
-| 实机内存占用 | **~50 MB** | **没启动成功，1GB RAM 独立分配仍 OOM（原因不明）** |
-| 镜像大小 | 封装多平台二进制frpc后 120.28 MB | 76.1 MB |
-| 部署方式 | 单二进制 / Docker | 单二进制 / Docker |
-| 多平台支持 | ✅ 原生交叉编译 | ✅ 原生交叉编译 |
-
-> Podux 与其说是一个 frp 控制面板，不如说是一个“一站式 frp 管理器 + 可视化数据流面板 + 通道保活监测工具”。这种一站式本身没毛病，甚至功能实现非常到位。</br>但 podux的框架选型有点重，而且很明显细节稍显仓促。PocketBase 自带 WebUI 的情况下，Podux 还要再包一层 WebUI——相当于给数据库的 UI 又套了个 UI。更费解的是，这层 WebUI 只支持导入，不支持导出。这设计确实让人有点摸不着头脑啦……</br>所以干脆换了一套轻量化工具自己上咯~
-
-
-### Q: 为什么不直接用 frp 官方提供的 web 界面？
-
-frp 官方确实提供了 `dashboard` 和 `frpc-admin` 功能，但它们更多是“监控”视角，而非“管理”视角。你需要手动编辑配置文件，重启 frpc，或者依赖命令行操作。
-
-frpc-console 的目标是：
-- **点一点就能新增隧道**
-- **开关一拨就能启用/禁用**
-- **导入导出无缝迁移**
-- **热加载无需重启**
-
-### Q: 如果 frpc-console 进程挂了，frpc 本身会受影响吗？
-
-**不会。**
-
-这是 frp-console 系列工具与同类项目最核心的区别之一。我们称之为 **“阴阳模式”**。</br>
-接下来，我们将结合中式哲学思想，阐述这个名称的由来：
-
-#### 什么是“阴阳模式”？
-
-以人的观察为出发点：
-
-- **阴**：看不见的业务流（frpc 进程、toml 配置文件、隧道连接）
-- **阳**：看得见的管理面板（Web 界面、API 服务）
-
-大多数管理工具走的是 **“阳阴模式”**：面板是“大脑”，业务是“肢体”。大脑一旦停止工作，肢体也就瘫痪了。</br>
-在这种模式下，管理面板与业务进程深度绑定，面板退出时业务进程也会随之终止。
-
-**frpc-console 走的是“阴阳模式”：业务是根基，面板是工具。**
-
-- **阴主导阳**：业务不依赖面板存活，面板只是用来观察和调整业务状态的手段
-- **阳依附于阴**：面板的存在是为了服务业务，而不是反过来
-
-
-#### 不同部署方式下的行为
-
-**二进制部署：**
-
-frpc-console 启动时，会以子进程的方式拉起 frpc，并为它创建一个独立的进程会话（`Setsid`）。这意味着 frpc 完全脱离父进程的生命周期控制。即使 SSH 断开导致 frpc-console 进程退出，frpc 也会被系统的 init 进程（PID 1）接管，继续在后台稳定运行。配置文件（`frpc.toml`）是持久化文件，不依赖 console 进程存活。面板可以随时挂、随时重启、随时升级，但隧道业务不受任何干扰。
-
-**Docker 部署：**
-
-容器使用 `--restart=always` 策略，frpc-console 进程意外退出时，Docker 守护进程会自动重启整个容器。重启后，console 重新读取持久化的 `frpc.toml`，重新拉起 frpc 子进程。数据目录（`/opt/frpc-console/data`）通过卷挂载持久化，容器重启不会丢失任何配置。Docker 模式的本质依然是“阳辅助阴”——`restart:always` 的目的是确保阴（业务）持续运行，而不是为了保住阳（面板）本身。
-
-
-#### 为什么同类项目里很少见到这种设计？
-
-因为大多数管理工具把“面板”和“业务”耦合在一起，认为面板是前提条件，业务是附属品。当然了，这确实是正向的、符合直觉的设计方向。但是有一个被很多人忽略的事实：**真正需要长期稳定运行的是隧道本身，而不是管理界面的进程。**
-
-界面是用来观察和调整的，不是用来维持业务存活的。这是运维集群常用的“管理面与控制面分离”——只不过通常只在几千台服务器的集群管理里才会出现，很少有人会把它用在一个人用的 frp 管理工具上。
-
-
-#### 核心原则
-
-console 只做“配置的保管者”和“进程的启动者”，而不是“配置的持有者”或“进程的绑定者”。即使 console 完全离线，已经生成的 `frpc.toml` 依然存在，frpc 进程依然可以独立运行。这是 frp 本身的容灾能力在管理工具层面的自然延伸——**可视化框架只是工具，业务本身才是核心。**
-
-> **管理面板可以丢，业务功能打死不能停。**
-
-### Q: 支持 frp 的所有功能吗？
-
-frpc-console 覆盖了 frp 最核心的 **TCP 隧道管理** 功能，包括 `tcpMux`、负载均衡、心跳配置等。如果你有更复杂的需求（比如 STCP、XTCP、P2P），欢迎提 issue，我们会评估是否加入。
-
 ---
 
-## 🧠 设计哲学
+## 最后
 
-frpc-console 遵循 **“够用就好”** 的原则：
+如果有一天，你已经忘记 frpc-console 安装在哪里，也忘记它上一次更新是什么时候。
 
-1. **frp 是轻量工具，管理工具也应该是轻量的。**
-2. **能用 SQLite 就不用 PostgreSQL，能用 Vue CDN 就不用 React 全家桶。**
-3. **前端能做的事，后端不加额外复杂度。**
-4. **删掉一个容器等于删掉所有垃圾，所以用 Docker 隔离是对的。**
-5. **面板的存在应该是为了服务业务的，而不该是反过来主导业务的。**
+但是：
+
+- FRP 依然稳定运行
+- 偶尔需要修改配置
+- 打开浏览器
+- 两分钟完成
+- 关闭
+- 继续忘记它
+
+那么，它已经完成了自己的使命。
 
 ---
 
 ## 📝 更新日志
 
-完整更新日志请查看[update-logs](https://git.whitetop.xyz/lxh2875931338/frpc-console/src/branch/main/update-logs.md)
+#### 相关更新日志请查看[update-logs.md](./update-logs.md)
 
 ---
 
@@ -280,10 +487,12 @@ MIT License © 2026 lxh2875931338（XHLiang0）
 ### FRP 生态同类工具（暂无互引）
 </br>
 
----
+## 致谢
+
+- [fatedier/frp](https://github.com/fatedier/frp) —— 强大的内网穿透工具
+- [gin-gonic/gin](https://github.com/gin-gonic/gin) —— 高性能 Go Web 框架
+- [vuejs/vue](https://github.com/vuejs/vue) —— 渐进式 JavaScript 框架
+
+
 
-## 🙏 致谢
 
-· fatedier/frp —— 强大的内网穿透工具</br>
-· gin-gonic/gin —— 高性能 Go Web 框架</br>
-· vuejs/vue —— 渐进式 JavaScript 框架

run-deploy.sh

@@ -0,0 +1,115 @@
+#!/bin/bash
+
+# ============================================================
+# frpc-console 部署入口（前置引导脚本）
+# 此脚本固定在 main 分支，永不变化。
+# 职责：引导用户选择通道，拉取对应分支的 deploy.sh 并执行
+# 
+# 用法:
+#   curl -sSL https://git.whitetop.xyz/.../run-deploy.sh | sudo bash
+#   curl -sSL https://git.whitetop.xyz/.../run-deploy.sh | sudo bash -s -- --channel preview
+# ============================================================
+
+set -e
+
+if [ -t 1 ]; then
+    RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'
+    BLUE='\033[0;34m'; CYAN='\033[0;36m'; MAGENTA='\033[0;35m'; NC='\033[0m'
+else
+    RED=''; GREEN=''; YELLOW=''; BLUE=''; CYAN=''; MAGENTA=''; NC=''
+fi
+
+print_info() { echo -e "${BLUE}[INFO]${NC} $1"; }
+print_error() { echo -e "${RED}[✗]${NC} $1"; }
+
+REPO_URL="https://git.whitetop.xyz/lxh2875931338/frpc-console.git"
+WORK_DIR="/tmp/frpc-console-deploy"
+CHANNEL=""
+BRANCH=""
+
+parse_args() {
+    for arg in "$@"; do
+        case $arg in
+            --channel)
+                shift; CHANNEL="$1"
+                ;;
+            --channel=*)
+                CHANNEL="${arg#*=}"
+                ;;
+            --help|-h)
+                echo "用法: curl .../run-deploy.sh | sudo bash -s -- [选项]"
+                echo ""
+                echo "选项:"
+                echo "  --channel lts       使用 LTS 通道 (main 分支)"
+                echo "  --channel preview   使用 Preview 通道 (test 分支)"
+                echo "  --help, -h          显示帮助信息"
+                exit 0
+                ;;
+            *)
+                print_error "未知选项: $arg"
+                echo "使用 --help 查看帮助"
+                exit 1
+                ;;
+        esac
+    done
+}
+
+select_channel() {
+    if [ -n "$CHANNEL" ]; then
+        if [ "$CHANNEL" != "lts" ] && [ "$CHANNEL" != "preview" ]; then
+            print_error "无效通道: $CHANNEL (仅支持 lts / preview)"
+            exit 1
+        fi
+        BRANCH="$([ "$CHANNEL" = "preview" ] && echo "test" || echo "main")"
+        print_info "使用命令行参数: ${CHANNEL} 通道 (${BRANCH} 分支)"
+        return
+    fi
+
+    echo ""
+    echo -e "${CYAN}请选择部署通道:${NC}"
+    echo "  1. LTS (稳定版，生产推荐) [默认] → main 分支"
+    echo "  2. Preview (技术预览版，包含新特性) → test 分支"
+    echo ""
+    read -p "请选择 [1]: " CHANNEL_INPUT </dev/tty
+    CHANNEL_INPUT=${CHANNEL_INPUT:-1}
+    case $CHANNEL_INPUT in
+        1|"") CHANNEL="lts"; BRANCH="main" ;;
+        2) CHANNEL="preview"; BRANCH="test" ;;
+        *) print_error "无效选择"; exit 1 ;;
+    esac
+    print_info "已选择: ${CHANNEL} 通道 (${BRANCH} 分支)"
+}
+
+fetch_and_run() {
+    local deploy_url="https://git.whitetop.xyz/lxh2875931338/frpc-console/raw/${BRANCH}/deploy.sh"
+    echo ""
+    echo -e "${CYAN}▶ 从 ${BRANCH} 分支拉取 deploy.sh...${NC}"
+    rm -rf "$WORK_DIR"
+    mkdir -p "$WORK_DIR"
+    cd "$WORK_DIR"
+    if ! curl -sSL -o deploy.sh "$deploy_url"; then
+        print_error "无法下载 deploy.sh: $deploy_url"
+        exit 1
+    fi
+    chmod +x deploy.sh
+    echo -e "${GREEN}[✓] deploy.sh 已拉取${NC}"
+    echo ""
+    echo -e "${CYAN}▶ 执行部署脚本...${NC}"
+    echo ""
+    export DEPLOY_CHANNEL="$CHANNEL"
+    export DEPLOY_BRANCH="$BRANCH"
+    exec ./deploy.sh "$@"
+}
+
+main() {
+    clear 2>/dev/null || true
+    echo -e "${MAGENTA}════════════════════════════════════════════════════════${NC}"
+    echo -e "${MAGENTA}  frpc-console 部署入口${NC}"
+    echo -e "${MAGENTA}════════════════════════════════════════════════════════${NC}"
+    echo ""
+    parse_args "$@"
+    select_channel
+    fetch_and_run "$@"
+}
+
+main "$@"

script/build.go

@@ -9,6 +9,7 @@ import (
 	"os/exec"
 	"path/filepath"
 	"strings"
+	"time"
 )
 
 type Platform struct {
@@ -22,15 +23,87 @@ var platforms = []Platform{
 	{"windows", "amd64", "Windows x86-64", ".exe"},
 	{"linux", "amd64", "Linux x86-64", ""},
 	{"linux", "arm64", "Linux ARM64", ""},
-	{"linux", "arm", "Linux ARMv7l", ""}, // GOARCH=arm, GOARM=7
+	{"linux", "arm", "Linux ARMv7l", ""},
 }
 
 const (
-	Version   = "2.0.0"
-	BuildTime = "2026-07-26"
+	BuildTime = "2026-07-29"
 	Binary    = "frpc-console"
 )
 
+// ============================================================
+// 版本管理核心
+// ============================================================
+
+func readVersion() (semver string, ltsDate string) {
+	data, err := os.ReadFile("./version.ini")
+	if err != nil {
+		return "0.0.0", ""
+	}
+	lines := strings.Split(string(data), "\n")
+	var content string
+	for _, line := range lines {
+		line = strings.TrimSpace(line)
+		if line == "" || strings.HasPrefix(line, ";") || strings.HasPrefix(line, "#") {
+			continue
+		}
+		content = line
+		break
+	}
+	parts := strings.Fields(content)
+	if len(parts) < 1 {
+		return "0.0.0", ""
+	}
+	semver = parts[0]
+	if len(parts) > 1 {
+		ltsDate = parts[1]
+	}
+	return semver, ltsDate
+}
+
+func getVersionType(semver string) string {
+	parts := strings.Split(semver, ".")
+	if len(parts) < 2 {
+		return "preview"
+	}
+	minor := parts[1]
+	if minor == "0" || minor == "5" {
+		return "lts"
+	}
+	return "preview"
+}
+
+func getFullVersion() string {
+	semver, ltsDate := readVersion()
+	vType := getVersionType(semver)
+
+	switch vType {
+	case "lts":
+		if ltsDate == "" {
+			ltsDate = time.Now().Format("20060102")
+		}
+		return semver + "-lts-" + ltsDate
+	default:
+		timestamp := time.Now().Format("20060102-150405")
+		return semver + "-preview-" + timestamp
+	}
+}
+
+func getImageTag() string {
+	semver, ltsDate := readVersion()
+	vType := getVersionType(semver)
+
+	switch vType {
+	case "lts":
+		if ltsDate == "" {
+			ltsDate = time.Now().Format("20060102")
+		}
+		return semver + "-lts-" + ltsDate
+	default:
+		return "preview-" + time.Now().Format("20060102-150405")
+	}
+}
+
 func main() {
 	if len(os.Args) > 1 {
 		target := os.Args[1]
@@ -44,6 +117,12 @@ func main() {
 		case "list":
 			listPlatforms()
 			return
+		case "version":
+			fmt.Println(getFullVersion())
+			return
+		case "image-tag":
+			fmt.Println(getImageTag())
+			return
 		}
 		for _, p := range platforms {
 			if target == p.OS+"/"+p.Arch {
@@ -52,8 +131,8 @@ func main() {
 			}
 		}
 		fmt.Println("❌ 不支持的平台:", target)
-		fmt.Println("   可用: windows/amd64, linux/amd64, linux/arm64, linux/armv7")
-		fmt.Println("   或: all, list, clean")
+		fmt.Println("   可用: windows/amd64, linux/amd64, linux/arm64, linux/arm")
+		fmt.Println("   或: all, list, clean, version, image-tag")
 		return
 	}
 	interactiveMenu()
@@ -68,15 +147,19 @@ func listPlatforms() {
 
 func interactiveMenu() {
 	fmt.Println("========================================")
-	fmt.Println("  frpc-console 多平台构建工具 v" + Version)
+	fmt.Println("  frpc-console 多平台构建工具")
 	fmt.Println("========================================")
 	fmt.Println()
+	fmt.Println("  当前版本:", getFullVersion())
+	fmt.Println("  镜像标签:", getImageTag())
+	fmt.Println()
 
 	for i, p := range platforms {
 		fmt.Printf("  %d. %s (%s/%s)\n", i+1, p.Name, p.OS, p.Arch)
 	}
 	fmt.Println("  a. 全部构建")
 	fmt.Println("  c. 清理构建产物")
+	fmt.Println("  v. 显示版本信息")
 	fmt.Println("  q. 退出")
 	fmt.Println()
 
@@ -96,6 +179,10 @@ func interactiveMenu() {
 	case "a":
 		buildAll()
 		return
+	case "v":
+		fmt.Println("版本:", getFullVersion())
+		fmt.Println("镜像标签:", getImageTag())
+		return
 	default:
 		var idx int
 		if n, err := fmt.Sscanf(input, "%d", &idx); n == 1 && err == nil && idx >= 1 && idx <= len(platforms) {
@@ -125,16 +212,22 @@ func build(p Platform, silent bool) {
 		return
 	}
 
-	// 构建输出文件名
+	fullVersion := getFullVersion()
+	imageTag := getImageTag()
+
 	outName := Binary + "-" + p.OS + "-" + p.Arch
 	if p.Arch == "arm" {
-		outName += "v7" // 标注 ARMv7 版本
+		outName += "v7"
 	}
 	outName += p.Ext
 	outPath := filepath.Join(outDir, outName)
 
 	cmd := exec.Command("go", "build",
-		"-ldflags=-s -w -X main.version="+Version,
+		"-ldflags="+
+			"-s -w "+
+			"-X main.buildVersion="+fullVersion+" "+
+			"-X main.buildImageTag="+imageTag+" "+
+			"-X main.buildTime="+BuildTime,
 		"-o", outPath,
 		".",
 	)
@@ -144,7 +237,6 @@ func build(p Platform, silent bool) {
 		"CGO_ENABLED=0",
 	)
 
-	// ARM 架构指定 GOARM=7
 	if p.Arch == "arm" {
 		cmd.Env = append(cmd.Env, "GOARM=7")
 	}
@@ -159,6 +251,7 @@ func build(p Platform, silent bool) {
 
 	if !silent {
 		fmt.Printf("✅ 构建完成: %s\n", outPath)
+		fmt.Printf("   版本: %s\n", fullVersion)
 		if info, err := os.Stat(outPath); err == nil {
 			size := float64(info.Size()) / 1024 / 1024
 			fmt.Printf("   📦 %.2f MB\n", size)

static/index.html

@@ -100,7 +100,8 @@
                                 <!-- Ping 延迟显示 -->
                                 <span class="ping-display" :class="pingStatusClass">
                                     <span class="ping-icon" v-html="pingIcon"></span>
-                                    <span class="ping-value">{{ pingLatency !== null ? pingLatency + 'ms' : '--ms' }}</span>
+                                    <span class="ping-value">{{ pingLatency !== null ? pingLatency + 'ms' : '--ms'
+                                        }}</span>
                                 </span>
                             </span>
                         </div>
@@ -343,6 +344,14 @@
                 </div> <!-- /content-area -->
 
                 <!-- ====== 弹窗 ====== -->
+
+
+            </div> <!-- /main-panel -->
+        </div> <!-- /app-container -->
+
+        <!-- 隐藏文件选择器 -->
+        <input type="file" id="tomlFileInput" accept=".toml" style="display:none" @change="handleImport" />
+
         <Transition name="dialog">
             <div v-if="dialogVisible" class="dialog-overlay" @click.self="dialogVisible = false">
                 <div class="dialog-card">
@@ -371,13 +380,6 @@
                 </div>
             </div>
         </Transition>
-
-            </div> <!-- /main-panel -->
-        </div> <!-- /app-container -->
-
-        <!-- 隐藏文件选择器 -->
-        <input type="file" id="tomlFileInput" accept=".toml" style="display:none" @change="handleImport" />
-
     </div> <!-- /#app -->
 
     <script src="/static/app.js"></script>

static/style-1.css

@@ -1,30 +1,28 @@
 /* ===== style-1.css - 全局基础 ===== */
 
 /* ---------- 字体定义 ---------- */
+/* 自托管 HarmonyOS Sans SC Regular */
+
+/* 中英文：HarmonyOS Sans SC Regular */
 @font-face {
     font-family: 'HarmonyOS Sans SC';
-    src: local('HarmonyOS Sans SC'),
-         local('PingFang SC'),
-         local('Microsoft YaHei'),
-         local('Helvetica Neue');
+    src: url('./fonts/HarmonyOS_Sans_SC_Regular.ttf') format('truetype');
     font-weight: 400;
+    font-style: normal;
     font-display: swap;
 }
+
+/* 数字专用：复用 HarmonyOS Sans SC Regular（因 Light 版本缺失） */
 @font-face {
-    font-family: 'HarmonyOS Sans SC';
-    src: local('HarmonyOS Sans SC Medium'),
-         local('PingFang SC Medium');
-    font-weight: 500;
-    font-display: swap;
-}
-@font-face {
-    font-family: 'HarmonyOS Sans SC';
-    src: local('HarmonyOS Sans SC Bold'),
-         local('PingFang SC Semibold');
-    font-weight: 700;
+    font-family: 'HarmonyOS Sans';
+    src: url('./fonts/HarmonyOS_Sans_SC_Regular.ttf') format('truetype');
+    font-weight: 300;
+    font-style: normal;
     font-display: swap;
 }
 
+/* 后备：如果自托管字体加载失败，使用系统字体 */
+
 /* ---------- 重置 ---------- */
 * {
     margin: 0;
@@ -33,14 +31,14 @@
 }
 
 body {
-    font-family: 'Segoe UI', 'PingFang SC', 'Microsoft YaHei', sans-serif;
+    font-family: 'HarmonyOS Sans SC', 'PingFang SC', 'Microsoft YaHei', 'Helvetica Neue', sans-serif;
     background: #0a0a0f;
     height: 100vh;
     overflow: hidden;
     color: #e0e0e0;
 }
 
-/* ---------- 数字专用字体（加粗） ---------- */
+/* ---------- 数字专用字体（使用 HarmonyOS Sans） ---------- */
 .digit,
 .big-number,
 .remote-port,
@@ -51,22 +49,23 @@ body {
 .login-btn,
 .save-btn,
 .btn-confirm {
-    font-weight: 600 !important;
+    font-weight: 300 !important;
     letter-spacing: 0.02em;
+    font-family: 'HarmonyOS Sans', 'JetBrains Mono', monospace;
 }
 
 /* 数字特别加粗（适用于大数字展示） */
 .big-number {
-    font-weight: 700 !important;
+    font-weight: 600 !important;
     letter-spacing: -0.01em;
 }
 
-/* 代码/端口类数字使用等宽字体，但保持加粗 */
+/* 代码/端口类数字使用等宽字体，但保持 HarmonyOS Sans 风格 */
 .digit,
 .remote-port,
 .proxy-addr {
-    font-family: 'HarmonyOS Sans SC', 'JetBrains Mono', monospace;
-    font-weight: 600 !important;
+    font-family: 'HarmonyOS Sans', 'JetBrains Mono', monospace;
+    font-weight: 300 !important;
 }
 
 /* ---------- 全局颜色变量 ---------- */
@@ -175,7 +174,7 @@ body {
     height: 100%;
     display: flex;
     flex-direction: column;
-    padding: 20px 28px;          /* ← 补上内边距 */
+    padding: 20px 28px;
     opacity: 0;
     transition: opacity 0.3s ease;
 }

static/style-3.css

@@ -17,8 +17,8 @@
 }
 
 .top-left .nav-logo {
-    width: 48px;
-    height: 48px;
+    width: 52px;   /* 原 48px */
+    height: 52px;  /* 原 48px */
     flex-shrink: 0;
     display: block;
     object-fit: contain;
@@ -32,7 +32,7 @@
 }
 
 .brand-info .logo-text {
-    font-size: 22px;
+    font-size: 20px;
     font-weight: 600;
     color: var(--text-primary);
     line-height: 1.2;
@@ -59,8 +59,9 @@
     box-shadow: 0 0 12px rgba(99, 226, 183, 0.4);
 }
 
+/* 状态文字 12px（原 13px） */
 .status-wrapper .status-text {
-    font-size: 13px;
+    font-size: 12px;
     color: var(--text-muted);
 }
 
@@ -71,7 +72,7 @@
 }
 
 .user-name {
-    font-size: 13px;
+    font-size: 12px;  /* 原 13px，与状态文字对齐 */
     color: var(--text-secondary);
 }
 
@@ -375,7 +376,7 @@
 .proxy-addr {
     font-size: 13px;
     color: var(--text-dim);
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'HarmonyOS Sans','JetBrains Mono', monospace;
 }
 
 .proxy-tag {
@@ -395,7 +396,7 @@
 }
 
 .remote-port {
-    font-family: 'JetBrains Mono', monospace;
+    font-family: 'HarmonyOS Sans','JetBrains Mono', monospace;
     font-size: 14px;
     color: var(--text-secondary);
 }
@@ -801,3 +802,40 @@ select:disabled {
         height: 14px;
     }
 }
+
+/* ---------- Tab 栏 ---------- */
+.tab-bar {
+    display: flex;
+    gap: 32px;
+    padding: 14px 0 12px;
+    flex-shrink: 0;
+    border-bottom: 1px solid var(--border-subtle);
+}
+
+/* 将最后一个 Tab（用户配置）推到最右侧 */
+.tab-item:last-child {
+    margin-left: auto;
+    /* 防止用户名过长导致溢出 */
+    max-width: 220px;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+}
+
+.tab-item {
+    font-size: 14px;
+    color: var(--text-muted);
+    cursor: pointer;
+    padding: 4px 0;
+    transition: color 0.3s, border-color 0.3s;
+    border-bottom: 2px solid transparent;
+}
+
+.tab-item:hover {
+    color: var(--text-secondary);
+}
+
+.tab-item.active {
+    color: var(--primary-blue);
+    border-bottom-color: var(--primary-blue);
+}

update-logs.md

@@ -1,36 +1,142 @@
-### 2.3 （2026-07-28）（non-LTS）
+## 📌 版本说明
 
+| 版本类型 | 标记 | 适用场景 |
+|----------|------|----------|
+| LTS 正式版 | `-lts` | 生产环境，长期维护 |
+| 技术预览版 | `-preview` | 功能前瞻，建议测试环境验证 |
 
-### 2.0-LTS （2026-07-27）
+---
 
-> 本次 LTS 版本聚焦于**稳定性兜底与协议能力对齐**，是 frp 0.70.0 LTS 的下游管理工具。
+## 2.5-lts (2026-08-03)
 
-· 🚀 **frp v2 协议正式启用** —— `wireProtocol = "v2"` 配置项可用，灰标状态解除，实测稳定</br>
-· 🔒 **数据库迁移引擎完整实现** —— 版本驱动的增量迁移 + 迁移前自动全量备份 + 失败可回滚，升级不再提心吊胆</br>
-· 🧩 **配套工具 frps-console 同步发布** —— 同一套设计哲学，一个管理 frpc，一个管理 frps，版本号同步，LTS 同步
+> **稳定加固版 —— 架构升级与部署流程闭环**
 
+### 核心变更
 
-### 1.5-Release (2026-07-25)（non-LTS）
+- 数据目录规范化 —— 所有运行时文件统一迁移至 `/app/data`，挂载点从 `/app` 收窄至 `/app/data`，彻底解决挂载覆盖二进制文件的问题
+- 版本管理解耦 —— 二进制不再注入版本信息，由 `deploy.sh` 在部署时写入 `version.ini`
+- 入口脚本分离 —— 引入 `run-deploy.sh` 独立入口，用户只需记住一个命令
+- 僵尸进程回收 —— 子进程退出时自动回收资源，防止僵尸进程积累
 
-> 本次更新聚焦于**WebUI 交互体验与基础工程能力**，为 2.0 LTS 铺路。
+### UI 优化
 
-· ✨ **全局配置页面卡片式重构** —— 按“服务器连接 / 传输配置 / 日志配置”分组，告别折叠面板</br>
-· ✨ **新增运行日志面板** —— WebUI 内实时查看 frpc 日志，8 秒自动轮询，最大 200 行，调试方便不少</br>
-· ✨ **frp v2 配置占位** —— UI 开关已就绪（灰标禁用），为 2.0 的正式启用做好铺垫</br>
-· 🔩 **数据库 Schema 迁移框架** —— 启动时自动检测并补全缺失列，升级不再依赖手动改表（2.0 在此基础上升级为完整备份 + 回滚）</br>
-· 🔐 **默认配置脱敏** —— 移除个人服务端地址与令牌，改为通用占位符，避免开箱即连别人的服务器</br>
-· 🎨 **样式拆分与优化** —— 按职责拆分为多个 CSS 文件，维护更清晰
+- 字体全系 HarmonyOS Sans SC，视觉风格统一
+- 「用户配置」Tab 移至导航栏最右侧
+- 弹窗居中修复，顶部导航字号优化
 
+### 🐛 修复
 
-### 1.0-Release (2026-07-24)（non-LTS）
+- 修复挂载覆盖导致二进制不可用的问题
+- 修复 `ps | grep` 进程检测在容器环境不可靠的问题
+- 修复旧版本升级时数据库路径不兼容的问题
 
-> 首次发布，核心功能全部就绪。
+## 🚀 2.4-lts (2026-07-30)
 
-· 🎉 **首次发布**</br>
-· 📋 **隧道全生命周期管理** —— 增删改查 + 一键启用/禁用</br>
-· 📦 **TOML 导入/导出** —— 无缝迁移现有 frpc 配置</br>
-· 🔄 **配置热加载** —— 修改即生效，无需重启 frpc</br>
-· 🔐 **首次启动 Web 注册** —— 无需命令行交互</br>
-· 🖥️ **多平台支持** —— Windows / Linux / ARM 全平台兼容</br>
-· 🐳 **容器化就绪** —— Docker 镜像，开箱即用</br>
-· 🎨 **深色磨砂玻璃 UI** —— 现代化视觉体验</br>
+> **紧急修复版 —— 架构升级与部署流程重构**
+>
+> 本次版本为 **非正统 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

version.ini

@@ -0,0 +1,6 @@
+; frpc-console 版本声明文件
+; 格式: {语义版本号} [{LTS发布日期}]
+; 示例:
+;   2.4              # Preview 版本，无日期
+;   2.5 20260729     # LTS 版本，带发布日期
+2.5