34 Commits
Author SHA1 Message Date
lxh2875931338 1bfa2383c1 docker脚本部分逻辑更新 2026-07-28 20:21:01 +08:00
lxh2875931338 b13f2d5047 指南更新 2026-07-28 20:13:14 +08:00
lxh2875931338 7a2737bc83 指南更新 2026-07-28 20:11:53 +08:00
lxh2875931338 1fd845a981 readme更新 2026-07-28 20:09:34 +08:00
lxh2875931338 f9a97a0af5 版本更新说明 2026-07-28 20:06:14 +08:00
lxh2875931338 ab73a38f06 直接更新 2026-07-28 20:03:20 +08:00
lxh2875931338 21c9c9556b 2.2逻辑设计已完成 2026-07-28 20:01:43 +08:00
lxh2875931338 babfdee02b 2.2技术预览版更新内容已写入 2026-07-28 19:30:26 +08:00
lxh2875931338 aaac3fc791 引入2.1应做的全新UI变更 2026-07-28 19:11:40 +08:00
lxh2875931338 509de72d10 2.2的部分代码新增实现 2026-07-28 18:46:08 +08:00
lxh2875931338 c2516dc8ff 2.2测试代码引入中 2026-07-28 18:43:56 +08:00
lxh2875931338 74a054d90c 更新 readme.md
readme更新2.0-LTS发布信息
2026-07-28 00:28:23 +08:00
lxh2875931338 d2b3dd8803 2.0前的最后几个版本推送 2026-07-27 23:34:07 +08:00
lxh2875931338 1afb56edfc readme更新 2026-07-27 18:32:32 +08:00
lxh2875931338 73f0011b54 readme援引项目更新 2026-07-27 18:31:26 +08:00
lxh2875931338 1d0e98e1fd readme更新 2026-07-27 18:10:44 +08:00
lxh2875931338 fb8fecc59a readme更新 2026-07-27 18:05:12 +08:00
lxh2875931338 0c21dd5d07 更新 readme.md 2026-07-27 13:07:16 +08:00
lxh2875931338 8b5de14cce 更新 readme.md
readme措辞调整

Signed-off-by: 不安的亡命樱 <1+lxh2875931338@noreply.localhost>
2026-07-27 13:04:25 +08:00
lxh2875931338 4bd3554140 readme补充 2026-07-27 12:40:04 +08:00
lxh2875931338 6934835394 readme补充 2026-07-27 12:39:44 +08:00
lxh2875931338 2c044890d8 readme补充 2026-07-27 12:38:59 +08:00
lxh2875931338 f9d817031e 调整日志内容 2026-07-27 12:38:24 +08:00
lxh2875931338 a97b3a7669 readme补充 2026-07-27 12:37:23 +08:00
lxh2875931338 059e4638da readme补充 2026-07-27 12:34:56 +08:00
lxh2875931338 b80238029a 阐述一个新的设计理念“阴阳模式” 2026-07-27 12:33:24 +08:00
lxh2875931338 e64a8687d2 第一份2.0-LTS代码上传 2026-07-26 21:55:42 +08:00
lxh2875931338 542f265a35 1.5正式完结,即将进入LTS更新环节 2026-07-26 14:00:16 +08:00
lxh2875931338 88046018a8 优化自动脚本逻辑 2026-07-26 12:53:11 +08:00
lxh2875931338 ebba194fbc 优化自动脚本逻辑 2026-07-26 12:49:56 +08:00
lxh2875931338 73a7bbea09 优化自动脚本逻辑 2026-07-26 12:40:26 +08:00
lxh2875931338 bfc6f9b6e2 docker安装自动脚本重构部署逻辑 2026-07-26 12:37:27 +08:00
lxh2875931338 7851bea1c3 增加对Arch分支系统的自动配置支持 2026-07-26 12:30:02 +08:00
lxh2875931338 469a3687ca 编译工具优化 2026-07-26 12:17:09 +08:00
15 changed files with 1499 additions and 552 deletions
+33 -1
View File
@@ -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"
@@ -64,7 +66,7 @@ func SetupRouter() *gin.Engine {
auth.POST("/frpc/stop", stopFrpcHandler)
auth.GET("/frpc/status", getFrpcStatusHandler)
auth.GET("/frpc/log", getFrpcLogHandler)
auth.GET("/ping", pingHandler)
auth.POST("/import/toml", importTomlHandler)
auth.GET("/export/toml", ExportTomlHandler)
@@ -143,6 +145,36 @@ func registerHandler(c *gin.Context) {
})
}
// Ping 延迟检测
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})
}
func loginHandler(c *gin.Context) {
var req struct {
Username string `json:"username"`
Binary file not shown.
BIN
View File
Binary file not shown.
+111
View File
@@ -0,0 +1,111 @@
package main
// ============================================================
// db-history.go - Schema 版本声明与字段映射
// 这是整个迁移引擎的“数据源”,记录每个版本的完整 Schema 定义。
// 迁移工具通过对比当前 Schema 与目标 Schema 的差异来决定迁移路径。
// ============================================================
// SchemaVersionDef 记录一个 Schema 版本的完整字段定义
type SchemaVersionDef struct {
Version string // 如 "v1", "v2", "v3"
TableName string // 表名,如 "proxies"
Columns map[string]ColumnDef // 字段名 → 字段定义
}
// ColumnDef 描述一个字段的结构
type ColumnDef struct {
Type string // 如 "INTEGER", "TEXT", "BOOLEAN"
NotNull bool // 是否 NOT NULL
Default string // 默认值表达式(如 "0"、"'CHANGE_ME'"
Primary bool // 是否主键
}
// schemaHistory 存储所有已知的 Schema 版本(从旧到新排列)
// 每个版本记录的是“完整的表结构”,而不是增量变更。
// 新增版本时,在这里追加一条记录即可。
var schemaHistory = []SchemaVersionDef{
// v1:初始版本(frpc-console 1.0
{
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
// 注意:wire_protocol_v2 是全局配置(global_config),不在 proxies 表中
{
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"},
},
},
// v3:未来版本(规划中)
// 示例:新增隧道分组、流量统计等字段
// {
// Version: "v3",
// TableName: "proxies",
// Columns: map[string]ColumnDef{
// // ... 完整字段定义
// },
// },
}
// getSchemaDef 根据版本号获取 Schema 定义
func getSchemaDef(version string) *SchemaVersionDef {
for _, def := range schemaHistory {
if def.Version == version {
return &def
}
}
return nil
}
// getLatestSchemaDef 获取最新的 Schema 版本定义
func getLatestSchemaDef() *SchemaVersionDef {
if len(schemaHistory) == 0 {
return nil
}
return &schemaHistory[len(schemaHistory)-1]
}
// schemaVersionsEqual 判断两个 Schema 版本是否完全相同
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
}
+299 -104
View File
@@ -4,15 +4,32 @@ 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 版本(与 schemaHistory 中的版本对应)
)
// ============================================================
// 数据模型
// ============================================================
// GlobalConfig 全局配置表
type GlobalConfig struct {
ID int `json:"id"`
ServerAddr string `json:"serverAddr"`
@@ -25,10 +42,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 协议全局开关
}
// ===== 隧道表(B表)=====
// Proxy 隧道表(不含 wire_protocol_v2
type Proxy struct {
ID int `json:"id"`
Name string `json:"name"`
@@ -39,7 +56,7 @@ type Proxy struct {
Enabled bool `json:"enabled"`
}
// ===== 用户表(C表)=====
// User 用户表
type User struct {
ID int `json:"id"`
Username string `json:"username"`
@@ -58,8 +75,29 @@ func InitDB() error {
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 +110,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 +132,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 +150,7 @@ func InitDB() error {
return err
}
// ---- 应用配置表 ----
// 应用配置表
_, err = DB.Exec(`
CREATE TABLE IF NOT EXISTS app_config (
key TEXT PRIMARY KEY,
@@ -146,98 +162,280 @@ 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")
// getCurrentSchemaVersion 读取当前数据库的 Schema 版本
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
}
// 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
}
if len(added) > 0 {
log.Printf("✅ 数据库迁移完成,新增字段: %v", added)
} else {
log.Println("✅ 数据库 Schema 已是最新")
timestamp := time.Now().Format("20060102_150405")
dst := fmt.Sprintf("./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
}
// 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
}
// getCurrentColumns 查询指定表的所有列名
func getCurrentColumns(tableName string) ([]string, error) {
rows, err := DB.Query("PRAGMA table_info(" + tableName + ")")
if err != nil {
return nil, err
}
defer rows.Close()
// runMigrations 执行迁移
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
}
cols = append(cols, name)
log.Printf("📌 当前数据库 Schema: %s, 目标版本: %s", currentVer, targetVer)
if currentVer == targetVer {
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 无变更)")
} 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
// heavyMigration 重型迁移
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
}
// buildCreateTableSQL 根据 Schema 定义生成 CREATE TABLE 语句
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 "))
}
// buildInsertSQL 构建 INSERT INTO new_table SELECT ... FROM old_table
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 +461,7 @@ func ensureJwtSecret() error {
if err != nil {
return err
}
log.Printf("✅ JWT 密钥已生成并保存到数据库")
log.Printf("✅ JWT 密钥已生成")
return nil
}
@@ -338,10 +536,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) {
+616 -283
View File
@@ -4,327 +4,660 @@
# 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
# ---------- 颜色输出 ----------
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
CYAN='\033[0;36m'
NC='\033[0m'
# ---------- 颜色检测 ----------
if [ -t 1 ]; then
# 交互式终端,启用颜色
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
CYAN='\033[0;36m'
MAGENTA='\033[0;35m'
NC='\033[0m'
else
# 非交互式终端(如管道),禁用颜色
RED=''
GREEN=''
YELLOW=''
BLUE=''
CYAN=''
MAGENTA=''
NC=''
fi
# ---------- 配置 ----------
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"
# curl
if command -v curl &> /dev/null; then
HAS_CURL=true
else
NEED_INSTALL_CURL=true
fi
# 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 " 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
echo -e " ${YELLOW}数据目录中的数据库文件将被保留${NC}"
fi
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}"
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)
# OpenSUSE 使用 git-core 而非 git
if [ "$NEED_INSTALL_GIT" = true ]; then
zypper install -y git-core
# 移除 git 避免重复安装
pkgs=$(echo "$pkgs" | sed 's/ git / /g' | sed 's/git //g' | sed 's/ git$//')
fi
if [ -n "$pkgs" ]; then
zypper install -y $pkgs
fi
;;
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
done
fi
if [ "$DOWNLOADED" = false ]; then
print_error "所有镜像源均下载失败"
exit 1
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
# ----- 拉取代码 -----
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 "代码拉取完成"
# ----- 修复 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
echo ""
echo -e " ${CYAN}📍 访问地址:${NC} http://$(hostname -I | awk '{print $1}'):${PORT}"
echo -e " ${CYAN}📂 数据目录:${NC} ${DATA_DIR}"
echo -e " ${CYAN}🐳 容器名称:${NC} frpc-console"
echo ""
echo -e " ${CYAN}常用命令:${NC}"
echo " docker logs frpc-console # 查看日志"
echo " docker restart frpc-console # 重启服务"
echo " docker stop frpc-console # 停止服务"
echo " docker start frpc-console # 启动服务"
echo ""
echo -e " ${YELLOW}首次访问需要注册管理员账户${NC}"
echo ""
print_title
}
# ---------- 主流程 ----------
main() {
clear 2>/dev/null || true
parse_args "$@"
check_root
# ---- 环境检测 ----
print_step "检测环境..."
detect_os
detect_arch
check_tools
check_container
# ---- 展示检测结果 ----
print_environment_summary
# ---- 如果只检测 ----
if [ "$CHECK_ONLY" = true ]; then
print_info "环境检测完成(--check 模式,不执行部署)"
exit 0
fi
# ---- 如果 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
# ---- 生成部署计划 ----
generate_plan
# ---- 展示部署计划 ----
print_deployment_plan
# ---- 确认或自定义 ----
if ! confirm_deploy; then
custom_config
print_deployment_plan
if ! confirm_deploy; then
print_info "已取消部署"
exit 0
fi
fi
# 安装 Go
rm -rf /usr/local/go
tar -C /usr/local -xzf "$GO_TMP"
export PATH=$PATH:/usr/local/go/bin
echo 'export PATH=$PATH:/usr/local/go/bin' > /etc/profile.d/go.sh
# ---- 如果只是演练 ----
if [ "$DRY_RUN" = true ]; then
print_info "演练模式(--dry-run),不实际执行部署"
exit 0
fi
# 配置 Go 代理
/usr/local/go/bin/go env -w GOPROXY=https://goproxy.cn,direct
/usr/local/go/bin/go env -w GOPRIVATE=git.whitetop.xyz
# ---- 执行部署 ----
do_deploy
}
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
# ---------- 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 ""
exit 1
else
print_success "Docker 已安装: $(docker --version | awk '{print $3}' | tr -d ',')"
fi
# ---------- 6. 交互式配置 ----------
print_step "部署配置"
read -p "监听端口 [${DEFAULT_PORT}]: " PORT
PORT=${PORT:-$DEFAULT_PORT}
read -p "部署目录 [${DEPLOY_DIR}]: " DEPLOY_DIR_INPUT
DEPLOY_DIR=${DEPLOY_DIR_INPUT:-$DEPLOY_DIR}
DATA_DIR="${DEPLOY_DIR}/data"
print_info "端口: $PORT"
print_info "部署目录: $DEPLOY_DIR"
print_info "数据目录: $DATA_DIR"
# ---------- 7. 拉取代码 ----------
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 "代码拉取完成"
# ---------- 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
# ---------- 9. 下载依赖 ----------
print_step "下载 Go 依赖..."
go mod download
print_success "依赖下载完成"
# ---------- 10. 编译 ----------
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
# ---------- 11. 准备部署目录 ----------
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"
# ---------- 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 "$@"
+26 -25
View File
@@ -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
}
// 优先级2embed 解压到临时目录
// 优先级2embed 解压
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.tomlv2.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 {
+3
View File
@@ -15,6 +15,9 @@ tcpMuxKeepaliveInterval = {{.TcpMuxKeepalive}}
heartbeatInterval = {{.HeartbeatInterval}}
heartbeatTimeout = {{.HeartbeatTimeout}}
poolCount = {{.PoolCount}}
{{if .WireProtocolLine}}
{{.WireProtocolLine}}
{{end}}
[webServer]
addr = "127.0.0.1:7400"
+5 -3
View File
@@ -1,13 +1,15 @@
## 🐳 Docker 版安装指南
> 推荐方式:一键脚本自动部署,无需手动编译,无需安装 Go 环境。
> 推荐方式:一键脚本自动部署,无需手动编译,无需安装 Go 环境。</br>
> ⚠️ **注意**:Docker 版直接从源码构建,使用的是当前 `main` 分支的最新代码,更新进度会远快于 Release 版本。⚠️</br>
> 如需使用特定版本(如 LTS),请查看 [Releases](https://git.whitetop.xyz/lxh2875931338/frpc-console/releases) 确认版本号,并通过二进制方式部署指定版本。
### 一、📥 前置条件
- 已安装 Docker(必须)
- 已安装 curl / wget(脚本会自动检查并安装)
- 操作系统:Linuxx86_64 / ARM64 均可,ARMv7 将在不久的未来得到支持
- 操作系统:Linuxx86_64 / ARM64 / ARMv7 均可
### 二、🚀 一键部署(推荐)
@@ -31,7 +33,7 @@ sudo bash deploy.sh
| 步骤 | 说明 |
|---|---|
| 检测系统 | 自动识别 OpenSUSE / Ubuntu / Debian / CentOS / Alpine |
| 检测系统 | 自动识别 OpenSUSE(猫猫特有的夹带私货) / Ubuntu / Debian / CentOS / Alpine |
| 检测 CPU 架构 | 自动适配 x86_64 / ARM64 / ARMv7 |
| 安装依赖 | git / curl / wget(如未安装) |
| 安装 Go | 从国内镜像下载,自动配置代理 |
+122 -29
View File
@@ -35,17 +35,20 @@
适用于 Linux / Windows,无需 Docker,单文件运行。
👉 详见:[二进制安装指南](./INSTALL_BINARY.md)
👉 详见:([二进制安装指南](https://git.whitetop.xyz/lxh2875931338/frpc-console/src/branch/main/install_binary.md))
### 🐳 Docker 部署(一键脚本)
适用于 Linux 服务器,自动编译 + 自动部署。
> ⚠️ **注意**:Docker 版直接从源码构建,使用的是当前 `main` 分支的最新代码,更新进度会远快于 Release 版本。⚠️</br>
> 如需使用特定版本(如 LTS),请查看 [Releases](https://git.whitetop.xyz/lxh2875931338/frpc-console/releases) 确认版本号,并通过二进制方式部署指定版本。
```bash
curl -sSL https://git.whitetop.xyz/lxh2875931338/frpc-console/raw/main/deploy.sh | sudo bash
```
👉 详见:[Docker 安装指南](./INSTALL_DOCKER.md)
👉 详见:([Docker 安装指南](https://git.whitetop.xyz/lxh2875931338/frpc-console/src/branch/main/install_docker.md))
### 🔧 源码编译
@@ -66,22 +69,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 +103,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 +145,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 +181,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 +194,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 +255,62 @@ frpc-console 遵循 **“够用就好”** 的原则:
2. **能用 SQLite 就不用 PostgreSQL,能用 Vue CDN 就不用 React 全家桶。**
3. **前端能做的事,后端不加额外复杂度。**
4. **删掉一个容器等于删掉所有垃圾,所以用 Docker 隔离是对的。**
5. **面板的存在应该是为了服务业务的,而不该是反过来主导业务的。**
---
## 📝 更新日志
### 1.0-Release (2026-07-24)
### 2.0-LTS 2026-07-28)正式发布
· 🎉 首次发布</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 lxh2875931338XHLiang0
---
## 🙏 相关项目援引
### FRP 生态互补工具
· [MoonProxy](https://github.com/MoonProxyHQ/moonproxy-desktop) —— 基于 Tauri v2 + Vue 3 + Rust 构建的跨平台 FRP 桌面客户端(frpc GUI),面向 macOS 与 Windows,让内网穿透开箱即用,MIT协议开源。
### FRP 生态同类工具(暂无互引)
</br>
---
+16 -7
View File
@@ -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
+116 -7
View File
@@ -28,6 +28,14 @@ async function apiFetch(endpoint, options = {}) {
...options,
headers: { ...headers, ...(options.headers || {}) },
});
// ---- 统一处理 401 认证失效 ----
if (res.status === 401) {
clearAuthState();
window.dispatchEvent(new CustomEvent("auth:expired"));
return { code: 401, msg: "认证已过期,请重新登录" };
}
return res.json();
}
@@ -189,7 +197,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 +298,89 @@ const app = createApp({
let logTimer = null;
let logFetching = false;
// ---- Ping 延迟检测(移到 setup 内部) ----
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>`;
}
// 延迟一般(1000-5000ms)—— 空心信号图标(黄色/橙色)
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() {
// 如果 frpc 未运行,直接显示 --ms
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 +405,15 @@ const app = createApp({
}
});
watch(frpcRunning, (running) => {
if (!running) {
stopPingPolling();
pingLatency.value = null; // 显示 --ms
} else if (loggedIn.value) {
startPingPolling();
}
});
async function checkUsers() {
try {
const res = await fetch("/api/check/users");
@@ -351,6 +453,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 +584,7 @@ const app = createApp({
const doLogout = () => {
if (expireTimer) clearInterval(expireTimer);
stopLogPolling();
stopPingPolling();
contentVisible.value = false;
loggedIn.value = false;
token.value = "";
@@ -637,11 +744,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() === "";
});
@@ -692,9 +798,8 @@ const app = createApp({
passwordChangeSuccess,
changePassword,
showDefaultTip,
showDefaultTip,
// 日志相关
logLines,
logTotal,
logError,
@@ -703,10 +808,14 @@ const app = createApp({
refreshLogs,
scrollLogToBottom,
// Token 显示切换
showToken,
// ---- 新增 Ping 相关导出 ----
pingLatency,
pingStatusClass,
pingIcon,
};
},
});
app.mount("#app");
app.mount("#app");
+80 -78
View File
@@ -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>
+66
View File
@@ -734,4 +734,70 @@ select:disabled {
.dialog-card {
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;
}
}
+6 -15
View File
@@ -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);