2.0前的最后几个版本推送

readme措辞调整

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

db.go

@@ -4,15 +4,31 @@ import (
 	"crypto/rand"
 	"database/sql"
 	"encoding/hex"
+	"fmt"
+	"io"
 	"log"
+	"os"
 	"strings"
+	"time"
 
 	_ "modernc.org/sqlite"
 )
 
 var DB *sql.DB
 
-// ===== 全局配置表（A表）=====
+// ============================================================
+// 数据库版本常量
+// ============================================================
+
+const (
+	SchemaVersion = "2.0.0" // 当前数据库 Schema 版本，与项目版本同步
+)
+
+// ============================================================
+// 数据模型
+// ============================================================
+
+// GlobalConfig 全局配置表
 type GlobalConfig struct {
 	ID                int    `json:"id"`
 	ServerAddr        string `json:"serverAddr"`
@@ -25,10 +41,10 @@ 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"` // v2.0 正式启用
 }
 
-// ===== 隧道表（B表）=====
+// Proxy 隧道表
 type Proxy struct {
 	ID         int    `json:"id"`
 	Name       string `json:"name"`
@@ -39,7 +55,7 @@ type Proxy struct {
 	Enabled    bool   `json:"enabled"`
 }
 
-// ===== 用户表（C表）=====
+// User 用户表
 type User struct {
 	ID           int    `json:"id"`
 	Username     string `json:"username"`
@@ -58,8 +74,32 @@ func InitDB() error {
 		return err
 	}
 
-	// ---- 用户表 ----
-	_, err = DB.Exec(`
+	// ---- 创建所有表 ----
+	if err := createTables(); err != nil {
+		return err
+	}
+
+	// ---- 执行版本迁移 ----
+	if err := runMigrations(); err != nil {
+		return err
+	}
+
+	// ---- 确保 JWT 密钥存在 ----
+	if err := ensureJwtSecret(); err != nil {
+		return err
+	}
+
+	log.Println("✅ 数据库初始化完成 (Schema v" + 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 +112,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 +134,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 +152,7 @@ func InitDB() error {
 		return err
 	}
 
-	// ---- 应用配置表 ----
+	// 应用配置表（存储 JWT 密钥、Schema 版本等）
 	_, err = DB.Exec(`
         CREATE TABLE IF NOT EXISTS app_config (
             key TEXT PRIMARY KEY,
@@ -146,66 +164,214 @@ 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",
+// getSchemaVersion 读取当前数据库的 Schema 版本
+func getSchemaVersion() string {
+	var version string
+	err := DB.QueryRow("SELECT value FROM app_config WHERE key = 'schema_version'").Scan(&version)
+	if err != nil {
+		if err == sql.ErrNoRows {
+			// 没有版本记录 → 首次启动或 v1.x 升级
+			// 检查是否已有数据（通过 users 表判断）
+			var count int
+			DB.QueryRow("SELECT COUNT(*) FROM users").Scan(&count)
+			if count > 0 {
+				// 有用户数据 → 这是 v1.x 升级，标记为 1.5
+				return "1.5.0"
+			}
+			// 全新安装 → 直接标记为当前版本
+			return SchemaVersion
+		}
+		log.Printf("⚠️  读取 Schema 版本失败: %v", err)
+		return "1.5.0" // 保守降级
+	}
+	return version
 }
 
-func migrateGlobalConfigTable() error {
-	// 1. 获取当前表的列名
-	currentCols, err := getCurrentColumns("global_config")
-	if err != nil {
-		return err
+// setSchemaVersion 更新 Schema 版本
+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
+}
+
+// backupDatabase 备份数据库文件
+func backupDatabase() (string, error) {
+	src := "./frpc-console.db"
+	if _, err := os.Stat(src); os.IsNotExist(err) {
+		return "", nil // 数据库不存在，无需备份
 	}
 
-	// 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
+	timestamp := time.Now().Format("20060102_150405")
+	dst := fmt.Sprintf("./frpc-console.db.pre-v%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
+}
+
+// runMigrations 执行版本迁移
+func runMigrations() error {
+	currentVersion := getSchemaVersion()
+	log.Printf("📌 当前数据库 Schema: %s, 目标版本: %s", currentVersion, SchemaVersion)
+
+	if currentVersion == SchemaVersion {
+		log.Println("✅ Schema 已是最新，无需迁移")
+		return nil
+	}
+
+	log.Printf("🔄 检测到版本变更 (%s → %s)，开始迁移...", currentVersion, SchemaVersion)
+
+	// ---- 1. 备份数据库 ----
+	backupPath, err := backupDatabase()
+	if err != nil {
+		return fmt.Errorf("备份数据库失败: %w", err)
+	}
+	if backupPath != "" {
+		log.Printf("📦 备份文件: %s", backupPath)
+	} else {
+		log.Println("📦 数据库为空，跳过备份")
+	}
+
+	// ---- 2. 执行迁移 ----
+	// 按照版本号逐个升级
+	migrations := []struct {
+		from    string
+		upgrade func() error
+	}{
+		{"1.5.0", migrateFrom1_5_0},
+		{"2.0.0", migrateFrom2_0_0}, // 预留，实际无操作
+	}
+
+	applied := 0
+	for _, m := range migrations {
+		if currentVersion == m.from {
+			log.Printf("  执行迁移: %s → %s", m.from, SchemaVersion)
+			if err := m.upgrade(); err != nil {
+				// 迁移失败，尝试恢复备份
+				if backupPath != "" {
+					log.Printf("❌ 迁移失败，尝试恢复备份: %s", backupPath)
+					if restoreErr := restoreDatabase(backupPath); restoreErr != nil {
+						log.Printf("⚠️  恢复备份失败: %v", restoreErr)
+					}
+				}
+				return fmt.Errorf("迁移失败: %w", err)
 			}
-			added = append(added, colName)
+			applied++
+			currentVersion = SchemaVersion
+			break
 		}
 	}
 
-	if len(added) > 0 {
-		log.Printf("✅ 数据库迁移完成，新增字段: %v", added)
-	} else {
-		log.Println("✅ 数据库 Schema 已是最新")
+	// ---- 3. 更新 Schema 版本 ----
+	if err := setSchemaVersion(SchemaVersion); err != nil {
+		return fmt.Errorf("更新 Schema 版本失败: %w", err)
 	}
 
+	log.Printf("✅ 迁移完成，应用了 %d 个迁移", applied)
 	return nil
 }
 
-// getCurrentColumns 查询指定表的所有列名
+// restoreDatabase 从备份恢复数据库
+func restoreDatabase(backupPath string) error {
+	srcFile, err := os.Open(backupPath)
+	if err != nil {
+		return err
+	}
+	defer srcFile.Close()
+
+	dstFile, err := os.Create("./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
+}
+
+// ============================================================
+// 迁移函数（各版本）
+// ============================================================
+
+// migrateFrom1_5_0: v1.5 → v2.0
+// v1.5 已经有 wire_protocol_v2 字段（灰标占位），v2.0 无需新增字段
+// 但需要确保字段存在（兼容从 v1.0 直接升级的场景）
+func migrateFrom1_5_0() error {
+	log.Println("  迁移: v1.5.0 → v2.0.0")
+
+	// 检查并补全 wire_protocol_v2 字段（兼容从 v1.0 直接升级的场景）
+	cols, err := getCurrentColumns("global_config")
+	if err != nil {
+		return fmt.Errorf("获取列信息失败: %w", err)
+	}
+
+	if !contains(cols, "wire_protocol_v2") {
+		log.Println("  添加字段: wire_protocol_v2")
+		_, err := DB.Exec("ALTER TABLE global_config ADD COLUMN wire_protocol_v2 INTEGER NOT NULL DEFAULT 0")
+		if err != nil {
+			return fmt.Errorf("添加 wire_protocol_v2 字段失败: %w", err)
+		}
+	}
+
+	log.Println("  ✅ v1.5.0 → v2.0.0 迁移完成")
+	return nil
+}
+
+// migrateFrom2_0_0: 预留，v2.0 → 未来版本
+func migrateFrom2_0_0() error {
+	log.Println("  v2.0.0 已是当前版本，无需迁移")
+	return nil
+}
+
+// ============================================================
+// 辅助函数
+// ============================================================
+
 func getCurrentColumns(tableName string) ([]string, error) {
 	rows, err := DB.Query("PRAGMA table_info(" + tableName + ")")
 	if err != nil {
@@ -263,7 +429,7 @@ func ensureJwtSecret() error {
 	if err != nil {
 		return err
 	}
-	log.Printf("✅ JWT 密钥已生成并保存到数据库")
+	log.Printf("✅ JWT 密钥已生成")
 	return nil
 }
 

deploy.sh

@@ -4,6 +4,12 @@
 # frpc-console 一键部署脚本
 # 支持：Linux x86_64 / ARM64 / ARMv7
 # 自动安装：git / curl / wget / Go / Docker
+# 
+# 用法:
+#   ./deploy.sh           # 完整交互流程
+#   ./deploy.sh --yes     # 跳过确认，直接执行
+#   ./deploy.sh --check   # 只检测环境，不执行
+#   ./deploy.sh --dry-run # 显示将执行的操作，不实际执行
 # ============================================================
 
 set -e
@@ -14,317 +20,621 @@ GREEN='\033[0;32m'
 YELLOW='\033[1;33m'
 BLUE='\033[0;34m'
 CYAN='\033[0;36m'
+MAGENTA='\033[0;35m'
 NC='\033[0m'
 
 # ---------- 配置 ----------
 REPO_URL="https://git.whitetop.xyz/lxh2875931338/frpc-console.git"
 BRANCH="main"
 WORK_DIR="/tmp/frpc-console-build"
-DEPLOY_DIR="/opt/frpc-console"
-DATA_DIR="${DEPLOY_DIR}/data"
 DEFAULT_PORT=9300
+DEFAULT_DEPLOY_DIR="/opt/frpc-console"
 IMAGE_NAME="frpc-console"
 GO_VERSION="1.25.0"
 
+# ---------- 状态变量 ----------
+OS=""
+OS_VERSION=""
+ARCH=""
+GO_ARCH=""
+HAS_GIT=false
+HAS_CURL=false
+HAS_WGET=false
+HAS_GO=false
+HAS_DOCKER=false
+NEED_INSTALL_GIT=false
+NEED_INSTALL_CURL=false
+NEED_INSTALL_WGET=false
+NEED_INSTALL_GO=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
+
 # ---------- 打印函数 ----------
 print_info() { echo -e "${BLUE}[INFO]${NC} $1"; }
 print_success() { echo -e "${GREEN}[✓]${NC} $1"; }
 print_warn() { echo -e "${YELLOW}[⚠]${NC} $1"; }
 print_error() { echo -e "${RED}[✗]${NC} $1"; }
 print_step() { echo -e "\n${CYAN}▶${NC} $1"; }
+print_title() { echo -e "\n${MAGENTA}════════════════════════════════════════════════════════${NC}"; }
+print_subtitle() { echo -e "${MAGENTA}  $1${NC}"; }
+
+# ---------- 解析命令行参数 ----------
+parse_args() {
+    for arg in "$@"; do
+        case $arg in
+            --yes|-y)
+                SKIP_CONFIRM=true
+                ;;
+            --check)
+                CHECK_ONLY=true
+                ;;
+            --dry-run)
+                DRY_RUN=true
+                ;;
+            --help|-h)
+                echo "用法: ./deploy.sh [选项]"
+                echo ""
+                echo "选项:"
+                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
+                ;;
+        esac
+    done
+}
 
 # ---------- 检查 root ----------
-if [ "$EUID" -ne 0 ]; then
-    print_error "请使用 root 权限运行此脚本"
-    echo "  sudo bash deploy.sh"
-    exit 1
-fi
-
-# ---------- 1. 检测操作系统 ----------
-print_step "检测操作系统..."
-if [ -f /etc/os-release ]; then
-    . /etc/os-release
-    OS=$ID
-    OS_VERSION=$VERSION_ID
-else
-    print_error "无法识别操作系统"
-    exit 1
-fi
-print_info "系统: $OS $OS_VERSION"
-
-# ---------- 2. 检测 CPU 架构 ----------
-print_step "检测 CPU 架构..."
-ARCH=$(uname -m)
-case $ARCH in
-    x86_64|amd64)
-        GO_ARCH="amd64"
-        ;;
-    aarch64|arm64)
-        GO_ARCH="arm64"
-        ;;
-    armv7l|armhf)
-        GO_ARCH="armv6l"
-        ;;
-    *)
-        print_error "不支持的 CPU 架构: $ARCH"
+check_root() {
+    if [ "$EUID" -ne 0 ]; then
+        print_error "请使用 root 权限运行此脚本"
+        echo "  sudo bash deploy.sh"
         exit 1
-        ;;
-esac
-print_success "CPU 架构: $ARCH → Go 架构: $GO_ARCH"
+    fi
+}
 
-# ---------- 3. 安装必要工具 ----------
-print_step "检查必要工具..."
+# ---------- 检测操作系统 ----------
+detect_os() {
+    if [ -f /etc/os-release ]; then
+        . /etc/os-release
+        OS=$ID
+        OS_VERSION=$VERSION_ID
+    else
+        print_error "无法识别操作系统"
+        exit 1
+    fi
+}
 
-# git
-if ! command -v git &> /dev/null; then
-    print_warn "git 未安装，正在安装..."
-    case $OS in
-        opensuse*|suse*|opensuse-tumbleweed|opensuse-slowroll)
-            zypper install -y git
+# ---------- 检测 CPU 架构 ----------
+detect_arch() {
+    ARCH=$(uname -m)
+    case $ARCH in
+        x86_64|amd64)
+            GO_ARCH="amd64"
             ;;
-        ubuntu|debian|linuxmint)
-            apt update -qq && apt install -y git
+        aarch64|arm64)
+            GO_ARCH="arm64"
             ;;
-        centos|rhel|fedora|rocky|almalinux)
-            yum install -y git
-            ;;
-        alpine)
-            apk add git
+        armv7l|armhf)
+            GO_ARCH="armv6l"
             ;;
         *)
-            print_error "无法识别包管理器，请手动安装 git"
+            print_error "不支持的 CPU 架构: $ARCH"
             exit 1
             ;;
     esac
-    print_success "git 安装完成"
-else
-    print_success "git 已安装: $(git --version | awk '{print $3}')"
-fi
+}
 
-# curl
-if ! command -v curl &> /dev/null; then
-    print_warn "curl 未安装，正在安装..."
-    case $OS in
-        opensuse*|suse*|opensuse-tumbleweed|opensuse-slowroll) zypper install -y curl ;;
-        ubuntu|debian|linuxmint) apt install -y curl ;;
-        centos|rhel|fedora|rocky|almalinux) yum install -y curl ;;
-        alpine) apk add curl ;;
-        *) print_error "无法安装 curl"; exit 1 ;;
-    esac
-    print_success "curl 安装完成"
-else
-    print_success "curl 已安装"
-fi
-
-# wget（备用）
-if ! command -v wget &> /dev/null; then
-    print_warn "wget 未安装，正在安装..."
-    case $OS in
-        opensuse*|suse*|opensuse-tumbleweed|opensuse-slowroll) zypper install -y wget ;;
-        ubuntu|debian|linuxmint) apt install -y wget ;;
-        centos|rhel|fedora|rocky|almalinux) yum install -y wget ;;
-        alpine) apk add wget ;;
-        *) print_warn "wget 未安装，但不影响主要功能" ;;
-    esac
-else
-    print_success "wget 已安装"
-fi
-
-# ---------- 4. 安装 Go ----------
-print_step "检查 Go 环境..."
-if ! command -v go &> /dev/null; then
-    print_warn "Go 未安装，正在下载 Go ${GO_VERSION} (${GO_ARCH})..."
-
-    GO_TMP="/tmp/go${GO_VERSION}.linux-${GO_ARCH}.tar.gz"
-
-    if [ -f "$GO_TMP" ]; then
-        print_info "使用缓存: $GO_TMP"
+# ---------- 检测工具 ----------
+check_tools() {
+    # git
+    if command -v git &> /dev/null; then
+        HAS_GIT=true
     else
-        print_info "正在下载..."
-        MIRRORS=(
-            "https://mirrors.aliyun.com/golang/go${GO_VERSION}.linux-${GO_ARCH}.tar.gz"
-            "https://mirrors.tuna.tsinghua.edu.cn/golang/go${GO_VERSION}.linux-${GO_ARCH}.tar.gz"
-            "https://golang.google.cn/dl/go${GO_VERSION}.linux-${GO_ARCH}.tar.gz"
-            "https://dl.google.com/go/go${GO_VERSION}.linux-${GO_ARCH}.tar.gz"
-        )
+        NEED_INSTALL_GIT=true
+    fi
 
-        DOWNLOADED=false
-        for MIRROR in "${MIRRORS[@]}"; do
-            print_info "尝试: $MIRROR"
-            if curl -# -f -L -o "$GO_TMP" "$MIRROR"; then
-                print_success "下载成功"
-                DOWNLOADED=true
-                break
-            else
-                print_warn "失败，尝试下一个镜像..."
-                rm -f "$GO_TMP"
-            fi
-        done
+    # curl
+    if command -v curl &> /dev/null; then
+        HAS_CURL=true
+    else
+        NEED_INSTALL_CURL=true
+    fi
 
-        if [ "$DOWNLOADED" = false ]; then
-            print_error "所有镜像源均下载失败"
-            exit 1
+    # wget
+    if command -v wget &> /dev/null; then
+        HAS_WGET=true
+    else
+        NEED_INSTALL_WGET=true
+    fi
+
+    # Go
+    if command -v go &> /dev/null; then
+        HAS_GO=true
+    else
+        NEED_INSTALL_GO=true
+    fi
+
+    # Docker
+    if command -v docker &> /dev/null; then
+        HAS_DOCKER=true
+    fi
+}
+
+# ---------- 检查容器状态 ----------
+check_container() {
+    if docker ps -a --format '{{.Names}}' 2>/dev/null | grep -q "^frpc-console$"; then
+        CONTAINER_EXISTS=true
+        if docker ps --format '{{.Names}}' 2>/dev/null | grep -q "^frpc-console$"; then
+            CONTAINER_RUNNING=true
+        fi
+    fi
+}
+
+# ---------- 获取系统包管理器 ----------
+get_package_manager() {
+    case $OS in
+        opensuse*|suse*|opensuse-tumbleweed|opensuse-slowroll|opensuse-leap)
+            echo "zypper"
+            ;;
+        ubuntu|debian|linuxmint)
+            echo "apt"
+            ;;
+        centos|rhel|fedora|rocky|almalinux)
+            echo "yum"
+            ;;
+        alpine)
+            echo "apk"
+            ;;
+        arch|manjaro|endeavouros)
+            echo "pacman"
+            ;;
+        *)
+            echo "unknown"
+            ;;
+    esac
+}
+
+# ---------- 检测结果汇总 ----------
+print_environment_summary() {
+    print_title
+    print_subtitle "环境检测结果"
+    echo ""
+
+    echo -e "  ${CYAN}操作系统:${NC} $OS $OS_VERSION"
+    echo -e "  ${CYAN}CPU 架构:${NC} $ARCH → Go 架构: $GO_ARCH"
+    echo ""
+
+    echo "  ${CYAN}必要工具:${NC}"
+    if [ "$HAS_GIT" = true ]; then
+        echo -e "    git     ✅ 已安装 ($(git --version | awk '{print $3}'))"
+    else
+        echo -e "    git     ❌ 未安装 (将自动安装)"
+    fi
+    if [ "$HAS_CURL" = true ]; then
+        echo "    curl    ✅ 已安装"
+    else
+        echo "    curl    ❌ 未安装 (将自动安装)"
+    fi
+    if [ "$HAS_WGET" = true ]; then
+        echo "    wget    ✅ 已安装"
+    else
+        echo "    wget    ❌ 未安装 (将自动安装)"
+    fi
+
+    echo ""
+    echo "  ${CYAN}Go 环境:${NC}"
+    if [ "$HAS_GO" = true ]; then
+        echo -e "    go      ✅ 已安装 ($(go version | awk '{print $3}'))"
+    else
+        echo "    go      ❌ 未安装 (将自动安装 Go ${GO_VERSION})"
+    fi
+
+    echo ""
+    echo "  ${CYAN}Docker 环境:${NC}"
+    if [ "$HAS_DOCKER" = true ]; then
+        echo -e "    docker  ✅ 已安装 ($(docker --version | awk '{print $3}' | tr -d ','))"
+    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  ✅ 运行中"
+        else
+            echo -e "    frpc-console  ⏸️  已存在但未运行"
         fi
     fi
 
-    # 安装 Go
-    rm -rf /usr/local/go
-    tar -C /usr/local -xzf "$GO_TMP"
+    echo ""
+}
+
+# ---------- 生成操作列表 ----------
+generate_plan() {
+    PLAN=""
+    if [ "$NEED_INSTALL_GIT" = true ] || [ "$NEED_INSTALL_CURL" = true ] || [ "$NEED_INSTALL_WGET" = true ]; then
+        local pkgs=""
+        [ "$NEED_INSTALL_GIT" = true ] && pkgs="${pkgs} git"
+        [ "$NEED_INSTALL_CURL" = true ] && pkgs="${pkgs} curl"
+        [ "$NEED_INSTALL_WGET" = true ] && pkgs="${pkgs} wget"
+        PLAN="${PLAN}  • 安装必要工具:${pkgs}\n"
+    fi
+    if [ "$NEED_INSTALL_GO" = true ]; then
+        PLAN="${PLAN}  • 安装 Go ${GO_VERSION}\n"
+    fi
+    PLAN="${PLAN}  • 拉取 frpc-console 源码 (${BRANCH} 分支)\n"
+    PLAN="${PLAN}  • 编译 frpc-console 二进制\n"
+    PLAN="${PLAN}  • 构建 Docker 镜像\n"
+    if [ "$CONTAINER_EXISTS" = true ]; then
+        PLAN="${PLAN}  • 停止并删除旧容器\n"
+    fi
+    PLAN="${PLAN}  • 启动 frpc-console 容器"
+}
+
+# ---------- 展示部署计划 ----------
+print_deployment_plan() {
+    print_title
+    print_subtitle "部署计划"
+    echo ""
+
+    echo -e "  ${CYAN}将执行以下操作:${NC}"
+    echo -e "$(echo -e "$PLAN")"
+
+    echo ""
+    echo -e "  ${CYAN}配置信息:${NC}"
+    echo -e "    ────────────────────────────────────"
+    echo -e "    监听端口      : ${PORT}"
+    echo -e "    部署目录      : ${DEPLOY_DIR}"
+    echo -e "    数据目录      : ${DATA_DIR}"
+    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}"
+    fi
+
+    echo ""
+}
+
+# ---------- 确认部署 ----------
+confirm_deploy() {
+    if [ "$SKIP_CONFIRM" = true ]; then
+        echo -e "${GREEN}▶ 已启用 --yes，自动确认${NC}"
+        return 0
+    fi
+    echo -e -n "${CYAN}确认执行? 输入 Y 继续，输入 n 自定义配置 [Y/n]: ${NC}"
+    # 强制从 /dev/tty 读取，而不是继承 stdin
+    read -r CONFIRM </dev/tty
+    case $CONFIRM in
+        n|N) return 1 ;;
+        *) return 0 ;;
+    esac
+}
+
+# ---------- 自定义配置 ----------
+custom_config() {
+    print_title
+    print_subtitle "自定义配置"
+    echo ""
+
+    read -p "请输入监听端口 [${DEFAULT_PORT}]: " INPUT_PORT </dev/tty
+    PORT=${INPUT_PORT:-$DEFAULT_PORT}
+
+    read -p "请输入部署目录 [${DEFAULT_DEPLOY_DIR}]: " INPUT_DEPLOY_DIR </dev/tty
+    DEPLOY_DIR=${INPUT_DEPLOY_DIR:-$DEFAULT_DEPLOY_DIR}
+    DATA_DIR="${DEPLOY_DIR}/data"
+
+    echo ""
+    echo -e "  ${CYAN}更新后的配置:${NC}"
+    echo -e "    ────────────────────────────────────"
+    echo -e "    监听端口      : ${PORT}"
+    echo -e "    部署目录      : ${DEPLOY_DIR}"
+    echo -e "    数据目录      : ${DATA_DIR}"
+    echo -e "    ────────────────────────────────────"
+    echo ""
+}
+
+# ---------- 实际执行部署 ----------
+do_deploy() {
+    print_title
+    print_subtitle "开始部署"
+    echo ""
+
+    # ----- 安装必要工具 -----
+    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)
+                zypper install -y $pkgs-core
+                ;;
+            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 "无法识别包管理器，请手动安装: $pkgs"
+                exit 1
+                ;;
+        esac
+        print_success "必要工具安装完成"
+    fi
+
+    # ----- 安装 Go -----
+    if [ "$NEED_INSTALL_GO" = true ]; then
+        print_step "安装 Go ${GO_VERSION} (${GO_ARCH})..."
+
+        GO_TMP="/tmp/go${GO_VERSION}.linux-${GO_ARCH}.tar.gz"
+
+        if [ -f "$GO_TMP" ]; then
+            print_info "使用缓存: $GO_TMP"
+        else
+            print_info "正在下载..."
+            MIRRORS=(
+                "https://mirrors.aliyun.com/golang/go${GO_VERSION}.linux-${GO_ARCH}.tar.gz"
+                "https://mirrors.tuna.tsinghua.edu.cn/golang/go${GO_VERSION}.linux-${GO_ARCH}.tar.gz"
+                "https://golang.google.cn/dl/go${GO_VERSION}.linux-${GO_ARCH}.tar.gz"
+                "https://dl.google.com/go/go${GO_VERSION}.linux-${GO_ARCH}.tar.gz"
+            )
+
+            DOWNLOADED=false
+            for MIRROR in "${MIRRORS[@]}"; do
+                print_info "尝试: $MIRROR"
+                if curl -# -f -L -o "$GO_TMP" "$MIRROR"; then
+                    print_success "下载成功"
+                    DOWNLOADED=true
+                    break
+                else
+                    print_warn "失败，尝试下一个镜像..."
+                    rm -f "$GO_TMP"
+                fi
+            done
+
+            if [ "$DOWNLOADED" = false ]; then
+                print_error "所有镜像源均下载失败"
+                exit 1
+            fi
+        fi
+
+        rm -rf /usr/local/go
+        tar -C /usr/local -xzf "$GO_TMP"
+        export PATH=$PATH:/usr/local/go/bin
+        if [ ! -f /etc/profile.d/go.sh ]; then
+            echo 'export PATH=$PATH:/usr/local/go/bin' > /etc/profile.d/go.sh
+        fi
+
+        /usr/local/go/bin/go env -w GOPROXY=https://goproxy.cn,direct
+        /usr/local/go/bin/go env -w GOPRIVATE=git.whitetop.xyz
+
+        print_success "Go ${GO_VERSION} (${GO_ARCH}) 安装完成"
+    fi
+
+    # 确保 go 在 PATH 中
     export PATH=$PATH:/usr/local/go/bin
-    echo 'export PATH=$PATH:/usr/local/go/bin' > /etc/profile.d/go.sh
 
-    # 配置 Go 代理
-    /usr/local/go/bin/go env -w GOPROXY=https://goproxy.cn,direct
-    /usr/local/go/bin/go env -w GOPRIVATE=git.whitetop.xyz
+    # ----- 拉取代码 -----
+    print_step "拉取代码..."
+    rm -rf "$WORK_DIR"
+    git clone --depth 1 --branch "$BRANCH" "$REPO_URL" "$WORK_DIR"
+    cd "$WORK_DIR"
+    mkdir -p bin static
+    print_success "代码拉取完成"
 
-    print_success "Go ${GO_VERSION} (${GO_ARCH}) 安装完成"
-else
-    print_success "Go 已安装: $(go version | awk '{print $3}') (架构: $(go env GOARCH))"
-    go env -w GOPROXY=https://goproxy.cn,direct 2>/dev/null || true
-    go env -w GOPRIVATE=git.whitetop.xyz 2>/dev/null || true
-fi
+    # ----- 修复 go.mod -----
+    print_step "检查 go.mod..."
+    if grep -q "go 1.2[6-9]" go.mod 2>/dev/null; then
+        print_warn "检测到 go.mod 版本过高，自动降级到 go 1.21"
+        sed -i 's/go 1.2[6-9].*/go 1.21/' go.mod
+    fi
+
+    # ----- 下载依赖 -----
+    print_step "下载 Go 依赖..."
+    go mod download
+    print_success "依赖下载完成"
+
+    # ----- 编译 -----
+    print_step "编译 frpc-console..."
+    CGO_ENABLED=0 GOOS=linux go build \
+        -ldflags="-s -w" \
+        -o frpc-console .
+
+    if [ -f "frpc-console" ]; then
+        SIZE=$(du -h frpc-console | cut -f1)
+        print_success "编译完成 ($SIZE)"
+    else
+        print_error "编译失败"
+        exit 1
+    fi
+
+    # ----- 准备部署目录 -----
+    print_step "准备部署目录..."
+    mkdir -p "$DEPLOY_DIR"
+    mkdir -p "$DATA_DIR"
+
+    if [ ! -f "$DATA_DIR/frpc-console.db" ]; then
+        touch "$DATA_DIR/frpc-console.db"
+        print_info "新数据目录已创建"
+    else
+        print_info "已有数据目录，保留现有数据"
+    fi
+
+    cp frpc-console "$DEPLOY_DIR/"
+    print_success "二进制已复制到 $DEPLOY_DIR"
+
+    # ----- 构建 Docker 镜像 -----
+    print_step "构建 Docker 镜像..."
+    docker build -t "${IMAGE_NAME}:latest" .
+    print_success "Docker 镜像构建完成: ${IMAGE_NAME}:latest"
+
+    # ----- 停止旧容器 -----
+    if [ "$CONTAINER_EXISTS" = true ]; then
+        print_step "处理旧容器..."
+        if [ "$CONTAINER_RUNNING" = true ]; then
+            docker stop frpc-console 2>/dev/null || true
+        fi
+        docker rm frpc-console 2>/dev/null || true
+        print_success "旧容器已清理"
+    fi
+
+    # ----- 启动新容器 -----
+    print_step "启动 frpc-console 容器..."
+    docker run -d \
+        --name frpc-console \
+        --restart=always \
+        --network host \
+        -v ${DATA_DIR}:/app/data \
+        -e PORT=${PORT} \
+        -e TZ=Asia/Shanghai \
+        ${IMAGE_NAME}:latest
+
+    if docker ps | grep -q frpc-console; then
+        print_success "容器启动成功！"
+    else
+        print_error "容器启动失败，请检查日志: docker logs frpc-console"
+        exit 1
+    fi
+
+    # ----- 检查 frpc 子进程 -----
+    print_step "检查 frpc 状态..."
+    sleep 3
+    if docker exec frpc-console ps aux 2>/dev/null | grep -q "[f]rpc -c"; then
+        print_success "frpc 进程运行正常"
+    else
+        print_warn "frpc 进程未运行（可能配置为空，请在 WebUI 中导入 TOML）"
+    fi
+
+    # ----- 清理临时文件 -----
+    print_step "清理临时文件..."
+    rm -rf "$WORK_DIR"
+    print_success "临时文件已清理"
+
+    # ----- 输出信息 -----
+    print_title
+    print_success "frpc-console 部署完成！"
+    print_title
 
-# ---------- 5. 检查 Docker ----------
-print_step "检查 Docker 环境..."
-if ! command -v docker &> /dev/null; then
-    print_error "Docker 未安装，请先安装 Docker"
     echo ""
-    echo "  快速安装:"
-    echo "  curl -fsSL https://get.docker.com | bash"
-    echo "  systemctl enable --now docker"
+    echo -e "  ${CYAN}📍 访问地址:${NC} http://$(hostname -I | awk '{print $1}'):${PORT}"
+    echo -e "  ${CYAN}📂 数据目录:${NC} ${DATA_DIR}"
+    echo -e "  ${CYAN}🐳 容器名称:${NC} frpc-console"
     echo ""
-    exit 1
-else
-    print_success "Docker 已安装: $(docker --version | awk '{print $3}' | tr -d ',')"
-fi
+    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 ""
+    echo -e "  ${YELLOW}首次访问需要注册管理员账户${NC}"
+    echo ""
+    print_title
+}
 
-# ---------- 6. 交互式配置 ----------
-print_step "部署配置"
-read -p "监听端口 [${DEFAULT_PORT}]: " PORT
-PORT=${PORT:-$DEFAULT_PORT}
+# ---------- 主流程 ----------
+# ---------- 主流程 ----------
+main() {
+    # 清屏，让输出从头开始
+    clear 2>/dev/null || true
 
-read -p "部署目录 [${DEPLOY_DIR}]: " DEPLOY_DIR_INPUT
-DEPLOY_DIR=${DEPLOY_DIR_INPUT:-$DEPLOY_DIR}
-DATA_DIR="${DEPLOY_DIR}/data"
+    parse_args "$@"
+    check_root
 
-print_info "端口: $PORT"
-print_info "部署目录: $DEPLOY_DIR"
-print_info "数据目录: $DATA_DIR"
+    # ---- 环境检测 ----
+    print_step "正在检测环境..."
+    detect_os
+    detect_arch
+    check_tools
+    check_container
 
-# ---------- 7. 拉取代码 ----------
-print_step "拉取代码..."
-rm -rf "$WORK_DIR"
-git clone --depth 1 --branch "$BRANCH" "$REPO_URL" "$WORK_DIR"
-cd "$WORK_DIR"
+    # ---- 展示检测结果 ----
+    print_environment_summary
 
-# 确保目录存在
-mkdir -p bin static
+    # ---- 如果只检测 ----
+    if [ "$CHECK_ONLY" = true ]; then
+        print_info "环境检测完成（--check 模式，不执行部署）"
+        exit 0
+    fi
 
-print_success "代码拉取完成"
+    # ---- 如果 Docker 未安装 ----
+    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 ""
+        exit 1
+    fi
 
-# ---------- 8. 修复 go.mod 版本（防止 toolchain 下载） ----------
-print_step "检查 go.mod..."
-if grep -q "go 1.26" go.mod 2>/dev/null; then
-    print_warn "检测到 go.mod 版本过高，自动降级到 go 1.21"
-    sed -i 's/go 1.26.*/go 1.21/' go.mod
-fi
+    # ---- 生成部署计划 ----
+    generate_plan
 
-# ---------- 9. 下载依赖 ----------
-print_step "下载 Go 依赖..."
-go mod download
-print_success "依赖下载完成"
+    # ---- 展示部署计划 ----
+    print_deployment_plan
 
-# ---------- 10. 编译 ----------
-print_step "编译 frpc-console..."
-CGO_ENABLED=0 GOOS=linux go build \
-    -ldflags="-s -w" \
-    -o frpc-console .
+    # ---- 确认或自定义 ----
+    if ! confirm_deploy; then
+        custom_config
+        print_deployment_plan
+        if ! confirm_deploy; then
+            print_info "已取消部署"
+            exit 0
+        fi
+    fi
 
-if [ -f "frpc-console" ]; then
-    SIZE=$(du -h frpc-console | cut -f1)
-    print_success "编译完成 ($SIZE)"
-else
-    print_error "编译失败"
-    exit 1
-fi
+    # ---- 如果只是演练 ----
+    if [ "$DRY_RUN" = true ]; then
+        print_info "演练模式（--dry-run），不实际执行部署"
+        exit 0
+    fi
 
-# ---------- 11. 准备部署目录 ----------
-print_step "准备部署目录..."
-mkdir -p "$DEPLOY_DIR"
-mkdir -p "$DATA_DIR"
+    # ---- 执行部署 ----
+    do_deploy
+}
 
-# 如果已有数据，保留；否则创建空占位
-if [ ! -f "$DATA_DIR/frpc-console.db" ]; then
-    touch "$DATA_DIR/frpc-console.db"
-    print_info "新数据目录已创建"
-else
-    print_info "已有数据目录，保留现有数据"
-fi
-
-cp frpc-console "$DEPLOY_DIR/"
-print_success "二进制已复制到 $DEPLOY_DIR"
-
-# ---------- 12. 构建 Docker 镜像 ----------
-print_step "构建 Docker 镜像..."
-docker build -t "${IMAGE_NAME}:latest" .
-print_success "Docker 镜像构建完成: ${IMAGE_NAME}:latest"
-
-# ---------- 13. 停止旧容器 ----------
-print_step "检查旧容器..."
-if docker ps -a --format '{{.Names}}' | grep -q "^frpc-console$"; then
-    print_warn "发现旧容器，正在停止并删除..."
-    docker stop frpc-console 2>/dev/null || true
-    docker rm frpc-console 2>/dev/null || true
-    print_success "旧容器已清理"
-fi
-
-# ---------- 14. 启动新容器 ----------
-print_step "启动 frpc-console 容器..."
-docker run -d \
-    --name frpc-console \
-    --restart=always \
-    --network host \
-    -v ${DATA_DIR}:/app/data \
-    -e PORT=9300 \
-    -e TZ=Asia/Shanghai \
-    ${IMAGE_NAME}:latest
-
-if docker ps | grep -q frpc-console; then
-    print_success "容器启动成功！"
-else
-    print_error "容器启动失败，请检查日志: docker logs frpc-console"
-    exit 1
-fi
-
-# ---------- 15. 检查 frpc 子进程 ----------
-print_step "检查 frpc 状态..."
-sleep 3
-if docker exec frpc-console ps aux 2>/dev/null | grep -q "[f]rpc -c"; then
-    print_success "frpc 进程运行正常"
-else
-    print_warn "frpc 进程未运行（可能配置为空，请在 WebUI 中导入 TOML）"
-fi
-
-# ---------- 16. 清理临时文件 ----------
-print_step "清理临时文件..."
-rm -rf "$WORK_DIR"
-print_success "临时文件已清理"
-
-# ---------- 17. 输出信息 ----------
-echo ""
-echo "=========================================="
-echo -e "${GREEN}✅ frpc-console 部署完成！${NC}"
-echo "=========================================="
-echo ""
-echo "📍 访问地址: http://$(hostname -I | awk '{print $1}'):${PORT}"
-echo "📂 数据目录: ${DATA_DIR}"
-echo "🐳 容器名称: frpc-console"
-echo ""
-echo "常用命令:（可提前复制，如果有宝塔或者1panel那当我没说）"
-echo "  docker logs frpc-console      # 查看日志"
-echo "  docker restart frpc-console   # 重启服务"
-echo "  docker stop frpc-console      # 停止服务"
-echo "  docker start frpc-console     # 启动服务"
-echo ""
-echo "首次访问需要注册管理员账户"
-echo "=========================================="
+# ---------- 入口 ----------
+main "$@"

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 | 从国内镜像下载，自动配置代理 |

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>
 
 ---
 
@@ -169,7 +171,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 +184,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 +245,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 Gitea:lxh2875931338/Github: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

@@ -20,15 +20,14 @@ 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", ""}, // GOARCH=arm, GOARM=7
 }
 
 const (
-	Version   = "1.0.0"
-	BuildTime = "2026-07-24"
+	Version   = "2.0.0"
+	BuildTime = "2026-07-26"
 	Binary    = "frpc-console"
 )
 
@@ -53,7 +52,7 @@ func main() {
 			}
 		}
 		fmt.Println("❌ 不支持的平台:", target)
-		fmt.Println("   可用: windows/amd64, windows/386, linux/amd64, linux/arm64, linux/armv7")
+		fmt.Println("   可用: windows/amd64, linux/amd64, linux/arm64, linux/armv7")
 		fmt.Println("   或: all, list, clean")
 		return
 	}
@@ -126,10 +125,14 @@ func build(p Platform, silent bool) {
 		return
 	}
 
-	outName := Binary + "-" + p.OS + "-" + p.Arch + p.Ext
+	// 构建输出文件名
+	outName := Binary + "-" + p.OS + "-" + p.Arch
+	if p.Arch == "arm" {
+		outName += "v7" // 标注 ARMv7 版本
+	}
+	outName += p.Ext
 	outPath := filepath.Join(outDir, outName)
 
-	// 用 "go" 而不是硬编码路径，让系统去 PATH 里找
 	cmd := exec.Command("go", "build",
 		"-ldflags=-s -w -X main.version="+Version,
 		"-o", outPath,
@@ -140,6 +143,12 @@ func build(p Platform, silent bool) {
 		"GOARCH="+p.Arch,
 		"CGO_ENABLED=0",
 	)
+
+	// ARM 架构指定 GOARM=7
+	if p.Arch == "arm" {
+		cmd.Env = append(cmd.Env, "GOARM=7")
+	}
+
 	cmd.Stdout = os.Stdout
 	cmd.Stderr = os.Stderr
 

static/index.html

@@ -170,7 +170,7 @@
 
                         <!-- 首次使用提示 -->
                         <div v-if="showDefaultTip" class="config-tip">
-                            首次使用请修改「服务器地址」和「认证令牌」为您的真实 frps 配置
+                            首次使用请修改「服务器地址」和「认证令牌」为您的真实 frpc 配置
                         </div>
 
                         <!-- ===== 账户管理 ===== -->
@@ -267,13 +267,12 @@
                                     <label>frp v2 隧道支持</label>
                                     <div class="v2-switch-wrapper">
                                         <label class="switch disabled">
-                                            <input type="checkbox" v-model="globalConfig.wireProtocolV2" disabled />
+                                            <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>

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);