// Package app 提供应用程序的启动和运行逻辑。 // // 该文件包含应用程序相关的核心逻辑,包括: // - 应用程序生命周期管理 // - 信号处理(优雅停止、重载配置、热升级) // - 配置加载和版本信息 // // 主要用途: // 用于启动和管理服务器进程,处理系统信号和运行时操作。 // // 注意事项: // - 支持热升级(USR2 信号) // - 支持配置重载(HUP 信号) // - 支持日志重新打开(USR1 信号) // // 作者:xfy package app import ( "fmt" "os" "os/signal" "syscall" "time" "rua.plus/lolly/internal/config" "rua.plus/lolly/internal/logging" "rua.plus/lolly/internal/server" "rua.plus/lolly/internal/stream" ) // 版本信息,通过 -ldflags 注入。 var ( // Version 版本号 Version = "dev" // GitCommit Git 提交哈希 GitCommit = "unknown" // GitBranch Git 分支名 GitBranch = "unknown" // BuildTime 构建时间 BuildTime = "unknown" // GoVersion Go 版本 GoVersion = "unknown" // BuildPlatform 构建平台 BuildPlatform = "unknown" ) // 应用状态。 var ( // shutdownTimeout 优雅停止超时时间 shutdownTimeout = 30 * time.Second ) // App 应用程序结构。 // // 管理服务器的完整生命周期,包括 HTTP 服务器、Stream 服务器 // 和热升级管理器。 type App struct { // cfgPath 配置文件路径 cfgPath string // cfg 配置对象 cfg *config.Config // srv HTTP 服务器实例 srv *server.Server // streamSrv Stream 服务器实例(可选) streamSrv *stream.Server // upgradeMgr 热升级管理器 upgradeMgr *server.UpgradeManager // pidFile PID 文件路径 pidFile string // logFile 日志文件路径(用于重新打开) logFile string } // NewApp 创建应用程序。 func NewApp(cfgPath string) *App { return &App{ cfgPath: cfgPath, } } // SetPidFile 设置 PID 文件路径。 func (a *App) SetPidFile(path string) { a.pidFile = path } // SetLogFile 设置日志文件路径。 func (a *App) SetLogFile(path string) { a.logFile = path } // Run 应用程序入口。 func Run(cfgPath string, genConfig bool, outputPath string, showVersion bool) int { if genConfig { return generateConfig(outputPath) } if showVersion { printVersion() return 0 } app := NewApp(cfgPath) return app.Run() } // generateConfig 生成默认配置文件。 func generateConfig(outputPath string) int { cfg := config.DefaultConfig() yamlData, err := config.GenerateConfigYAML(cfg) if err != nil { fmt.Fprintf(os.Stderr, "生成配置失败: %v\n", err) return 1 } if outputPath == "" { fmt.Print(string(yamlData)) } else { if err := os.WriteFile(outputPath, yamlData, 0644); err != nil { fmt.Fprintf(os.Stderr, "写入文件失败: %v\n", err) return 1 } fmt.Printf("配置已写入: %s\n", outputPath) } return 0 } // printVersion 打印版本信息。 func printVersion() { fmt.Printf("lolly version %s\n", Version) fmt.Printf(" Git: %s (%s)\n", GitCommit, GitBranch) fmt.Printf(" Built: %s\n", BuildTime) fmt.Printf(" Go: %s\n", GoVersion) fmt.Printf(" Platform: %s\n", BuildPlatform) } // Run 启动应用程序。 func (a *App) Run() int { // 检查是否是子进程(热升级) if os.Getenv("GRACEFUL_UPGRADE") == "1" { fmt.Println("检测到热升级模式,继承父进程监听器") } cfg, err := config.Load(a.cfgPath) if err != nil { fmt.Fprintf(os.Stderr, "加载配置失败: %v\n", err) return 1 } a.cfg = cfg fmt.Printf("配置加载成功: %s\n", a.cfgPath) fmt.Printf("监听地址: %s\n", cfg.Server.Listen) // 创建 HTTP 服务器 a.srv = server.New(cfg) // 创建 Stream 服务器(如果配置了) if len(cfg.Stream) > 0 { a.streamSrv = stream.NewServer() for _, sc := range cfg.Stream { // 转换目标配置 targets := make([]stream.TargetSpec, len(sc.Upstream.Targets)) for i, t := range sc.Upstream.Targets { targets[i] = stream.TargetSpec{ Addr: t.Addr, Weight: t.Weight, } } // 添加上游配置 if err := a.streamSrv.AddUpstream(sc.Listen, targets, sc.Upstream.LoadBalance, stream.HealthCheckSpec{}); err != nil { fmt.Fprintf(os.Stderr, "添加 Stream 上游失败: %v\n", err) } // 监听端口 if sc.Protocol == "udp" { if err := a.streamSrv.ListenUDP(sc.Listen, sc.Listen, 60*time.Second); err != nil { fmt.Fprintf(os.Stderr, "监听 UDP %s 失败: %v\n", sc.Listen, err) } } else { if err := a.streamSrv.ListenTCP(sc.Listen); err != nil { fmt.Fprintf(os.Stderr, "监听 TCP %s 失败: %v\n", sc.Listen, err) } } } // 启动 Stream 服务器 go func() { fmt.Println("Stream 服务器启动中...") if err := a.streamSrv.Start(); err != nil { fmt.Fprintf(os.Stderr, "Stream 服务器启动失败: %v\n", err) } }() } // 创建升级管理器 a.upgradeMgr = server.NewUpgradeManager(a.srv) if a.pidFile != "" { a.upgradeMgr.SetPidFile(a.pidFile) a.upgradeMgr.WritePid() } // 启动信号处理 sigChan := make(chan os.Signal, 1) a.setupSignalHandlers(sigChan) // 启动 HTTP 服务器 errChan := make(chan error, 1) go func() { fmt.Println("HTTP 服务器启动中...") if err := a.srv.Start(); err != nil { errChan <- err } }() // 等待信号或启动错误 for { select { case err := <-errChan: fmt.Fprintf(os.Stderr, "服务器启动失败: %v\n", err) return 1 case sig := <-sigChan: if !a.handleSignal(sig) { // 返回 false 表示退出 fmt.Println("服务器已停止") return 0 } // 返回 true 表示继续运行(如重载配置) } } } // setupSignalHandlers 设置信号处理。 func (a *App) setupSignalHandlers(sigChan chan<- os.Signal) { signal.Notify(sigChan, syscall.SIGTERM, // 快速停止(kill 或 systemd stop) syscall.SIGINT, // 快速停止(Ctrl+C) syscall.SIGQUIT, // 优雅停止 syscall.SIGHUP, // 重载配置 syscall.SIGUSR1, // 重新打开日志 syscall.SIGUSR2, // 热升级 ) } // handleSignal 处理信号,返回 false 表示退出。 func (a *App) handleSignal(sig os.Signal) bool { switch sig { case syscall.SIGQUIT: // 优雅停止:等待请求完成 fmt.Printf("\n收到 SIGQUIT,优雅停止(等待 %v)...\n", shutdownTimeout) a.srv.GracefulStop(shutdownTimeout) return false case syscall.SIGTERM, syscall.SIGINT: // 快速停止 fmt.Printf("\n收到 %v,停止服务器...\n", sigName(sig.(syscall.Signal))) a.srv.Stop() return false case syscall.SIGHUP: // 重载配置 fmt.Println("\n收到 SIGHUP,重载配置...") a.reloadConfig() return true case syscall.SIGUSR1: // 重新打开日志 fmt.Println("\n收到 SIGUSR1,重新打开日志...") a.reopenLogs() return true case syscall.SIGUSR2: // 热升级 fmt.Println("\n收到 SIGUSR2,执行热升级...") a.gracefulUpgrade() return true default: fmt.Printf("\n收到未知信号: %v\n", sig) return true } } // reloadConfig 重载配置。 func (a *App) reloadConfig() { newCfg, err := config.Load(a.cfgPath) if err != nil { fmt.Fprintf(os.Stderr, "重载配置失败: %v\n", err) return } // 更新配置 a.cfg = newCfg fmt.Println("配置重载成功") // 注意:当前实现不重启服务器,仅更新配置 // 如需应用新配置,需要重启服务器或实现热更新 fmt.Println("配置已重新加载") } // reopenLogs 重新打开日志文件。 func (a *App) reopenLogs() { // 重新初始化日志系统 if a.cfg != nil { logging.Init(a.cfg.Logging.Error.Level, false) } fmt.Println("日志已重新打开") } // gracefulUpgrade 执行热升级。 func (a *App) gracefulUpgrade() { // 获取当前可执行文件路径 execPath, err := os.Executable() if err != nil { fmt.Fprintf(os.Stderr, "获取可执行文件路径失败: %v\n", err) return } // 尝试从服务器获取监听器 listeners := a.srv.GetListeners() if len(listeners) == 0 { fmt.Fprintf(os.Stderr, "热升级失败: 服务器未保存监听器(热升级当前未完全实现)\n") fmt.Fprintf(os.Stderr, "提示: 热升级需要服务器使用手动监听器管理模式\n") return } // 设置监听器到升级管理器 a.upgradeMgr.SetListeners(listeners) // 执行升级 if err := a.upgradeMgr.GracefulUpgrade(execPath); err != nil { fmt.Fprintf(os.Stderr, "热升级失败: %v\n", err) return } fmt.Println("热升级已启动,新进程正在接管") // 当前进程优雅停止 a.srv.GracefulStop(shutdownTimeout) } // sigName 返回信号名称(用于日志输出)。 func sigName(sig syscall.Signal) string { switch sig { case syscall.SIGTERM: return "SIGTERM" case syscall.SIGINT: return "SIGINT" case syscall.SIGQUIT: return "SIGQUIT" case syscall.SIGHUP: return "SIGHUP" case syscall.SIGUSR1: return "SIGUSR1" case syscall.SIGUSR2: return "SIGUSR2" default: return fmt.Sprintf("Signal(%d)", sig) } }