handler

func (*AdminCouponHandler) CreateCoupon ¶

func (h *AdminCouponHandler) CreateCoupon(c *gin.Context)

CreateCoupon 创建优惠券

func (*AdminCouponHandler) DeleteCoupon ¶

func (h *AdminCouponHandler) DeleteCoupon(c *gin.Context)

DeleteCoupon 删除优惠券

func (*AdminCouponHandler) GetCoupons ¶

func (h *AdminCouponHandler) GetCoupons(c *gin.Context)

GetCoupons 获取优惠券列表

func (*AdminHandler) AssignPlanToUser ¶

func (h *AdminHandler) AssignPlanToUser(c *gin.Context)

AssignPlanToUser godoc @Summary 分配套餐给用户 @Description 管理员将指定套餐分配给用户 @Tags 管理端-套餐 @Accept json @Produce json @Security BearerAuth @Param id path int true "套餐ID" @Param request body map[string]any true "分配请求 {user_id: uint, expire_at: int64}" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/plans/{id}/assign [post]

func (*AdminHandler) BanUser ¶

func (h *AdminHandler) BanUser(c *gin.Context)

BanUser godoc @Summary 封禁用户 @Description 管理员封禁指定用户 @Tags 管理端-用户 @Accept json @Produce json @Security BearerAuth @Param id path int true "用户ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/users/{id}/ban [post]

func (*AdminHandler) CancelOrder ¶

func (h *AdminHandler) CancelOrder(c *gin.Context)

CancelOrder godoc @Summary 取消订单 @Description 管理员取消指定订单 @Tags 管理端-订单 @Accept json @Produce json @Security BearerAuth @Param id path int true "订单ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/orders/{id}/cancel [post]

func (*AdminHandler) CreatePlan ¶

func (h *AdminHandler) CreatePlan(c *gin.Context)

CreatePlan godoc @Summary 创建套餐 @Description 管理员创建新套餐 @Tags 管理端-套餐 @Accept json @Produce json @Security BearerAuth @Param request body model.Plan true "套餐信息" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/plans [post]

func (*AdminHandler) CreateUser ¶

func (h *AdminHandler) CreateUser(c *gin.Context)

CreateUser godoc @Summary 创建用户 @Description 管理员创建新用户 @Tags 管理端-用户 @Accept json @Produce json @Security BearerAuth @Param request body model.AdminCreateUserRequest true "用户信息" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Router /admin/users [post]

func (*AdminHandler) DeletePlan ¶

func (h *AdminHandler) DeletePlan(c *gin.Context)

DeletePlan godoc @Summary 删除套餐 @Description 管理员删除指定套餐 @Tags 管理端-套餐 @Accept json @Produce json @Security BearerAuth @Param id path int true "套餐ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/plans/{id} [delete]

func (*AdminHandler) DeleteUser ¶

func (h *AdminHandler) DeleteUser(c *gin.Context)

DeleteUser godoc @Summary 删除用户 @Description 管理员删除指定用户 @Tags 管理端-用户 @Accept json @Produce json @Security BearerAuth @Param id path int true "用户ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/users/{id} [delete]

func (*AdminHandler) GetDashboard ¶

func (h *AdminHandler) GetDashboard(c *gin.Context)

GetDashboard godoc @Summary 获取仪表盘数据 @Description 管理员获取仪表盘统计数据，包括用户数、订单数、收入等 @Tags 管理端-系统 @Accept json @Produce json @Security BearerAuth @Param refresh query bool false "是否强制刷新缓存" @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/dashboard [get]

func (*AdminHandler) GetHourlyTraffic ¶

func (h *AdminHandler) GetHourlyTraffic(c *gin.Context)

GetHourlyTraffic 返回最近 N 小时的流量序列 (默认 24 小时, 最多 720 小时) GET /api/v2/admin/traffic/hourly?hours=24&user_id=0

func (*AdminHandler) GetOrder ¶

func (h *AdminHandler) GetOrder(c *gin.Context)

GetOrder godoc The order with its plan's id and name and its buyer's id and e-mail (service.OrderView). @Summary 获取订单详情 @Description 管理员获取指定订单的详细信息 @Tags 管理端-订单 @Accept json @Produce json @Security BearerAuth @Param id path int true "订单ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 404 {object} map[string]any @Router /admin/orders/{id} [get]

func (*AdminHandler) GetOrderList ¶

func (h *AdminHandler) GetOrderList(c *gin.Context)

GetOrderList godoc Each order carries its plan's id and name and its buyer's id and e-mail (service.OrderView), never the rest of their rows. @Summary 获取订单列表 @Description 管理员获取订单列表，支持分页和筛选 @Tags 管理端-订单 @Accept json @Produce json @Security BearerAuth @Param page query int false "页码" default(1) @Param page_size query int false "每页数量" default(20) @Param trade_no query string false "订单号" @Param email query string false "用户邮箱" @Param status query int false "订单状态" @Param type query int false "订单类型" @Param user_id query int false "用户ID" @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/orders [get]

func (*AdminHandler) GetOrderStats ¶

func (h *AdminHandler) GetOrderStats(c *gin.Context)

GetOrderStats godoc @Summary 获取订单统计 @Description 管理员获取订单统计数据 @Tags 管理端-订单 @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/orders/stats [get]

func (*AdminHandler) GetPlan ¶

func (h *AdminHandler) GetPlan(c *gin.Context)

GetPlan godoc @Summary 获取套餐详情 @Description 管理员获取指定套餐的详细信息 @Tags 管理端-套餐 @Accept json @Produce json @Security BearerAuth @Param id path int true "套餐ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 404 {object} map[string]any @Router /admin/plans/{id} [get]

func (*AdminHandler) GetPlans ¶

func (h *AdminHandler) GetPlans(c *gin.Context)

GetPlans godoc @Summary 获取套餐列表 @Description 管理员获取所有套餐列表 @Tags 管理端-套餐 @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/plans [get]

func (*AdminHandler) GetSystemInfo ¶

func (h *AdminHandler) GetSystemInfo(c *gin.Context)

GET /api/v2/admin/system/info

func (*AdminHandler) GetUser ¶

func (h *AdminHandler) GetUser(c *gin.Context)

GetUser godoc @Summary 获取用户详情 @Description 管理员获取用户详细信息 @Tags 管理端-用户 @Accept json @Produce json @Security BearerAuth @Param id path int true "用户ID" @Success 200 {object} map[string]any @Router /admin/users/{id} [get]

func (*AdminHandler) GetUserList ¶

func (h *AdminHandler) GetUserList(c *gin.Context)

GetUserList godoc Each user carries the account and subscription summary (service.UserListItem), never the subscription token or proxy uuid, which the user detail answers for one user. @Summary 获取用户列表 @Description 管理员获取用户列表 @Tags 管理端-用户 @Accept json @Produce json @Security BearerAuth @Param page query int false "页码" default(1) @Param page_size query int false "每页数量" default(20) @Param email query string false "邮箱搜索" @Param status query string false "状态筛选" @Param plan_id query int false "套餐ID筛选" @Success 200 {object} map[string]any @Router /admin/users [get]

func (*AdminHandler) GetUserStats ¶

func (h *AdminHandler) GetUserStats(c *gin.Context)

GetUserStats godoc @Summary 获取用户统计 @Description 管理员获取用户统计数据，包括总用户数、活跃用户等 @Tags 管理端-用户 @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/users/stats [get]

func (*AdminHandler) GetUserTrafficRanking ¶

func (h *AdminHandler) GetUserTrafficRanking(c *gin.Context)

GetUserTrafficRanking 返回最近 N 小时内按用户聚合的流量排行 (默认 24 小时, top 20) GET /api/v2/admin/traffic/user-ranking?hours=24&limit=20

func (*AdminHandler) MarkOrderPaid ¶

func (h *AdminHandler) MarkOrderPaid(c *gin.Context)

MarkOrderPaid godoc @Summary 标记订单已支付 @Description 管理员手动标记订单为已支付并开通服务 @Tags 管理端-订单 @Accept json @Produce json @Security BearerAuth @Param id path int true "订单ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/orders/{id}/paid [post]

func (*AdminHandler) ResetCompatFlow ¶

func (h *AdminHandler) ResetCompatFlow(c *gin.Context)

ResetCompatFlow is the Flux-style POST /api/v2/user/reset: type 1 zeroes a subscriber's traffic, under service.ForwardUserResetRequestID in the subscriber request ledger so that a retry applies once whichever side serves it (the forward package serves the route natively too); type 2 zeroes a tunnel permission's traffic and that of its forwards.

func (*AdminHandler) ResetUserSubscribe ¶

func (h *AdminHandler) ResetUserSubscribe(c *gin.Context)

ResetUserSubscribe godoc @Summary 重置用户订阅 @Description 管理员为用户重新生成订阅 token, 旧订阅链接立即失效 (UUID 不变) @Tags 管理端-用户 @Accept json @Produce json @Security BearerAuth @Param id path int true "用户ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/users/{id}/reset-subscribe [post]

func (*AdminHandler) ResetUserTraffic ¶

func (h *AdminHandler) ResetUserTraffic(c *gin.Context)

ResetUserTraffic godoc @Summary 重置用户流量 @Description 管理员重置指定用户的已使用流量 @Tags 管理端-用户 @Accept json @Produce json @Security BearerAuth @Param id path int true "用户ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/users/{id}/reset-traffic [post]

func (*AdminHandler) UnbanUser ¶

func (h *AdminHandler) UnbanUser(c *gin.Context)

UnbanUser godoc @Summary 解封用户 @Description 管理员解封指定用户 @Tags 管理端-用户 @Accept json @Produce json @Security BearerAuth @Param id path int true "用户ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/users/{id}/unban [post]

func (*AdminHandler) UpdateOrderStatus ¶

func (h *AdminHandler) UpdateOrderStatus(c *gin.Context)

UpdateOrderStatus godoc @Summary 更新订单状态 @Description 管理员更新指定订单的状态 @Tags 管理端-订单 @Accept json @Produce json @Security BearerAuth @Param id path int true "订单ID" @Param request body map[string]any true "状态请求 {status: int}" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/orders/{id}/status [put]

func (*AdminHandler) UpdatePlan ¶

func (h *AdminHandler) UpdatePlan(c *gin.Context)

UpdatePlan godoc @Summary 更新套餐 @Description 管理员更新指定套餐信息 @Tags 管理端-套餐 @Accept json @Produce json @Security BearerAuth @Param id path int true "套餐ID" @Param request body model.Plan true "套餐信息" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/plans/{id} [put]

func (*AdminHandler) UpdateUser ¶

func (h *AdminHandler) UpdateUser(c *gin.Context)

UpdateUser godoc @Summary 更新用户信息 @Description 管理员更新用户信息，支持修改邮箱、密码、余额、套餐等 @Tags 管理端-用户 @Accept json @Produce json @Security BearerAuth @Param id path int true "用户ID" @Param request body map[string]any true "用户更新信息" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/users/{id} [put]

func (*AdminKnowledgeHandler) CreateArticle ¶

func (h *AdminKnowledgeHandler) CreateArticle(c *gin.Context)

CreateArticle 创建文章

func (*AdminKnowledgeHandler) DeleteArticle ¶

func (h *AdminKnowledgeHandler) DeleteArticle(c *gin.Context)

DeleteArticle 删除文章

func (*AdminKnowledgeHandler) GetArticles ¶

func (h *AdminKnowledgeHandler) GetArticles(c *gin.Context)

GetArticles 获取文章列表

func (*AdminKnowledgeHandler) UpdateArticle ¶

func (h *AdminKnowledgeHandler) UpdateArticle(c *gin.Context)

UpdateArticle 更新文章

func (*AdminTicketHandler) CloseTicket ¶

func (h *AdminTicketHandler) CloseTicket(c *gin.Context)

CloseTicket 关闭工单

func (*AdminTicketHandler) GetTickets ¶

func (h *AdminTicketHandler) GetTickets(c *gin.Context)

GetTickets 获取工单列表

func (*AdminTicketHandler) ReplyTicket ¶

func (h *AdminTicketHandler) ReplyTicket(c *gin.Context)

ReplyTicket 回复工单

func (*AgentHandler) AgentGetForwardRules ¶

func (h *AgentHandler) AgentGetForwardRules(c *gin.Context)

AgentGetForwardRules godoc @Summary 鑾峰彇杞彂瑙勫垯 @Description Agent 鑾峰彇璇ヨ妭鐐圭殑杞彂瑙勫垯 @Tags Agent @Produce json @Param node_id query int true "鑺傜偣 ID" @Param X-API-Key header string true "forward node API token" @Success 200 {object} map[string]any @Failure 401 {object} map[string]any @Failure 403 {object} map[string]any @Router /api/v2/forward/agent/rules [get]

Only a forward node reads its rules: the request names the node (node_id, or the X-Node-ID header) and carries its API token (the X-API-Key header, or api_key or token), as the agent's other calls do. The route is public, and the rules show where every user's traffic goes.

func (*AgentHandler) AgentGetTasks ¶

func (h *AgentHandler) AgentGetTasks(c *gin.Context)

AgentGetTasks godoc @Summary 鑾峰彇寰呮墽琛屼换鍔?// @Description Agent 杞鑾峰彇寰呮墽琛岀殑浠诲姟 @Tags Agent @Produce json @Param node_id query int true "鑺傜偣 ID" @Success 200 {object} map[string]any @Router /api/v2/agent/tasks [get]

func (*AgentHandler) AgentHeartbeat ¶

func (h *AgentHandler) AgentHeartbeat(c *gin.Context)

AgentHeartbeat godoc @Summary Agent 蹇冭烦 @Description Agent 瀹氭湡鍙戦€佸績璺?// @Tags Agent @Accept json @Produce json @Param request body AgentHeartbeatRequest true "蹇冭烦淇℃伅" @Success 200 {object} map[string]any @Router /api/v2/agent/heartbeat [post]

func (*AgentHandler) AgentMonitor ¶

func (h *AgentHandler) AgentMonitor(c *gin.Context)

AgentMonitor godoc @Summary 涓婃姤鐩戞帶鏁版嵁 @Description Agent 涓婃姤绯荤粺鐩戞帶鏁版嵁 @Tags Agent @Accept json @Produce json @Param request body AgentMonitorRequest true "鐩戞帶鏁版嵁" @Success 200 {object} map[string]any @Router /api/v2/agent/monitor [post]

func (*AgentHandler) AgentRegister ¶

func (h *AgentHandler) AgentRegister(c *gin.Context)

AgentRegister godoc @Summary Agent 娉ㄥ唽 @Description Agent 鍚姩鏃舵敞鍐屽埌闈㈡澘 @Tags Agent @Accept json @Produce json @Param request body AgentRegisterRequest true "娉ㄥ唽淇℃伅" @Success 200 {object} map[string]any @Router /api/v2/agent/register [post]

func (*AgentHandler) AgentReportResult ¶

func (h *AgentHandler) AgentReportResult(c *gin.Context)

AgentReportResult godoc @Summary 涓婃姤浠诲姟缁撴灉 @Description Agent 涓婃姤浠诲姟鎵ц缁撴灉 @Tags Agent @Accept json @Produce json @Param request body AgentTaskResult true "浠诲姟缁撴灉" @Success 200 {object} map[string]any @Router /api/v2/agent/result [post]

func (*AgentHandler) AgentWebSocketUnified ¶

func (h *AgentHandler) AgentWebSocketUnified(c *gin.Context)

AgentWebSocketUnified supports both legacy message-auth and header/query-auth. @Summary WebSocket 杩炴帴 @Description Agent 寤虹珛 WebSocket 闀胯繛鎺?// @Tags Agent @Success 101 @Router /api/v2/agent/ws [get]

func (*AgentHandler) CreateTask ¶

func (h *AgentHandler) CreateTask(c *gin.Context)

CreateTask godoc @Summary 鍒涘缓浠诲姟 @Description 绠＄悊鍛樺悜鑺傜偣涓嬪彂浠诲姟 @Tags 绠＄悊绔?Agent @Accept json @Produce json @Security BearerAuth @Param request body CreateTaskRequest true "浠诲姟淇℃伅" @Success 200 {object} map[string]any @Router /admin/agent/tasks [post]

func (*AgentHandler) ExecuteCommand ¶

func (h *AgentHandler) ExecuteCommand(c *gin.Context)

ExecuteCommand godoc @Summary 鎵ц鍛戒护 @Description 绠＄悊鍛樺湪鑺傜偣涓婃墽琛屽懡浠?// @Tags 绠＄悊绔?Agent @Accept json @Produce json @Security BearerAuth @Param request body ExecuteCommandRequest true "鍛戒护淇℃伅" @Success 200 {object} map[string]any @Router /admin/agent/execute [post]

func (*AgentHandler) GetMonitor ¶

func (h *AgentHandler) GetMonitor(c *gin.Context)

GetMonitor godoc @Summary Get latest monitor payload from agent node @Description Query monitor data by node_id @Tags 管理端 Agent @Produce json @Security BearerAuth @Param node_id query int true "Node ID" @Success 200 {object} map[string]any @Failure 404 {object} map[string]any @Router /admin/agent/monitor [get]

func (*AgentHandler) GetTaskResult ¶

func (h *AgentHandler) GetTaskResult(c *gin.Context)

GetTaskResult godoc @Summary Get task execution result @Description Query the latest status/result for a task by task_id @Tags 管理端 Agent @Produce json @Security BearerAuth @Param task_id path string true "Task ID" @Success 200 {object} map[string]any @Failure 404 {object} map[string]any @Router /admin/agent/tasks/{task_id} [get]

func (*AgentHandler) ListAgents ¶

func (h *AgentHandler) ListAgents(c *gin.Context)

ListAgents godoc @Summary 鑾峰彇鍦ㄧ嚎 Agent 鍒楄〃 @Description 绠＄悊鍛樿幏鍙栨墍鏈夊湪绾跨殑 Agent @Tags 绠＄悊绔?Agent @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Router /admin/agent/list [get]

func (*AgentHandler) ListDiagnosticTasks ¶

func (h *AgentHandler) ListDiagnosticTasks(c *gin.Context)

ListDiagnosticTasks godoc @Summary List diagnostic task history @Description Query recent whitelisted diagnostic tasks, optionally filtered by node_id @Tags 管理端 Agent @Produce json @Security BearerAuth @Param node_id query int false "Node ID" @Param limit query int false "Limit" @Success 200 {object} map[string]any @Router /admin/agent/tasks [get]

func (*AgentHandler) PrepareWebSocketBridge ¶

func (h *AgentHandler) PrepareWebSocketBridge(c *gin.Context) bool

PrepareWebSocketBridge authenticates optional request credentials before a package-host relay is opened. It retains only the verified node identity in Gin context; the credential itself never reaches the package host.

func (*AgentHandler) RequireAgentNode ¶ added in v4.1.0

func (h *AgentHandler) RequireAgentNode(c *gin.Context)

RequireAgentNode authenticates an agent's HTTP request in the kernel, before the package gateway, as the agent WebSocket's preflight does: the node id comes from X-Node-ID or the node_id query, the token from X-API-Key or the api_key or token query, and verifyForwardNodeToken checks it. The verified node travels to the legacy handler as the kernel's trusted agent identity, so the credential never reaches the package host.

The heartbeat, task, result and monitor routes had no authentication: anyone could mark any node online, take and complete its queued tasks (forward runtime jobs included) or report its monitoring data.

func (*AgentHandler) WebSockets ¶ added in v4.1.0

func (h *AgentHandler) WebSockets() agentstreams.WebSockets

WebSockets is this handler's connected agents as the KernelNodeOps session RPCs and the agent.diagnostic executor read them (agentstreams.WebSockets).

func (*AgentPKIHandler) CreateEnrollmentToken ¶ added in v4.1.0

func (h *AgentPKIHandler) CreateEnrollmentToken(c *gin.Context)

CreateEnrollmentToken issues a one-time agent enrollment credential bound to a node.

func (*AuthHandler) Login ¶

func (h *AuthHandler) Login(c *gin.Context)

Login godoc @Summary 用户登录 @Description 用户登录获取 JWT Token @Tags 认证 @Accept json @Produce json @Param request body model.LoginRequest true "登录请求" @Success 200 {object} map[string]any "登录成功" @Failure 401 {object} map[string]any "认证失败" @Router /login [post]

func (*AuthHandler) Register ¶

func (h *AuthHandler) Register(c *gin.Context)

Register godoc @Summary 用户注册 @Description 创建新用户账户 @Tags 认证 @Accept json @Produce json @Param request body model.RegisterRequest true "注册请求" @Success 200 {object} map[string]any "注册成功" @Failure 400 {object} map[string]any "参数错误" @Router /register [post]

func (*CouponHandler) CheckCoupon ¶

func (h *CouponHandler) CheckCoupon(c *gin.Context)

CheckCoupon 校验优惠券是否可用

func (*ForwardCleanAgentHandler) CreateAgentToken ¶

func (h *ForwardCleanAgentHandler) CreateAgentToken(c *gin.Context)

func (*ForwardCleanAgentHandler) Heartbeat ¶

func (h *ForwardCleanAgentHandler) Heartbeat(c *gin.Context)

func (*ForwardCleanAgentHandler) InstallScript ¶

func (h *ForwardCleanAgentHandler) InstallScript(c *gin.Context)

func (*ForwardCleanAgentHandler) ListAgents ¶

func (h *ForwardCleanAgentHandler) ListAgents(c *gin.Context)

func (*ForwardCleanAgentHandler) Register ¶

func (h *ForwardCleanAgentHandler) Register(c *gin.Context)

func (*ForwardCleanAgentHandler) Report ¶

func (h *ForwardCleanAgentHandler) Report(c *gin.Context)

func (*ForwardCleanAgentHandler) RevokeAgent ¶

func (h *ForwardCleanAgentHandler) RevokeAgent(c *gin.Context)

func (*ForwardHandler) AssignPanelUserTunnel ¶

func (h *ForwardHandler) AssignPanelUserTunnel(c *gin.Context)

func (*ForwardHandler) CheckAnsibleMachine ¶

func (h *ForwardHandler) CheckAnsibleMachine(c *gin.Context)

func (*ForwardHandler) CheckNode ¶

func (h *ForwardHandler) CheckNode(c *gin.Context)

CheckNode godoc @Summary 健康检查节点 @Description 管理员对指定中转节点进行健康检查 @Tags 管理端-转发 @Accept json @Produce json @Security BearerAuth @Param id path int true "节点ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/forward/nodes/{id}/check [post]

func (*ForwardHandler) CreateAnsibleMachine ¶

func (h *ForwardHandler) CreateAnsibleMachine(c *gin.Context)

func (*ForwardHandler) CreateNode ¶

func (h *ForwardHandler) CreateNode(c *gin.Context)

CreateNode godoc @Summary 创建中转节点 @Description 管理员创建新的中转节点 @Tags 管理端-转发 @Accept json @Produce json @Security BearerAuth @Param request body CreateNodeRequest true "节点信息" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/forward/nodes [post]

func (*ForwardHandler) CreatePanelForward ¶

func (h *ForwardHandler) CreatePanelForward(c *gin.Context)

func (*ForwardHandler) CreatePanelTunnel ¶

func (h *ForwardHandler) CreatePanelTunnel(c *gin.Context)

func (*ForwardHandler) CreateRule ¶

func (h *ForwardHandler) CreateRule(c *gin.Context)

CreateRule godoc @Summary 创建转发规则 @Description 管理员创建新的转发规则 @Tags 管理端-转发 @Accept json @Produce json @Security BearerAuth @Param request body CreateRuleRequest true "规则信息" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/forward/rules [post]

func (*ForwardHandler) CreateUserRule ¶

func (h *ForwardHandler) CreateUserRule(c *gin.Context)

CreateUserRule godoc @Summary 管理员创建自己的旧版转发规则 @Description 旧版转发规则只能由管理员创建或修改：规则直接运行在所选中转和落地节点上，用户的隧道权限不覆盖它们。普通用户收到错误，应通过已授权的隧道创建转发 (/forward/create)。 @Tags 用户端 @Accept json @Produce json @Security BearerAuth @Param request body service.CreateRuleRequest true "规则信息" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Router /user/forward/rules [post]

func (*ForwardHandler) DeleteAnsibleMachine ¶

func (h *ForwardHandler) DeleteAnsibleMachine(c *gin.Context)

func (*ForwardHandler) DeleteNode ¶

func (h *ForwardHandler) DeleteNode(c *gin.Context)

DeleteNode godoc @Summary 删除中转节点 @Description 管理员删除指定中转节点 @Tags 管理端-转发 @Accept json @Produce json @Security BearerAuth @Param id path int true "节点ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/forward/nodes/{id} [delete]

func (*ForwardHandler) DeletePanelForward ¶

func (h *ForwardHandler) DeletePanelForward(c *gin.Context)

func (*ForwardHandler) DeletePanelTunnel ¶

func (h *ForwardHandler) DeletePanelTunnel(c *gin.Context)

func (*ForwardHandler) DeleteRule ¶

func (h *ForwardHandler) DeleteRule(c *gin.Context)

DeleteRule godoc @Summary 删除转发规则 @Description 管理员删除指定转发规则 @Tags 管理端-转发 @Accept json @Produce json @Security BearerAuth @Param id path int true "规则ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/forward/rules/{id} [delete]

func (*ForwardHandler) DiagnoseLocalRuntime ¶

func (h *ForwardHandler) DiagnoseLocalRuntime(c *gin.Context)

func (*ForwardHandler) DiagnoseNodeXRuntime ¶

func (h *ForwardHandler) DiagnoseNodeXRuntime(c *gin.Context)

func (*ForwardHandler) DiagnosePanelForward ¶

func (h *ForwardHandler) DiagnosePanelForward(c *gin.Context)

func (*ForwardHandler) DiagnosePanelRuntime ¶

func (h *ForwardHandler) DiagnosePanelRuntime(c *gin.Context)

func (*ForwardHandler) DiagnosePanelTunnel ¶

func (h *ForwardHandler) DiagnosePanelTunnel(c *gin.Context)

func (*ForwardHandler) ForceDeletePanelForward ¶

func (h *ForwardHandler) ForceDeletePanelForward(c *gin.Context)

func (*ForwardHandler) GetAnsibleMachine ¶

func (h *ForwardHandler) GetAnsibleMachine(c *gin.Context)

func (*ForwardHandler) GetForwardStats ¶

func (h *ForwardHandler) GetForwardStats(c *gin.Context)

GetForwardStats godoc @Summary 获取转发统计 @Description 管理员获取转发统计数据，包括节点数、在线数、流量等 @Tags 管理端-转发 @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Router /admin/forward/stats [get]

func (*ForwardHandler) GetLocalRuntimeStatus ¶

func (h *ForwardHandler) GetLocalRuntimeStatus(c *gin.Context)

func (*ForwardHandler) GetNode ¶

func (h *ForwardHandler) GetNode(c *gin.Context)

GetNode godoc @Summary 获取中转节点详情 @Description 管理员获取指定中转节点的详细信息 @Tags 管理端-转发 @Accept json @Produce json @Security BearerAuth @Param id path int true "节点ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 404 {object} map[string]any @Router /admin/forward/nodes/{id} [get]

func (*ForwardHandler) GetNodeXRuntimeStatus ¶

func (h *ForwardHandler) GetNodeXRuntimeStatus(c *gin.Context)

func (*ForwardHandler) GetObservabilityMultiIngress ¶

func (h *ForwardHandler) GetObservabilityMultiIngress(c *gin.Context)

GetObservabilityMultiIngress GET /admin/forward/observability/multi-ingress?targetId=

func (*ForwardHandler) GetObservabilityTopology ¶

func (h *ForwardHandler) GetObservabilityTopology(c *gin.Context)

GetObservabilityTopology GET /admin/forward/observability/topology

func (*ForwardHandler) GetObservabilityTrend ¶

func (h *ForwardHandler) GetObservabilityTrend(c *gin.Context)

GetObservabilityTrend GET /admin/forward/observability/trend?targetKey=&from=&to=

func (*ForwardHandler) GetPanelRuntimeStatus ¶

func (h *ForwardHandler) GetPanelRuntimeStatus(c *gin.Context)

func (*ForwardHandler) GetRule ¶

func (h *ForwardHandler) GetRule(c *gin.Context)

GetRule godoc @Summary 获取转发规则详情 @Description 管理员获取指定转发规则的详细信息 @Tags 管理端-转发 @Accept json @Produce json @Security BearerAuth @Param id path int true "规则ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 404 {object} map[string]any @Router /admin/forward/rules/{id} [get]

func (*ForwardHandler) GetUserRules ¶

func (h *ForwardHandler) GetUserRules(c *gin.Context)

GetUserRules godoc @Summary 获取用户的转发规则 @Description 用户获取自己的转发规则列表 @Tags 用户端 @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /user/forward/rules [get]

func (*ForwardHandler) ListAnsibleMachines ¶

func (h *ForwardHandler) ListAnsibleMachines(c *gin.Context)

func (*ForwardHandler) ListNodes ¶

func (h *ForwardHandler) ListNodes(c *gin.Context)

ListNodes godoc @Summary 获取中转节点列表 @Description 管理员获取中转节点列表，支持分页和类型筛选 @Tags 管理端-转发 @Accept json @Produce json @Security BearerAuth @Param type query string false "节点类型 (relay/exit)" @Param page query int false "页码" default(1) @Param page_size query int false "每页数量" default(20) @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/forward/nodes [get]

func (*ForwardHandler) ListObservabilityTargets ¶

func (h *ForwardHandler) ListObservabilityTargets(c *gin.Context)

ListObservabilityTargets GET /admin/forward/observability/targets

func (*ForwardHandler) ListPanelAdminTunnels ¶

func (h *ForwardHandler) ListPanelAdminTunnels(c *gin.Context)

func (*ForwardHandler) ListPanelForwards ¶

func (h *ForwardHandler) ListPanelForwards(c *gin.Context)

func (*ForwardHandler) ListPanelRuntimeJobs ¶

func (h *ForwardHandler) ListPanelRuntimeJobs(c *gin.Context)

func (*ForwardHandler) ListPanelTunnels ¶

func (h *ForwardHandler) ListPanelTunnels(c *gin.Context)

func (*ForwardHandler) ListPanelUserTunnels ¶

func (h *ForwardHandler) ListPanelUserTunnels(c *gin.Context)

func (*ForwardHandler) ListRules ¶

func (h *ForwardHandler) ListRules(c *gin.Context)

ListRules godoc @Summary 获取转发规则列表 @Description 管理员获取转发规则列表，支持分页和用户筛选 @Tags 管理端-转发 @Accept json @Produce json @Security BearerAuth @Param page query int false "页码" default(1) @Param page_size query int false "每页数量" default(20) @Param user_id query int false "用户ID" @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/forward/rules [get]

func (*ForwardHandler) PausePanelForward ¶

func (h *ForwardHandler) PausePanelForward(c *gin.Context)

func (*ForwardHandler) RemovePanelUserTunnel ¶

func (h *ForwardHandler) RemovePanelUserTunnel(c *gin.Context)

func (*ForwardHandler) ReportPanelForwardTraffic ¶

func (h *ForwardHandler) ReportPanelForwardTraffic(c *gin.Context)

func (*ForwardHandler) ResumePanelForward ¶

func (h *ForwardHandler) ResumePanelForward(c *gin.Context)

func (*ForwardHandler) SnapshotPanelForwardTraffic ¶

func (h *ForwardHandler) SnapshotPanelForwardTraffic(c *gin.Context)

func (*ForwardHandler) SyncAnsibleMachineStats ¶

func (h *ForwardHandler) SyncAnsibleMachineStats(c *gin.Context)

func (*ForwardHandler) SyncForwardsToBackend ¶

func (h *ForwardHandler) SyncForwardsToBackend(c *gin.Context)

func (*ForwardHandler) SyncNodeStats ¶

func (h *ForwardHandler) SyncNodeStats(c *gin.Context)

SyncNodeStats godoc @Summary 同步节点统计数据 @Description 从 gost 节点同步流量和连接统计数据到面板 @Tags 管理端-转发 @Accept json @Produce json @Security BearerAuth @Param id path int true "节点ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Router /admin/forward/nodes/{id}/sync-stats [post]

func (*ForwardHandler) TestGostConnection ¶

func (h *ForwardHandler) TestGostConnection(c *gin.Context)

TestGostConnection godoc @Summary 测试 gost 节点连接 @Description 测试与 gost 节点的 API 连接是否正常 @Tags 管理端-转发 @Accept json @Produce json @Security BearerAuth @Param request body TestGostConnectionRequest true "连接信息" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Router /admin/forward/test-connection [post]

func (*ForwardHandler) ToggleAnsibleMachine ¶

func (h *ForwardHandler) ToggleAnsibleMachine(c *gin.Context)

func (*ForwardHandler) ToggleNode ¶

func (h *ForwardHandler) ToggleNode(c *gin.Context)

ToggleNode godoc @Summary 切换节点状态 @Description 管理员启用或禁用指定中转节点 @Tags 管理端-转发 @Accept json @Produce json @Security BearerAuth @Param id path int true "节点ID" @Param request body ToggleRequest true "状态请求" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 404 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/forward/nodes/{id}/toggle [post]

func (*ForwardHandler) ToggleRule ¶

func (h *ForwardHandler) ToggleRule(c *gin.Context)

ToggleRule godoc @Summary 切换规则状态 @Description 管理员启用或禁用指定转发规则 @Tags 管理端-转发 @Accept json @Produce json @Security BearerAuth @Param id path int true "规则ID" @Param request body ToggleRequest true "状态请求" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/forward/rules/{id}/toggle [post]

func (*ForwardHandler) UpdateAnsibleMachine ¶

func (h *ForwardHandler) UpdateAnsibleMachine(c *gin.Context)

func (*ForwardHandler) UpdateNode ¶

func (h *ForwardHandler) UpdateNode(c *gin.Context)

UpdateNode godoc @Summary 更新中转节点 @Description 管理员更新指定中转节点的信息 @Tags 管理端-转发 @Accept json @Produce json @Security BearerAuth @Param id path int true "节点ID" @Param request body UpdateNodeRequest true "节点更新信息" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 404 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/forward/nodes/{id} [put]

func (*ForwardHandler) UpdatePanelForward ¶

func (h *ForwardHandler) UpdatePanelForward(c *gin.Context)

func (*ForwardHandler) UpdatePanelForwardOrder ¶

func (h *ForwardHandler) UpdatePanelForwardOrder(c *gin.Context)

func (*ForwardHandler) UpdatePanelTunnel ¶

func (h *ForwardHandler) UpdatePanelTunnel(c *gin.Context)

func (*ForwardHandler) UpdatePanelUserTunnel ¶

func (h *ForwardHandler) UpdatePanelUserTunnel(c *gin.Context)

func (*ForwardHandler) UpdateRule ¶

func (h *ForwardHandler) UpdateRule(c *gin.Context)

UpdateRule godoc @Summary 更新转发规则 @Description 管理员更新指定转发规则的信息 @Tags 管理端-转发 @Accept json @Produce json @Security BearerAuth @Param id path int true "规则ID" @Param request body UpdateRuleRequest true "规则更新信息" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 404 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/forward/rules/{id} [put]

func (*ForwardHandler) UploadPanelFlowData ¶

func (h *ForwardHandler) UploadPanelFlowData(c *gin.Context)

func (*InviteHandler) GenerateCode ¶

func (h *InviteHandler) GenerateCode(c *gin.Context)

GenerateCode godoc @Summary 鐢熸垚閭€璇风爜 @Description 鐢ㄦ埛鐢熸垚鏂扮殑閭€璇风爜 @Tags 鐢ㄦ埛绔? @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /user/invite/generate [post]

func (*InviteHandler) GetCommissionRecords ¶

func (h *InviteHandler) GetCommissionRecords(c *gin.Context)

GetCommissionRecords godoc @Summary 鑾峰彇浣ｉ噾璁板綍 @Description 鐢ㄦ埛鑾峰彇鑷繁鐨勪剑閲戣褰曞垪琛? @Tags 鐢ㄦ埛绔? @Accept json @Produce json @Security BearerAuth @Param page query int false "椤电爜" default(1) @Param page_size query int false "姣忛〉鏁伴噺" default(20) @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /user/invite/commissions [get]

func (*InviteHandler) GetConfig ¶

func (h *InviteHandler) GetConfig(c *gin.Context)

GetConfig godoc @Summary 鑾峰彇閭€璇烽厤缃? @Description 绠＄悊鍛樿幏鍙栭個璇风郴缁熼厤缃? @Tags 绠＄悊绔?绯荤粺 @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/invite/config [get]

func (*InviteHandler) GetInviteInfo ¶

func (h *InviteHandler) GetInviteInfo(c *gin.Context)

GetInviteInfo godoc @Summary 鑾峰彇閭€璇蜂俊鎭? @Description 鐢ㄦ埛鑾峰彇鑷繁鐨勯個璇风爜鍜屼剑閲戜俊鎭? @Tags 鐢ㄦ埛绔? @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /user/invite [get]

func (*InviteHandler) GetInviteStats ¶

func (h *InviteHandler) GetInviteStats(c *gin.Context)

GetInviteStats godoc @Summary 鑾峰彇閭€璇风粺璁? @Description 绠＄悊鍛樿幏鍙栭個璇风郴缁熺粺璁℃暟鎹? @Tags 绠＄悊绔?绯荤粺 @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Router /admin/invite/stats [get]

func (*InviteHandler) GetWithdrawRecords ¶

func (h *InviteHandler) GetWithdrawRecords(c *gin.Context)

GetWithdrawRecords godoc @Summary 鑾峰彇鎻愮幇璁板綍 @Description 鐢ㄦ埛鑾峰彇鑷繁鐨勬彁鐜拌褰曞垪琛? @Tags 鐢ㄦ埛绔? @Accept json @Produce json @Security BearerAuth @Param page query int false "椤电爜" default(1) @Param page_size query int false "姣忛〉鏁伴噺" default(20) @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /user/invite/withdrawals [get]

func (*InviteHandler) GetWithdrawals ¶

func (h *InviteHandler) GetWithdrawals(c *gin.Context)

GetWithdrawals godoc @Summary 鑾峰彇鎻愮幇鐢宠鍒楄〃 @Description 绠＄悊鍛樿幏鍙栨彁鐜扮敵璇峰垪琛? @Tags 绠＄悊绔?绯荤粺 @Accept json @Produce json @Security BearerAuth @Param status query string false "Status filter" @Param page query int false "椤电爜" default(1) @Param page_size query int false "姣忛〉鏁伴噺" default(20) @Success 200 {object} map[string]any @Router /admin/invite/withdrawals [get]

func (*InviteHandler) ProcessWithdraw ¶

func (h *InviteHandler) ProcessWithdraw(c *gin.Context)

ProcessWithdraw godoc @Summary 澶勭悊鎻愮幇鐢宠 @Description 绠＄悊鍛樺鐞嗘彁鐜扮敵璇凤紝鎵瑰噯鎴栨嫆缁? @Tags 绠＄悊绔?绯荤粺 @Accept json @Produce json @Security BearerAuth @Param id path int true "鎻愮幇璁板綍ID" @Param request body map[string]any true "澶勭悊璇锋眰 {status, remark}" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 404 {object} map[string]any @Router /admin/invite/withdrawals/{id}/process [post]

func (*InviteHandler) RequestWithdraw ¶

func (h *InviteHandler) RequestWithdraw(c *gin.Context)

RequestWithdraw godoc @Summary 鐢宠鎻愮幇 @Description 鐢ㄦ埛鐢宠浣ｉ噾鎻愮幇 @Tags 鐢ㄦ埛绔? @Accept json @Produce json @Security BearerAuth @Param request body map[string]any true "鎻愮幇璇锋眰 {amount, method, account, name}" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Router /user/invite/withdraw [post]

func (*InviteHandler) UpdateConfig ¶

func (h *InviteHandler) UpdateConfig(c *gin.Context)

UpdateConfig godoc @Summary 鏇存柊閭€璇烽厤缃? @Description 绠＄悊鍛樻洿鏂伴個璇风郴缁熼厤缃? @Tags 绠＄悊绔?绯荤粺 @Accept json @Produce json @Security BearerAuth @Param request body model.InviteConfig true "Invite configuration" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/invite/config [put]

func (*KernelHandler) AddGroupPlan ¶

func (h *KernelHandler) AddGroupPlan(c *gin.Context)

func (*KernelHandler) AddGroupUser ¶

func (h *KernelHandler) AddGroupUser(c *gin.Context)

func (*KernelHandler) ApplyDeployment ¶

func (h *KernelHandler) ApplyDeployment(c *gin.Context)

func (*KernelHandler) CancelOperation ¶

func (h *KernelHandler) CancelOperation(c *gin.Context)

func (*KernelHandler) CreateAccessGroup ¶

func (h *KernelHandler) CreateAccessGroup(c *gin.Context)

func (*KernelHandler) CreateOperation ¶

func (h *KernelHandler) CreateOperation(c *gin.Context)

func (*KernelHandler) CreateResourceGrant ¶

func (h *KernelHandler) CreateResourceGrant(c *gin.Context)

func (*KernelHandler) CreateTopology ¶

func (h *KernelHandler) CreateTopology(c *gin.Context)

func (*KernelHandler) CreateTopologyRevision ¶

func (h *KernelHandler) CreateTopologyRevision(c *gin.Context)

func (*KernelHandler) DeleteAccessGroup ¶

func (h *KernelHandler) DeleteAccessGroup(c *gin.Context)

func (*KernelHandler) DeleteAssignment ¶

func (h *KernelHandler) DeleteAssignment(c *gin.Context)

func (*KernelHandler) DeleteQuotaPolicy ¶

func (h *KernelHandler) DeleteQuotaPolicy(c *gin.Context)

func (*KernelHandler) DeleteResourceGrant ¶

func (h *KernelHandler) DeleteResourceGrant(c *gin.Context)

func (*KernelHandler) DiagnoseTopologyDeployment ¶

func (h *KernelHandler) DiagnoseTopologyDeployment(c *gin.Context)

DiagnoseTopologyDeployment is a semantic alias retained for clients that use the contract's diagnose naming. Both endpoints are strictly read-only.

func (*KernelHandler) GetAccessGroupDetail ¶

func (h *KernelHandler) GetAccessGroupDetail(c *gin.Context)

GetAccessGroupDetail returns the associated identities and policy records needed to safely administer one access group. The underlying models stay normalized so the allow-union resolver remains the single authorization implementation rather than a client-side reconstruction.

func (*KernelHandler) GetDeploymentStatus ¶

func (h *KernelHandler) GetDeploymentStatus(c *gin.Context)

func (*KernelHandler) GetPluginInstallationConfiguration ¶

func (h *KernelHandler) GetPluginInstallationConfiguration(c *gin.Context)

func (*KernelHandler) GetPluginReleaseArtifact ¶

func (h *KernelHandler) GetPluginReleaseArtifact(c *gin.Context)

func (*KernelHandler) GetTopologyRevision ¶

func (h *KernelHandler) GetTopologyRevision(c *gin.Context)

func (*KernelHandler) ListAccessGroups ¶

func (h *KernelHandler) ListAccessGroups(c *gin.Context)

func (*KernelHandler) ListAssignments ¶

func (h *KernelHandler) ListAssignments(c *gin.Context)

func (*KernelHandler) ListDeployments ¶

func (h *KernelHandler) ListDeployments(c *gin.Context)

func (*KernelHandler) ListExtensions ¶

func (h *KernelHandler) ListExtensions(c *gin.Context)

func (*KernelHandler) ListObservedStates ¶

func (h *KernelHandler) ListObservedStates(c *gin.Context)

func (*KernelHandler) ListOperations ¶

func (h *KernelHandler) ListOperations(c *gin.Context)

func (*KernelHandler) ListPluginInstallations ¶

func (h *KernelHandler) ListPluginInstallations(c *gin.Context)

func (*KernelHandler) ListPluginReleases ¶

func (h *KernelHandler) ListPluginReleases(c *gin.Context)

func (*KernelHandler) ListPlugins ¶

func (h *KernelHandler) ListPlugins(c *gin.Context)

func (*KernelHandler) ListQuotaPolicies ¶

func (h *KernelHandler) ListQuotaPolicies(c *gin.Context)

func (*KernelHandler) ListResourceGrants ¶

func (h *KernelHandler) ListResourceGrants(c *gin.Context)

func (*KernelHandler) ListServiceScopes ¶

func (h *KernelHandler) ListServiceScopes(c *gin.Context)

func (*KernelHandler) ListTopologies ¶

func (h *KernelHandler) ListTopologies(c *gin.Context)

func (*KernelHandler) ListTopologyRevisions ¶

func (h *KernelHandler) ListTopologyRevisions(c *gin.Context)

func (*KernelHandler) PlanDeployment ¶

func (h *KernelHandler) PlanDeployment(c *gin.Context)

func (*KernelHandler) PluginInstallationAction ¶

func (h *KernelHandler) PluginInstallationAction(c *gin.Context)

func (*KernelHandler) PluginRouteGateway ¶

func (h *KernelHandler) PluginRouteGateway(c *gin.Context)

func (*KernelHandler) PreviewDeployment ¶

func (h *KernelHandler) PreviewDeployment(c *gin.Context)

PreviewDeployment is the body-addressed variant used by automation that has not yet selected a nested topology route.

func (*KernelHandler) PreviewTopologyDeployment ¶

func (h *KernelHandler) PreviewTopologyDeployment(c *gin.Context)

PreviewTopologyDeployment runs the read-only topology preflight. It returns HTTP 200 with valid=false and structured issues for an invalid graph so the editor can render all problems in one request; only missing database rows are transport errors.

func (*KernelHandler) RegisterPluginRelease ¶

func (h *KernelHandler) RegisterPluginRelease(c *gin.Context)

func (*KernelHandler) RemoveGroupPlan ¶

func (h *KernelHandler) RemoveGroupPlan(c *gin.Context)

func (*KernelHandler) RemoveGroupUser ¶

func (h *KernelHandler) RemoveGroupUser(c *gin.Context)

func (*KernelHandler) ResolveAccess ¶

func (h *KernelHandler) ResolveAccess(c *gin.Context)

func (*KernelHandler) RollbackDeployment ¶

func (h *KernelHandler) RollbackDeployment(c *gin.Context)

func (*KernelHandler) ServeAgentPluginArtifact ¶

func (h *KernelHandler) ServeAgentPluginArtifact(c *gin.Context)

func (*KernelHandler) ServeAgentPluginManifest ¶

func (h *KernelHandler) ServeAgentPluginManifest(c *gin.Context)

func (*KernelHandler) ServePluginWebUIAsset ¶

func (h *KernelHandler) ServePluginWebUIAsset(c *gin.Context)

func (*KernelHandler) UpdateAccessGroup ¶

func (h *KernelHandler) UpdateAccessGroup(c *gin.Context)

func (*KernelHandler) UpdatePluginInstallationConfiguration ¶

func (h *KernelHandler) UpdatePluginInstallationConfiguration(c *gin.Context)

func (*KernelHandler) UploadPluginReleaseArtifact ¶

func (h *KernelHandler) UploadPluginReleaseArtifact(c *gin.Context)

func (*KernelHandler) UpsertAssignment ¶

func (h *KernelHandler) UpsertAssignment(c *gin.Context)

func (*KernelHandler) UpsertPluginInstallation ¶

func (h *KernelHandler) UpsertPluginInstallation(c *gin.Context)

func (*KernelHandler) UpsertQuotaPolicy ¶

func (h *KernelHandler) UpsertQuotaPolicy(c *gin.Context)

func (*KernelHandler) ValidateTopology ¶

func (h *KernelHandler) ValidateTopology(c *gin.Context)

func (*KernelNodeOperationsHandler) List ¶ added in v4.1.0

func (h *KernelNodeOperationsHandler) List(c *gin.Context)

List answers GET /api/v4/kernel/node-operations: every package's node operations, newest first, filtered by package_id, family, kind, state, request_id, operation_id, parent_operation_id, or target_kind with target_id, and paged by before (a cursor) and limit (at most 500).

func (*KnowledgeHandler) GetArticle ¶

func (h *KnowledgeHandler) GetArticle(c *gin.Context)

GetArticle 获取单篇文章详情

func (*KnowledgeHandler) GetArticles ¶

func (h *KnowledgeHandler) GetArticles(c *gin.Context)

GetArticles 获取文章列表 (仅可见且按排序)

func (*LoadBalancerHandler) CreateLoadBalancer ¶

func (h *LoadBalancerHandler) CreateLoadBalancer(c *gin.Context)

CreateLoadBalancer godoc @Summary 创建负载均衡器 @Description 管理员创建新的负载均衡器 @Tags 管理端-系统 @Accept json @Produce json @Security BearerAuth @Param request body model.LoadBalancer true "负载均衡器配置" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/loadbalancers [post]

func (*LoadBalancerHandler) DeleteLoadBalancer ¶

func (h *LoadBalancerHandler) DeleteLoadBalancer(c *gin.Context)

DeleteLoadBalancer godoc @Summary 删除负载均衡器 @Description 管理员删除指定负载均衡器 @Tags 管理端-系统 @Accept json @Produce json @Security BearerAuth @Param id path int true "负载均衡器ID" @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/loadbalancers/{id} [delete]

func (*LoadBalancerHandler) GetLoadBalancer ¶

func (h *LoadBalancerHandler) GetLoadBalancer(c *gin.Context)

GetLoadBalancer godoc @Summary 获取负载均衡器详情 @Description 管理员获取指定负载均衡器的详细信息 @Tags 管理端-系统 @Accept json @Produce json @Security BearerAuth @Param id path int true "负载均衡器ID" @Success 200 {object} map[string]any @Failure 404 {object} map[string]any @Router /admin/loadbalancers/{id} [get]

func (*LoadBalancerHandler) GetLoadBalancerStats ¶

func (h *LoadBalancerHandler) GetLoadBalancerStats(c *gin.Context)

GetLoadBalancerStats godoc @Summary 获取负载均衡统计 @Description 管理员获取指定负载均衡器的统计数据 @Tags 管理端-系统 @Accept json @Produce json @Security BearerAuth @Param id path int true "负载均衡器ID" @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/loadbalancers/{id}/stats [get]

func (*LoadBalancerHandler) ListLoadBalancers ¶

func (h *LoadBalancerHandler) ListLoadBalancers(c *gin.Context)

ListLoadBalancers godoc @Summary 获取负载均衡器列表 @Description 管理员获取负载均衡器列表 @Tags 管理端-系统 @Accept json @Produce json @Security BearerAuth @Param group_id query int false "分组ID" @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/loadbalancers [get]

func (*LoadBalancerHandler) RunHealthCheck ¶

func (h *LoadBalancerHandler) RunHealthCheck(c *gin.Context)

RunHealthCheck godoc @Summary 执行健康检查 @Description 管理员对指定负载均衡器执行健康检查 @Tags 管理端-系统 @Accept json @Produce json @Security BearerAuth @Param id path int true "负载均衡器ID" @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/loadbalancers/{id}/check [post]

func (*LoadBalancerHandler) UpdateLoadBalancer ¶

func (h *LoadBalancerHandler) UpdateLoadBalancer(c *gin.Context)

UpdateLoadBalancer godoc @Summary 更新负载均衡器 @Description 管理员更新指定负载均衡器的配置 @Tags 管理端-系统 @Accept json @Produce json @Security BearerAuth @Param id path int true "负载均衡器ID" @Param request body model.LoadBalancer true "负载均衡器配置" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 404 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/loadbalancers/{id} [put]

func (*MFAHandler) DisableMFA ¶

func (h *MFAHandler) DisableMFA(c *gin.Context)

DisableMFA disables MFA with password confirmation.

func (*MFAHandler) EnableTOTP ¶

func (h *MFAHandler) EnableTOTP(c *gin.Context)

EnableTOTP enables TOTP with verification code.

func (*MFAHandler) GetAdminConfig ¶

func (h *MFAHandler) GetAdminConfig(c *gin.Context)

GetAdminConfig returns global MFA admin config.

func (*MFAHandler) GetStatus ¶

func (h *MFAHandler) GetStatus(c *gin.Context)

GetStatus gets MFA status for current user.

func (*MFAHandler) RegenerateBackupCodes ¶

func (h *MFAHandler) RegenerateBackupCodes(c *gin.Context)

RegenerateBackupCodes regenerates backup codes for current user.

func (*MFAHandler) SetupTOTP ¶

func (h *MFAHandler) SetupTOTP(c *gin.Context)

SetupTOTP sets up TOTP for current user.

func (*MFAHandler) UpdateAdminConfig ¶

func (h *MFAHandler) UpdateAdminConfig(c *gin.Context)

UpdateAdminConfig updates and persists MFA admin config.

func (*MFAHandler) VerifyMFA ¶

func (h *MFAHandler) VerifyMFA(c *gin.Context)

VerifyMFA verifies MFA code.

func (*MetricsHandler) GetMetrics ¶

func (h *MetricsHandler) GetMetrics(c *gin.Context)

GetMetrics godoc @Summary Prometheus 指标 @Description 获取 Prometheus 格式的系统指标 @Tags 系统 @Produce plain @Success 200 {string} string "Prometheus metrics" @Router /metrics [get]

func (*MetricsHandler) RecordRequest ¶

func (h *MetricsHandler) RecordRequest(success bool)

RecordRequest 记录请求

func (*ModuleHandler) CreateEnrollment ¶ added in v4.1.0

func (h *ModuleHandler) CreateEnrollment(c *gin.Context)

CreateEnrollment issues an enrollment credential for a module.

func (*ModuleHandler) ListEnrollments ¶ added in v4.1.0

func (h *ModuleHandler) ListEnrollments(c *gin.Context)

ListEnrollments lists enrollment credentials without their secrets.

func (*ModuleHandler) ListRuntimes ¶ added in v4.1.0

func (h *ModuleHandler) ListRuntimes(c *gin.Context)

ListRuntimes lists the packages whose runtime was chosen explicitly; all others run locally.

func (*ModuleHandler) RevokeEnrollment ¶ added in v4.1.0

func (h *ModuleHandler) RevokeEnrollment(c *gin.Context)

RevokeEnrollment revokes a credential and the certificates issued with it.

func (*ModuleHandler) RotateCA ¶ added in v4.1.0

func (h *ModuleHandler) RotateCA(c *gin.Context)

RotateCA creates the next module CA; it signs after one certificate lifetime.

func (*ModuleHandler) SetRuntime ¶ added in v4.1.0

func (h *ModuleHandler) SetRuntime(c *gin.Context)

SetRuntime selects local or remote for a package. It applies at the package's next lifecycle operation.

func (*ModuleHandler) TrustBundle ¶ added in v4.1.0

func (h *ModuleHandler) TrustBundle(c *gin.Context)

TrustBundle returns the module CA bundle as PEM for module deployments.

func (*MonitorWSHandler) HandleMonitorWS ¶

func (h *MonitorWSHandler) HandleMonitorWS(c *gin.Context)

HandleMonitorWS 处理 WebSocket 监控连接 @Summary WebSocket 实时监控 @Description 实时推送节点监控数据 @Tags 管理端-WebSocket @Produce json @Security BearerAuth @Success 101 @Router /admin/ws/monitor [get]

func (Node) TableName ¶

func (Node) TableName() string

func (*NodeHandler) CreateNode ¶

func (h *NodeHandler) CreateNode(c *gin.Context)

CreateNode godoc @Summary 创建节点 @Description 管理员手动创建节点 @Tags 管理端-节点 @Accept json @Produce json @Security BearerAuth @Param request body model.Node true "节点信息" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/nodes [post]

func (*NodeHandler) CreateProtocol ¶

func (h *NodeHandler) CreateProtocol(c *gin.Context)

CreateProtocol godoc @Summary 创建节点协议 @Description 管理员为指定节点创建协议配置 @Tags 管理端-节点 @Accept json @Produce json @Security BearerAuth @Param id path int true "节点ID" @Param request body model.NodeProtocol true "协议配置" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/nodes/{id}/protocols [post]

func (*NodeHandler) DeleteAuthKey ¶

func (h *NodeHandler) DeleteAuthKey(c *gin.Context)

DeleteAuthKey godoc @Summary 删除授权密钥 @Description 管理员删除指定的授权密钥 @Tags 管理端-节点 @Accept json @Produce json @Security BearerAuth @Param id path int true "密钥ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/auth-keys/{id} [delete]

func (*NodeHandler) DeleteNode ¶

func (h *NodeHandler) DeleteNode(c *gin.Context)

DeleteNode godoc @Summary 删除节点 @Description 管理员删除指定节点 @Tags 管理端-节点 @Accept json @Produce json @Security BearerAuth @Param id path int true "节点ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/nodes/{id} [delete]

func (*NodeHandler) DeleteProtocol ¶

func (h *NodeHandler) DeleteProtocol(c *gin.Context)

DeleteProtocol godoc @Summary 删除节点协议 @Description 管理员删除指定的节点协议配置 @Tags 管理端-节点 @Accept json @Produce json @Security BearerAuth @Param protocol_id path int true "协议ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/nodes/protocols/{protocol_id} [delete]

func (*NodeHandler) DispatchAgentControlOperation ¶

func (h *NodeHandler) DispatchAgentControlOperation(c *gin.Context)

DispatchAgentControlOperation sends a bounded, capability-backed operation.

func (*NodeHandler) GenerateAuthKey ¶

func (h *NodeHandler) GenerateAuthKey(c *gin.Context)

GenerateAuthKey godoc @Summary 生成授权密钥 @Description 管理员生成节点自动注册的授权密钥 @Tags 管理端-节点 @Accept json @Produce json @Security BearerAuth @Param request body map[string]any true "密钥请求 {name, expire_days}" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/auth-keys [post]

func (*NodeHandler) GenerateWireGuardKeypair ¶

func (h *NodeHandler) GenerateWireGuardKeypair(c *gin.Context)

GenerateWireGuardKeypair creates a WireGuard server keypair for the admin protocol form. The private key is returned only to the authenticated caller and is never stored by this endpoint.

func (*NodeHandler) GetAgentControlStatus ¶

func (h *NodeHandler) GetAgentControlStatus(c *gin.Context)

GetAgentControlStatus returns the live v3 control-stream state for one node.

func (*NodeHandler) GetAuthKeys ¶

func (h *NodeHandler) GetAuthKeys(c *gin.Context)

GetAuthKeys godoc @Summary 获取授权密钥列表 @Description 管理员获取所有授权密钥列表。密钥值显示为 ********, 只在生成时返回一次。 @Tags 管理端-节点 @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/auth-keys [get]

func (*NodeHandler) GetNode ¶

func (h *NodeHandler) GetNode(c *gin.Context)

GetNode godoc @Summary 获取节点详情 @Description 管理员获取指定节点的详细信息 @Tags 管理端-节点 @Accept json @Produce json @Security BearerAuth @Param id path int true "节点ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 404 {object} map[string]any @Router /admin/nodes/{id} [get]

func (*NodeHandler) GetNodeCredentials ¶

func (h *NodeHandler) GetNodeCredentials(c *gin.Context)

GetNodeCredentials godoc @Summary 获取节点凭证 @Description 管理员获取指定节点的 api_key / secret, 用于 AnixOps Agent 对接配置。 @Description Node.APIKey/Secret 在普通序列化里是隐藏字段 (json:"-"), 此接口显式返回, @Description 仅限管理员, 供 Ansible 等部署工具自动拉取节点凭证。 @Description 每次读取都写入管理员审计日志 (action "reveal")。 @Tags 管理端-节点 @Accept json @Produce json @Security BearerAuth @Param id path int true "节点ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 404 {object} map[string]any @Router /admin/nodes/{id}/credentials [get]

func (*NodeHandler) GetNodeLogs ¶

func (h *NodeHandler) GetNodeLogs(c *gin.Context)

GetNodeLogs godoc @Summary 获取节点运行日志 @Description 管理员获取指定节点通过 gRPC 上报的运行日志 @Tags 管理端-节点 @Accept json @Produce json @Security BearerAuth @Param id path int true "节点ID" @Param page query int false "页码" default(1) @Param page_size query int false "每页数量" default(20) @Param level query string false "日志级别" @Param source query string false "日志来源" @Param search query string false "关键词" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/nodes/{id}/logs [get]

func (*NodeHandler) GetNodeRawConfig ¶

func (h *NodeHandler) GetNodeRawConfig(c *gin.Context)

GetNodeRawConfig godoc @Summary 获取节点原始配置 @Description 管理员获取指定节点的原始JSON配置 @Tags 管理端-节点 @Accept json @Produce json @Security BearerAuth @Param id path int true "节点ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 404 {object} map[string]any @Router /admin/nodes/{id}/raw-config [get]

func (*NodeHandler) GetNodeStats ¶

func (h *NodeHandler) GetNodeStats(c *gin.Context)

GetNodeStats godoc @Summary 获取节点统计 @Description 管理员获取节点统计数据 @Tags 管理端-节点 @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/nodes/stats [get]

func (*NodeHandler) GetNodes ¶

func (h *NodeHandler) GetNodes(c *gin.Context)

GetNodes godoc @Summary 获取节点列表 @Description 管理员获取节点列表，支持分页和筛选 @Tags 管理端-节点 @Accept json @Produce json @Security BearerAuth @Param page query int false "页码" default(1) @Param page_size query int false "每页数量" default(20) @Param search query string false "搜索关键词" @Param status query int false "节点状态" @Param group_id query int false "分组ID" @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/nodes [get]

func (*NodeHandler) GetProtocolTemplates ¶

func (h *NodeHandler) GetProtocolTemplates(c *gin.Context)

GetProtocolTemplates godoc @Summary 获取协议模板 @Description 管理员获取可用的协议模板列表 @Tags 管理端-节点 @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Router /admin/protocol-templates [get]

func (*NodeHandler) GetProtocols ¶

func (h *NodeHandler) GetProtocols(c *gin.Context)

GetProtocols godoc @Summary 获取节点协议列表 @Description 管理员获取指定节点的协议配置列表 @Tags 管理端-节点 @Accept json @Produce json @Security BearerAuth @Param id path int true "节点ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/nodes/{id}/protocols [get]

func (*NodeHandler) Heartbeat ¶

func (h *NodeHandler) Heartbeat(c *gin.Context)

Heartbeat godoc @Summary 节点心跳 @Description 节点向面板发送心跳以保持在线状态 @Tags 节点通信 @Accept json @Produce json @Security BearerAuth @Param request body model.NodeHeartbeatRequest true "心跳请求" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 401 {object} map[string]any @Failure 500 {object} map[string]any @Router /node/heartbeat [post]

func (*NodeHandler) InternalGenerateAuthKey ¶

func (h *NodeHandler) InternalGenerateAuthKey(c *gin.Context)

InternalGenerateAuthKey godoc @Summary 内部生成授权密钥 @Description 使用API Token认证生成节点自动注册的授权密钥（供Ansible等自动化工具使用） @Tags 内部API @Accept json @Produce json @Security ApiTokenAuth @Param request body map[string]any true "密钥请求 {name, expire_days, node_name}" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /internal/auth-keys [post]

func (*NodeHandler) Register ¶

func (h *NodeHandler) Register(c *gin.Context)

Register godoc @Summary 节点自动注册 @Description 节点通过授权密钥自动注册到面板 @Tags 节点通信 @Accept json @Produce json @Param request body model.NodeRegisterRequest true "注册请求" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Router /node/register [post]

func (*NodeHandler) RuntimeHealth ¶

func (h *NodeHandler) RuntimeHealth(c *gin.Context)

RuntimeHealth godoc @Summary 上报节点运行时健康状态 @Description 节点上报 WireGuard/GOST 等托管运行时的进程健康状态，不覆盖普通心跳状态 @Tags 节点通信 @Accept json @Produce json @Security BearerAuth @Param request body model.NodeRuntimeHealthRequest true "运行时健康状态" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 401 {object} map[string]any @Failure 404 {object} map[string]any @Failure 500 {object} map[string]any @Router /node/runtime-health [post]

func (*NodeHandler) SyncProtocol ¶

func (h *NodeHandler) SyncProtocol(c *gin.Context)

SyncProtocol godoc @Summary 同步协议到节点 @Description 管理员将协议配置同步到指定节点 @Tags 管理端-节点 @Accept json @Produce json @Security BearerAuth @Param id path int true "节点ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/nodes/{id}/sync [post]

func (*NodeHandler) UpdateNode ¶

func (h *NodeHandler) UpdateNode(c *gin.Context)

UpdateNode godoc @Summary 更新节点 @Description 管理员更新指定节点的信息 @Tags 管理端-节点 @Accept json @Produce json @Security BearerAuth @Param id path int true "节点ID" @Param request body map[string]any true "节点更新信息" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/nodes/{id} [put]

func (*NodeHandler) UpdateNodeRawConfig ¶

func (h *NodeHandler) UpdateNodeRawConfig(c *gin.Context)

UpdateNodeRawConfig godoc @Summary 更新节点原始配置 @Description 管理员更新指定节点的原始JSON配置（高级模式） @Tags 管理端-节点 @Accept json @Produce json @Security BearerAuth @Param id path int true "节点ID" @Param request body map[string]any true "原始配置 {raw_config: object}" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/nodes/{id}/raw-config [put]

func (*NodeHandler) UpdateProtocol ¶

func (h *NodeHandler) UpdateProtocol(c *gin.Context)

UpdateProtocol godoc @Summary 更新节点协议 @Description 管理员更新指定的节点协议配置 @Tags 管理端-节点 @Accept json @Produce json @Security BearerAuth @Param protocol_id path int true "协议ID" @Param request body map[string]any true "协议更新信息" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/nodes/protocols/{protocol_id} [put]

func (*NodeHandler) ValidateRawConfig ¶

func (h *NodeHandler) ValidateRawConfig(c *gin.Context)

ValidateRawConfig godoc @Summary 验证原始配置 @Description 管理员验证节点原始JSON配置的有效性 @Tags 管理端-节点 @Accept json @Produce json @Security BearerAuth @Param request body map[string]any true "原始配置 {raw_config: object}" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Router /admin/nodes/validate-config [post]

func (*NotificationHandler) CreateTemplate ¶

func (h *NotificationHandler) CreateTemplate(c *gin.Context)

CreateTemplate godoc @Summary 创建通知模板 @Description 管理员创建新的通知模板 @Tags 管理端-通知 @Accept json @Produce json @Security BearerAuth @Param request body map[string]any true "模板信息" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/notification/templates [post]

func (*NotificationHandler) DeleteTemplate ¶

func (h *NotificationHandler) DeleteTemplate(c *gin.Context)

DeleteTemplate godoc @Summary 删除通知模板 @Description 管理员删除指定通知模板 @Tags 管理端-通知 @Accept json @Produce json @Security BearerAuth @Param id path int true "模板ID" @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/notification/templates/{id} [delete]

func (*NotificationHandler) GetEmailConfig ¶

func (h *NotificationHandler) GetEmailConfig(c *gin.Context)

GetEmailConfig godoc @Summary 获取邮件配置 @Description 管理员获取邮件发送配置 @Tags 管理端-通知 @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Router /admin/notification/email/config [get]

func (*NotificationHandler) GetUnreadCount ¶

func (h *NotificationHandler) GetUnreadCount(c *gin.Context)

GetUnreadCount godoc @Summary 获取未读通知数量 @Description 用户获取未读通知的数量 @Tags 用户端 @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Router /user/notifications/unread-count [get]

func (*NotificationHandler) GetUserNotifications ¶

func (h *NotificationHandler) GetUserNotifications(c *gin.Context)

GetUserNotifications godoc @Summary 获取用户通知列表 @Description 用户获取自己的通知列表 @Tags 用户端 @Accept json @Produce json @Security BearerAuth @Param page query int false "页码" default(1) @Param page_size query int false "每页数量" default(20) @Success 200 {object} map[string]any @Router /user/notifications [get]

func (*NotificationHandler) ListLogs ¶

func (h *NotificationHandler) ListLogs(c *gin.Context)

ListLogs godoc @Summary 获取通知日志列表 @Description 管理员获取通知日志列表 @Tags 管理端-通知 @Accept json @Produce json @Security BearerAuth @Param page query int false "页码" default(1) @Param page_size query int false "每页数量" default(20) @Param type query string false "通知类型" @Param status query string false "发送状态" @Success 200 {object} map[string]any @Router /admin/notification/logs [get]

func (*NotificationHandler) ListTemplates ¶

func (h *NotificationHandler) ListTemplates(c *gin.Context)

ListTemplates godoc @Summary 获取通知模板列表 @Description 管理员获取通知模板列表 @Tags 管理端-通知 @Accept json @Produce json @Security BearerAuth @Param type query string false "通知类型" @Success 200 {object} map[string]any @Router /admin/notification/templates [get]

func (*NotificationHandler) MarkAllAsRead ¶

func (h *NotificationHandler) MarkAllAsRead(c *gin.Context)

MarkAllAsRead godoc @Summary 标记所有通知为已读 @Description 用户将所有通知标记为已读 @Tags 用户端 @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Router /user/notifications/read-all [post]

func (*NotificationHandler) MarkAsRead ¶

func (h *NotificationHandler) MarkAsRead(c *gin.Context)

MarkAsRead godoc @Summary 标记通知为已读 @Description 用户将指定通知标记为已读 @Tags 用户端 @Accept json @Produce json @Security BearerAuth @Param id path int true "通知ID" @Success 200 {object} map[string]any @Failure 404 {object} map[string]any @Router /user/notifications/{id}/read [post]

func (*NotificationHandler) SendTestNotification ¶

func (h *NotificationHandler) SendTestNotification(c *gin.Context)

SendTestNotification godoc @Summary 发送测试通知 @Description 管理员发送测试通知 @Tags 管理端-通知 @Accept json @Produce json @Security BearerAuth @Param request body map[string]any true "测试通知请求" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/notification/test [post]

func (*NotificationHandler) UpdateEmailConfig ¶

func (h *NotificationHandler) UpdateEmailConfig(c *gin.Context)

UpdateEmailConfig godoc @Summary 更新邮件配置 @Description 管理员更新邮件发送配置 @Tags 管理端-通知 @Accept json @Produce json @Security BearerAuth @Param request body map[string]any true "邮件配置" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Router /admin/notification/email/config [put]

func (*NotificationHandler) UpdateTemplate ¶

func (h *NotificationHandler) UpdateTemplate(c *gin.Context)

UpdateTemplate godoc @Summary 更新通知模板 @Description 管理员更新指定通知模板 @Tags 管理端-通知 @Accept json @Produce json @Security BearerAuth @Param id path int true "模板ID" @Param request body map[string]any true "模板更新信息" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 404 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/notification/templates/{id} [put]

func (Order) TableName ¶

func (Order) TableName() string

func (*OrderHandler) GetOrderDetail ¶

func (h *OrderHandler) GetOrderDetail(c *gin.Context)

GetOrderDetail 获取订单详情: the caller's own order with its plan's id and name. Another user's order is "not found", as an unknown one.

func (*OrderHandler) GetOrders ¶

func (h *OrderHandler) GetOrders(c *gin.Context)

GetOrders 获取用户自己的订单: each with its plan's id and name, none with the buyer. The page size is clamped as on the administrator's list.

func (*OrderHandler) SaveOrder ¶

func (h *OrderHandler) SaveOrder(c *gin.Context)

SaveOrder 保存订单 (下单)

func (*PaymentGatewayHandler) CreateGateway ¶

func (h *PaymentGatewayHandler) CreateGateway(c *gin.Context)

CreateGateway godoc @Summary 创建支付网关 @Description 管理员创建新的支付网关 @Tags 管理端-支付 @Accept json @Produce json @Security BearerAuth @Param request body CreateGatewayRequest true "网关信息" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/payment/gateways [post]

func (*PaymentGatewayHandler) CreatePayment ¶

func (h *PaymentGatewayHandler) CreatePayment(c *gin.Context)

CreatePayment godoc @Summary 创建支付订单 @Description 用户创建支付订单 @Tags 用户端 @Accept json @Produce json @Security BearerAuth @Param request body CreatePaymentRequest true "支付请求" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /user/payment/create [post]

func (*PaymentGatewayHandler) DeleteGateway ¶

func (h *PaymentGatewayHandler) DeleteGateway(c *gin.Context)

DeleteGateway godoc @Summary 删除支付网关 @Description 管理员删除指定支付网关 @Tags 管理端-支付 @Accept json @Produce json @Security BearerAuth @Param id path int true "网关ID" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/payment/gateways/{id} [delete]

func (*PaymentGatewayHandler) GetChannels ¶

func (h *PaymentGatewayHandler) GetChannels(c *gin.Context)

GetChannels godoc @Summary 获取支付渠道列表 @Description 用户获取可用的支付渠道列表 @Tags 用户端 @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /user/payment/channels [get]

func (*PaymentGatewayHandler) GetPaymentStats ¶

func (h *PaymentGatewayHandler) GetPaymentStats(c *gin.Context)

GetPaymentStats godoc @Summary 获取支付统计 @Description 管理员获取支付统计数据，支持日期范围筛选 @Tags 管理端-支付 @Accept json @Produce json @Security BearerAuth @Param start query string false "开始日期 (格式: 2006-01-02)" @Param end query string false "结束日期 (格式: 2006-01-02)" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/payment/stats [get]

func (*PaymentGatewayHandler) GetPaymentStatus ¶

func (h *PaymentGatewayHandler) GetPaymentStatus(c *gin.Context)

GetPaymentStatus godoc @Summary 查询支付状态 @Description 用户查询支付订单状态 @Tags 用户端 @Accept json @Produce json @Security BearerAuth @Param trade_no path string true "订单号" @Success 200 {object} map[string]any @Failure 404 {object} map[string]any @Router /user/payment/status/{trade_no} [get]

func (*PaymentGatewayHandler) GetUserRecords ¶

func (h *PaymentGatewayHandler) GetUserRecords(c *gin.Context)

GetUserRecords godoc @Summary 获取用户支付记录 @Description 用户获取自己的支付记录列表 @Tags 用户端 @Accept json @Produce json @Security BearerAuth @Param page query int false "页码" default(1) @Param page_size query int false "每页数量" default(20) @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /user/payment/records [get]

func (*PaymentGatewayHandler) ListGateways ¶

func (h *PaymentGatewayHandler) ListGateways(c *gin.Context)

ListGateways godoc @Summary 获取支付网关列表 @Description 管理员获取所有支付网关列表 @Tags 管理端-支付 @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/payment/gateways [get]

func (*PaymentGatewayHandler) ListPaymentRecords ¶

func (h *PaymentGatewayHandler) ListPaymentRecords(c *gin.Context)

ListPaymentRecords godoc @Summary 获取支付记录列表 @Description 管理员获取支付记录列表，支持分页和状态筛选 @Tags 管理端-支付 @Accept json @Produce json @Security BearerAuth @Param page query int false "页码" default(1) @Param page_size query int false "每页数量" default(20) @Param status query int false "支付状态" @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/payment/records [get]

func (*PaymentGatewayHandler) PaymentCallback ¶

func (h *PaymentGatewayHandler) PaymentCallback(c *gin.Context)

PaymentCallback godoc @Summary 支付回调 @Description 接收第三方支付平台的回调通知 @Tags 支付回调 @Accept json @Produce plain @Param type path string true "支付类型 (alipay/wechat/epay等)" @Success 200 {string} string "success" @Failure 400 {string} string "fail" @Router /payment/callback/{type} [post]

func (*PaymentGatewayHandler) ToggleGateway ¶

func (h *PaymentGatewayHandler) ToggleGateway(c *gin.Context)

ToggleGateway godoc @Summary 切换网关状态 @Description 管理员启用或禁用指定支付网关 @Tags 管理端-支付 @Accept json @Produce json @Security BearerAuth @Param id path int true "网关ID" @Param request body ToggleRequest true "状态请求" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/payment/gateways/{id}/toggle [post]

func (*PaymentGatewayHandler) UpdateGateway ¶

func (h *PaymentGatewayHandler) UpdateGateway(c *gin.Context)

UpdateGateway godoc @Summary 更新支付网关 @Description 管理员更新指定支付网关的信息 @Tags 管理端-支付 @Accept json @Produce json @Security BearerAuth @Param id path int true "网关ID" @Param request body UpdateGatewayRequest true "网关更新信息" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 404 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/payment/gateways/{id} [put]

func (*PaymentHandler) FiatCreatePayment ¶

func (h *PaymentHandler) FiatCreatePayment(c *gin.Context)

FiatCreatePayment 创建法币支付

func (*PaymentHandler) GetPaymentMethods ¶

func (h *PaymentHandler) GetPaymentMethods(c *gin.Context)

GetPaymentMethods 获取可用支付方式

func (*PaymentHandler) GetPaymentStatus ¶

func (h *PaymentHandler) GetPaymentStatus(c *gin.Context)

GetPaymentStatus 查询支付状态

func (*PaymentHandler) PayPalWebhook ¶

func (h *PaymentHandler) PayPalWebhook(c *gin.Context)

PayPalWebhook PayPal 回调

func (*PaymentHandler) StripeWebhook ¶

func (h *PaymentHandler) StripeWebhook(c *gin.Context)

StripeWebhook Stripe 回调

func (*PaymentHandler) X402Callback ¶

func (h *PaymentHandler) X402Callback(c *gin.Context)

X402Callback X402 支付回调

func (*PaymentHandler) X402CheckPayment ¶

func (h *PaymentHandler) X402CheckPayment(c *gin.Context)

X402CheckPayment 查询 X402 支付状态

func (*PaymentHandler) X402CreatePayment ¶

func (h *PaymentHandler) X402CreatePayment(c *gin.Context)

X402CreatePayment 创建 X402 支付

func (*SpeedLimitHandler) CreatePanelSpeedLimit ¶

func (h *SpeedLimitHandler) CreatePanelSpeedLimit(c *gin.Context)

func (*SpeedLimitHandler) DeletePanelSpeedLimit ¶

func (h *SpeedLimitHandler) DeletePanelSpeedLimit(c *gin.Context)

func (*SpeedLimitHandler) ListPanelSpeedLimitTunnels ¶

func (h *SpeedLimitHandler) ListPanelSpeedLimitTunnels(c *gin.Context)

func (*SpeedLimitHandler) ListPanelSpeedLimits ¶

func (h *SpeedLimitHandler) ListPanelSpeedLimits(c *gin.Context)

func (*SpeedLimitHandler) UpdatePanelSpeedLimit ¶

func (h *SpeedLimitHandler) UpdatePanelSpeedLimit(c *gin.Context)

func (*SubscribeHandler) GetLegacySubscription ¶

func (h *SubscribeHandler) GetLegacySubscription(c *gin.Context)

GetLegacySubscription keeps compatibility with the historical /api/v1/client/subscribe?token=TOKEN entrypoint.

func (*SubscribeHandler) GetSubscription ¶

func (h *SubscribeHandler) GetSubscription(c *gin.Context)

GetSubscription 获取用户订阅 GET /s/:token 支持 URL 参数:

• type: 指定输出格式 (v2ray, clash, stash, egern, surge, loon, shadowrocket, quantumultx, json, base64json, wireguard) 也支持 type=auto 或 type=ua，强制按 User-Agent 自动识别格式
• include: 包含节点名关键词 (正则)
• exclude: 排除节点名关键词 (正则)
• groups: 指定分组 ID (逗号分隔)

func (*SubscriptionAdminHandler) AssignGroupToPlan ¶

func (h *SubscriptionAdminHandler) AssignGroupToPlan(c *gin.Context)

AssignGroupToPlan 为套餐分配订阅分组 POST /api/v2/admin/subscription/plans/:plan_id/groups

func (*SubscriptionAdminHandler) AssignGroupToUser ¶

func (h *SubscriptionAdminHandler) AssignGroupToUser(c *gin.Context)

AssignGroupToUser 为用户分配订阅分组 POST /api/v2/admin/subscription/users/:user_id/groups

func (*SubscriptionAdminHandler) CreateGroup ¶

func (h *SubscriptionAdminHandler) CreateGroup(c *gin.Context)

CreateGroup 创建订阅分组 POST /api/v2/admin/subscription/groups

func (*SubscriptionAdminHandler) CreateTemplate ¶

func (h *SubscriptionAdminHandler) CreateTemplate(c *gin.Context)

CreateTemplate 创建订阅模板 POST /api/v2/admin/subscription/groups/:id/templates

func (*SubscriptionAdminHandler) DeleteGroup ¶

func (h *SubscriptionAdminHandler) DeleteGroup(c *gin.Context)

DeleteGroup 删除订阅分组 DELETE /api/v2/admin/subscription/groups/:id

func (*SubscriptionAdminHandler) DeleteTemplate ¶

func (h *SubscriptionAdminHandler) DeleteTemplate(c *gin.Context)

DeleteTemplate 删除订阅模板 DELETE /api/v2/admin/subscription/templates/:id

func (*SubscriptionAdminHandler) GetAvailableProtocols ¶

func (h *SubscriptionAdminHandler) GetAvailableProtocols(c *gin.Context)

GetAvailableProtocols 获取所有可用的物理节点协议 (Protocol Pool) GET /api/v2/admin/subscription/protocols/available

func (*SubscriptionAdminHandler) GetGroup ¶

func (h *SubscriptionAdminHandler) GetGroup(c *gin.Context)

GetGroup 获取订阅分组详情 GET /api/v2/admin/subscription/groups/:id

func (*SubscriptionAdminHandler) GetGroupProtocols ¶

func (h *SubscriptionAdminHandler) GetGroupProtocols(c *gin.Context)

GetGroupProtocols 获取属于该分组的物理节点协议 GET /api/v2/admin/subscription/groups/:id/protocols

func (*SubscriptionAdminHandler) GetGroupStats ¶

func (h *SubscriptionAdminHandler) GetGroupStats(c *gin.Context)

GetGroupStats 获取订阅分组统计数据 GET /api/v2/admin/subscription/stats

func (*SubscriptionAdminHandler) GetGroups ¶

func (h *SubscriptionAdminHandler) GetGroups(c *gin.Context)

GetGroups 获取所有订阅分组 GET /api/v2/admin/subscription/groups

func (*SubscriptionAdminHandler) GetPlanGroups ¶

func (h *SubscriptionAdminHandler) GetPlanGroups(c *gin.Context)

GetPlanGroups 获取套餐的订阅分组 GET /api/v2/admin/subscription/plans/:plan_id/groups

func (*SubscriptionAdminHandler) GetProtocolTypes ¶

func (h *SubscriptionAdminHandler) GetProtocolTypes(c *gin.Context)

GetProtocolTypes 获取支持的协议类型 GET /api/v2/admin/subscription/protocols

func (*SubscriptionAdminHandler) GetSubscriptionFormats ¶

func (h *SubscriptionAdminHandler) GetSubscriptionFormats(c *gin.Context)

GetSubscriptionFormats 获取支持的订阅格式 GET /api/v2/admin/subscription/formats

func (*SubscriptionAdminHandler) GetTemplate ¶

func (h *SubscriptionAdminHandler) GetTemplate(c *gin.Context)

GetTemplate 获取订阅模板详情 GET /api/v2/admin/subscription/templates/:id

func (*SubscriptionAdminHandler) GetTemplates ¶

func (h *SubscriptionAdminHandler) GetTemplates(c *gin.Context)

GetTemplates 获取分组的模板列表 GET /api/v2/admin/subscription/groups/:id/templates

func (*SubscriptionAdminHandler) GetUserGroups ¶

func (h *SubscriptionAdminHandler) GetUserGroups(c *gin.Context)

GetUserGroups 获取用户的订阅分组 GET /api/v2/admin/subscription/users/:user_id/groups

func (*SubscriptionAdminHandler) PreviewSubscription ¶

func (h *SubscriptionAdminHandler) PreviewSubscription(c *gin.Context)

PreviewSubscription 预览订阅内容 POST /api/v2/admin/subscription/preview

func (*SubscriptionAdminHandler) RemoveGroupFromPlan ¶

func (h *SubscriptionAdminHandler) RemoveGroupFromPlan(c *gin.Context)

RemoveGroupFromPlan 移除套餐的订阅分组 DELETE /api/v2/admin/subscription/plans/:plan_id/groups/:group_id

func (*SubscriptionAdminHandler) RemoveGroupFromUser ¶

func (h *SubscriptionAdminHandler) RemoveGroupFromUser(c *gin.Context)

RemoveGroupFromUser 移除用户的订阅分组 DELETE /api/v2/admin/subscription/users/:user_id/groups/:group_id

func (*SubscriptionAdminHandler) UpdateGroup ¶

func (h *SubscriptionAdminHandler) UpdateGroup(c *gin.Context)

UpdateGroup 更新订阅分组 PUT /api/v2/admin/subscription/groups/:id

func (*SubscriptionAdminHandler) UpdateGroupProtocols ¶

func (h *SubscriptionAdminHandler) UpdateGroupProtocols(c *gin.Context)

UpdateGroupProtocols 更新分组关联的物理节点协议 POST /api/v2/admin/subscription/groups/:id/protocols

func (*SubscriptionAdminHandler) UpdateTemplate ¶

func (h *SubscriptionAdminHandler) UpdateTemplate(c *gin.Context)

UpdateTemplate 更新订阅模板 PUT /api/v2/admin/subscription/templates/:id

func (*SystemHandler) CreateBackup ¶

func (h *SystemHandler) CreateBackup(c *gin.Context)

CreateBackup godoc @Summary 创建备份 @Description 管理员手动创建系统备份 @Tags 管理端-系统 @Accept json @Produce json @Security BearerAuth @Param type query string false "备份类型 (database/full)" default(database) @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/system/backup [post]

func (*SystemHandler) DeleteBackup ¶

func (h *SystemHandler) DeleteBackup(c *gin.Context)

DeleteBackup godoc @Summary 删除备份 @Description 管理员删除指定备份记录 @Tags 管理端-系统 @Accept json @Produce json @Security BearerAuth @Param id path int true "备份ID" @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/system/backups/{id} [delete]

func (*SystemHandler) DeleteConfig ¶

func (h *SystemHandler) DeleteConfig(c *gin.Context)

DeleteConfig godoc @Summary 删除系统配置 @Description 管理员删除指定key的系统配置 @Tags 管理端-系统 @Accept json @Produce json @Security BearerAuth @Param key path string true "配置键名" @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/system/configs/{key} [delete]

func (*SystemHandler) GetAuditLogs ¶

func (h *SystemHandler) GetAuditLogs(c *gin.Context)

GetAuditLogs godoc @Summary Get system audit logs @Description Admin query for system operation audit logs with optional filters. @Tags Admin System @Accept json @Produce json @Security BearerAuth @Param target_type query string false "Filter by target type" @Param action query string false "Filter by action" @Param page query int false "Page number" default(1) @Param page_size query int false "Page size" default(20) @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/system/audit-logs [get]

func (*SystemHandler) GetBackupConfig ¶

func (h *SystemHandler) GetBackupConfig(c *gin.Context)

GetBackupConfig godoc @Summary 获取备份配置 @Description 管理员获取系统备份配置 @Tags 管理端-系统 @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/system/backup/config [get]

func (*SystemHandler) GetBackupStats ¶

func (h *SystemHandler) GetBackupStats(c *gin.Context)

GetBackupStats godoc @Summary 获取备份统计 @Description 管理员获取备份统计数据 @Tags 管理端-系统 @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/system/backup/stats [get]

func (*SystemHandler) GetConfig ¶

func (h *SystemHandler) GetConfig(c *gin.Context)

GetConfig godoc @Summary 获取单个系统配置 @Description 管理员获取指定key的系统配置 @Tags 管理端-系统 @Accept json @Produce json @Security BearerAuth @Param key path string true "配置键名" @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/system/configs/{key} [get]

func (*SystemHandler) GetConfigs ¶

func (h *SystemHandler) GetConfigs(c *gin.Context)

GetConfigs godoc @Summary 获取系统配置列表 @Description 管理员获取系统配置列表，支持按分组筛选 @Tags 管理端-系统 @Accept json @Produce json @Security BearerAuth @Param group query string false "配置分组" @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/system/configs [get]

func (*SystemHandler) GetSubscriptionSettings ¶

func (h *SystemHandler) GetSubscriptionSettings(c *gin.Context)

GetSubscriptionSettings returns current subscription URL settings.

func (*SystemHandler) ListBackups ¶

func (h *SystemHandler) ListBackups(c *gin.Context)

ListBackups godoc @Summary 获取备份列表 @Description 管理员获取备份记录列表 @Tags 管理端-系统 @Accept json @Produce json @Security BearerAuth @Param page query int false "页码" default(1) @Param page_size query int false "每页数量" default(20) @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/system/backups [get]

func (*SystemHandler) RestoreBackup ¶

func (h *SystemHandler) RestoreBackup(c *gin.Context)

RestoreBackup godoc @Summary 恢复备份 @Description 管理员从备份恢复系统 @Tags 管理端-系统 @Accept json @Produce json @Security BearerAuth @Param id path int true "备份ID" @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/system/backups/{id}/restore [post]

func (*SystemHandler) SetConfig ¶

func (h *SystemHandler) SetConfig(c *gin.Context)

SetConfig godoc @Summary 设置系统配置 @Description 管理员设置系统配置项 @Tags 管理端-系统 @Accept json @Produce json @Security BearerAuth @Param key path string true "配置键名" @Param request body map[string]any true "配置值" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/system/configs/{key} [put]

func (*SystemHandler) UpdateBackupConfig ¶

func (h *SystemHandler) UpdateBackupConfig(c *gin.Context)

UpdateBackupConfig godoc @Summary 更新备份配置 @Description 管理员更新系统备份配置 @Tags 管理端-系统 @Accept json @Produce json @Security BearerAuth @Param request body model.BackupConfig true "备份配置" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/system/backup/config [put]

func (*TelegramHandler) Broadcast ¶

func (h *TelegramHandler) Broadcast(c *gin.Context)

Broadcast godoc @Summary 广播Telegram消息 @Description 管理员通过Telegram广播消息给所有绑定用�? @Tags 管理�?通知 @Accept json @Produce json @Security BearerAuth @Param request body BroadcastRequest true "广播请求" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Router /admin/telegram/broadcast [post]

func (*TelegramHandler) DeleteWebhook ¶

func (h *TelegramHandler) DeleteWebhook(c *gin.Context)

DeleteWebhook godoc @Summary 删除Telegram Webhook @Description 管理员删除Telegram Bot的Webhook配置 @Tags 管理�?通知 @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/telegram/webhook [delete]

func (*TelegramHandler) GetBot ¶

func (h *TelegramHandler) GetBot(c *gin.Context)

GetBot godoc @Summary 获取Telegram Bot配置 @Description 管理员获取Telegram Bot的配置信�? @Tags 管理�?通知 @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Failure 404 {object} map[string]any @Router /admin/telegram/bot [get]

func (*TelegramHandler) GetTelegramStatus ¶

func (h *TelegramHandler) GetTelegramStatus(c *gin.Context)

GetTelegramStatus godoc @Summary 获取Telegram绑定状�? @Description 用户获取自己的Telegram绑定状�? @Tags 用户�? @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Router /user/telegram/status [get]

func (*TelegramHandler) GetUserBindings ¶

func (h *TelegramHandler) GetUserBindings(c *gin.Context)

GetUserBindings godoc @Summary 获取用户绑定列表 @Description 管理员获取Telegram用户绑定列表 @Tags 管理�?通知 @Accept json @Produce json @Security BearerAuth @Param page query int false "页码" default(1) @Param page_size query int false "每页数量" default(20) @Success 200 {object} map[string]any @Router /admin/telegram/users [get]

func (*TelegramHandler) SendNotification ¶

func (h *TelegramHandler) SendNotification(c *gin.Context)

SendNotification godoc @Summary 发送Telegram通知 @Description 管理员通过Telegram发送通知给指定用�? @Tags 管理�?通知 @Accept json @Produce json @Security BearerAuth @Param request body SendNotificationRequest true "通知请求" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/telegram/notify [post]

func (*TelegramHandler) SetWebhook ¶

func (h *TelegramHandler) SetWebhook(c *gin.Context)

SetWebhook godoc @Summary 设置Telegram Webhook @Description 管理员设置Telegram Bot的Webhook地址 @Tags 管理�?通知 @Accept json @Produce json @Security BearerAuth @Param request body SetWebhookRequest true "Webhook配置" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/telegram/webhook [post]

func (*TelegramHandler) TelegramWebhook ¶

func (h *TelegramHandler) TelegramWebhook(c *gin.Context)

TelegramWebhook godoc @Summary Telegram Webhook回调 @Description 接收Telegram Bot的Webhook回调 @Tags Telegram @Accept json @Produce json @Param request body service.TelegramUpdate true "Telegram Update" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Router /telegram/webhook [post]

func (*TelegramHandler) UnbindTelegram ¶

func (h *TelegramHandler) UnbindTelegram(c *gin.Context)

UnbindTelegram godoc @Summary 解绑Telegram @Description 用户解绑自己的Telegram账号 @Tags 用户�? @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Router /user/telegram/unbind [post]

func (*TelegramHandler) UpdateBot ¶

func (h *TelegramHandler) UpdateBot(c *gin.Context)

UpdateBot godoc @Summary 更新Telegram Bot配置 @Description 管理员更新Telegram Bot的配置信�? @Tags 管理�?通知 @Accept json @Produce json @Security BearerAuth @Param request body UpdateBotRequest true "Bot配置" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 404 {object} map[string]any @Failure 500 {object} map[string]any @Router /admin/telegram/bot [put]

func (*TelegramHandler) UpdateNotifySettings ¶

func (h *TelegramHandler) UpdateNotifySettings(c *gin.Context)

UpdateNotifySettings godoc @Summary 更新Telegram通知设置 @Description 用户更新自己的Telegram通知设置 @Tags 用户�? @Accept json @Produce json @Security BearerAuth @Param request body NotifySettingsRequest true "通知设置" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Router /user/telegram/notify [post]

func (*TelegramHandler) UpdateUserNotify ¶

func (h *TelegramHandler) UpdateUserNotify(c *gin.Context)

UpdateUserNotify godoc @Summary 鏇存柊Telegram鐢ㄦ埛閫氱煡璁剧疆 @Description 绠＄悊鍛樻洿鏂版寚瀹歍elegram鐢ㄦ埛鐨勯€氱煡寮€鍏?// @Tags 绠＄悊绔?閫氱煡 @Accept json @Produce json @Security BearerAuth @Param id path int true "Telegram缁戝畾ID" @Param request body map[string]any true "閫氱煡璁剧疆" @Success 200 {object} map[string]any @Failure 400 {object} map[string]any @Failure 404 {object} map[string]any @Router /admin/telegram/users/{id}/notify [put]

func (*TicketHandler) CloseTicket ¶

func (h *TicketHandler) CloseTicket(c *gin.Context)

CloseTicket 用户主动关闭工单

func (*TicketHandler) CreateTicket ¶

func (h *TicketHandler) CreateTicket(c *gin.Context)

CreateTicket 提交新工单

func (*TicketHandler) GetTicket ¶

func (h *TicketHandler) GetTicket(c *gin.Context)

GetTicket 获取工单详情及回话

func (*TicketHandler) GetTickets ¶

func (h *TicketHandler) GetTickets(c *gin.Context)

GetTickets 获取用户自己的工单列表

func (*TicketHandler) ReplyTicket ¶

func (h *TicketHandler) ReplyTicket(c *gin.Context)

ReplyTicket 回复自己的工单

func (*UniProxyHandler) GetAliveList ¶

func (h *UniProxyHandler) GetAliveList(c *gin.Context)

GetAliveList returns online counts. GET /api/v1/server/UniProxy/alivelist

func (*UniProxyHandler) GetConfig ¶

func (h *UniProxyHandler) GetConfig(c *gin.Context)

GetConfig returns node config. GET /api/v1/server/UniProxy/config

func (*UniProxyHandler) GetUsers ¶

func (h *UniProxyHandler) GetUsers(c *gin.Context)

GetUsers returns active users. GET /api/v1/server/UniProxy/user

func (*UniProxyHandler) PushAlive ¶

func (h *UniProxyHandler) PushAlive(c *gin.Context)

PushAlive receives online IP report. POST /api/v1/server/UniProxy/alive

func (*UniProxyHandler) PushTraffic ¶

func (h *UniProxyHandler) PushTraffic(c *gin.Context)

PushTraffic receives traffic report. POST /api/v1/server/UniProxy/push

func (User) TableName ¶

func (User) TableName() string

func (*UserHandler) GetDashboard ¶

func (h *UserHandler) GetDashboard(c *gin.Context)

GetDashboard godoc @Summary 获取用户仪表盘 @Description 获取当前登录用户的仪表盘数据，包括订阅信息等 @Tags 用户端 @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Failure 401 {object} map[string]any @Failure 500 {object} map[string]any @Router /user/dashboard [get]

func (*UserHandler) GetProfile ¶

func (h *UserHandler) GetProfile(c *gin.Context)

GetProfile godoc @Summary 获取用户基本信息 @Description 获取当前登录用户的基本信息，包括邮箱、UUID、Token等 @Tags 用户端 @Accept json @Produce json @Security BearerAuth @Success 200 {object} map[string]any @Failure 401 {object} map[string]any @Failure 404 {object} map[string]any @Router /user/profile [get]

func (*UserHandler) GetSubscription ¶

func (h *UserHandler) GetSubscription(c *gin.Context)

GetSubscription godoc @Summary 获取用户订阅详情 @Description 获取当前登录用户的订阅信息，包括流量、到期时间等 @Tags 用户端 @Accept json @Produce json @Security BearerAuth @Param refresh query bool false "是否强制刷新缓存" @Success 200 {object} map[string]any @Failure 401 {object} map[string]any @Failure 500 {object} map[string]any @Router /user/subscription [get]

func (*UserPlanHandler) GetPlans ¶

func (h *UserPlanHandler) GetPlans(c *gin.Context)

GetPlans 获取可购买的套餐列表