47 Commits

Author SHA1 Message Date
lxh2875931338 e1cf6f4f47 推送新的日志 2026-07-28 23:14:39 +08:00
lxh2875931338 a5c33580e2 调整部分部署逻辑 2026-07-28 22:56:45 +08:00
lxh2875931338 f2af48f8d0 调整部分部署逻辑 2026-07-28 22:50:17 +08:00
lxh2875931338 2663e71b4f 调整部分部署逻辑 2026-07-28 22:35:48 +08:00
lxh2875931338 bf24d3cb00 调整部分部署逻辑 2026-07-28 22:29:42 +08:00
lxh2875931338 00f2b9fd14 重新设计新的部署逻辑,去掉本机自己的go build,合并到docker多阶段构建部分进行 2026-07-28 22:23:39 +08:00
lxh2875931338 76ac9503c6 调整部分部署逻辑 2026-07-28 21:58:12 +08:00
lxh2875931338 04851d244f 调整部分部署逻辑 2026-07-28 21:55:33 +08:00
lxh2875931338 a2f4326882 确认部分逻辑 2026-07-28 21:50:04 +08:00
lxh2875931338 4cd438ed3e Merge branch 'test' 2026-07-28 21:24:54 +08:00
lxh2875931338 c340e3934c 更新部署逻辑 2026-07-28 21:22:31 +08:00
lxh2875931338 ef6c75aef9 需要测试相关功能 2026-07-28 20:47:41 +08:00
lxh2875931338 6904e4993f 延迟监测逻辑更新 2026-07-28 20:38:21 +08:00
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
17 changed files with 1412 additions and 665 deletions
+1 -1
View File
@@ -24,7 +24,7 @@ RUN CGO_ENABLED=0 GOOS=linux go build \
FROM alpine:latest FROM alpine:latest
# 安装 ca-certificates 和 tzdata(确保 HTTPS 和时区正常) # 安装 ca-certificates 和 tzdata(确保 HTTPS 和时区正常)
RUN apk --no-cache add ca-certificates tzdata RUN apk add --no-cache ca-certificates sqlite tzdata
WORKDIR /app WORKDIR /app
+158 -109
View File
@@ -6,11 +6,13 @@ import (
"fmt" "fmt"
"io" "io"
"io/fs" "io/fs"
"net"
"net/http" "net/http"
"os" "os"
"strconv" "strconv"
"strings" "strings"
"text/template" "text/template"
"time"
"github.com/gin-gonic/gin" "github.com/gin-gonic/gin"
"golang.org/x/crypto/bcrypt" "golang.org/x/crypto/bcrypt"
@@ -43,10 +45,13 @@ func SetupRouter() *gin.Engine {
api := r.Group("/api") api := r.Group("/api")
{ {
// ---- 公开路由(不需要认证) ----
api.GET("/check/users", checkUsersHandler) api.GET("/check/users", checkUsersHandler)
api.POST("/register", registerHandler) api.POST("/register", registerHandler)
api.POST("/login", loginHandler) api.POST("/login", loginHandler)
api.GET("/ping", pingHandler)
// ---- 需要认证的路由 ----
auth := api.Group("/") auth := api.Group("/")
auth.Use(AuthMiddleware()) auth.Use(AuthMiddleware())
{ {
@@ -75,7 +80,7 @@ func SetupRouter() *gin.Engine {
return r return r
} }
// ========== 所有 Handler ========== // ========== 认证 Handler ==========
func checkUsersHandler(c *gin.Context) { func checkUsersHandler(c *gin.Context) {
count, err := CountUsers() count, err := CountUsers()
@@ -223,6 +228,8 @@ func changePasswordHandler(c *gin.Context) {
c.JSON(http.StatusOK, gin.H{"code": 0, "msg": "密码修改成功"}) c.JSON(http.StatusOK, gin.H{"code": 0, "msg": "密码修改成功"})
} }
// ========== 配置 Handler ==========
func getConfigHandler(c *gin.Context) { func getConfigHandler(c *gin.Context) {
cfg, err := GetGlobalConfig() cfg, err := GetGlobalConfig()
if err != nil { if err != nil {
@@ -258,6 +265,8 @@ func updateConfigHandler(c *gin.Context) {
c.JSON(http.StatusOK, gin.H{"code": 0, "msg": "配置更新成功"}) c.JSON(http.StatusOK, gin.H{"code": 0, "msg": "配置更新成功"})
} }
// ========== 隧道 Handler ==========
func getProxiesHandler(c *gin.Context) { func getProxiesHandler(c *gin.Context) {
proxies, err := GetProxies() proxies, err := GetProxies()
if err != nil { if err != nil {
@@ -348,6 +357,8 @@ func deleteProxyHandler(c *gin.Context) {
c.JSON(http.StatusOK, gin.H{"code": 0, "msg": "隧道删除成功"}) c.JSON(http.StatusOK, gin.H{"code": 0, "msg": "隧道删除成功"})
} }
// ========== frpc 进程管理 Handler ==========
func reloadFrpcHandler(c *gin.Context) { func reloadFrpcHandler(c *gin.Context) {
if err := GenerateFrpcConfig(); err != nil { if err := GenerateFrpcConfig(); err != nil {
c.JSON(http.StatusInternalServerError, gin.H{"code": 2, "msg": "生成配置失败: " + err.Error()}) c.JSON(http.StatusInternalServerError, gin.H{"code": 2, "msg": "生成配置失败: " + err.Error()})
@@ -385,6 +396,144 @@ func getFrpcStatusHandler(c *gin.Context) {
c.JSON(http.StatusOK, gin.H{"code": 0, "data": gin.H{"running": running}}) c.JSON(http.StatusOK, gin.H{"code": 0, "data": gin.H{"running": running}})
} }
// ========== 日志 Handler ==========
func getFrpcLogHandler(c *gin.Context) {
lines, err := readTailLog("./frpc.log", 200)
if err != nil {
c.JSON(http.StatusOK, gin.H{
"code": 0,
"data": gin.H{
"lines": []string{},
"total": 0,
"error": err.Error(),
},
})
return
}
c.JSON(http.StatusOK, gin.H{
"code": 0,
"data": gin.H{
"lines": lines,
"total": len(lines),
},
})
}
// readTailLog 读取文件末尾 n 行(倒序读取,返回正序)
func readTailLog(filePath string, n int) ([]string, error) {
file, err := os.Open(filePath)
if err != nil {
return nil, err
}
defer file.Close()
// 获取文件大小
info, err := file.Stat()
if err != nil {
return nil, err
}
fileSize := info.Size()
if fileSize == 0 {
return []string{}, nil
}
// 从末尾开始读
const chunkSize = 4096
var lines []string
var leftover []byte
offset := fileSize
for len(lines) < n && offset > 0 {
// 计算读取起点
readSize := chunkSize
if offset < int64(chunkSize) {
readSize = int(offset)
}
offset -= int64(readSize)
// 读取这一块
buf := make([]byte, readSize)
_, err := file.ReadAt(buf, offset)
if err != nil && err != io.EOF {
return nil, err
}
// 将当前块与之前剩下的拼接
data := append(buf, leftover...)
leftover = nil
// 按行分割(从后往前)
start := 0
for i := len(data) - 1; i >= 0; i-- {
if data[i] == '\n' {
if i+1 < len(data) {
line := string(data[i+1:])
if line != "" {
lines = append([]string{line}, lines...)
if len(lines) >= n {
break
}
}
}
start = i
}
}
// 如果还没凑够,把未处理的部分留到下一轮
if len(lines) < n && start > 0 {
leftover = data[:start]
}
}
// 处理最后剩余部分(文件开头)
if len(lines) < n && len(leftover) > 0 {
parts := strings.Split(string(leftover), "\n")
for i := len(parts) - 1; i >= 0; i-- {
if parts[i] != "" {
lines = append([]string{parts[i]}, lines...)
if len(lines) >= n {
break
}
}
}
}
return lines, nil
}
// ========== Ping Handler ==========
func pingHandler(c *gin.Context) {
target := c.Query("target")
if target == "" {
c.JSON(http.StatusBadRequest, gin.H{"code": 1, "msg": "缺少 target 参数"})
return
}
cfg, err := GetGlobalConfig()
if err != nil {
c.JSON(http.StatusInternalServerError, gin.H{"code": 2, "msg": "读取配置失败"})
return
}
port := cfg.ServerPort
address := net.JoinHostPort(target, strconv.Itoa(port))
start := time.Now()
conn, err := net.DialTimeout("tcp", address, 5*time.Second)
if err != nil {
c.JSON(http.StatusOK, gin.H{"code": 1, "msg": "ping 失败", "latency": -1})
return
}
conn.Close()
latency := time.Since(start).Milliseconds()
c.JSON(http.StatusOK, gin.H{"code": 0, "latency": latency})
}
// ========== 导入/导出 TOML ==========
func importTomlHandler(c *gin.Context) { func importTomlHandler(c *gin.Context) {
file, err := c.FormFile("file") file, err := c.FormFile("file")
if err != nil { if err != nil {
@@ -470,14 +619,22 @@ func ExportTomlHandler(c *gin.Context) {
} }
} }
// 构建与 GenerateFrpcConfig 一致的数据结构
data := struct { data := struct {
*GlobalConfig *GlobalConfig
Proxies []Proxy Proxies []Proxy
WireProtocolLine string
}{ }{
GlobalConfig: cfg, GlobalConfig: cfg,
Proxies: activeProxies, Proxies: activeProxies,
} }
if cfg.WireProtocolV2 {
data.WireProtocolLine = `wireProtocol = "v2"`
} else {
data.WireProtocolLine = ""
}
tmpl, err := template.New("frpc").Parse(FrpcTemplateContent) tmpl, err := template.New("frpc").Parse(FrpcTemplateContent)
if err != nil { if err != nil {
c.JSON(http.StatusInternalServerError, gin.H{"code": 2, "msg": "解析模板失败: " + err.Error()}) c.JSON(http.StatusInternalServerError, gin.H{"code": 2, "msg": "解析模板失败: " + err.Error()})
@@ -495,114 +652,6 @@ func ExportTomlHandler(c *gin.Context) {
c.String(http.StatusOK, buf.String()) c.String(http.StatusOK, buf.String())
} }
// ========== 日志读取 ==========
func getFrpcLogHandler(c *gin.Context) {
// 读取 ./frpc.log,最多返回 200 行(最新的 200 行)
lines, err := readTailLog("./frpc.log", 200)
if err != nil {
c.JSON(http.StatusOK, gin.H{
"code": 0,
"data": gin.H{
"lines": []string{},
"total": 0,
"error": err.Error(),
},
})
return
}
c.JSON(http.StatusOK, gin.H{
"code": 0,
"data": gin.H{
"lines": lines,
"total": len(lines),
},
})
}
// readTailLog 读取文件末尾 n 行(倒序读取,返回正序)
func readTailLog(filePath string, n int) ([]string, error) {
file, err := os.Open(filePath)
if err != nil {
return nil, err
}
defer file.Close()
// 获取文件大小
info, err := file.Stat()
if err != nil {
return nil, err
}
fileSize := info.Size()
if fileSize == 0 {
return []string{}, nil
}
// 从末尾开始读
const chunkSize = 4096
var lines []string
var leftover []byte
offset := fileSize
for len(lines) < n && offset > 0 {
// 计算读取起点
readSize := chunkSize
if offset < int64(chunkSize) {
readSize = int(offset)
}
offset -= int64(readSize)
// 读取这一块
buf := make([]byte, readSize)
_, err := file.ReadAt(buf, offset)
if err != nil && err != io.EOF {
return nil, err
}
// 将当前块与之前剩下的拼接
data := append(buf, leftover...)
leftover = nil
// 按行分割
start := 0
for i := len(data) - 1; i >= 0; i-- {
if data[i] == '\n' {
if i+1 < len(data) {
line := string(data[i+1:])
if line != "" {
lines = append([]string{line}, lines...)
if len(lines) >= n {
break
}
}
}
start = i
}
}
// 如果还没凑够,把未处理的部分留到下一轮
if len(lines) < n && start > 0 {
leftover = data[:start]
}
}
// 处理最后剩余部分(文件开头)
if len(lines) < n && len(leftover) > 0 {
// 从 leftover 中提取行
parts := strings.Split(string(leftover), "\n")
for i := len(parts) - 1; i >= 0; i-- {
if parts[i] != "" {
lines = append([]string{parts[i]}, lines...)
if len(lines) >= n {
break
}
}
}
}
return lines, nil
}
func generateAndReload() error { func generateAndReload() error {
if err := GenerateFrpcConfig(); err != nil { if err := GenerateFrpcConfig(); err != nil {
return err return err
Binary file not shown.
BIN
View File
Binary file not shown.
+91
View File
@@ -0,0 +1,91 @@
package main
// ============================================================
// db-history.go - Schema 版本声明与字段映射
// ============================================================
type SchemaVersionDef struct {
Version string
TableName string
Columns map[string]ColumnDef
}
type ColumnDef struct {
Type string
NotNull bool
Default string
Primary bool
}
var schemaHistory = []SchemaVersionDef{
// v1:初始版本
{
Version: "v1",
TableName: "proxies",
Columns: map[string]ColumnDef{
"id": {Type: "INTEGER", Primary: true},
"name": {Type: "TEXT", NotNull: true},
"type": {Type: "TEXT", NotNull: true, Default: "'tcp'"},
"local_ip": {Type: "TEXT", NotNull: true},
"local_port": {Type: "INTEGER", NotNull: true},
"remote_port": {Type: "INTEGER", NotNull: true},
"enabled": {Type: "INTEGER", NotNull: true, Default: "1"},
"created_at": {Type: "DATETIME", Default: "CURRENT_TIMESTAMP"},
"updated_at": {Type: "DATETIME", Default: "CURRENT_TIMESTAMP"},
},
},
// v2:当前版本(frpc-console 2.0 LTS
{
Version: "v2",
TableName: "proxies",
Columns: map[string]ColumnDef{
"id": {Type: "INTEGER", Primary: true},
"name": {Type: "TEXT", NotNull: true},
"type": {Type: "TEXT", NotNull: true, Default: "'tcp'"},
"local_ip": {Type: "TEXT", NotNull: true},
"local_port": {Type: "INTEGER", NotNull: true},
"remote_port": {Type: "INTEGER", NotNull: true},
"enabled": {Type: "INTEGER", NotNull: true, Default: "1"},
"created_at": {Type: "DATETIME", Default: "CURRENT_TIMESTAMP"},
"updated_at": {Type: "DATETIME", Default: "CURRENT_TIMESTAMP"},
},
},
}
func getSchemaDef(version string) *SchemaVersionDef {
for _, def := range schemaHistory {
if def.Version == version {
return &def
}
}
return nil
}
func getLatestSchemaDef() *SchemaVersionDef {
if len(schemaHistory) == 0 {
return nil
}
return &schemaHistory[len(schemaHistory)-1]
}
func schemaVersionsEqual(v1, v2 *SchemaVersionDef) bool {
if v1 == nil || v2 == nil {
return false
}
if v1.TableName != v2.TableName {
return false
}
if len(v1.Columns) != len(v2.Columns) {
return false
}
for name, col1 := range v1.Columns {
col2, ok := v2.Columns[name]
if !ok {
return false
}
if col1.Type != col2.Type || col1.NotNull != col2.NotNull || col1.Default != col2.Default {
return false
}
}
return true
}
+295 -97
View File
@@ -4,15 +4,31 @@ import (
"crypto/rand" "crypto/rand"
"database/sql" "database/sql"
"encoding/hex" "encoding/hex"
"fmt"
"io"
"log" "log"
"os"
"sort"
"strings" "strings"
"time"
_ "modernc.org/sqlite" _ "modernc.org/sqlite"
) )
var DB *sql.DB var DB *sql.DB
// ===== 全局配置表(A表)===== // ============================================================
// 数据库版本常量
// ============================================================
const (
SchemaVersion = "v2" // 当前数据库 Schema 版本
)
// ============================================================
// 数据模型
// ============================================================
type GlobalConfig struct { type GlobalConfig struct {
ID int `json:"id"` ID int `json:"id"`
ServerAddr string `json:"serverAddr"` ServerAddr string `json:"serverAddr"`
@@ -25,10 +41,9 @@ type GlobalConfig struct {
HeartbeatInterval int `json:"heartbeatInterval"` HeartbeatInterval int `json:"heartbeatInterval"`
HeartbeatTimeout int `json:"heartbeatTimeout"` HeartbeatTimeout int `json:"heartbeatTimeout"`
PoolCount int `json:"poolCount"` PoolCount int `json:"poolCount"`
WireProtocolV2 bool `json:"wireProtocolV2"` // frp v2 协议开关 (v2.0 启用) WireProtocolV2 bool `json:"wireProtocolV2"`
} }
// ===== 隧道表(B表)=====
type Proxy struct { type Proxy struct {
ID int `json:"id"` ID int `json:"id"`
Name string `json:"name"` Name string `json:"name"`
@@ -39,7 +54,6 @@ type Proxy struct {
Enabled bool `json:"enabled"` Enabled bool `json:"enabled"`
} }
// ===== 用户表(C表)=====
type User struct { type User struct {
ID int `json:"id"` ID int `json:"id"`
Username string `json:"username"` Username string `json:"username"`
@@ -49,7 +63,6 @@ type User struct {
// ============================================================ // ============================================================
// 数据库初始化 // 数据库初始化
// ============================================================
func InitDB() error { func InitDB() error {
var err error var err error
@@ -58,8 +71,29 @@ func InitDB() error {
return err return err
} }
// ---- 用户表 ---- if err := createTables(); err != nil {
_, err = DB.Exec(` 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 ( CREATE TABLE IF NOT EXISTS users (
id INTEGER PRIMARY KEY AUTOINCREMENT, id INTEGER PRIMARY KEY AUTOINCREMENT,
username TEXT UNIQUE NOT NULL, username TEXT UNIQUE NOT NULL,
@@ -72,7 +106,7 @@ func InitDB() error {
return err return err
} }
// ---- 全局配置表 ---- // 全局配置表
_, err = DB.Exec(` _, err = DB.Exec(`
CREATE TABLE IF NOT EXISTS global_config ( CREATE TABLE IF NOT EXISTS global_config (
id INTEGER PRIMARY KEY CHECK (id = 1), id INTEGER PRIMARY KEY CHECK (id = 1),
@@ -94,29 +128,7 @@ func InitDB() error {
return err 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(` _, err = DB.Exec(`
CREATE TABLE IF NOT EXISTS proxies ( CREATE TABLE IF NOT EXISTS proxies (
id INTEGER PRIMARY KEY AUTOINCREMENT, id INTEGER PRIMARY KEY AUTOINCREMENT,
@@ -134,7 +146,7 @@ func InitDB() error {
return err return err
} }
// ---- 应用配置表 ---- // 应用配置表
_, err = DB.Exec(` _, err = DB.Exec(`
CREATE TABLE IF NOT EXISTS app_config ( CREATE TABLE IF NOT EXISTS app_config (
key TEXT PRIMARY KEY, key TEXT PRIMARY KEY,
@@ -146,98 +158,287 @@ func InitDB() error {
return err return err
} }
if err := ensureJwtSecret(); err != nil { // 初始化默认配置
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 return err
} }
log.Println("✅ 全局配置初始化完成")
}
log.Println("✅ 数据库初始化完成")
return nil return nil
} }
// ============================================================ // ============================================================
// Schema 迁移:自动补全缺失的字段 // 迁移引擎
// ============================================================ // ============================================================
// expectedColumns 定义所有期望的列,格式: 列名 => 完整定义 func getCurrentSchemaVersion() string {
// 新增字段时,在这里加一行即可 var version string
var expectedColumns = map[string]string{ err := DB.QueryRow("SELECT value FROM app_config WHERE key = 'schema_version'").Scan(&version)
"id": "id INTEGER PRIMARY KEY CHECK (id = 1)", if err != nil {
"server_addr": "server_addr TEXT NOT NULL DEFAULT 'frp.example.com'", if err == sql.ErrNoRows {
"server_port": "server_port INTEGER NOT NULL DEFAULT 7000", var count int
"token": "token TEXT NOT NULL DEFAULT 'CHANGE_ME'", DB.QueryRow("SELECT COUNT(*) FROM users").Scan(&count)
"log_level": "log_level TEXT NOT NULL DEFAULT 'info'", if count > 0 {
"log_max_days": "log_max_days INTEGER NOT NULL DEFAULT 3", return "v1"
"tcp_mux": "tcp_mux INTEGER NOT NULL DEFAULT 1", }
"tcp_mux_keepalive": "tcp_mux_keepalive INTEGER NOT NULL DEFAULT 30", return SchemaVersion
"heartbeat_interval": "heartbeat_interval INTEGER NOT NULL DEFAULT 15", }
"heartbeat_timeout": "heartbeat_timeout INTEGER NOT NULL DEFAULT 70", log.Printf("⚠️ 读取 Schema 版本失败: %v", err)
"pool_count": "pool_count INTEGER NOT NULL DEFAULT 8", return "v1"
"wire_protocol_v2": "wire_protocol_v2 INTEGER NOT NULL DEFAULT 0", // v1.5 新增 }
"updated_at": "updated_at DATETIME DEFAULT CURRENT_TIMESTAMP", return version
} }
func migrateGlobalConfigTable() error { func setSchemaVersion(version string) error {
// 1. 获取当前表的列名 _, err := DB.Exec(`
currentCols, err := getCurrentColumns("global_config") INSERT INTO app_config (key, value) VALUES ('schema_version', ?)
if err != nil { ON CONFLICT(key) DO UPDATE SET value = excluded.value, updated_at = CURRENT_TIMESTAMP
`, version)
return err return err
} }
// 2. 比对并补全缺失的列 func backupDatabase() (string, error) {
var added []string src := "./frpc-console.db"
for colName, colDef := range expectedColumns { if _, err := os.Stat(src); os.IsNotExist(err) {
if !contains(currentCols, colName) { return "", nil
alterSQL := "ALTER TABLE global_config ADD COLUMN " + colDef
if _, err := DB.Exec(alterSQL); err != nil {
log.Printf("⚠️ 添加列 %s 失败: %v", colName, err)
continue
}
added = append(added, colName)
}
} }
if len(added) > 0 { timestamp := time.Now().Format("20060102_150405")
log.Printf("✅ 数据库迁移完成,新增字段: %v", added) 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
}
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
}
func runMigrations() error {
currentVer := getCurrentSchemaVersion()
targetVer := SchemaVersion
log.Printf("📌 当前数据库 Schema: %s, 目标版本: %s", currentVer, targetVer)
if currentVer == targetVer {
// 检查数据库是否包含有效数据
var userCount int
err := DB.QueryRow("SELECT COUNT(*) FROM users").Scan(&userCount)
if err != nil || userCount == 0 {
log.Println(" 数据库为空或无效,无需迁移,直接初始化")
return nil
}
log.Println("✅ Schema 已是最新,数据库有效")
return nil
}
log.Printf("🔄 检测到版本变更 (%s → %s),开始迁移...", currentVer, targetVer)
backupPath, err := backupDatabase()
if err != nil {
return fmt.Errorf("备份数据库失败: %w", err)
}
if backupPath != "" {
log.Printf("📦 备份文件: %s", backupPath)
}
currentSchema := getSchemaDef(currentVer)
targetSchema := getSchemaDef(targetVer)
if targetSchema == nil {
return fmt.Errorf("目标 Schema 版本 %s 未在 schemaHistory 中定义", targetVer)
}
if currentSchema == nil || schemaVersionsEqual(currentSchema, targetSchema) {
log.Println(" 迁移类型: 轻量复制(Schema 无变更)")
// 验证数据库是否有效
var userCount int
err := DB.QueryRow("SELECT COUNT(*) FROM users").Scan(&userCount)
if err != nil || userCount == 0 {
log.Println(" 数据库为空或无效,跳过迁移,直接初始化")
return nil
}
log.Println(" 数据库有效,继续使用")
} else { } else {
log.Println("✅ 数据库 Schema 已是最新") 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 return nil
} }
// getCurrentColumns 查询指定表的所有列名 func heavyMigration(oldDef, newDef *SchemaVersionDef) error {
func getCurrentColumns(tableName string) ([]string, error) { if oldDef == nil {
rows, err := DB.Query("PRAGMA table_info(" + tableName + ")") 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 { if err != nil {
return nil, err return fmt.Errorf("构建数据迁移 SQL 失败: %w", err)
}
log.Printf(" 迁移数据: %s → %s", oldTable, newTable)
if _, err := DB.Exec(insertSQL); err != nil {
return fmt.Errorf("数据迁移失败: %w", err)
} }
defer rows.Close()
var oldCount, newCount int
DB.QueryRow(fmt.Sprintf("SELECT COUNT(*) FROM %s", oldTable)).Scan(&oldCount)
DB.QueryRow(fmt.Sprintf("SELECT COUNT(*) FROM %s", newTable)).Scan(&newCount)
if oldCount != newCount {
return fmt.Errorf("数据迁移不完整: 旧表 %d 行,新表 %d 行", oldCount, newCount)
}
log.Printf(" 数据迁移验证通过: %d 行", newCount)
tempTable := oldTable + "_old_temp"
if _, err := DB.Exec(fmt.Sprintf("ALTER TABLE %s RENAME TO %s", oldTable, tempTable)); err != nil {
return fmt.Errorf("重命名旧表失败: %w", err)
}
if _, err := DB.Exec(fmt.Sprintf("ALTER TABLE %s RENAME TO %s", newTable, oldTable)); err != nil {
DB.Exec(fmt.Sprintf("ALTER TABLE %s RENAME TO %s", tempTable, oldTable))
return fmt.Errorf("重命名新表失败: %w", err)
}
if _, err := DB.Exec(fmt.Sprintf("DROP TABLE %s", tempTable)); err != nil {
log.Printf("⚠️ 删除临时表失败(不影响使用): %v", err)
}
log.Printf(" 表交换完成: %s (新表已生效)", oldTable)
return nil
}
func buildCreateTableSQL(tableName string, def *SchemaVersionDef) string {
var cols []string var cols []string
for rows.Next() { var primaryKey string
var (
cid int names := make([]string, 0, len(def.Columns))
name string for name := range def.Columns {
typ string names = append(names, name)
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) 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 cols, rows.Err()
} }
func contains(slice []string, item string) bool { if primaryKey != "" {
for _, s := range slice { cols = append(cols, primaryKey)
if strings.EqualFold(s, item) { }
return true
return fmt.Sprintf("CREATE TABLE %s (\n %s\n)", tableName, strings.Join(cols, ",\n "))
}
func buildInsertSQL(oldTable, newTable string, oldDef, newDef *SchemaVersionDef) (string, error) {
newCols := make([]string, 0, len(newDef.Columns))
for name := range newDef.Columns {
newCols = append(newCols, name)
}
sort.Strings(newCols)
var selectParts []string
var colNames []string
for _, name := range newCols {
colNames = append(colNames, name)
if _, ok := oldDef.Columns[name]; ok {
selectParts = append(selectParts, name)
} else {
colDef := newDef.Columns[name]
if colDef.Default != "" {
selectParts = append(selectParts, colDef.Default+" AS "+name)
} else if colDef.Type == "INTEGER" {
selectParts = append(selectParts, "0 AS "+name)
} else if colDef.Type == "TEXT" {
selectParts = append(selectParts, "'' AS "+name)
} else {
selectParts = append(selectParts, "NULL AS "+name)
} }
} }
return false }
return fmt.Sprintf(
"INSERT INTO %s (%s) SELECT %s FROM %s",
newTable,
strings.Join(colNames, ", "),
strings.Join(selectParts, ", "),
oldTable,
), nil
} }
// ============================================================ // ============================================================
@@ -263,7 +464,7 @@ func ensureJwtSecret() error {
if err != nil { if err != nil {
return err return err
} }
log.Printf("✅ JWT 密钥已生成并保存到数据库") log.Printf("✅ JWT 密钥已生成")
return nil return nil
} }
@@ -338,10 +539,7 @@ func GetProxies() ([]Proxy, error) {
} }
proxies = append(proxies, p) proxies = append(proxies, p)
} }
if err = rows.Err(); err != nil { return proxies, rows.Err()
return nil, err
}
return proxies, nil
} }
func GetProxy(id int) (*Proxy, error) { func GetProxy(id int) (*Proxy, error) {
+346 -209
View File
@@ -1,30 +1,65 @@
#!/bin/bash #!/bin/bash
# ============================================================ # ============================================================
# frpc-console 一键部署脚本 # frpc-console 一键部署脚本Docker 优先)
# 支持:Linux x86_64 / ARM64 / ARMv7 # 支持:Linux x86_64 / ARM64 / ARMv7
# 自动安装:git / curl / wget / Go / Docker # 自动安装:git / curl / wget / Docker
#
# 用法:
# ./deploy.sh # 完整交互流程
# ./deploy.sh --yes # 跳过确认,直接执行
# ./deploy.sh --check # 只检测环境,不执行
# ./deploy.sh --dry-run # 显示将执行的操作,不实际执行
# ============================================================ # ============================================================
set -e set -e
# ---------- 颜色输出 ---------- # ---------- 颜色检测 ----------
if [ -t 1 ]; then
RED='\033[0;31m' RED='\033[0;31m'
GREEN='\033[0;32m' GREEN='\033[0;32m'
YELLOW='\033[1;33m' YELLOW='\033[1;33m'
BLUE='\033[0;34m' BLUE='\033[0;34m'
CYAN='\033[0;36m' CYAN='\033[0;36m'
MAGENTA='\033[0;35m'
NC='\033[0m' NC='\033[0m'
else
RED=''
GREEN=''
YELLOW=''
BLUE=''
CYAN=''
MAGENTA=''
NC=''
fi
# ---------- 配置 ---------- # ---------- 配置 ----------
REPO_URL="https://git.whitetop.xyz/lxh2875931338/frpc-console.git" REPO_URL="https://git.whitetop.xyz/lxh2875931338/frpc-console.git"
BRANCH="main" BRANCH="main"
WORK_DIR="/tmp/frpc-console-build" WORK_DIR="/tmp/frpc-console-build"
DEPLOY_DIR="/opt/frpc-console"
DATA_DIR="${DEPLOY_DIR}/data"
DEFAULT_PORT=9300 DEFAULT_PORT=9300
DEFAULT_DEPLOY_DIR="/opt/frpc-console"
IMAGE_NAME="frpc-console" IMAGE_NAME="frpc-console"
GO_VERSION="1.25.0"
# ---------- 状态变量 ----------
OS=""
OS_VERSION=""
ARCH=""
HAS_GIT=false
HAS_CURL=false
HAS_WGET=false
HAS_DOCKER=false
NEED_INSTALL_GIT=false
NEED_INSTALL_CURL=false
NEED_INSTALL_WGET=false
PORT=${DEFAULT_PORT}
DEPLOY_DIR=${DEFAULT_DEPLOY_DIR}
DATA_DIR="${DEPLOY_DIR}/data"
CONTAINER_EXISTS=false
CONTAINER_RUNNING=false
SKIP_CONFIRM=false
CHECK_ONLY=false
DRY_RUN=false
# ---------- 打印函数 ---------- # ---------- 打印函数 ----------
print_info() { echo -e "${BLUE}[INFO]${NC} $1"; } print_info() { echo -e "${BLUE}[INFO]${NC} $1"; }
@@ -32,16 +67,51 @@ print_success() { echo -e "${GREEN}[✓]${NC} $1"; }
print_warn() { echo -e "${YELLOW}[⚠]${NC} $1"; } print_warn() { echo -e "${YELLOW}[⚠]${NC} $1"; }
print_error() { echo -e "${RED}[✗]${NC} $1"; } print_error() { echo -e "${RED}[✗]${NC} $1"; }
print_step() { echo -e "\n${CYAN}${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 ---------- # ---------- 检查 root ----------
check_root() {
if [ "$EUID" -ne 0 ]; then if [ "$EUID" -ne 0 ]; then
print_error "请使用 root 权限运行此脚本" print_error "请使用 root 权限运行此脚本"
echo " sudo bash deploy.sh" echo " sudo bash deploy.sh"
exit 1 exit 1
fi fi
}
# ---------- 1. 检测操作系统 ---------- # ---------- 检测操作系统 ----------
print_step "检测操作系统..." detect_os() {
if [ -f /etc/os-release ]; then if [ -f /etc/os-release ]; then
. /etc/os-release . /etc/os-release
OS=$ID OS=$ID
@@ -50,143 +120,70 @@ else
print_error "无法识别操作系统" print_error "无法识别操作系统"
exit 1 exit 1
fi fi
print_info "系统: $OS $OS_VERSION" }
# ---------- 2. 检测 CPU 架构 ---------- # ---------- 检测 CPU 架构 ----------
print_step "检测 CPU 架构..." detect_arch() {
ARCH=$(uname -m) ARCH=$(uname -m)
case $ARCH in case $ARCH in
x86_64|amd64) x86_64|amd64|aarch64|arm64|armv7l|armhf)
GO_ARCH="amd64" print_success "CPU 架构: $ARCH"
;;
aarch64|arm64)
GO_ARCH="arm64"
;;
armv7l|armhf)
GO_ARCH="armv6l"
;; ;;
*) *)
print_error "不支持的 CPU 架构: $ARCH" print_error "不支持的 CPU 架构: $ARCH"
exit 1 exit 1
;; ;;
esac esac
print_success "CPU 架构: $ARCH → Go 架构: $GO_ARCH" }
# ---------- 3. 安装必要工具 ---------- # ---------- 检测工具 ----------
print_step "检查必要工具..." check_tools() {
command -v git &> /dev/null && HAS_GIT=true || NEED_INSTALL_GIT=true
command -v curl &> /dev/null && HAS_CURL=true || NEED_INSTALL_CURL=true
command -v wget &> /dev/null && HAS_WGET=true || NEED_INSTALL_WGET=true
command -v docker &> /dev/null && HAS_DOCKER=true
}
# git # ---------- 检查容器状态 ----------
if ! command -v git &> /dev/null; then check_container() {
print_warn "git 未安装,正在安装..." if docker ps -a --format '{{.Names}}' 2>/dev/null | grep -q "^frpc-console$"; then
case $OS in CONTAINER_EXISTS=true
opensuse*|suse*|opensuse-tumbleweed|opensuse-slowroll) if docker ps --format '{{.Names}}' 2>/dev/null | grep -q "^frpc-console$"; then
zypper install -y git CONTAINER_RUNNING=true
;; fi
ubuntu|debian|linuxmint) fi
apt update -qq && apt install -y git }
;;
centos|rhel|fedora|rocky|almalinux) # ---------- 检测结果汇总 ----------
yum install -y git print_environment_summary() {
;; print_title
alpine) print_subtitle "环境检测结果"
apk add git echo ""
;; echo -e " ${CYAN}操作系统:${NC} $OS $OS_VERSION"
*) echo -e " ${CYAN}CPU 架构:${NC} $ARCH"
print_error "无法识别包管理器,请手动安装 git" echo ""
exit 1 echo " ${CYAN}必要工具:${NC}"
;; if [ "$HAS_GIT" = true ]; then
esac echo -e " git ✅ 已安装 ($(git --version | awk '{print $3}'))"
print_success "git 安装完成"
else else
print_success "git 已安装: $(git --version | awk '{print $3}')" echo " git ❌ 未安装 (将自动安装)"
fi fi
if [ "$HAS_CURL" = true ]; then
# curl echo " 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 else
print_success "curl 已安装" echo " curl ❌ 未安装 (将自动安装)"
fi fi
if [ "$HAS_WGET" = true ]; then
# wget(备用) echo " 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 else
print_success "wget 已安装" echo " wget ❌ 未安装 (将自动安装)"
fi fi
echo ""
# ---------- 4. 安装 Go ---------- echo " ${CYAN}Docker 环境:${NC}"
print_step "检查 Go 环境..." if [ "$HAS_DOCKER" = true ]; then
if ! command -v go &> /dev/null; then echo -e " docker ✅ 已安装 ($(docker --version | awk '{print $3}' | tr -d ','))"
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"
else else
print_info "正在下载..." echo " docker ❌ 未安装"
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
# 安装 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
# 配置 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_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" print_error "Docker 未安装,请先安装 Docker"
echo "" echo ""
echo " 快速安装:" echo " 快速安装:"
@@ -194,98 +191,172 @@ if ! command -v docker &> /dev/null; then
echo " systemctl enable --now docker" echo " systemctl enable --now docker"
echo "" echo ""
exit 1 exit 1
else
print_success "Docker 已安装: $(docker --version | awk '{print $3}' | tr -d ',')"
fi fi
# ---------- 6. 交互式配置 ---------- if [ "$CONTAINER_EXISTS" = true ]; then
print_step "部署配置" echo ""
read -p "监听端口 [${DEFAULT_PORT}]: " PORT echo " ${CYAN}容器状态:${NC}"
PORT=${PORT:-$DEFAULT_PORT} if [ "$CONTAINER_RUNNING" = true ]; then
echo -e " frpc-console ✅ 运行中 (将停止并重建)"
else
echo -e " frpc-console ⏸️ 已停止 (将重建)"
fi
echo -e " ${YELLOW}数据目录中的数据库文件将被保留${NC}"
fi
echo ""
}
read -p "部署目录 [${DEPLOY_DIR}]: " DEPLOY_DIR_INPUT # ---------- 生成操作列表 ----------
DEPLOY_DIR=${DEPLOY_DIR_INPUT:-$DEPLOY_DIR} 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
PLAN="${PLAN} • 拉取 frpc-console 源码 (${BRANCH} 分支)\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" 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 ""
}
print_info "端口: $PORT" # ---------- 执行部署 ----------
print_info "部署目录: $DEPLOY_DIR" do_deploy() {
print_info "数据目录: $DATA_DIR" print_title
print_subtitle "开始部署"
echo ""
# ---------- 7. 拉取代码 ---------- # ----- 事务前钩子:备份数据库 -----
print_step "备份数据库..."
BACKUP_DIR="/tmp/frpc-console/db-backups"
mkdir -p "$BACKUP_DIR"
DB_FILE="${DEPLOY_DIR}/frpc-console.db"
if [ -f "$DB_FILE" ]; then
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
BACKUP_FILE="$BACKUP_DIR/frpc-console.db.$TIMESTAMP"
cp "$DB_FILE" "$BACKUP_FILE"
print_info "已备份: $BACKUP_FILE"
if command -v sqlite3 &> /dev/null; then
if ! sqlite3 "$DB_FILE" "SELECT COUNT(*) FROM sqlite_master WHERE type='table' AND name='users';" 2>/dev/null | grep -q "^1$"; then
print_warn "数据库文件无效,将删除,由容器全新初始化"
rm -f "$DB_FILE"
else
print_info "数据库有效,保留"
fi
else
print_warn "sqlite3 未安装,无法检查数据库有效性,保留原文件"
fi
else
print_info "数据库文件不存在,跳过备份"
fi
# ----- 拉取代码 -----
print_step "拉取代码..." print_step "拉取代码..."
rm -rf "$WORK_DIR" rm -rf "$WORK_DIR"
git clone --depth 1 --branch "$BRANCH" "$REPO_URL" "$WORK_DIR" git clone --depth 1 --branch "$BRANCH" "$REPO_URL" "$WORK_DIR"
cd "$WORK_DIR" cd "$WORK_DIR"
# 确保目录存在
mkdir -p bin static mkdir -p bin static
print_success "代码拉取完成" print_success "代码拉取完成"
# ---------- 8. 修复 go.mod 版本(防止 toolchain 下载) ---------- # ----- 停止旧容器(拉取代码之后)-----
print_step "检查 go.mod..." if [ "$CONTAINER_EXISTS" = true ]; then
if grep -q "go 1.26" go.mod 2>/dev/null; then print_step "停止旧容器..."
print_warn "检测到 go.mod 版本过高,自动降级到 go 1.21" if [ "$CONTAINER_RUNNING" = true ]; then
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 stop frpc-console 2>/dev/null || true
fi
docker rm frpc-console 2>/dev/null || true docker rm frpc-console 2>/dev/null || true
print_success "旧容器已清理" print_success "旧容器已清理"
fi fi
# ---------- 14. 启动新容器 ---------- # ----- 准备部署目录 -----
print_step "准备部署目录..."
mkdir -p "$DEPLOY_DIR"
mkdir -p "$DATA_DIR"
if [ -f "$DB_FILE" ]; then
print_info "数据库文件存在,将保留"
else
print_info "数据库文件不存在,容器启动时将自动创建"
fi
# ----- 构建 Docker 镜像(内部自动处理 go.mod 降级)-----
print_step "构建 Docker 镜像..."
docker build -t "${IMAGE_NAME}:latest" .
print_success "Docker 镜像构建完成: ${IMAGE_NAME}:latest"
# ----- 启动新容器 -----
print_step "启动 frpc-console 容器..." print_step "启动 frpc-console 容器..."
docker run -d \ docker run -d \
--name frpc-console \ --name frpc-console \
--restart=always \ --restart=always \
--network host \ --network host \
-v ${DATA_DIR}:/app/data \ -v ${DEPLOY_DIR}:/app \
-e PORT=9300 \ -e PORT=${PORT} \
-e TZ=Asia/Shanghai \ -e TZ=Asia/Shanghai \
${IMAGE_NAME}:latest ${IMAGE_NAME}:latest
@@ -296,35 +367,101 @@ else
exit 1 exit 1
fi fi
# ---------- 15. 检查 frpc 子进程 ---------- # ----- 检查 frpc 子进程 -----
print_step "检查 frpc 状态..." print_step "检查 frpc 状态..."
sleep 3 sleep 3
if docker ps --format '{{.Names}}' | grep -q "^frpc-console$"; then
if docker exec frpc-console ps aux 2>/dev/null | grep -q "[f]rpc -c"; then if docker exec frpc-console ps aux 2>/dev/null | grep -q "[f]rpc -c"; then
print_success "frpc 进程运行正常" print_success "frpc 进程运行正常"
else else
print_warn "frpc 进程未运行(可能配置为空,请在 WebUI 中导入 TOML" print_warn "frpc 进程未运行(可能配置为空,请在 WebUI 中导入 TOML"
fi fi
else
print_error "frpc-console 容器未运行,请检查日志"
exit 1
fi
# ---------- 16. 清理临时文件 ---------- # ----- 事务后钩子:检测数据库 -----
print_step "验证数据库状态..."
if docker exec frpc-console sqlite3 /app/frpc-console.db "SELECT COUNT(*) FROM users;" 2>/dev/null | grep -q "^[0-9]"; then
print_success "数据库可用"
else
print_warn "数据库为空或不可用,请通过 WebUI 注册管理员账户"
fi
# ----- 清理临时文件 -----
print_step "清理临时文件..." print_step "清理临时文件..."
rm -rf "$WORK_DIR" rm -rf "$WORK_DIR"
print_success "临时文件已清理" print_success "临时文件已清理"
# ---------- 17. 输出信息 ---------- # ----- 输出信息 -----
print_title
print_success "frpc-console 部署完成!"
print_title
echo "" echo ""
echo "==========================================" echo -e " ${CYAN}📍 访问地址:${NC} http://$(hostname -I | awk '{print $1}'):${PORT}"
echo -e "${GREEN}✅ frpc-console 部署完成!${NC}" echo -e " ${CYAN}📂 数据目录:${NC} ${DEPLOY_DIR}"
echo "==========================================" echo -e " ${CYAN}📦 备份目录:${NC} /tmp/frpc-console/db-backups"
echo -e " ${CYAN}🐳 容器名称:${NC} frpc-console"
echo "" echo ""
echo "📍 访问地址: http://$(hostname -I | awk '{print $1}'):${PORT}" echo -e " ${CYAN}常用命令:${NC}"
echo "📂 数据目录: ${DATA_DIR}"
echo "🐳 容器名称: frpc-console"
echo ""
echo "常用命令:(可提前复制,如果有宝塔或者1panel那当我没说)"
echo " docker logs frpc-console # 查看日志" echo " docker logs frpc-console # 查看日志"
echo " docker restart frpc-console # 重启服务" echo " docker restart frpc-console # 重启服务"
echo " docker stop frpc-console # 停止服务" echo " docker stop frpc-console # 停止服务"
echo " docker start frpc-console # 启动服务" echo " docker start frpc-console # 启动服务"
echo "" echo ""
echo "首次访问需要注册管理员账户" echo -e " ${YELLOW}首次访问需要注册管理员账户${NC}"
echo "==========================================" 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
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
if [ "$DRY_RUN" = true ]; then
print_info "演练模式(--dry-run),不实际执行部署"
exit 0
fi
do_deploy
}
main "$@"
+25 -24
View File
@@ -27,10 +27,10 @@ var (
frpcPathMutex sync.Mutex frpcPathMutex sync.Mutex
) )
// getFrpcPath 获取 frpc 路径,优先级: // ============================================================
// 1. 当前目录 ./bin/<platform> (便于用户手动管理 frpc 版本) // 获取 frpc 路径
// 2. embed 解压到 /tmp (便于开箱即用) // ============================================================
// 3. 系统 PATH 中的 frpc (降级方案)
func getFrpcPath() (string, error) { func getFrpcPath() (string, error) {
frpcPathMutex.Lock() frpcPathMutex.Lock()
defer frpcPathMutex.Unlock() defer frpcPathMutex.Unlock()
@@ -46,14 +46,12 @@ func getFrpcPath() (string, error) {
switch { switch {
case runtime.GOOS == "windows" && runtime.GOARCH == "amd64": case runtime.GOOS == "windows" && runtime.GOARCH == "amd64":
fileName = "frpc_windows_amd64.exe" fileName = "frpc_windows_amd64.exe"
case runtime.GOOS == "windows" && runtime.GOARCH == "386":
fileName = "frpc_windows_386.exe"
case runtime.GOOS == "linux" && runtime.GOARCH == "amd64": case runtime.GOOS == "linux" && runtime.GOARCH == "amd64":
fileName = "frpc_linux_amd64" fileName = "frpc_linux_amd64"
case runtime.GOOS == "linux" && runtime.GOARCH == "arm64": case runtime.GOOS == "linux" && runtime.GOARCH == "arm64":
fileName = "frpc_linux_arm64" fileName = "frpc_linux_arm64"
case runtime.GOOS == "linux" && runtime.GOARCH == "arm": case runtime.GOOS == "linux" && runtime.GOARCH == "arm":
fileName = "frpc_linux_armv7" fileName = "frpc_linux_arm_hf"
default: default:
path, err := exec.LookPath("frpc") path, err := exec.LookPath("frpc")
if err == nil { if err == nil {
@@ -70,7 +68,7 @@ func getFrpcPath() (string, error) {
return localPath, nil return localPath, nil
} }
// 优先级2embed 解压到临时目录 // 优先级2embed 解压
data, err := embeddedFrpc.ReadFile("bin/" + fileName) data, err := embeddedFrpc.ReadFile("bin/" + fileName)
if err == nil { if err == nil {
tmpPath := filepath.Join(os.TempDir(), "frpc") tmpPath := filepath.Join(os.TempDir(), "frpc")
@@ -94,10 +92,13 @@ func getFrpcPath() (string, error) {
return path, nil return path, nil
} }
return "", fmt.Errorf("未找到 frpc 文件 (本地 bin/、embed、PATH 均无)") return "", fmt.Errorf("未找到 frpc 文件")
} }
// GenerateFrpcConfig 生成 frpc.toml // ============================================================
// 生成 frpc.tomlv2.0 支持 wireProtocol
// ============================================================
func GenerateFrpcConfig() error { func GenerateFrpcConfig() error {
cfg, err := GetGlobalConfig() cfg, err := GetGlobalConfig()
if err != nil { if err != nil {
@@ -116,14 +117,24 @@ func GenerateFrpcConfig() error {
} }
} }
// 构建模板数据
data := struct { data := struct {
*GlobalConfig *GlobalConfig
Proxies []Proxy Proxies []Proxy
WireProtocolLine string // v2 协议配置行(为空则不输出)
}{ }{
GlobalConfig: cfg, GlobalConfig: cfg,
Proxies: activeProxies, Proxies: activeProxies,
} }
// v2.0: 如果启用 v2 协议,生成配置行
if cfg.WireProtocolV2 {
data.WireProtocolLine = `wireProtocol = "v2"`
} else {
data.WireProtocolLine = "" // 不输出,使用默认 v1
}
// 读取模板
var tmplContent string var tmplContent string
if _, err := os.Stat("frpc.tmpl"); err == nil { if _, err := os.Stat("frpc.tmpl"); err == nil {
content, readErr := os.ReadFile("frpc.tmpl") content, readErr := os.ReadFile("frpc.tmpl")
@@ -153,7 +164,10 @@ func GenerateFrpcConfig() error {
return nil return nil
} }
// isFrpcRunning 通过 PID 文件检查 frpc 是否在运行 // ============================================================
// frpc 进程管理
// ============================================================
func isFrpcRunning() bool { func isFrpcRunning() bool {
pidData, err := os.ReadFile("./frpc.pid") pidData, err := os.ReadFile("./frpc.pid")
if err != nil { if err != nil {
@@ -165,7 +179,6 @@ func isFrpcRunning() bool {
} }
if runtime.GOOS == "windows" { if runtime.GOOS == "windows" {
// Windows 用 tasklist 检查
cmd := exec.Command("tasklist", "/FI", "PID eq", strconv.Itoa(pid)) cmd := exec.Command("tasklist", "/FI", "PID eq", strconv.Itoa(pid))
output, err := cmd.CombinedOutput() output, err := cmd.CombinedOutput()
if err != nil { if err != nil {
@@ -174,7 +187,6 @@ func isFrpcRunning() bool {
return strings.Contains(string(output), strconv.Itoa(pid)) return strings.Contains(string(output), strconv.Itoa(pid))
} }
// Linux/Unix: 用 kill 0 检查进程是否存在
process, err := os.FindProcess(pid) process, err := os.FindProcess(pid)
if err != nil { if err != nil {
return false return false
@@ -182,7 +194,6 @@ func isFrpcRunning() bool {
return process.Signal(syscall.Signal(0)) == nil return process.Signal(syscall.Signal(0)) == nil
} }
// StartFrpc 启动 frpc(独立进程,脱离父进程)
func StartFrpc() error { func StartFrpc() error {
frpcPath, err := getFrpcPath() frpcPath, err := getFrpcPath()
if err != nil { if err != nil {
@@ -199,16 +210,12 @@ func StartFrpc() error {
return nil return nil
} }
// 清理旧的 PID 文件
os.Remove("./frpc.pid") os.Remove("./frpc.pid")
cmd := exec.Command(frpcPath, "-c", "./frpc.toml") cmd := exec.Command(frpcPath, "-c", "./frpc.toml")
setWindowHide(cmd) setWindowHide(cmd)
// ✅ 设置进程属性(Unix: Setsid 脱离父进程,Windows: 不处理)
setSysProcAttr(cmd) setSysProcAttr(cmd)
// 把输出重定向到日志文件
logFile, err := os.OpenFile("./frpc.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644) logFile, err := os.OpenFile("./frpc.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
if err != nil { if err != nil {
return fmt.Errorf("打开日志文件失败: %w", err) return fmt.Errorf("打开日志文件失败: %w", err)
@@ -220,7 +227,6 @@ func StartFrpc() error {
return fmt.Errorf("启动 frpc 失败: %w", err) return fmt.Errorf("启动 frpc 失败: %w", err)
} }
// ✅ 保存 PID 到文件
if err := os.WriteFile("./frpc.pid", []byte(fmt.Sprintf("%d", cmd.Process.Pid)), 0644); err != nil { if err := os.WriteFile("./frpc.pid", []byte(fmt.Sprintf("%d", cmd.Process.Pid)), 0644); err != nil {
return fmt.Errorf("保存 PID 失败: %w", err) return fmt.Errorf("保存 PID 失败: %w", err)
} }
@@ -228,7 +234,6 @@ func StartFrpc() error {
return nil return nil
} }
// StopFrpc 停止 frpc(通过 PID 文件精准杀进程)
func StopFrpc() error { func StopFrpc() error {
if runtime.GOOS == "windows" { if runtime.GOOS == "windows" {
cmd := exec.Command("taskkill", "/F", "/IM", "frpc.exe") cmd := exec.Command("taskkill", "/F", "/IM", "frpc.exe")
@@ -239,10 +244,8 @@ func StopFrpc() error {
return nil return nil
} }
// Linux: 读取 PID 文件精准杀进程
pidData, err := os.ReadFile("./frpc.pid") pidData, err := os.ReadFile("./frpc.pid")
if err != nil { if err != nil {
// 降级到 pkill
cmd := exec.Command("pkill", "-f", "frpc") cmd := exec.Command("pkill", "-f", "frpc")
if err := cmd.Run(); err != nil && !strings.Contains(err.Error(), "no process") { if err := cmd.Run(); err != nil && !strings.Contains(err.Error(), "no process") {
return fmt.Errorf("停止 frpc 失败: %w", err) return fmt.Errorf("停止 frpc 失败: %w", err)
@@ -265,12 +268,10 @@ func StopFrpc() error {
return nil return nil
} }
// GetFrpcStatus 获取 frpc 运行状态(通过 PID 文件)
func GetFrpcStatus() (bool, error) { func GetFrpcStatus() (bool, error) {
return isFrpcRunning(), nil return isFrpcRunning(), nil
} }
// ReloadFrpc 热加载,失败时自动降级为重启
func ReloadFrpc() error { func ReloadFrpc() error {
running := isFrpcRunning() running := isFrpcRunning()
if !running { if !running {
+3
View File
@@ -15,6 +15,9 @@ tcpMuxKeepaliveInterval = {{.TcpMuxKeepalive}}
heartbeatInterval = {{.HeartbeatInterval}} heartbeatInterval = {{.HeartbeatInterval}}
heartbeatTimeout = {{.HeartbeatTimeout}} heartbeatTimeout = {{.HeartbeatTimeout}}
poolCount = {{.PoolCount}} poolCount = {{.PoolCount}}
{{if .WireProtocolLine}}
{{.WireProtocolLine}}
{{end}}
[webServer] [webServer]
addr = "127.0.0.1:7400" addr = "127.0.0.1:7400"
+5 -3
View File
@@ -1,13 +1,15 @@
## 🐳 Docker 版安装指南 ## 🐳 Docker 版安装指南
> 推荐方式:一键脚本自动部署,无需手动编译,无需安装 Go 环境。 > 推荐方式:一键脚本自动部署,无需手动编译,无需安装 Go 环境。</br>
> ⚠️ **注意**:Docker 版直接从源码构建,使用的是当前 `main` 分支的最新代码,更新进度会远快于 Release 版本。⚠️</br>
> 如需使用特定版本(如 LTS),请查看 [Releases](https://git.whitetop.xyz/lxh2875931338/frpc-console/releases) 确认版本号,并通过二进制方式部署指定版本。
### 一、📥 前置条件 ### 一、📥 前置条件
- 已安装 Docker(必须) - 已安装 Docker(必须)
- 已安装 curl / wget(脚本会自动检查并安装) - 已安装 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 | | 检测 CPU 架构 | 自动适配 x86_64 / ARM64 / ARMv7 |
| 安装依赖 | git / curl / wget(如未安装) | | 安装依赖 | git / curl / wget(如未安装) |
| 安装 Go | 从国内镜像下载,自动配置代理 | | 安装 Go | 从国内镜像下载,自动配置代理 |
+82 -21
View File
@@ -35,17 +35,20 @@
适用于 Linux / Windows,无需 Docker,单文件运行。 适用于 Linux / Windows,无需 Docker,单文件运行。
👉 详见:[二进制安装指南](./INSTALL_BINARY.md) 👉 详见:([二进制安装指南](https://git.whitetop.xyz/lxh2875931338/frpc-console/src/branch/main/install_binary.md))
### 🐳 Docker 部署(一键脚本) ### 🐳 Docker 部署(一键脚本)
适用于 Linux 服务器,自动编译 + 自动部署。 适用于 Linux 服务器,自动编译 + 自动部署。
> ⚠️ **注意**:Docker 版直接从源码构建,使用的是当前 `main` 分支的最新代码,更新进度会远快于 Release 版本。⚠️</br>
> 如需使用特定版本(如 LTS),请查看 [Releases](https://git.whitetop.xyz/lxh2875931338/frpc-console/releases) 确认版本号,并通过二进制方式部署指定版本。
```bash ```bash
curl -sSL https://git.whitetop.xyz/lxh2875931338/frpc-console/raw/main/deploy.sh | sudo bash curl -sSL https://git.whitetop.xyz/lxh2875931338/frpc-console/raw/main/deploy.sh | sudo bash
``` ```
👉 详见:[Docker 安装指南](./INSTALL_DOCKER.md) 👉 详见:([Docker 安装指南](https://git.whitetop.xyz/lxh2875931338/frpc-console/src/branch/main/install_docker.md))
### 🔧 源码编译 ### 🔧 源码编译
@@ -77,11 +80,13 @@ frpc-console/
│ ├── app.js │ ├── app.js
│ ├── style-1.css # 全局基础样式 │ ├── style-1.css # 全局基础样式
│ ├── style-2.css # 登录页样式 │ ├── style-2.css # 登录页样式
── style-3.css # 主界面样式 ── style-3.css # 主界面样式
└── style-4.css
├── bin/ # 内嵌 frpc 二进制 (多平台) ├── bin/ # 内嵌 frpc 二进制 (多平台)
│ ├── frpc_windows_amd64.exe │ ├── frpc_windows_amd64.exe
│ ├── frpc_linux_amd64 │ ├── frpc_linux_amd64
── frpc_linux_arm64 ── frpc_linux_arm64
│ └── frpc_linux_arm_hf
├── frpc.tmpl # frpc 配置模板 ├── frpc.tmpl # frpc 配置模板
├── Dockerfile ├── Dockerfile
└── go.mod └── go.mod
@@ -98,9 +103,9 @@ frpc-console/
### 数据存储 ### 数据存储
· 数据库文件:./frpc-console.db · 数据库文件:./frpc-console.db</br>
· frpc 配置文件:./frpc.toml · frpc 配置文件:./frpc.toml</br>
· frpc 日志文件:./frpc.log · frpc 日志文件:./frpc.log</br>
--- ---
@@ -140,7 +145,14 @@ go build -ldflags="-s -w" -o frpc-console .
#### Q: frpc 启动失败怎么办? #### 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 版本? #### Q: 支持哪些 frp 版本?
@@ -169,7 +181,7 @@ Podux 是个好项目,理念上和我们是一致的:用 Web 界面管理 fr
| 部署方式 | 单二进制 / Docker | 单二进制 / Docker | | 部署方式 | 单二进制 / 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 界面? ### 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 的所有功能吗? ### Q: 支持 frp 的所有功能吗?
frpc-console 覆盖了 frp 最核心的 **TCP 隧道管理** 功能,包括 `tcpMux`、负载均衡、心跳配置等。如果你有更复杂的需求(比如 STCP、XTCP、P2P),欢迎提 issue,我们会评估是否加入。 frpc-console 覆盖了 frp 最核心的 **TCP 隧道管理** 功能,包括 `tcpMux`、负载均衡、心跳配置等。如果你有更复杂的需求(比如 STCP、XTCP、P2P),欢迎提 issue,我们会评估是否加入。
@@ -196,28 +255,30 @@ frpc-console 遵循 **“够用就好”** 的原则:
2. **能用 SQLite 就不用 PostgreSQL,能用 Vue CDN 就不用 React 全家桶。** 2. **能用 SQLite 就不用 PostgreSQL,能用 Vue CDN 就不用 React 全家桶。**
3. **前端能做的事,后端不加额外复杂度。** 3. **前端能做的事,后端不加额外复杂度。**
4. **删掉一个容器等于删掉所有垃圾,所以用 Docker 隔离是对的。** 4. **删掉一个容器等于删掉所有垃圾,所以用 Docker 隔离是对的。**
5. **面板的存在应该是为了服务业务的,而不该是反过来主导业务的。**
--- ---
## 📝 更新日志 ## 📝 更新日志
### 1.0-Release (2026-07-24) 完整更新日志请查看[update-logs](https://git.whitetop.xyz/lxh2875931338/frpc-console/src/branch/main/update-logs.md)
· 🎉 首次发布</br>
· ✨ 支持隧道增删改查</br>
· ✨ 支持 TOML 导入/导出</br>
· ✨ 首次启动 Web 注册</br>
· ✨ 深色磨砂玻璃 UI</br>
· ✨ 多平台 frpc 自动适配</br>
· 🐳 Docker 镜像支持
### 2.0-Release (正在修整,后续开发)
--- ---
## 📄 许可证 ## 📄 许可证
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{ var platforms = []Platform{
{"windows", "amd64", "Windows x86-64", ".exe"}, {"windows", "amd64", "Windows x86-64", ".exe"},
{"windows", "386", "Windows x86", ".exe"},
{"linux", "amd64", "Linux x86-64", ""}, {"linux", "amd64", "Linux x86-64", ""},
{"linux", "arm64", "Linux ARM64", ""}, {"linux", "arm64", "Linux ARM64", ""},
{"linux", "armv7", "Linux ARMv7l", ""}, {"linux", "arm", "Linux ARMv7l", ""}, // GOARCH=arm, GOARM=7
} }
const ( const (
Version = "1.0.0" Version = "2.0.0"
BuildTime = "2026-07-24" BuildTime = "2026-07-26"
Binary = "frpc-console" Binary = "frpc-console"
) )
@@ -53,7 +52,7 @@ func main() {
} }
} }
fmt.Println("❌ 不支持的平台:", target) 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") fmt.Println(" 或: all, list, clean")
return return
} }
@@ -126,10 +125,14 @@ func build(p Platform, silent bool) {
return 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) outPath := filepath.Join(outDir, outName)
// 用 "go" 而不是硬编码路径,让系统去 PATH 里找
cmd := exec.Command("go", "build", cmd := exec.Command("go", "build",
"-ldflags=-s -w -X main.version="+Version, "-ldflags=-s -w -X main.version="+Version,
"-o", outPath, "-o", outPath,
@@ -140,6 +143,12 @@ func build(p Platform, silent bool) {
"GOARCH="+p.Arch, "GOARCH="+p.Arch,
"CGO_ENABLED=0", "CGO_ENABLED=0",
) )
// ARM 架构指定 GOARM=7
if p.Arch == "arm" {
cmd.Env = append(cmd.Env, "GOARM=7")
}
cmd.Stdout = os.Stdout cmd.Stdout = os.Stdout
cmd.Stderr = os.Stderr cmd.Stderr = os.Stderr
+106 -5
View File
@@ -28,6 +28,13 @@ async function apiFetch(endpoint, options = {}) {
...options, ...options,
headers: { ...headers, ...(options.headers || {}) }, headers: { ...headers, ...(options.headers || {}) },
}); });
if (res.status === 401) {
clearAuthState();
window.dispatchEvent(new CustomEvent("auth:expired"));
return { code: 401, msg: "认证已过期,请重新登录" };
}
return res.json(); return res.json();
} }
@@ -189,7 +196,11 @@ async function fetchLogsApi() {
try { try {
const data = await apiFetch("/frpc/log"); const data = await apiFetch("/frpc/log");
if (data.code === 0) { 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: "加载失败" }; return { lines: [], total: 0, error: "加载失败" };
} catch (e) { } catch (e) {
@@ -286,8 +297,83 @@ const app = createApp({
let logTimer = null; let logTimer = null;
let logFetching = false; let logFetching = false;
// ---- Ping 延迟检测 ----
const pingLatency = ref(null);
let pingTimer = null;
const PING_INTERVAL_MS = 30000;
const PING_TIMEOUT_MS = 5000;
const pingStatusClass = computed(() => {
if (pingLatency.value === null) return "ping-fail";
if (pingLatency.value < 1000) return "ping-good";
if (pingLatency.value < 5000) return "ping-slow";
return "ping-fail";
});
const pingIcon = computed(() => {
if (pingLatency.value === null) {
return `<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 256 256">
<path d="M0 0h256v256H0z" fill="none"/>
<g fill="currentColor">
<path d="m224.39 104.34-90.24 108.78a8 8 0 0 1-12.3 0L17.8 87.69a7.79 7.79 0 0 1 1.31-11.21A179.58 179.58 0 0 1 128 40a182 182 0 0 1 33.06 3a7.94 7.94 0 0 1 4.17 2.21L224 104Z" opacity=".2"/>
<path d="M229.66 98.34a8 8 0 0 1-11.32 11.32L200 91.31l-18.34 18.35a8 8 0 0 1-11.32-11.32L188.69 80l-18.35-18.34a8 8 0 0 1 11.32-11.32L200 68.69l18.34-18.35a8 8 0 0 1 11.32 11.32L211.31 80Zm-33.06 39.5a8 8 0 0 0-11.27 1L128 208L24.09 82.74A170.76 170.76 0 0 1 128 48c2.54 0 5.11.06 7.65.17a8 8 0 0 0 .7-16c-2.77-.12-5.58-.18-8.35-.18A186.67 186.67 0 0 0 14.28 70.1a15.93 15.93 0 0 0-6.17 10.81a15.65 15.65 0 0 0 3.54 11.89l104 125.43A15.93 15.93 0 0 0 128 224a15.93 15.93 0 0 0 12.31-5.77l57.34-69.12a8 8 0 0 0-1.05-11.27"/>
</g>
</svg>`;
}
if (pingLatency.value < 1000) {
return `<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 25 24">
<path d="M0 0h25v24H0z" fill="none"/>
<path fill="currentColor" d="M2.046 6.725c6.192-4.967 15.05-4.967 21.243 0l.779.625l-11.4 14.25L1.265 7.35z"/>
</svg>`;
}
return `<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24">
<path d="M0 0h24v24H0z" fill="none"/>
<path fill="none" stroke="currentColor" stroke-width="2" d="M21.996 7.505L12 20L2.004 7.505c5.827-4.673 14.165-4.673 19.992 0Z"/>
</svg>`;
});
async function doPing() {
if (!frpcRunning.value) {
pingLatency.value = null;
return;
}
const addr = globalConfig.serverAddr || "frp.example.com";
const start = performance.now();
try {
const res = await fetch(
`/api/ping?target=${encodeURIComponent(addr)}`,
{ signal: AbortSignal.timeout(PING_TIMEOUT_MS) },
);
if (!res.ok) throw new Error("Ping failed");
const end = performance.now();
pingLatency.value = Math.round(end - start);
} catch {
pingLatency.value = null;
}
}
function startPingPolling() {
if (pingTimer) return;
doPing();
pingTimer = setInterval(doPing, PING_INTERVAL_MS);
}
function stopPingPolling() {
if (pingTimer) {
clearInterval(pingTimer);
pingTimer = null;
}
}
// ---- 认证过期处理 ----
const handleAuthExpired = () => {
doLogout();
};
// ---- 初始化 ---- // ---- 初始化 ----
onMounted(() => { onMounted(() => {
window.addEventListener("auth:expired", handleAuthExpired);
const saved = loadAuthState(); const saved = loadAuthState();
if (saved.valid) { if (saved.valid) {
token.value = saved.token; token.value = saved.token;
@@ -312,6 +398,15 @@ const app = createApp({
} }
}); });
watch(frpcRunning, (running) => {
if (!running) {
stopPingPolling();
pingLatency.value = null;
} else if (loggedIn.value) {
startPingPolling();
}
});
async function checkUsers() { async function checkUsers() {
try { try {
const res = await fetch("/api/check/users"); const res = await fetch("/api/check/users");
@@ -351,6 +446,10 @@ const app = createApp({
logFetching = true; logFetching = true;
try { try {
const result = await fetchLogsApi(); const result = await fetchLogsApi();
if (result.code === 401) {
logFetching = false;
return;
}
logLines.value = result.lines; logLines.value = result.lines;
logTotal.value = result.total; logTotal.value = result.total;
logError.value = result.error; logError.value = result.error;
@@ -478,6 +577,7 @@ const app = createApp({
const doLogout = () => { const doLogout = () => {
if (expireTimer) clearInterval(expireTimer); if (expireTimer) clearInterval(expireTimer);
stopLogPolling(); stopLogPolling();
stopPingPolling();
contentVisible.value = false; contentVisible.value = false;
loggedIn.value = false; loggedIn.value = false;
token.value = ""; token.value = "";
@@ -637,11 +737,10 @@ const app = createApp({
// ---- 计算属性 ---- // ---- 计算属性 ----
const filteredProxies = computed(() => const filteredProxies = computed(() =>
filterProxies(proxies.value, searchKeyword.value) filterProxies(proxies.value, searchKeyword.value),
); );
const showDefaultTip = computed(() => { const showDefaultTip = computed(() => {
// 如果 serverAddr 还是默认值,或者为空,显示警告
const addr = globalConfig.serverAddr; const addr = globalConfig.serverAddr;
return !addr || addr === "frp.example.com" || addr.trim() === ""; return !addr || addr === "frp.example.com" || addr.trim() === "";
}); });
@@ -694,7 +793,6 @@ const app = createApp({
showDefaultTip, showDefaultTip,
// 日志相关
logLines, logLines,
logTotal, logTotal,
logError, logError,
@@ -703,8 +801,11 @@ const app = createApp({
refreshLogs, refreshLogs,
scrollLogToBottom, scrollLogToBottom,
// Token 显示切换
showToken, showToken,
pingLatency,
pingStatusClass,
pingIcon,
}; };
}, },
}); });
+51 -49
View File
@@ -97,11 +97,15 @@
<span class="status-wrapper"> <span class="status-wrapper">
<span class="status-dot" :class="{ active: frpcRunning }"></span> <span class="status-dot" :class="{ active: frpcRunning }"></span>
<span class="status-text">{{ frpcRunning ? 'frpc 运行中' : 'frpc 已停止' }}</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> </span>
</div> </div>
</div> </div>
<div class="top-right"> <div class="top-right">
<span class="user-name">{{ loginForm.username }}</span>
<button class="logout-btn" @click="doLogout">退出</button> <button class="logout-btn" @click="doLogout">退出</button>
</div> </div>
</div> </div>
@@ -114,6 +118,8 @@
@click="activeTab = 'config'">全局配置信息</span> @click="activeTab = 'config'">全局配置信息</span>
<span class="tab-item" :class="{ active: activeTab === 'logs' }" <span class="tab-item" :class="{ active: activeTab === 'logs' }"
@click="activeTab = 'logs'">运行日志</span> @click="activeTab = 'logs'">运行日志</span>
<span class="tab-item" :class="{ active: activeTab === 'user' }"
@click="activeTab = 'user'">用户配置:{{loginForm.username }}</span>
</div> </div>
<!-- 内容区 --> <!-- 内容区 -->
@@ -159,48 +165,18 @@
</div> </div>
</div> </div>
<!-- ====== 全局配置信息 ====== -->
<!-- ====== 全局配置信息 ====== --> <!-- ====== 全局配置信息 ====== -->
<div v-if="activeTab === 'config'" class="tab-content config-tab-content"> <div v-if="activeTab === 'config'" class="tab-content config-tab-content">
<!-- 页面标题 -->
<div class="config-page-header"> <div class="config-page-header">
<h2>全局配置信息</h2> <h2>全局配置信息</h2>
<p class="config-subtitle">管理 frpc 连接参数与传输设置</p> <p class="config-subtitle">管理 frpc 连接参数与传输设置</p>
</div> </div>
<!-- 首次使用提示 -->
<div v-if="showDefaultTip" class="config-tip"> <div v-if="showDefaultTip" class="config-tip">
首次使用请修改「服务器地址」和「认证令牌」为您的真实 frps 配置 首次使用请修改「服务器地址」和「认证令牌」为您的真实 frps 配置
</div> </div>
<!-- ===== 账户管理 ===== --> <!-- 卡片1: 服务器连接 -->
<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: 服务器连接 ===== -->
<div class="config-card"> <div class="config-card">
<div class="config-card-header"> <div class="config-card-header">
<span class="card-title">服务器连接</span> <span class="card-title">服务器连接</span>
@@ -227,13 +203,12 @@
</div> </div>
</div> </div>
<!-- ===== 卡片2: 传输配置 ===== --> <!-- 卡片2: 传输配置 -->
<div class="config-card"> <div class="config-card">
<div class="config-card-header"> <div class="config-card-header">
<span class="card-title">传输配置</span> <span class="card-title">传输配置</span>
</div> </div>
<div class="config-card-body"> <div class="config-card-body">
<!-- TCP 多路复用(只读,占满一行) -->
<div class="form-row" style="grid-column: 1 / -1;"> <div class="form-row" style="grid-column: 1 / -1;">
<label>TCP 多路复用</label> <label>TCP 多路复用</label>
<div class="readonly-value"> <div class="readonly-value">
@@ -242,44 +217,38 @@
<span class="hint-text">优化连接性能,减少延迟,frp 官方推荐开启</span> <span class="hint-text">优化连接性能,减少延迟,frp 官方推荐开启</span>
</div> </div>
</div> </div>
<!-- 保活间隔 -->
<div class="form-row"> <div class="form-row">
<label>保活间隔(秒)</label> <label>保活间隔(秒)</label>
<input type="number" v-model="globalConfig.tcpMuxKeepalive" /> <input type="number" v-model="globalConfig.tcpMuxKeepalive" />
</div> </div>
<!-- 心跳间隔 -->
<div class="form-row"> <div class="form-row">
<label>心跳间隔(秒)</label> <label>心跳间隔(秒)</label>
<input type="number" v-model="globalConfig.heartbeatInterval" /> <input type="number" v-model="globalConfig.heartbeatInterval" />
</div> </div>
<!-- 心跳超时 -->
<div class="form-row"> <div class="form-row">
<label>心跳超时(秒)</label> <label>心跳超时(秒)</label>
<input type="number" v-model="globalConfig.heartbeatTimeout" /> <input type="number" v-model="globalConfig.heartbeatTimeout" />
</div> </div>
<!-- 连接池大小 -->
<div class="form-row"> <div class="form-row">
<label>连接池大小(个)</label> <label>连接池大小(个)</label>
<input type="number" v-model="globalConfig.poolCount" /> <input type="number" v-model="globalConfig.poolCount" />
</div> </div>
<!-- v2 协议开关(v1.5 灰标禁用) -->
<div class="form-row v2-switch-row"> <div class="form-row v2-switch-row">
<label>frp v2 隧道支持</label> <label>frp v2 隧道支持</label>
<div class="v2-switch-wrapper"> <div class="v2-switch-wrapper">
<label class="switch disabled"> <label class="switch">
<input type="checkbox" v-model="globalConfig.wireProtocolV2" disabled /> <input type="checkbox" v-model="globalConfig.wireProtocolV2" />
<span class="slider"></span> <span class="slider"></span>
</label> </label>
<span class="v2-badge">即将推出</span>
</div> </div>
<span class="hint-text v2-hint"> <span class="hint-text v2-hint">
此功能为 frp 0.70.0 以上版本才能开启,若要打开必须搭配同版本 frps 使用,否则此功能不生效 此功能为 frp 0.70.0 以上版本才能开启,若要打开必须搭配同版本 frpc 使用,否则此功能不生效
</span> </span>
</div> </div>
</div> </div>
</div> </div>
<!-- ===== 卡片3: 日志配置 ===== --> <!-- 卡片3: 日志配置 -->
<div class="config-card"> <div class="config-card">
<div class="config-card-header"> <div class="config-card-header">
<span class="card-title">日志配置</span> <span class="card-title">日志配置</span>
@@ -302,12 +271,11 @@
</div> </div>
</div> </div>
<!-- 保存按钮 -->
<button class="save-config-btn" @click="saveConfig">保存配置并热加载</button> <button class="save-config-btn" @click="saveConfig">保存配置并热加载</button>
</div> </div>
<!-- ====== 运行日志 ====== --> <!-- ====== 运行日志 ====== -->
<div v-else-if="activeTab === 'logs'" class="tab-content log-tab-content"> <div v-else-if="activeTab === 'logs'" class="tab-content log-tab-content">
<!-- 工具栏 -->
<div class="log-toolbar"> <div class="log-toolbar">
<div class="log-toolbar-left"> <div class="log-toolbar-left">
<span class="log-info-badge">共 {{ logTotal }} 行</span> <span class="log-info-badge">共 {{ logTotal }} 行</span>
@@ -323,7 +291,6 @@
</div> </div>
</div> </div>
<!-- 日志显示区域 -->
<div class="log-terminal" id="logContainer"> <div class="log-terminal" id="logContainer">
<div v-if="logLines.length === 0 && !logError" class="log-empty"> <div v-if="logLines.length === 0 && !logError" class="log-empty">
暂无日志,frpc 尚未产生输出 暂无日志,frpc 尚未产生输出
@@ -333,17 +300,48 @@
</div> </div>
</div> </div>
<!-- 底部状态 -->
<div class="log-footer"> <div class="log-footer">
<span>上次更新: {{ logLastUpdate || '--:--:--' }}</span> <span>上次更新: {{ logLastUpdate || '--:--:--' }}</span>
<span class="log-polling-status">自动刷新中 (8s)</span> <span class="log-polling-status">自动刷新中 (8s)</span>
</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>
<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>
</div> </div>
</div> <!-- /content-area -->
<!-- ====== 弹窗 ====== --> <!-- ====== 弹窗 ====== -->
<Transition name="dialog"> <Transition name="dialog">
<div v-if="dialogVisible" class="dialog-overlay" @click.self="dialogVisible = false"> <div v-if="dialogVisible" class="dialog-overlay" @click.self="dialogVisible = false">
@@ -374,9 +372,13 @@
</div> </div>
</Transition> </Transition>
</div> <!-- /main-panel -->
</div> <!-- /app-container -->
<!-- 隐藏文件选择器 --> <!-- 隐藏文件选择器 -->
<input type="file" id="tomlFileInput" accept=".toml" style="display:none" @change="handleImport" /> <input type="file" id="tomlFileInput" accept=".toml" style="display:none" @change="handleImport" />
</div>
</div> <!-- /#app -->
<script src="/static/app.js"></script> <script src="/static/app.js"></script>
</body> </body>
+66
View File
@@ -735,3 +735,69 @@ select:disabled {
padding: 20px; 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; 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 { .v2-badge {
@@ -183,6 +168,12 @@
font-weight: 500; 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 { .v2-hint {
font-size: 12px; font-size: 12px;
color: var(--text-dim); color: var(--text-dim);
+36
View File
@@ -0,0 +1,36 @@
### 2.3 2026-07-28)(non-LTS
### 2.0-LTS 2026-07-27
> 本次 LTS 版本聚焦于**稳定性兜底与协议能力对齐**,是 frp 0.70.0 LTS 的下游管理工具。
· 🚀 **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>