// Copyright 2026 Arctel.net // SPDX-License-Identifier: Apache-2.0 package flared import ( "context" "errors" "fmt" "strings" "time" "github.com/Rain-kl/Wavelet/internal/repository" "github.com/Rain-kl/Wavelet/internal/apps/openflare/agent" "github.com/Rain-kl/Wavelet/internal/model" "gorm.io/gorm" ) const ( nodeStatusOnline = "online" applyResultOK = "success" applyResultWarn = "warning" applyResultFail = "failed" maxApplyLogMessageLength = 16000 ) // Heartbeat processes an OpenFlared heartbeat and returns runtime settings. func Heartbeat(ctx context.Context, node *model.OpenFlareNode, payload HeartbeatPayload) (*HeartbeatResponse, error) { if node == nil { return nil, errors.New("tunnel client node is nil") } if node.NodeType != "tunnel_client" { return nil, fmt.Errorf("node %s is not a tunnel_client", node.NodeID) } payload = normalizeFlaredHeartbeatPayload(payload) previous := *node updateNow := node.UpdateRequested updateChannel := normalizeReleaseChannel(node.UpdateChannel) updateTag := strings.TrimSpace(node.UpdateTag) now := time.Now().UTC() changes := map[string]any{ "version": payload.ClientVersion, "ext_version": payload.FrpVersion, "current_version": payload.CurrentVersion, "last_seen_at": now, "status": nodeStatusOnline, "update_requested": false, "update_channel": updateChannelStable, "update_tag": "", } if !previous.UpdateRequested { delete(changes, "update_requested") } if previous.UpdateChannel == updateChannelStable { delete(changes, "update_channel") } if previous.UpdateTag == "" { delete(changes, "update_tag") } if !node.IPManualOverride && payload.IP != "" && previous.IP != payload.IP { changes["ip"] = payload.IP node.IP = payload.IP } node.Version = payload.ClientVersion node.ExtVersion = payload.FrpVersion node.CurrentVersion = payload.CurrentVersion node.UpdateRequested = false node.UpdateChannel = updateChannelStable node.UpdateTag = "" lastSeen := now node.LastSeenAt = &lastSeen node.Status = nodeStatusOnline if err := repository.UpdateOpenFlareNodeColumns(ctx, node, changes); err != nil { return nil, fmt.Errorf("update flared heartbeat: %w", err) } agent.RefreshAccessTokenCache(ctx, node) persistFlaredObservability(ctx, node.NodeID, payload, now) activeConfig, err := getActiveConfigMeta(ctx) if err != nil && !errors.Is(err, gorm.ErrRecordNotFound) { return nil, err } return &HeartbeatResponse{ ActiveConfig: activeConfig, TunnelSettings: buildTunnelSettings(ctx, node, updateNow, updateChannel, updateTag), }, nil } // GetTunnelConfig builds the full tunnel routing config for an OpenFlared client. func GetTunnelConfig(ctx context.Context, node *model.OpenFlareNode) (*TunnelConfigResponse, error) { if node == nil { return nil, errors.New("node is nil") } activeVersion, err := getActiveConfigMeta(ctx) if err != nil { return nil, fmt.Errorf("no active config version: %w", err) } routes, err := repository.ListProxyRoutes(ctx) if err != nil { return nil, fmt.Errorf("get proxy routes: %w", err) } relayNodes, err := listTunnelRelayNodes(ctx) if err != nil { return nil, fmt.Errorf("get relay nodes: %w", err) } relays := make([]RelayInfo, 0, len(relayNodes)) for i := range relayNodes { relayNode := relayNodes[i] if relayNode.RelayStatus == "healthy" || relayNode.Status == nodeStatusOnline { relays = append(relays, RelayInfo{ RelayNodeID: relayNode.NodeID, Address: relayClientAddress(&relayNode), AuthToken: relayNode.RelayAuthToken, ProxyURL: strings.TrimSpace(relayNode.RelayClientProxyURL), }) } } proxies := make([]ProxyEntry, 0) for _, route := range routes { if route == nil || route.UpstreamType != "tunnel" || route.TunnelNodeID == nil || *route.TunnelNodeID != node.ID { continue } if !route.Enabled { continue } zoneDomains, domainErr := repository.ListZoneDomainsByRouteID(ctx, route.ID) if domainErr != nil || len(zoneDomains) == 0 { continue } localAddr, localPort := parseTunnelTargetAddr(route.TunnelTargetAddr) proxies = append(proxies, ProxyEntry{ Name: fmt.Sprintf("%s-%s", node.NodeID, sanitizeProxyName(zoneDomains[0].Domain)), Type: "http", LocalAddr: localAddr, LocalPort: localPort, CustomDomains: zoneDomainNames(zoneDomains), }) } return &TunnelConfigResponse{ Version: activeVersion.Version, Checksum: activeVersion.Checksum, Relays: relays, Proxies: proxies, }, nil } func zoneDomainNames(domains []model.ZoneDomain) []string { names := make([]string, 0, len(domains)) for _, domain := range domains { names = append(names, domain.Domain) } return names } // ReportApplyLog records an apply result from OpenFlared. func ReportApplyLog(ctx context.Context, payload ApplyLogPayload) (*model.OpenFlareApplyLog, error) { now := time.Now().UTC() payload = normalizeApplyLogPayload(payload) if payload.NodeID == "" { return nil, errors.New("node_id 不能为空") } if payload.Version == "" { return nil, errors.New("version 不能为空") } if payload.Result != applyResultOK && payload.Result != applyResultWarn && payload.Result != applyResultFail { return nil, errors.New("result 仅支持 success、warning 或 failed") } latest, err := repository.GetLatestOpenFlareApplyLogByNodeID(ctx, payload.NodeID) if err != nil { return nil, err } if model.IsRepeatSuccessApplyLog(latest, payload.Version, payload.Checksum, payload.Result) { if err := repository.UpdateOpenFlareNodeFromApplyResult(ctx, payload.NodeID, payload.Result, payload.Version, payload.Message, now); err != nil { return nil, err } return latest, nil } log := &model.OpenFlareApplyLog{ NodeID: payload.NodeID, Version: payload.Version, Result: payload.Result, Message: payload.Message, Checksum: payload.Checksum, MainConfigChecksum: payload.MainConfigChecksum, RouteConfigChecksum: payload.RouteConfigChecksum, SupportFileCount: payload.SupportFileCount, CreatedAt: now, } if err := repository.CreateOpenFlareApplyLogAndUpdateNode(ctx, log, payload.Result, payload.Version, payload.Message); err != nil { return nil, err } return log, nil } func normalizeApplyLogPayload(payload ApplyLogPayload) ApplyLogPayload { payload.NodeID = strings.TrimSpace(payload.NodeID) payload.Version = strings.TrimSpace(payload.Version) payload.Result = strings.ToLower(strings.TrimSpace(payload.Result)) payload.Message = strings.TrimSpace(payload.Message) payload.Checksum = strings.TrimSpace(payload.Checksum) payload.MainConfigChecksum = strings.TrimSpace(payload.MainConfigChecksum) payload.RouteConfigChecksum = strings.TrimSpace(payload.RouteConfigChecksum) if len(payload.Message) > maxApplyLogMessageLength { payload.Message = payload.Message[:maxApplyLogMessageLength] } return payload }