package httpapi import ( "encoding/json" "log/slog" "net/http" "strconv" "strings" "time" "github.com/go-chi/chi/v5" "github.com/wangjia/pangolin/server/internal/apierr" "github.com/wangjia/pangolin/server/internal/auth" "github.com/wangjia/pangolin/server/internal/nodes" agentv1 "github.com/wangjia/pangolin/server/internal/pb/agentv1" ) const ( // paidCredentialTTL is the default connect credential lifetime for paid users. paidCredentialTTL = 24 * time.Hour // freeCredentialTTL is the per-minute TTL for free users (per remaining minutes). freeMinuteTTL = time.Minute ) // NodeAPI serves the /v1/nodes endpoints. type NodeAPI struct { store nodes.NodeStore hub *nodes.Hub deriveKey string // rulesBaseURL 是控制面对外公网基址(PANGOLIN_PUBLIC_URL),供国内分流的 // rule_set .srs 下载用;空则分流不生效。 rulesBaseURL string } // NewNodeAPI creates a NodeAPI. func NewNodeAPI(store nodes.NodeStore, hub *nodes.Hub, deriveKey, rulesBaseURL string) *NodeAPI { return &NodeAPI{store: store, hub: hub, deriveKey: deriveKey, rulesBaseURL: rulesBaseURL} } // ─── GET /v1/nodes ─────────────────────────────────────────────────────────── type nodeResponse struct { ID string `json:"id"` // UUID (used as path param for connect) Region string `json:"region"` // HK / JP / SG / US NameZH string `json:"name_zh"` NameEN string `json:"name_en"` Tier string `json:"tier"` // "free" | "pro" Status string `json:"status"` // "up" only when the agent is also online; "down" otherwise // host/port 暴露节点入口,供客户端实测真实延迟(per-client ping 服务端无法代知)。 Host string `json:"host"` Port int `json:"port"` } // effectiveNodeStatus downgrades a DB-'up' node to "down" when its agent is // offline. The DB status column reflects provisioning/scheduler state, NOT agent // liveness — without this, a node whose agent has been offline for days still // shows healthy (the gap that hid a 6-day agent outage and let clients "connect" // to a node that couldn't serve them). func effectiveNodeStatus(dbStatus string, agentOnline bool) string { if dbStatus == "up" && !agentOnline { return "down" } return dbStatus } // ListNodes handles GET /v1/nodes. func (a *NodeAPI) ListNodes(w http.ResponseWriter, r *http.Request) { nodeRows, err := a.store.ListUp(r.Context()) if err != nil { apierr.WriteJSON(w, http.StatusInternalServerError, apierr.ErrInternal) return } resp := make([]nodeResponse, 0, len(nodeRows)) for _, n := range nodeRows { host, portStr := splitHostPort(n.Endpoint) if host == "" { host = n.Endpoint } port, _ := strconv.Atoi(portStr) resp = append(resp, nodeResponse{ ID: n.UUID, Region: n.Region, NameZH: n.NameZH, NameEN: n.NameEN, Tier: n.Tier, Status: effectiveNodeStatus(n.Status, a.hub == nil || a.hub.IsOnline(n.UUID)), Host: host, Port: port, }) } w.Header().Set("Content-Type", "application/json; charset=utf-8") _ = json.NewEncoder(w).Encode(map[string]any{"nodes": resp}) } // ─── POST /v1/nodes/{id}/connect ───────────────────────────────────────────── type connectRequest struct { DeviceID string `json:"device_id"` } // ConnectNode handles POST /v1/nodes/{id}/connect. func (a *NodeAPI) ConnectNode(w http.ResponseWriter, r *http.Request) { uid, ok := auth.UserIDFromContext(r.Context()) if !ok { apierr.WriteJSON(w, http.StatusUnauthorized, apierr.ErrUnauthorized) return } nodeUUID := chi.URLParam(r, "id") if nodeUUID == "" { apierr.WriteJSON(w, http.StatusBadRequest, apierr.ErrBadRequest) return } var req connectRequest if err := json.NewDecoder(http.MaxBytesReader(w, r.Body, 8*1024)).Decode(&req); err != nil || strings.TrimSpace(req.DeviceID) == "" { apierr.WriteJSON(w, http.StatusBadRequest, &apierr.Error{ Code: "BAD_REQUEST", MessageZH: "缺少 device_id", MessageEn: "Missing device_id", }) return } // 1. Load user entitlement (dp_uuid + plan). ent, err := a.store.EntitlementForUser(r.Context(), uid) if err != nil { slog.Error("connect: entitlement load failed", "user", uid, "err", err) apierr.WriteJSON(w, http.StatusInternalServerError, apierr.ErrInternal) return } if ent == nil { apierr.WriteJSON(w, http.StatusUnauthorized, apierr.ErrUnauthorized) return } // 1.5 GB 综合配额卡控(todo #5 Phase 2):按账户当日综合流量卡,超 plan.daily_mb 即拒。 // 对免费(与分钟门双卡)与付费(高上限防滥用)统一生效;daily_mb NULL = 不限。 if ent.DailyMB.Valid { usedBytes, qerr := a.store.AccountDayBytes(r.Context(), uid, time.Now().UTC()) if qerr != nil { slog.Error("connect: account day bytes failed", "user", uid, "err", qerr) apierr.WriteJSON(w, http.StatusInternalServerError, apierr.ErrInternal) return } if usedBytes >= ent.DailyMB.Int64*(1<<20) { apierr.WriteJSON(w, http.StatusForbidden, apierr.ErrQuotaExhausted) return } } // 2. Determine TTL from plan. var ttl time.Duration if ent.AdGate { // Free plan: flat 10-minute session for MVP (full ad-gate in a later pass). dm := int64(10) if ent.DailyMinutes.Valid { dm = ent.DailyMinutes.Int64 } if dm <= 0 { apierr.WriteJSON(w, http.StatusForbidden, apierr.ErrQuotaExhausted) return } ttl = time.Duration(dm) * freeMinuteTTL } else { ttl = paidCredentialTTL } expiresAt := time.Now().UTC().Add(ttl) // 2.5 Per-device dp_uuid (todo #5 Phase 2): each device gets its own data-plane // credential so the node reports per-device traffic counters. Falls back to the // account-level dp_uuid when the device isn't registered yet (legacy clients). dpUUID := ent.DpUUID if devDp, _, derr := a.store.EnsureDeviceDpUUID(r.Context(), uid, req.DeviceID); derr == nil && devDp != "" { dpUUID = devDp } else if derr != nil { slog.Info("connect: per-device dp_uuid unavailable, using account credential", "user", uid, "device", req.DeviceID, "err", derr.Error()) } // 3. Resolve node. node, err := a.store.NodeByUUID(r.Context(), nodeUUID) if err != nil { slog.Error("connect: node load failed", "node", nodeUUID, "err", err) apierr.WriteJSON(w, http.StatusInternalServerError, apierr.ErrInternal) return } if node == nil || node.Status != "up" { apierr.WriteJSON(w, http.StatusNotFound, apierr.ErrNotFound) return } // 4. Build the agentv1.Credential. cred := &agentv1.Credential{ DpUUID: dpUUID, Protocol: agentv1.ProtocolBoth, Flow: "xtls-rprx-vision", ExpiresAtUnix: expiresAt.Unix(), } // 5. Refuse early if the node's agent is offline. A credential we can't push // now leaves the client "connected" to a node that rejects its UUID — the // exact failure that hid a 6-day agent outage. Persist it so the agent // applies it on resync, then signal unavailable instead of faking success. if !a.hub.IsOnline(node.UUID) { if persistErr := a.store.PersistCredential(r.Context(), node.ID, cred, expiresAt); persistErr != nil { slog.Error("connect: persist credential (agent offline) failed", "node", nodeUUID, "user", uid, "err", persistErr) } slog.Warn("connect: node agent offline, refusing connect", "node", nodeUUID, "user", uid) apierr.WriteJSON(w, http.StatusServiceUnavailable, apierr.ErrNodeUnavailable) return } // 6. Push to the node agent via Hub. The agent is online, so a push failure is // a real error — surface it, don't pretend the tunnel will work. if pushErr := a.hub.Push(r.Context(), node.UUID, &agentv1.Command{ Type: agentv1.CommandTypeUpsert, Upsert: &agentv1.UpsertPayload{Credential: cred}, }); pushErr != nil { slog.Error("connect: push credential to agent failed", "node", nodeUUID, "user", uid, "err", pushErr) apierr.WriteJSON(w, http.StatusServiceUnavailable, apierr.ErrNodeUnavailable) return } // 7. Persist credential for agent resync (best-effort; the push above already // delivered it to the live agent). if persistErr := a.store.PersistCredential(r.Context(), node.ID, cred, expiresAt); persistErr != nil { slog.Error("connect: persist credential failed", "node", nodeUUID, "user", uid, "err", persistErr) } // 7. Render and return the full sing-box CLIENT config JSON. // split_cn=1/true → 国内 IP/域名直连(#5);客户端按 smartRoute 偏好传。 splitCN := r.URL.Query().Get("split_cn") == "1" || r.URL.Query().Get("split_cn") == "true" cfgJSON, renderErr := BuildClientConfig(node, dpUUID, a.deriveKey, ClientConfigOpts{SplitCN: splitCN, RulesBaseURL: a.rulesBaseURL}) if renderErr != nil { slog.Error("connect: build client config failed", "node", nodeUUID, "err", renderErr) apierr.WriteJSON(w, http.StatusInternalServerError, apierr.ErrInternal) return } // 可观测:国内分流是否真正生效(split_active=两个条件都满足才渲染 rule_set)。 slog.Info("client config rendered", "node", nodeUUID, "split_cn", splitCN, "rules_base_set", a.rulesBaseURL != "", "split_active", splitCN && a.rulesBaseURL != "", "bytes", len(cfgJSON)) w.Header().Set("Content-Type", "application/json; charset=utf-8") _, _ = w.Write(cfgJSON) } // ─── POST /v1/nodes/{id}/disconnect ────────────────────────────────────────── // DisconnectNode handles POST /v1/nodes/{id}/disconnect. func (a *NodeAPI) DisconnectNode(w http.ResponseWriter, r *http.Request) { uid, ok := auth.UserIDFromContext(r.Context()) if !ok { apierr.WriteJSON(w, http.StatusUnauthorized, apierr.ErrUnauthorized) return } nodeUUID := chi.URLParam(r, "id") if nodeUUID == "" { apierr.WriteJSON(w, http.StatusBadRequest, apierr.ErrBadRequest) return } // Load dp_uuid. ent, err := a.store.EntitlementForUser(r.Context(), uid) if err != nil { apierr.WriteJSON(w, http.StatusInternalServerError, apierr.ErrInternal) return } if ent == nil { w.WriteHeader(http.StatusNoContent) // nothing to revoke return } node, err := a.store.NodeByUUID(r.Context(), nodeUUID) if err != nil { apierr.WriteJSON(w, http.StatusInternalServerError, apierr.ErrInternal) return } if node == nil { w.WriteHeader(http.StatusNoContent) return } // Push revoke command. _ = a.hub.Push(r.Context(), node.UUID, &agentv1.Command{ Type: agentv1.CommandTypeRevoke, Revoke: &agentv1.RevokePayload{DpUUID: ent.DpUUID}, }) // Delete persisted credential. _ = a.store.DeleteCredential(r.Context(), node.ID, ent.DpUUID) w.WriteHeader(http.StatusNoContent) }