2.4-接入全新部署逻辑设计，内容较多，后续会在日志内单开一个md文件说明

readme措辞调整

Signed-off-by: 不安的亡命樱 <1+lxh2875931338@noreply.localhost>

api.go

@@ -6,11 +6,13 @@ import (
 	"fmt"
 	"io"
 	"io/fs"
+	"net"
 	"net/http"
 	"os"
 	"strconv"
 	"strings"
 	"text/template"
+	"time"
 
 	"github.com/gin-gonic/gin"
 	"golang.org/x/crypto/bcrypt"
@@ -43,10 +45,13 @@ func SetupRouter() *gin.Engine {
 
 	api := r.Group("/api")
 	{
+		// ---- 公开路由（不需要认证） ----
 		api.GET("/check/users", checkUsersHandler)
 		api.POST("/register", registerHandler)
 		api.POST("/login", loginHandler)
+		api.GET("/ping", pingHandler)
 
+		// ---- 需要认证的路由 ----
 		auth := api.Group("/")
 		auth.Use(AuthMiddleware())
 		{
@@ -75,7 +80,7 @@ func SetupRouter() *gin.Engine {
 	return r
 }
 
-// ========== 所有 Handler ==========
+// ========== 认证 Handler ==========
 
 func checkUsersHandler(c *gin.Context) {
 	count, err := CountUsers()
@@ -223,6 +228,8 @@ func changePasswordHandler(c *gin.Context) {
 	c.JSON(http.StatusOK, gin.H{"code": 0, "msg": "密码修改成功"})
 }
 
+// ========== 配置 Handler ==========
+
 func getConfigHandler(c *gin.Context) {
 	cfg, err := GetGlobalConfig()
 	if err != nil {
@@ -258,6 +265,8 @@ func updateConfigHandler(c *gin.Context) {
 	c.JSON(http.StatusOK, gin.H{"code": 0, "msg": "配置更新成功"})
 }
 
+// ========== 隧道 Handler ==========
+
 func getProxiesHandler(c *gin.Context) {
 	proxies, err := GetProxies()
 	if err != nil {
@@ -348,6 +357,8 @@ func deleteProxyHandler(c *gin.Context) {
 	c.JSON(http.StatusOK, gin.H{"code": 0, "msg": "隧道删除成功"})
 }
 
+// ========== frpc 进程管理 Handler ==========
+
 func reloadFrpcHandler(c *gin.Context) {
 	if err := GenerateFrpcConfig(); err != nil {
 		c.JSON(http.StatusInternalServerError, gin.H{"code": 2, "msg": "生成配置失败: " + err.Error()})
@@ -385,6 +396,144 @@ func getFrpcStatusHandler(c *gin.Context) {
 	c.JSON(http.StatusOK, gin.H{"code": 0, "data": gin.H{"running": running}})
 }
 
+// ========== 日志 Handler ==========
+
+func getFrpcLogHandler(c *gin.Context) {
+	lines, err := readTailLog("./frpc.log", 200)
+	if err != nil {
+		c.JSON(http.StatusOK, gin.H{
+			"code": 0,
+			"data": gin.H{
+				"lines": []string{},
+				"total": 0,
+				"error": err.Error(),
+			},
+		})
+		return
+	}
+	c.JSON(http.StatusOK, gin.H{
+		"code": 0,
+		"data": gin.H{
+			"lines": lines,
+			"total": len(lines),
+		},
+	})
+}
+
+// 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) {
+	target := c.Query("target")
+	if target == "" {
+		c.JSON(http.StatusBadRequest, gin.H{"code": 1, "msg": "缺少 target 参数"})
+		return
+	}
+
+	cfg, err := GetGlobalConfig()
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"code": 2, "msg": "读取配置失败"})
+		return
+	}
+
+	port := cfg.ServerPort
+	address := net.JoinHostPort(target, strconv.Itoa(port))
+
+	start := time.Now()
+	conn, err := net.DialTimeout("tcp", address, 5*time.Second)
+	if err != nil {
+		c.JSON(http.StatusOK, gin.H{"code": 1, "msg": "ping 失败", "latency": -1})
+		return
+	}
+	conn.Close()
+
+	latency := time.Since(start).Milliseconds()
+	c.JSON(http.StatusOK, gin.H{"code": 0, "latency": latency})
+}
+
+// ========== 导入/导出 TOML ==========
+
 func importTomlHandler(c *gin.Context) {
 	file, err := c.FormFile("file")
 	if err != nil {
@@ -470,14 +619,22 @@ func ExportTomlHandler(c *gin.Context) {
 		}
 	}
 
+	// 构建与 GenerateFrpcConfig 一致的数据结构
 	data := struct {
 		*GlobalConfig
-		Proxies []Proxy
+		Proxies          []Proxy
+		WireProtocolLine string
 	}{
 		GlobalConfig: cfg,
 		Proxies:      activeProxies,
 	}
 
+	if cfg.WireProtocolV2 {
+		data.WireProtocolLine = `wireProtocol = "v2"`
+	} else {
+		data.WireProtocolLine = ""
+	}
+
 	tmpl, err := template.New("frpc").Parse(FrpcTemplateContent)
 	if err != nil {
 		c.JSON(http.StatusInternalServerError, gin.H{"code": 2, "msg": "解析模板失败: " + err.Error()})
@@ -495,114 +652,6 @@ func ExportTomlHandler(c *gin.Context) {
 	c.String(http.StatusOK, buf.String())
 }
 
-// ========== 日志读取 ==========
-
-func getFrpcLogHandler(c *gin.Context) {
-	// 读取 ./frpc.log，最多返回 200 行（最新的 200 行）
-	lines, err := readTailLog("./frpc.log", 200)
-	if err != nil {
-		c.JSON(http.StatusOK, gin.H{
-			"code": 0,
-			"data": gin.H{
-				"lines": []string{},
-				"total": 0,
-				"error": err.Error(),
-			},
-		})
-		return
-	}
-	c.JSON(http.StatusOK, gin.H{
-		"code": 0,
-		"data": gin.H{
-			"lines": lines,
-			"total": len(lines),
-		},
-	})
-}
-
-// 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 {
-		// 从 leftover 中提取行
-		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
-}
-
 func generateAndReload() error {
 	if err := GenerateFrpcConfig(); err != nil {
 		return err

db-history.go

@@ -0,0 +1,91 @@
+package main
+
+// ============================================================
+// db-history.go - Schema 版本声明与字段映射
+// ============================================================
+
+type SchemaVersionDef struct {
+	Version   string
+	TableName string
+	Columns   map[string]ColumnDef
+}
+
+type ColumnDef struct {
+	Type    string
+	NotNull bool
+	Default string
+	Primary bool
+}
+
+var schemaHistory = []SchemaVersionDef{
+	// v1：初始版本
+	{
+		Version:   "v1",
+		TableName: "proxies",
+		Columns: map[string]ColumnDef{
+			"id":          {Type: "INTEGER", Primary: true},
+			"name":        {Type: "TEXT", NotNull: true},
+			"type":        {Type: "TEXT", NotNull: true, Default: "'tcp'"},
+			"local_ip":    {Type: "TEXT", NotNull: true},
+			"local_port":  {Type: "INTEGER", NotNull: true},
+			"remote_port": {Type: "INTEGER", NotNull: true},
+			"enabled":     {Type: "INTEGER", NotNull: true, Default: "1"},
+			"created_at":  {Type: "DATETIME", Default: "CURRENT_TIMESTAMP"},
+			"updated_at":  {Type: "DATETIME", Default: "CURRENT_TIMESTAMP"},
+		},
+	},
+	// v2：当前版本（frpc-console 2.0 LTS）
+	{
+		Version:   "v2",
+		TableName: "proxies",
+		Columns: map[string]ColumnDef{
+			"id":          {Type: "INTEGER", Primary: true},
+			"name":        {Type: "TEXT", NotNull: true},
+			"type":        {Type: "TEXT", NotNull: true, Default: "'tcp'"},
+			"local_ip":    {Type: "TEXT", NotNull: true},
+			"local_port":  {Type: "INTEGER", NotNull: true},
+			"remote_port": {Type: "INTEGER", NotNull: true},
+			"enabled":     {Type: "INTEGER", NotNull: true, Default: "1"},
+			"created_at":  {Type: "DATETIME", Default: "CURRENT_TIMESTAMP"},
+			"updated_at":  {Type: "DATETIME", Default: "CURRENT_TIMESTAMP"},
+		},
+	},
+}
+
+func getSchemaDef(version string) *SchemaVersionDef {
+	for _, def := range schemaHistory {
+		if def.Version == version {
+			return &def
+		}
+	}
+	return nil
+}
+
+func getLatestSchemaDef() *SchemaVersionDef {
+	if len(schemaHistory) == 0 {
+		return nil
+	}
+	return &schemaHistory[len(schemaHistory)-1]
+}
+
+func schemaVersionsEqual(v1, v2 *SchemaVersionDef) bool {
+	if v1 == nil || v2 == nil {
+		return false
+	}
+	if v1.TableName != v2.TableName {
+		return false
+	}
+	if len(v1.Columns) != len(v2.Columns) {
+		return false
+	}
+	for name, col1 := range v1.Columns {
+		col2, ok := v2.Columns[name]
+		if !ok {
+			return false
+		}
+		if col1.Type != col2.Type || col1.NotNull != col2.NotNull || col1.Default != col2.Default {
+			return false
+		}
+	}
+	return true
+}

db.go

@@ -4,15 +4,31 @@ import (
 	"crypto/rand"
 	"database/sql"
 	"encoding/hex"
+	"fmt"
+	"io"
 	"log"
+	"os"
+	"sort"
 	"strings"
+	"time"
 
 	_ "modernc.org/sqlite"
 )
 
 var DB *sql.DB
 
-// ===== 全局配置表（A表）=====
+// ============================================================
+// 数据库版本常量
+// ============================================================
+
+const (
+	SchemaVersion = "v2" // 当前数据库 Schema 版本
+)
+
+// ============================================================
+// 数据模型
+// ============================================================
+
 type GlobalConfig struct {
 	ID                int    `json:"id"`
 	ServerAddr        string `json:"serverAddr"`
@@ -25,10 +41,9 @@ type GlobalConfig struct {
 	HeartbeatInterval int    `json:"heartbeatInterval"`
 	HeartbeatTimeout  int    `json:"heartbeatTimeout"`
 	PoolCount         int    `json:"poolCount"`
-	WireProtocolV2    bool   `json:"wireProtocolV2"` // frp v2 协议开关 (v2.0 启用)
+	WireProtocolV2    bool   `json:"wireProtocolV2"`
 }
 
-// ===== 隧道表（B表）=====
 type Proxy struct {
 	ID         int    `json:"id"`
 	Name       string `json:"name"`
@@ -39,7 +54,6 @@ type Proxy struct {
 	Enabled    bool   `json:"enabled"`
 }
 
-// ===== 用户表（C表）=====
 type User struct {
 	ID           int    `json:"id"`
 	Username     string `json:"username"`
@@ -52,14 +66,41 @@ type User struct {
 // ============================================================
 
 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
 	}
 
-	// ---- 用户表 ----
-	_, err = DB.Exec(`
+	if err := createTables(); err != nil {
+		return err
+	}
+
+	if err := runMigrations(); err != nil {
+		return err
+	}
+
+	if err := ensureJwtSecret(); err != nil {
+		return err
+	}
+
+	log.Println("✅ 数据库初始化完成 (Schema " + SchemaVersion + ")")
+	return nil
+}
+
+// ============================================================
+// 建表
+// ============================================================
+
+func createTables() error {
+	// 用户表
+	_, err := DB.Exec(`
         CREATE TABLE IF NOT EXISTS users (
             id INTEGER PRIMARY KEY AUTOINCREMENT,
             username TEXT UNIQUE NOT NULL,
@@ -72,7 +113,7 @@ func InitDB() error {
 		return err
 	}
 
-	// ---- 全局配置表 ----
+	// 全局配置表
 	_, err = DB.Exec(`
         CREATE TABLE IF NOT EXISTS global_config (
             id INTEGER PRIMARY KEY CHECK (id = 1),
@@ -94,29 +135,7 @@ func InitDB() error {
 		return err
 	}
 
-	// ---- 迁移：自动补全缺失的字段 ----
-	if err := migrateGlobalConfigTable(); err != nil {
-		log.Printf("⚠️  迁移警告: %v", err)
-	}
-
-	// ---- 初始化默认配置（仅当表为空时） ----
-	var count int
-	DB.QueryRow("SELECT COUNT(*) FROM global_config").Scan(&count)
-	if count == 0 {
-		_, err = DB.Exec(`
-            INSERT INTO global_config (
-                id, server_addr, server_port, token, log_level, log_max_days,
-                tcp_mux, tcp_mux_keepalive, heartbeat_interval, heartbeat_timeout, pool_count,
-                wire_protocol_v2
-            ) VALUES (1, 'frp.example.com', 7000, 'CHANGE_ME', 'info', 3, 1, 30, 15, 70, 8, 0)
-        `)
-		if err != nil {
-			return err
-		}
-		log.Println("✅ 全局配置初始化完成")
-	}
-
-	// ---- 隧道表 ----
+	// 隧道表
 	_, err = DB.Exec(`
         CREATE TABLE IF NOT EXISTS proxies (
             id INTEGER PRIMARY KEY AUTOINCREMENT,
@@ -134,7 +153,7 @@ func InitDB() error {
 		return err
 	}
 
-	// ---- 应用配置表 ----
+	// 应用配置表
 	_, err = DB.Exec(`
         CREATE TABLE IF NOT EXISTS app_config (
             key TEXT PRIMARY KEY,
@@ -146,98 +165,287 @@ func InitDB() error {
 		return err
 	}
 
-	if err := ensureJwtSecret(); err != nil {
-		return err
+	// 初始化默认配置
+	var count int
+	DB.QueryRow("SELECT COUNT(*) FROM global_config").Scan(&count)
+	if count == 0 {
+		_, err = DB.Exec(`
+            INSERT INTO global_config (
+                id, server_addr, server_port, token, log_level, log_max_days,
+                tcp_mux, tcp_mux_keepalive, heartbeat_interval, heartbeat_timeout, pool_count,
+                wire_protocol_v2
+            ) VALUES (1, 'frp.example.com', 7000, 'CHANGE_ME', 'info', 3, 1, 30, 15, 70, 8, 0)
+        `)
+		if err != nil {
+			return err
+		}
+		log.Println("✅ 全局配置初始化完成")
 	}
 
-	log.Println("✅ 数据库初始化完成")
 	return nil
 }
 
 // ============================================================
-// Schema 迁移：自动补全缺失的字段
+// 迁移引擎
 // ============================================================
 
-// expectedColumns 定义所有期望的列，格式: 列名 => 完整定义
-// 新增字段时，在这里加一行即可
-var expectedColumns = map[string]string{
-	"id":                 "id INTEGER PRIMARY KEY CHECK (id = 1)",
-	"server_addr":        "server_addr TEXT NOT NULL DEFAULT 'frp.example.com'",
-	"server_port":        "server_port INTEGER NOT NULL DEFAULT 7000",
-	"token":              "token TEXT NOT NULL DEFAULT 'CHANGE_ME'",
-	"log_level":          "log_level TEXT NOT NULL DEFAULT 'info'",
-	"log_max_days":       "log_max_days INTEGER NOT NULL DEFAULT 3",
-	"tcp_mux":            "tcp_mux INTEGER NOT NULL DEFAULT 1",
-	"tcp_mux_keepalive":  "tcp_mux_keepalive INTEGER NOT NULL DEFAULT 30",
-	"heartbeat_interval": "heartbeat_interval INTEGER NOT NULL DEFAULT 15",
-	"heartbeat_timeout":  "heartbeat_timeout INTEGER NOT NULL DEFAULT 70",
-	"pool_count":         "pool_count INTEGER NOT NULL DEFAULT 8",
-	"wire_protocol_v2":   "wire_protocol_v2 INTEGER NOT NULL DEFAULT 0", // v1.5 新增
-	"updated_at":         "updated_at DATETIME DEFAULT CURRENT_TIMESTAMP",
-}
-
-func migrateGlobalConfigTable() error {
-	// 1. 获取当前表的列名
-	currentCols, err := getCurrentColumns("global_config")
+func getCurrentSchemaVersion() string {
+	var version string
+	err := DB.QueryRow("SELECT value FROM app_config WHERE key = 'schema_version'").Scan(&version)
 	if err != nil {
-		return err
-	}
-
-	// 2. 比对并补全缺失的列
-	var added []string
-	for colName, colDef := range expectedColumns {
-		if !contains(currentCols, colName) {
-			alterSQL := "ALTER TABLE global_config ADD COLUMN " + colDef
-			if _, err := DB.Exec(alterSQL); err != nil {
-				log.Printf("⚠️  添加列 %s 失败: %v", colName, err)
-				continue
+		if err == sql.ErrNoRows {
+			var count int
+			DB.QueryRow("SELECT COUNT(*) FROM users").Scan(&count)
+			if count > 0 {
+				return "v1"
 			}
-			added = append(added, colName)
+			return SchemaVersion
 		}
+		log.Printf("⚠️  读取 Schema 版本失败: %v", err)
+		return "v1"
+	}
+	return version
+}
+
+func setSchemaVersion(version string) error {
+	_, err := DB.Exec(`
+        INSERT INTO app_config (key, value) VALUES ('schema_version', ?)
+        ON CONFLICT(key) DO UPDATE SET value = excluded.value, updated_at = CURRENT_TIMESTAMP
+    `, version)
+	return err
+}
+
+func backupDatabase() (string, error) {
+	src := "./data/frpc-console.db"
+	if _, err := os.Stat(src); os.IsNotExist(err) {
+		return "", nil
 	}
 
-	if len(added) > 0 {
-		log.Printf("✅ 数据库迁移完成，新增字段: %v", added)
-	} else {
-		log.Println("✅ 数据库 Schema 已是最新")
+	timestamp := time.Now().Format("20060102_150405")
+	dst := fmt.Sprintf("./data/frpc-console.db.pre-%s.%s", SchemaVersion, timestamp)
+
+	srcFile, err := os.Open(src)
+	if err != nil {
+		return "", fmt.Errorf("打开源数据库失败: %w", err)
+	}
+	defer srcFile.Close()
+
+	dstFile, err := os.Create(dst)
+	if err != nil {
+		return "", fmt.Errorf("创建备份文件失败: %w", err)
+	}
+	defer dstFile.Close()
+
+	if _, err := io.Copy(dstFile, srcFile); err != nil {
+		return "", fmt.Errorf("复制数据库失败: %w", err)
 	}
 
+	log.Printf("✅ 数据库备份完成: %s", dst)
+	return dst, nil
+}
+
+func restoreDatabase(backupPath string) error {
+	srcFile, err := os.Open(backupPath)
+	if err != nil {
+		return err
+	}
+	defer srcFile.Close()
+
+	dstFile, err := os.Create("./data/frpc-console.db")
+	if err != nil {
+		return err
+	}
+	defer dstFile.Close()
+
+	if _, err := io.Copy(dstFile, srcFile); err != nil {
+		return err
+	}
+
+	log.Printf("✅ 数据库已从备份恢复: %s", backupPath)
 	return nil
 }
 
-// getCurrentColumns 查询指定表的所有列名
-func getCurrentColumns(tableName string) ([]string, error) {
-	rows, err := DB.Query("PRAGMA table_info(" + tableName + ")")
-	if err != nil {
-		return nil, err
-	}
-	defer rows.Close()
+func runMigrations() error {
+	currentVer := getCurrentSchemaVersion()
+	targetVer := SchemaVersion
 
-	var cols []string
-	for rows.Next() {
-		var (
-			cid     int
-			name    string
-			typ     string
-			notNull int
-			dfltVal sql.NullString
-			pk      int
-		)
-		if err := rows.Scan(&cid, &name, &typ, &notNull, &dfltVal, &pk); err != nil {
-			return nil, err
+	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 {
+			log.Println("  数据库为空或无效，无需迁移，直接初始化")
+			return nil
 		}
-		cols = append(cols, name)
+		log.Println("✅ Schema 已是最新，数据库有效")
+		return nil
 	}
-	return cols, rows.Err()
+
+	log.Printf("🔄 检测到版本变更 (%s → %s)，开始迁移...", currentVer, targetVer)
+
+	backupPath, err := backupDatabase()
+	if err != nil {
+		return fmt.Errorf("备份数据库失败: %w", err)
+	}
+	if backupPath != "" {
+		log.Printf("📦 备份文件: %s", backupPath)
+	}
+
+	currentSchema := getSchemaDef(currentVer)
+	targetSchema := getSchemaDef(targetVer)
+
+	if targetSchema == nil {
+		return fmt.Errorf("目标 Schema 版本 %s 未在 schemaHistory 中定义", targetVer)
+	}
+
+	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 {
+			log.Println("  数据库为空或无效，跳过迁移，直接初始化")
+			return nil
+		}
+		log.Println("  数据库有效，继续使用")
+	} else {
+		log.Println("  迁移类型: 重型迁移（Schema 有变更，新建表 + 搬数据）")
+		if err := heavyMigration(currentSchema, targetSchema); err != nil {
+			if backupPath != "" {
+				log.Printf("❌ 迁移失败，尝试恢复备份: %s", backupPath)
+				if restoreErr := restoreDatabase(backupPath); restoreErr != nil {
+					log.Printf("⚠️  恢复备份失败: %v", restoreErr)
+				}
+			}
+			return fmt.Errorf("重型迁移失败: %w", err)
+		}
+	}
+
+	if err := setSchemaVersion(targetVer); err != nil {
+		return fmt.Errorf("更新 Schema 版本失败: %w", err)
+	}
+
+	log.Printf("✅ 迁移完成，当前 Schema: %s", targetVer)
+	return nil
 }
 
-func contains(slice []string, item string) bool {
-	for _, s := range slice {
-		if strings.EqualFold(s, item) {
-			return true
+func heavyMigration(oldDef, newDef *SchemaVersionDef) error {
+	if oldDef == nil {
+		return fmt.Errorf("旧 Schema 定义为空，无法执行重型迁移")
+	}
+
+	oldTable := oldDef.TableName
+	newTable := oldTable + "_new"
+
+	createSQL := buildCreateTableSQL(newTable, newDef)
+	log.Printf("  创建新表: %s", newTable)
+	if _, err := DB.Exec(createSQL); err != nil {
+		return fmt.Errorf("创建新表失败: %w", err)
+	}
+
+	insertSQL, err := buildInsertSQL(oldTable, newTable, oldDef, newDef)
+	if err != nil {
+		return fmt.Errorf("构建数据迁移 SQL 失败: %w", err)
+	}
+	log.Printf("  迁移数据: %s → %s", oldTable, newTable)
+	if _, err := DB.Exec(insertSQL); err != nil {
+		return fmt.Errorf("数据迁移失败: %w", err)
+	}
+
+	var oldCount, newCount int
+	DB.QueryRow(fmt.Sprintf("SELECT COUNT(*) FROM %s", oldTable)).Scan(&oldCount)
+	DB.QueryRow(fmt.Sprintf("SELECT COUNT(*) FROM %s", newTable)).Scan(&newCount)
+	if oldCount != newCount {
+		return fmt.Errorf("数据迁移不完整: 旧表 %d 行，新表 %d 行", oldCount, newCount)
+	}
+	log.Printf("  数据迁移验证通过: %d 行", newCount)
+
+	tempTable := oldTable + "_old_temp"
+	if _, err := DB.Exec(fmt.Sprintf("ALTER TABLE %s RENAME TO %s", oldTable, tempTable)); err != nil {
+		return fmt.Errorf("重命名旧表失败: %w", err)
+	}
+	if _, err := DB.Exec(fmt.Sprintf("ALTER TABLE %s RENAME TO %s", newTable, oldTable)); err != nil {
+		DB.Exec(fmt.Sprintf("ALTER TABLE %s RENAME TO %s", tempTable, oldTable))
+		return fmt.Errorf("重命名新表失败: %w", err)
+	}
+	if _, err := DB.Exec(fmt.Sprintf("DROP TABLE %s", tempTable)); err != nil {
+		log.Printf("⚠️  删除临时表失败（不影响使用）: %v", err)
+	}
+
+	log.Printf("  表交换完成: %s (新表已生效)", oldTable)
+	return nil
+}
+
+func buildCreateTableSQL(tableName string, def *SchemaVersionDef) string {
+	var cols []string
+	var primaryKey string
+
+	names := make([]string, 0, len(def.Columns))
+	for name := range def.Columns {
+		names = append(names, name)
+	}
+	sort.Strings(names)
+
+	for _, name := range names {
+		col := def.Columns[name]
+		parts := []string{name, col.Type}
+		if col.NotNull {
+			parts = append(parts, "NOT NULL")
+		}
+		if col.Default != "" {
+			parts = append(parts, "DEFAULT "+col.Default)
+		}
+		if col.Primary {
+			primaryKey = "PRIMARY KEY (" + name + ")"
+		} else {
+			cols = append(cols, strings.Join(parts, " "))
 		}
 	}
-	return false
+
+	if primaryKey != "" {
+		cols = append(cols, primaryKey)
+	}
+
+	return fmt.Sprintf("CREATE TABLE %s (\n    %s\n)", tableName, strings.Join(cols, ",\n    "))
+}
+
+func buildInsertSQL(oldTable, newTable string, oldDef, newDef *SchemaVersionDef) (string, error) {
+	newCols := make([]string, 0, len(newDef.Columns))
+	for name := range newDef.Columns {
+		newCols = append(newCols, name)
+	}
+	sort.Strings(newCols)
+
+	var selectParts []string
+	var colNames []string
+
+	for _, name := range newCols {
+		colNames = append(colNames, name)
+		if _, ok := oldDef.Columns[name]; ok {
+			selectParts = append(selectParts, name)
+		} else {
+			colDef := newDef.Columns[name]
+			if colDef.Default != "" {
+				selectParts = append(selectParts, colDef.Default+" AS "+name)
+			} else if colDef.Type == "INTEGER" {
+				selectParts = append(selectParts, "0 AS "+name)
+			} else if colDef.Type == "TEXT" {
+				selectParts = append(selectParts, "'' AS "+name)
+			} else {
+				selectParts = append(selectParts, "NULL AS "+name)
+			}
+		}
+	}
+
+	return fmt.Sprintf(
+		"INSERT INTO %s (%s) SELECT %s FROM %s",
+		newTable,
+		strings.Join(colNames, ", "),
+		strings.Join(selectParts, ", "),
+		oldTable,
+	), nil
 }
 
 // ============================================================
@@ -263,7 +471,7 @@ func ensureJwtSecret() error {
 	if err != nil {
 		return err
 	}
-	log.Printf("✅ JWT 密钥已生成并保存到数据库")
+	log.Printf("✅ JWT 密钥已生成")
 	return nil
 }
 
@@ -338,10 +546,7 @@ func GetProxies() ([]Proxy, error) {
 		}
 		proxies = append(proxies, p)
 	}
-	if err = rows.Err(); err != nil {
-		return nil, err
-	}
-	return proxies, nil
+	return proxies, rows.Err()
 }
 
 func GetProxy(id int) (*Proxy, error) {

frp.go

@@ -27,10 +27,10 @@ var (
 	frpcPathMutex  sync.Mutex
 )
 
-// getFrpcPath 获取 frpc 路径，优先级：
-// 1. 当前目录 ./bin/<platform>   （便于用户手动管理 frpc 版本）
-// 2. embed 解压到 /tmp           （便于开箱即用）
-// 3. 系统 PATH 中的 frpc          （降级方案）
+// ============================================================
+// 获取 frpc 路径
+// ============================================================
+
 func getFrpcPath() (string, error) {
 	frpcPathMutex.Lock()
 	defer frpcPathMutex.Unlock()
@@ -46,14 +46,12 @@ func getFrpcPath() (string, error) {
 	switch {
 	case runtime.GOOS == "windows" && runtime.GOARCH == "amd64":
 		fileName = "frpc_windows_amd64.exe"
-	case runtime.GOOS == "windows" && runtime.GOARCH == "386":
-		fileName = "frpc_windows_386.exe"
 	case runtime.GOOS == "linux" && runtime.GOARCH == "amd64":
 		fileName = "frpc_linux_amd64"
 	case runtime.GOOS == "linux" && runtime.GOARCH == "arm64":
 		fileName = "frpc_linux_arm64"
 	case runtime.GOOS == "linux" && runtime.GOARCH == "arm":
-		fileName = "frpc_linux_armv7"
+		fileName = "frpc_linux_arm_hf"
 	default:
 		path, err := exec.LookPath("frpc")
 		if err == nil {
@@ -70,7 +68,7 @@ func getFrpcPath() (string, error) {
 		return localPath, nil
 	}
 
-	// 优先级2：embed 解压到临时目录
+	// 优先级2：embed 解压
 	data, err := embeddedFrpc.ReadFile("bin/" + fileName)
 	if err == nil {
 		tmpPath := filepath.Join(os.TempDir(), "frpc")
@@ -94,10 +92,13 @@ func getFrpcPath() (string, error) {
 		return path, nil
 	}
 
-	return "", fmt.Errorf("未找到 frpc 文件 (本地 bin/、embed、PATH 均无)")
+	return "", fmt.Errorf("未找到 frpc 文件")
 }
 
-// GenerateFrpcConfig 生成 frpc.toml
+// ============================================================
+// 生成 frpc.toml（v2.0 支持 wireProtocol）
+// ============================================================
+
 func GenerateFrpcConfig() error {
 	cfg, err := GetGlobalConfig()
 	if err != nil {
@@ -116,14 +117,24 @@ func GenerateFrpcConfig() error {
 		}
 	}
 
+	// 构建模板数据
 	data := struct {
 		*GlobalConfig
-		Proxies []Proxy
+		Proxies          []Proxy
+		WireProtocolLine string // v2 协议配置行（为空则不输出）
 	}{
 		GlobalConfig: cfg,
 		Proxies:      activeProxies,
 	}
 
+	// v2.0: 如果启用 v2 协议，生成配置行
+	if cfg.WireProtocolV2 {
+		data.WireProtocolLine = `wireProtocol = "v2"`
+	} else {
+		data.WireProtocolLine = "" // 不输出，使用默认 v1
+	}
+
+	// 读取模板
 	var tmplContent string
 	if _, err := os.Stat("frpc.tmpl"); err == nil {
 		content, readErr := os.ReadFile("frpc.tmpl")
@@ -153,7 +164,10 @@ func GenerateFrpcConfig() error {
 	return nil
 }
 
-// isFrpcRunning 通过 PID 文件检查 frpc 是否在运行
+// ============================================================
+// frpc 进程管理
+// ============================================================
+
 func isFrpcRunning() bool {
 	pidData, err := os.ReadFile("./frpc.pid")
 	if err != nil {
@@ -165,7 +179,6 @@ func isFrpcRunning() bool {
 	}
 
 	if runtime.GOOS == "windows" {
-		// Windows 用 tasklist 检查
 		cmd := exec.Command("tasklist", "/FI", "PID eq", strconv.Itoa(pid))
 		output, err := cmd.CombinedOutput()
 		if err != nil {
@@ -174,7 +187,6 @@ func isFrpcRunning() bool {
 		return strings.Contains(string(output), strconv.Itoa(pid))
 	}
 
-	// Linux/Unix: 用 kill 0 检查进程是否存在
 	process, err := os.FindProcess(pid)
 	if err != nil {
 		return false
@@ -182,7 +194,6 @@ func isFrpcRunning() bool {
 	return process.Signal(syscall.Signal(0)) == nil
 }
 
-// StartFrpc 启动 frpc（独立进程，脱离父进程）
 func StartFrpc() error {
 	frpcPath, err := getFrpcPath()
 	if err != nil {
@@ -199,16 +210,12 @@ func StartFrpc() error {
 		return nil
 	}
 
-	// 清理旧的 PID 文件
 	os.Remove("./frpc.pid")
 
 	cmd := exec.Command(frpcPath, "-c", "./frpc.toml")
 	setWindowHide(cmd)
-
-	// ✅ 设置进程属性（Unix: Setsid 脱离父进程，Windows: 不处理）
 	setSysProcAttr(cmd)
 
-	// 把输出重定向到日志文件
 	logFile, err := os.OpenFile("./frpc.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
 	if err != nil {
 		return fmt.Errorf("打开日志文件失败: %w", err)
@@ -220,7 +227,6 @@ func StartFrpc() error {
 		return fmt.Errorf("启动 frpc 失败: %w", err)
 	}
 
-	// ✅ 保存 PID 到文件
 	if err := os.WriteFile("./frpc.pid", []byte(fmt.Sprintf("%d", cmd.Process.Pid)), 0644); err != nil {
 		return fmt.Errorf("保存 PID 失败: %w", err)
 	}
@@ -228,7 +234,6 @@ func StartFrpc() error {
 	return nil
 }
 
-// StopFrpc 停止 frpc（通过 PID 文件精准杀进程）
 func StopFrpc() error {
 	if runtime.GOOS == "windows" {
 		cmd := exec.Command("taskkill", "/F", "/IM", "frpc.exe")
@@ -239,10 +244,8 @@ func StopFrpc() error {
 		return nil
 	}
 
-	// Linux: 读取 PID 文件精准杀进程
 	pidData, err := os.ReadFile("./frpc.pid")
 	if err != nil {
-		// 降级到 pkill
 		cmd := exec.Command("pkill", "-f", "frpc")
 		if err := cmd.Run(); err != nil && !strings.Contains(err.Error(), "no process") {
 			return fmt.Errorf("停止 frpc 失败: %w", err)
@@ -265,12 +268,10 @@ func StopFrpc() error {
 	return nil
 }
 
-// GetFrpcStatus 获取 frpc 运行状态（通过 PID 文件）
 func GetFrpcStatus() (bool, error) {
 	return isFrpcRunning(), nil
 }
 
-// ReloadFrpc 热加载，失败时自动降级为重启
 func ReloadFrpc() error {
 	running := isFrpcRunning()
 	if !running {

frpc.tmpl

@@ -15,6 +15,9 @@ tcpMuxKeepaliveInterval = {{.TcpMuxKeepalive}}
 heartbeatInterval = {{.HeartbeatInterval}}
 heartbeatTimeout = {{.HeartbeatTimeout}}
 poolCount = {{.PoolCount}}
+{{if .WireProtocolLine}}
+{{.WireProtocolLine}}
+{{end}}
 
 [webServer]
 addr = "127.0.0.1:7400"

install_docker.md

@@ -31,7 +31,7 @@ sudo bash deploy.sh
 
 | 步骤 | 说明 |
 |---|---|
-| 检测系统 | 自动识别 OpenSUSE / Ubuntu / Debian / CentOS / Alpine |
+| 检测系统 | 自动识别 OpenSUSE（猫猫特有的夹带私货） / Ubuntu / Debian / CentOS / Alpine |
 | 检测 CPU 架构 | 自动适配 x86_64 / ARM64 / ARMv7 |
 | 安装依赖 | git / curl / wget（如未安装） |
 | 安装 Go | 从国内镜像下载，自动配置代理 |

main.go

@@ -2,15 +2,29 @@ package main
 
 import (
 	"log"
+	"os"
 	"time"
 )
 
+// 由 build.go 通过 -ldflags 注入
+var (
+	buildVersion  = "0.0.0-dev"
+	buildImageTag = "dev"
+	buildTime     = "unknown"
+)
+
 func main() {
+	// ---- 写入 VERSION.ini 文件到持久化目录 ----
+	if err := os.WriteFile("./VERSION.ini", []byte(buildVersion+"\n"), 0644); err != nil {
+		log.Printf("⚠️  写入 VERSION.ini 文件失败: %v", err)
+	} else {
+		log.Printf("📌 版本: %s", buildVersion)
+	}
+
 	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

@@ -66,22 +66,24 @@ go build -o frpc-console .
 ## 🗂️ 项目结构
 ```txt
 frpc-console/
-├── main.go              # 入口
-├── api.go               # HTTP 路由 & Handler
-├── db.go                # SQLite 数据库操作
-├── auth.go              # JWT 认证 & 密码管理
-├── frp.go               # frpc 管理核心逻辑
-├── toml_parser.go       # TOML 解析器
-├── static/              # 前端静态资源
+├── 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      # 主界面样式
-├── bin/                 # 内嵌 frpc 二进制 (多平台)
+│   ├── 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_arm64
+│   └── frpc_linux_arm_hf
 ├── frpc.tmpl            # frpc 配置模板
 ├── Dockerfile
 └── go.mod
@@ -98,9 +100,9 @@ frpc-console/
 
 ### 数据存储
 
-· 数据库文件：./frpc-console.db
-· frpc 配置文件：./frpc.toml
-· frpc 日志文件：./frpc.log
+· 数据库文件：./frpc-console.db</br>
+· frpc 配置文件：./frpc.toml</br>
+· frpc 日志文件：./frpc.log</br>
 
 ---
 
@@ -140,7 +142,14 @@ go build -ldflags="-s -w" -o frpc-console .
 
 #### Q: frpc 启动失败怎么办？
 
-检查 frpc.toml 配置是否正确，或查看 ./frpc.log 日志文件。
+如果是首次启动，console 会自动生成一份符合官方规范的 `frps.toml` 配置文件，通常不需要额外操作。
+
+如果在使用过程中遇到启动失败，可以按以下步骤排查：
+
+1. **检查配置是否正确** —— 在「全局配置」页面重新配置一次服务端参数，或导入已有的 `frpc.toml` 配置文件，console 会自动应用并尝试重启
+2. **查看日志定位问题** —— 若上述操作后仍然失败，请查看 `./frpc.log` 日志文件，定位具体报错原因
+
+> 日志文件的位置：与 `frpc-console` 二进制同级目录下的 `frpc.log`。Docker 部署时，可通过 `docker logs frpc-console` 查看容器输出。
 
 #### Q: 支持哪些 frp 版本？
 
@@ -169,7 +178,7 @@ Podux 是个好项目，理念上和我们是一致的：用 Web 界面管理 fr
 | 部署方式 | 单二进制 / Docker | 单二进制 / Docker |
 | 多平台支持 | ✅ 原生交叉编译 | ✅ 原生交叉编译 |
 
-> Podux 与其说是一个 frp 控制面板，不如说是一个“一站式 frp 管理器 + 可视化数据流面板 + 通道保活监测工具”。这种一站式本身没毛病，甚至功能实现非常到位。</br>但 podux的框架选型有点重，而且很明显细节稍显仓促。PocketBase 自带 WebUI 的情况下，Podux 还要再包一层 WebUI——相当于给数据库的 UI 又套了个 UI。更费解的是，这层 WebUI 只支持导入，不支持导出。这设计确实让人有点摸不着头脑。</br>这也正是我们选择 SQLite + Vue CDN 的原因。
+> Podux 与其说是一个 frp 控制面板，不如说是一个“一站式 frp 管理器 + 可视化数据流面板 + 通道保活监测工具”。这种一站式本身没毛病，甚至功能实现非常到位。</br>但 podux的框架选型有点重，而且很明显细节稍显仓促。PocketBase 自带 WebUI 的情况下，Podux 还要再包一层 WebUI——相当于给数据库的 UI 又套了个 UI。更费解的是，这层 WebUI 只支持导入，不支持导出。这设计确实让人有点摸不着头脑啦……</br>所以干脆换了一套轻量化工具自己上咯~
 
 
 ### Q: 为什么不直接用 frp 官方提供的 web 界面？
@@ -182,6 +191,53 @@ 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，我们会评估是否加入。
@@ -196,28 +252,62 @@ frpc-console 遵循 **“够用就好”** 的原则：
 2. **能用 SQLite 就不用 PostgreSQL，能用 Vue CDN 就不用 React 全家桶。**
 3. **前端能做的事，后端不加额外复杂度。**
 4. **删掉一个容器等于删掉所有垃圾，所以用 Docker 隔离是对的。**
+5. **面板的存在应该是为了服务业务的，而不该是反过来主导业务的。**
 
 ---
 
 ## 📝 更新日志
 
-### 1.0-Release (2026-07-24)
+### 2.0-Release（LTS，跟随上游提供支持，frps 端现已正式发布，frpc 端测试中，敬请期待……）
 
-· 🎉 首次发布</br>
-· ✨ 支持隧道增删改查</br>
-· ✨ 支持 TOML 导入/导出</br>
-· ✨ 首次启动 Web 注册</br>
-· ✨ 深色磨砂玻璃 UI</br>
-· ✨ 多平台 frpc 自动适配</br>
-· 🐳 Docker 镜像支持
+> 本次 LTS 版本聚焦于**稳定性兜底与协议能力对齐**，是 frp 0.70.0 LTS 的下游管理工具。
 
-### 2.0-Release (正在修整，后续开发)
+· 🚀 **frp v2 协议正式启用** —— `wireProtocol = "v2"` 配置项可用，灰标状态解除，实测稳定</br>
+· 🔒 **数据库迁移引擎完整实现** —— 版本驱动的增量迁移 + 迁移前自动全量备份 + 失败可回滚，升级不再提心吊胆</br>
+· 🧩 **配套工具 frps-console 同步发布** —— 同一套设计哲学，一个管理 frpc，一个管理 frps，版本号同步，LTS 同步
+
+
+### 1.5-Release (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-Release (2026-07-24)（non-LTS）
+
+> 首次发布，核心功能全部就绪。
+
+· 🎉 **首次发布**</br>
+· 📋 **隧道全生命周期管理** —— 增删改查 + 一键启用/禁用</br>
+· 📦 **TOML 导入/导出** —— 无缝迁移现有 frpc 配置</br>
+· 🔄 **配置热加载** —— 修改即生效，无需重启 frpc</br>
+· 🔐 **首次启动 Web 注册** —— 无需命令行交互</br>
+· 🖥️ **多平台支持** —— Windows / Linux / ARM 全平台兼容</br>
+· 🐳 **容器化就绪** —— Docker 镜像，开箱即用</br>
+· 🎨 **深色磨砂玻璃 UI** —— 现代化视觉体验</br>
 
 ---
 
 ## 📄 许可证
 
-MIT License © 2026 lxh2875931338
+MIT License © 2026 lxh2875931338（XHLiang0）
+
+---
+
+## 🙏 相关项目援引
+
+### FRP 生态互补工具
+
+· [MoonProxy](https://github.com/MoonProxyHQ/moonproxy-desktop) —— 基于 Tauri v2 + Vue 3 + Rust 构建的跨平台 FRP 桌面客户端（frpc GUI），面向 macOS 与 Windows，让内网穿透开箱即用，MIT协议开源。
+
+### FRP 生态同类工具（暂无互引）
+</br>
 
 ---
 

script/build.go

@@ -9,6 +9,7 @@ import (
 	"os/exec"
 	"path/filepath"
 	"strings"
+	"time"
 )
 
 type Platform struct {
@@ -20,18 +21,101 @@ type Platform struct {
 
 var platforms = []Platform{
 	{"windows", "amd64", "Windows x86-64", ".exe"},
-	{"windows", "386", "Windows x86", ".exe"},
 	{"linux", "amd64", "Linux x86-64", ""},
 	{"linux", "arm64", "Linux ARM64", ""},
-	{"linux", "armv7", "Linux ARMv7l", ""},
+	{"linux", "arm", "Linux ARMv7l", ""},
 }
 
 const (
-	Version   = "1.0.0"
-	BuildTime = "2026-07-24"
+	BuildTime = "2026-07-29"
 	Binary    = "frpc-console"
 )
 
+// ============================================================
+// 版本管理核心
+// ============================================================
+
+// readVersion 读取仓库根目录的 VERSION.ini 文件
+// Preview 格式: "2.4"
+// LTS 格式: "2.5 20260729"
+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
+}
+
+// getVersionType 判断版本类型
+// 规则: X.0 或 X.5 → LTS，其他 → Preview
+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"
+}
+
+// getFullVersion 生成完整版本字符串
+// LTS (X.0/X.5): {semver}-lts-{ltsDate}  (必须有日期)
+// Preview (其他): {semver}-preview-{buildTimestamp}
+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
+	}
+}
+
+// getImageTag 生成镜像标签
+// LTS: {semver}-lts-{ltsDate}
+// Preview: preview-{buildTimestamp}
+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]
@@ -45,6 +129,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 {
@@ -53,13 +143,17 @@ func main() {
 			}
 		}
 		fmt.Println("❌ 不支持的平台:", target)
-		fmt.Println("   可用: windows/amd64, windows/386, 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()
 }
 
+// ============================================================
+// 构建函数
+// ============================================================
+
 func listPlatforms() {
 	fmt.Println("可用平台:")
 	for i, p := range platforms {
@@ -69,15 +163,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()
 
@@ -97,6 +195,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) {
@@ -126,12 +228,22 @@ func build(p Platform, silent bool) {
 		return
 	}
 
-	outName := Binary + "-" + p.OS + "-" + p.Arch + p.Ext
+	fullVersion := getFullVersion()
+	imageTag := getImageTag()
+
+	outName := Binary + "-" + p.OS + "-" + p.Arch
+	if p.Arch == "arm" {
+		outName += "v7"
+	}
+	outName += p.Ext
 	outPath := filepath.Join(outDir, outName)
 
-	// 用 "go" 而不是硬编码路径，让系统去 PATH 里找
 	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,
 		".",
 	)
@@ -140,6 +252,11 @@ func build(p Platform, silent bool) {
 		"GOARCH="+p.Arch,
 		"CGO_ENABLED=0",
 	)
+
+	if p.Arch == "arm" {
+		cmd.Env = append(cmd.Env, "GOARM=7")
+	}
+
 	cmd.Stdout = os.Stdout
 	cmd.Stderr = os.Stderr
 
@@ -150,6 +267,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/app.js

@@ -28,6 +28,13 @@ async function apiFetch(endpoint, options = {}) {
         ...options,
         headers: { ...headers, ...(options.headers || {}) },
     });
+
+    if (res.status === 401) {
+        clearAuthState();
+        window.dispatchEvent(new CustomEvent("auth:expired"));
+        return { code: 401, msg: "认证已过期，请重新登录" };
+    }
+
     return res.json();
 }
 
@@ -163,7 +170,7 @@ function filterProxies(list, keyword) {
         (p) =>
             p.name.toLowerCase().includes(kw) ||
             p.localIP.includes(kw) ||
-            String(p.remotePort).includes(kw)
+            String(p.remotePort).includes(kw),
     );
 }
 
@@ -189,7 +196,11 @@ async function fetchLogsApi() {
     try {
         const data = await apiFetch("/frpc/log");
         if (data.code === 0) {
-            return { lines: data.data.lines || [], total: data.data.total || 0, error: data.data.error || "" };
+            return {
+                lines: data.data.lines || [],
+                total: data.data.total || 0,
+                error: data.data.error || "",
+            };
         }
         return { lines: [], total: 0, error: "加载失败" };
     } catch (e) {
@@ -286,8 +297,83 @@ const app = createApp({
         let logTimer = null;
         let logFetching = false;
 
+        // ---- Ping 延迟检测 ----
+        const pingLatency = ref(null);
+        let pingTimer = null;
+        const PING_INTERVAL_MS = 30000;
+        const PING_TIMEOUT_MS = 5000;
+
+        const pingStatusClass = computed(() => {
+            if (pingLatency.value === null) return "ping-fail";
+            if (pingLatency.value < 1000) return "ping-good";
+            if (pingLatency.value < 5000) return "ping-slow";
+            return "ping-fail";
+        });
+
+        const pingIcon = computed(() => {
+            if (pingLatency.value === null) {
+                return `<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 256 256">
+                    <path d="M0 0h256v256H0z" fill="none"/>
+                    <g fill="currentColor">
+                        <path d="m224.39 104.34-90.24 108.78a8 8 0 0 1-12.3 0L17.8 87.69a7.79 7.79 0 0 1 1.31-11.21A179.58 179.58 0 0 1 128 40a182 182 0 0 1 33.06 3a7.94 7.94 0 0 1 4.17 2.21L224 104Z" opacity=".2"/>
+                        <path d="M229.66 98.34a8 8 0 0 1-11.32 11.32L200 91.31l-18.34 18.35a8 8 0 0 1-11.32-11.32L188.69 80l-18.35-18.34a8 8 0 0 1 11.32-11.32L200 68.69l18.34-18.35a8 8 0 0 1 11.32 11.32L211.31 80Zm-33.06 39.5a8 8 0 0 0-11.27 1L128 208L24.09 82.74A170.76 170.76 0 0 1 128 48c2.54 0 5.11.06 7.65.17a8 8 0 0 0 .7-16c-2.77-.12-5.58-.18-8.35-.18A186.67 186.67 0 0 0 14.28 70.1a15.93 15.93 0 0 0-6.17 10.81a15.65 15.65 0 0 0 3.54 11.89l104 125.43A15.93 15.93 0 0 0 128 224a15.93 15.93 0 0 0 12.31-5.77l57.34-69.12a8 8 0 0 0-1.05-11.27"/>
+                    </g>
+                </svg>`;
+            }
+            if (pingLatency.value < 1000) {
+                return `<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 25 24">
+                    <path d="M0 0h25v24H0z" fill="none"/>
+                    <path fill="currentColor" d="M2.046 6.725c6.192-4.967 15.05-4.967 21.243 0l.779.625l-11.4 14.25L1.265 7.35z"/>
+                </svg>`;
+            }
+            return `<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24">
+                <path d="M0 0h24v24H0z" fill="none"/>
+                <path fill="none" stroke="currentColor" stroke-width="2" d="M21.996 7.505L12 20L2.004 7.505c5.827-4.673 14.165-4.673 19.992 0Z"/>
+            </svg>`;
+        });
+
+        async function doPing() {
+            if (!frpcRunning.value) {
+                pingLatency.value = null;
+                return;
+            }
+            const addr = globalConfig.serverAddr || "frp.example.com";
+            const start = performance.now();
+            try {
+                const res = await fetch(
+                    `/api/ping?target=${encodeURIComponent(addr)}`,
+                    { signal: AbortSignal.timeout(PING_TIMEOUT_MS) },
+                );
+                if (!res.ok) throw new Error("Ping failed");
+                const end = performance.now();
+                pingLatency.value = Math.round(end - start);
+            } catch {
+                pingLatency.value = null;
+            }
+        }
+
+        function startPingPolling() {
+            if (pingTimer) return;
+            doPing();
+            pingTimer = setInterval(doPing, PING_INTERVAL_MS);
+        }
+
+        function stopPingPolling() {
+            if (pingTimer) {
+                clearInterval(pingTimer);
+                pingTimer = null;
+            }
+        }
+
+        // ---- 认证过期处理 ----
+        const handleAuthExpired = () => {
+            doLogout();
+        };
+
         // ---- 初始化 ----
         onMounted(() => {
+            window.addEventListener("auth:expired", handleAuthExpired);
+
             const saved = loadAuthState();
             if (saved.valid) {
                 token.value = saved.token;
@@ -312,6 +398,15 @@ const app = createApp({
             }
         });
 
+        watch(frpcRunning, (running) => {
+            if (!running) {
+                stopPingPolling();
+                pingLatency.value = null;
+            } else if (loggedIn.value) {
+                startPingPolling();
+            }
+        });
+
         async function checkUsers() {
             try {
                 const res = await fetch("/api/check/users");
@@ -351,6 +446,10 @@ const app = createApp({
             logFetching = true;
             try {
                 const result = await fetchLogsApi();
+                if (result.code === 401) {
+                    logFetching = false;
+                    return;
+                }
                 logLines.value = result.lines;
                 logTotal.value = result.total;
                 logError.value = result.error;
@@ -478,6 +577,7 @@ const app = createApp({
         const doLogout = () => {
             if (expireTimer) clearInterval(expireTimer);
             stopLogPolling();
+            stopPingPolling();
             contentVisible.value = false;
             loggedIn.value = false;
             token.value = "";
@@ -637,11 +737,10 @@ const app = createApp({
 
         // ---- 计算属性 ----
         const filteredProxies = computed(() =>
-            filterProxies(proxies.value, searchKeyword.value)
+            filterProxies(proxies.value, searchKeyword.value),
         );
 
         const showDefaultTip = computed(() => {
-            // 如果 serverAddr 还是默认值，或者为空，显示警告
             const addr = globalConfig.serverAddr;
             return !addr || addr === "frp.example.com" || addr.trim() === "";
         });
@@ -694,7 +793,6 @@ const app = createApp({
 
             showDefaultTip,
 
-            // 日志相关
             logLines,
             logTotal,
             logError,
@@ -703,8 +801,11 @@ const app = createApp({
             refreshLogs,
             scrollLogToBottom,
 
-            // Token 显示切换
             showToken,
+
+            pingLatency,
+            pingStatusClass,
+            pingIcon,
         };
     },
 });

static/index.html

@@ -97,11 +97,15 @@
                             <span class="status-wrapper">
                                 <span class="status-dot" :class="{ active: frpcRunning }"></span>
                                 <span class="status-text">{{ frpcRunning ? 'frpc 运行中' : 'frpc 已停止' }}</span>
+                                <!-- 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>
                             </span>
                         </div>
                     </div>
                     <div class="top-right">
-                        <span class="user-name">{{ loginForm.username }}</span>
                         <button class="logout-btn" @click="doLogout">退出</button>
                     </div>
                 </div>
@@ -114,6 +118,8 @@
                         @click="activeTab = 'config'">全局配置信息</span>
                     <span class="tab-item" :class="{ active: activeTab === 'logs' }"
                         @click="activeTab = 'logs'">运行日志</span>
+                    <span class="tab-item" :class="{ active: activeTab === 'user' }"
+                        @click="activeTab = 'user'">用户配置：{{loginForm.username }}</span>
                 </div>
 
                 <!-- 内容区 -->
@@ -159,48 +165,18 @@
                         </div>
                     </div>
 
-                    <!-- ====== 全局配置信息 ====== -->
                     <!-- ====== 全局配置信息 ====== -->
                     <div v-if="activeTab === 'config'" class="tab-content config-tab-content">
-                        <!-- 页面标题 -->
                         <div class="config-page-header">
                             <h2>全局配置信息</h2>
                             <p class="config-subtitle">管理 frpc 连接参数与传输设置</p>
                         </div>
 
-                        <!-- 首次使用提示 -->
                         <div v-if="showDefaultTip" class="config-tip">
                             首次使用请修改「服务器地址」和「认证令牌」为您的真实 frps 配置
                         </div>
 
-                        <!-- ===== 账户管理 ===== -->
-                        <div class="profile-section">
-                            <div class="profile-header">
-                                <span>账户管理</span>
-                                <span class="profile-username">{{ loginForm.username }}</span>
-                            </div>
-                            <div class="profile-form">
-                                <div class="form-row">
-                                    <label>当前密码</label>
-                                    <input v-model="passwordChange.oldPassword" type="password" placeholder="输入当前密码" />
-                                </div>
-                                <div class="form-row">
-                                    <label>新密码</label>
-                                    <input v-model="passwordChange.newPassword" type="password"
-                                        placeholder="至少8位，含大小写/数字/特殊字符" />
-                                </div>
-                                <div class="form-row">
-                                    <label>确认新密码</label>
-                                    <input v-model="passwordChange.confirmPassword" type="password"
-                                        placeholder="再次输入新密码" />
-                                </div>
-                                <button class="save-btn" @click="changePassword">修改密码</button>
-                                <p v-if="passwordChangeError" class="login-error">{{ passwordChangeError }}</p>
-                                <p v-if="passwordChangeSuccess" class="login-success">{{ passwordChangeSuccess }}</p>
-                            </div>
-                        </div>
-
-                        <!-- ===== 卡片1: 服务器连接 ===== -->
+                        <!-- 卡片1: 服务器连接 -->
                         <div class="config-card">
                             <div class="config-card-header">
                                 <span class="card-title">服务器连接</span>
@@ -227,13 +203,12 @@
                             </div>
                         </div>
 
-                        <!-- ===== 卡片2: 传输配置 ===== -->
+                        <!-- 卡片2: 传输配置 -->
                         <div class="config-card">
                             <div class="config-card-header">
                                 <span class="card-title">传输配置</span>
                             </div>
                             <div class="config-card-body">
-                                <!-- TCP 多路复用（只读，占满一行） -->
                                 <div class="form-row" style="grid-column: 1 / -1;">
                                     <label>TCP 多路复用</label>
                                     <div class="readonly-value">
@@ -242,44 +217,38 @@
                                         <span class="hint-text">优化连接性能，减少延迟，frp 官方推荐开启</span>
                                     </div>
                                 </div>
-                                <!-- 保活间隔 -->
                                 <div class="form-row">
                                     <label>保活间隔（秒）</label>
                                     <input type="number" v-model="globalConfig.tcpMuxKeepalive" />
                                 </div>
-                                <!-- 心跳间隔 -->
                                 <div class="form-row">
                                     <label>心跳间隔（秒）</label>
                                     <input type="number" v-model="globalConfig.heartbeatInterval" />
                                 </div>
-                                <!-- 心跳超时 -->
                                 <div class="form-row">
                                     <label>心跳超时（秒）</label>
                                     <input type="number" v-model="globalConfig.heartbeatTimeout" />
                                 </div>
-                                <!-- 连接池大小 -->
                                 <div class="form-row">
                                     <label>连接池大小（个）</label>
                                     <input type="number" v-model="globalConfig.poolCount" />
                                 </div>
-                                <!-- v2 协议开关（v1.5 灰标禁用） -->
                                 <div class="form-row v2-switch-row">
                                     <label>frp v2 隧道支持</label>
                                     <div class="v2-switch-wrapper">
-                                        <label class="switch disabled">
-                                            <input type="checkbox" v-model="globalConfig.wireProtocolV2" disabled />
+                                        <label class="switch">
+                                            <input type="checkbox" v-model="globalConfig.wireProtocolV2" />
                                             <span class="slider"></span>
                                         </label>
-                                        <span class="v2-badge">即将推出</span>
                                     </div>
                                     <span class="hint-text v2-hint">
-                                        此功能为 frp 0.70.0 以上版本才能开启，若要打开必须搭配同版本 frps 使用，否则此功能不生效
+                                        此功能为 frp 0.70.0 以上版本才能开启，若要打开必须搭配同版本 frpc 使用，否则此功能不生效
                                     </span>
                                 </div>
                             </div>
                         </div>
 
-                        <!-- ===== 卡片3: 日志配置 ===== -->
+                        <!-- 卡片3: 日志配置 -->
                         <div class="config-card">
                             <div class="config-card-header">
                                 <span class="card-title">日志配置</span>
@@ -302,12 +271,11 @@
                             </div>
                         </div>
 
-                        <!-- 保存按钮 -->
                         <button class="save-config-btn" @click="saveConfig">保存配置并热加载</button>
                     </div>
+
                     <!-- ====== 运行日志 ====== -->
                     <div v-else-if="activeTab === 'logs'" class="tab-content log-tab-content">
-                        <!-- 工具栏 -->
                         <div class="log-toolbar">
                             <div class="log-toolbar-left">
                                 <span class="log-info-badge">共 {{ logTotal }} 行</span>
@@ -323,7 +291,6 @@
                             </div>
                         </div>
 
-                        <!-- 日志显示区域 -->
                         <div class="log-terminal" id="logContainer">
                             <div v-if="logLines.length === 0 && !logError" class="log-empty">
                                 暂无日志，frpc 尚未产生输出
@@ -333,50 +300,85 @@
                             </div>
                         </div>
 
-                        <!-- 底部状态 -->
                         <div class="log-footer">
                             <span>上次更新: {{ logLastUpdate || '--:--:--' }}</span>
                             <span class="log-polling-status">自动刷新中 (8s)</span>
                         </div>
                     </div>
 
-                </div>
-            </div>
-        </div>
+                    <!-- ====== 用户配置 ====== -->
+                    <div v-if="activeTab === 'user'" class="tab-content config-tab-content">
+                        <div class="config-page-header">
+                            <h2>用户配置：{{ loginForm.username }}</h2>
+                            <p class="config-subtitle">修改当前账户的登录密码</p>
+                        </div>
 
-        <!-- ====== 弹窗 ====== -->
-        <Transition name="dialog">
-            <div v-if="dialogVisible" class="dialog-overlay" @click.self="dialogVisible = false">
-                <div class="dialog-card">
-                    <h3>{{ dialogMode === 'add' ? '新增隧道' : '编辑隧道' }}</h3>
-                    <div class="dialog-form">
-                        <div class="form-row"><label>名称</label><input v-model="dialogForm.name" /></div>
-                        <div class="form-row">
-                            <label>类型</label>
-                            <select v-model="dialogForm.type">
-                                <option value="tcp">tcp</option>
-                                <option value="udp">udp</option>
-                                <option value="http">http</option>
-                                <option value="https">https</option>
-                            </select>
-                        </div>
-                        <div class="form-row"><label>本地 IP</label><input v-model="dialogForm.localIP" /></div>
-                        <div class="form-row"><label>本地端口</label><input type="number" v-model="dialogForm.localPort" />
-                        </div>
-                        <div class="form-row"><label>远程端口</label><input type="number" v-model="dialogForm.remotePort" />
+                        <div class="profile-section">
+                            <div class="profile-header">
+                                <span>账户管理</span>
+                                <span class="profile-username">{{ loginForm.username }}</span>
+                            </div>
+                            <div class="profile-form">
+                                <div class="form-row">
+                                    <label>当前密码</label>
+                                    <input v-model="passwordChange.oldPassword" type="password" placeholder="输入当前密码" />
+                                </div>
+                                <div class="form-row">
+                                    <label>新密码</label>
+                                    <input v-model="passwordChange.newPassword" type="password"
+                                        placeholder="至少8位，含大小写/数字/特殊字符" />
+                                </div>
+                                <div class="form-row">
+                                    <label>确认新密码</label>
+                                    <input v-model="passwordChange.confirmPassword" type="password"
+                                        placeholder="再次输入新密码" />
+                                </div>
+                                <button class="save-btn" @click="changePassword">修改密码</button>
+                                <p v-if="passwordChangeError" class="login-error">{{ passwordChangeError }}</p>
+                                <p v-if="passwordChangeSuccess" class="login-success">{{ passwordChangeSuccess }}</p>
+                            </div>
                         </div>
                     </div>
-                    <div class="dialog-actions">
-                        <button class="btn-cancel" @click="dialogVisible = false">取消</button>
-                        <button class="btn-confirm" @click="confirmDialog">确认</button>
+
+                </div> <!-- /content-area -->
+
+                <!-- ====== 弹窗 ====== -->
+                <Transition name="dialog">
+                    <div v-if="dialogVisible" class="dialog-overlay" @click.self="dialogVisible = false">
+                        <div class="dialog-card">
+                            <h3>{{ dialogMode === 'add' ? '新增隧道' : '编辑隧道' }}</h3>
+                            <div class="dialog-form">
+                                <div class="form-row"><label>名称</label><input v-model="dialogForm.name" /></div>
+                                <div class="form-row">
+                                    <label>类型</label>
+                                    <select v-model="dialogForm.type">
+                                        <option value="tcp">tcp</option>
+                                        <option value="udp">udp</option>
+                                        <option value="http">http</option>
+                                        <option value="https">https</option>
+                                    </select>
+                                </div>
+                                <div class="form-row"><label>本地 IP</label><input v-model="dialogForm.localIP" /></div>
+                                <div class="form-row"><label>本地端口</label><input type="number" v-model="dialogForm.localPort" />
+                                </div>
+                                <div class="form-row"><label>远程端口</label><input type="number" v-model="dialogForm.remotePort" />
+                                </div>
+                            </div>
+                            <div class="dialog-actions">
+                                <button class="btn-cancel" @click="dialogVisible = false">取消</button>
+                                <button class="btn-confirm" @click="confirmDialog">确认</button>
+                            </div>
+                        </div>
                     </div>
-                </div>
-            </div>
-        </Transition>
+                </Transition>
+
+            </div> <!-- /main-panel -->
+        </div> <!-- /app-container -->
 
         <!-- 隐藏文件选择器 -->
         <input type="file" id="tomlFileInput" accept=".toml" style="display:none" @change="handleImport" />
-    </div>
+
+    </div> <!-- /#app -->
 
     <script src="/static/app.js"></script>
 </body>

static/style-3.css

@@ -735,3 +735,69 @@ select:disabled {
         padding: 20px;
     }
 }
+
+/* ---------- Ping 延迟显示 ---------- */
+.status-wrapper {
+    display: flex;
+    align-items: center;
+    gap: 12px;
+}
+
+.ping-display {
+    display: inline-flex;
+    align-items: center;
+    gap: 4px;
+    font-size: 12px;
+    font-weight: 500;
+    padding: 2px 8px 2px 4px;
+    border-radius: 12px;
+    background: rgba(255, 255, 255, 0.04);
+    transition: background 0.3s;
+}
+
+.ping-display .ping-icon {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 16px;
+    height: 16px;
+}
+
+.ping-display .ping-icon svg {
+    width: 100%;
+    height: 100%;
+}
+
+/* 状态颜色 */
+.ping-good .ping-icon {
+    color: #63e2b7;
+}
+.ping-good .ping-value {
+    color: #63e2b7;
+}
+
+.ping-slow .ping-icon {
+    color: #f0c040;
+}
+.ping-slow .ping-value {
+    color: #f0c040;
+}
+
+.ping-fail .ping-icon {
+    color: #f87171;
+}
+.ping-fail .ping-value {
+    color: #f87171;
+}
+
+/* 响应式调整 */
+@media (max-width: 768px) {
+    .ping-display {
+        font-size: 11px;
+        padding: 1px 6px 1px 2px;
+    }
+    .ping-display .ping-icon {
+        width: 14px;
+        height: 14px;
+    }
+}

static/style-4.css

@@ -155,21 +155,6 @@
     padding: 6px 0;
 }
 
-/* 禁用状态开关 - 灰标 */
-.switch.disabled {
-    opacity: 0.4;
-    cursor: not-allowed;
-    pointer-events: none;
-}
-.switch.disabled .slider {
-    background: rgba(255, 255, 255, 0.08);
-}
-.switch.disabled input:checked + .slider {
-    background: rgba(74, 124, 255, 0.25);
-}
-.switch.disabled .slider::before {
-    background: #3a3a4a;
-}
 
 /* "即将推出" 徽章 */
 .v2-badge {
@@ -183,6 +168,12 @@
     font-weight: 500;
 }
 
+.v2-badge.v2-enabled {
+    background: rgba(99, 226, 183, 0.12);
+    border-color: rgba(99, 226, 183, 0.2);
+    color: #63e2b7;
+}
+
 .v2-hint {
     font-size: 12px;
     color: var(--text-dim);

version.ini

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