fix: remote agent exec url_path_prefix error

internal/controllers/agent_controller.go

@@ -337,8 +337,19 @@ func (c *AgentController) ForceUpdate(ctx *gin.Context) {
 
 // WSConnect Agent WebSocket 连接
 func (c *AgentController) WSConnect(ctx *gin.Context) {
+	// 添加 panic 恢复
+	defer func() {
+		if r := recover(); r != nil {
+			logger.Errorf("[AgentWS] WSConnect panic: %v", r)
+			ctx.JSON(http.StatusInternalServerError, gin.H{"error": "服务器内部错误"})
+		}
+	}()
+
 	ip := ctx.ClientIP()
 
+	// 打印请求信息用于调试
+	logger.Infof("[AgentWS] 收到连接请求: IP=%s, URL=%s", ip, ctx.Request.URL.String())
+
 	// 检查 IP 限流
 	if allowed, reason := c.wsManager.CheckRateLimit(ip); !allowed {
 		logger.Warnf("[AgentWS] IP %s 被限流: %s", ip, reason)
@@ -349,36 +360,45 @@ func (c *AgentController) WSConnect(ctx *gin.Context) {
 	token := ctx.Query("token")
 	if token == "" {
 		c.wsManager.RecordConnectFail(ip)
+		logger.Warnf("[AgentWS] 连接失败: 缺少 token, IP=%s", ip)
 		ctx.JSON(http.StatusUnauthorized, gin.H{"error": "缺少 token"})
 		return
 	}
 
 	machineID := ctx.Query("machine_id")
+	logger.Infof("[AgentWS] Token: %s..., MachineID: %s...", token[:8], machineID[:16])
+
 	isNewAgent := false
 
 	// 先尝试用 token 查找已有 Agent
 	agent := c.agentService.GetByToken(token)
+	logger.Infof("[AgentWS] GetByToken 结果: agent=%v", agent != nil)
 
 	// 如果没找到，尝试用令牌注册（会检查 machine_id 是否已存在）
 	if agent == nil {
+		logger.Infof("[AgentWS] 尝试注册新 Agent")
 		var err error
 		agent, isNewAgent, err = c.agentService.RegisterByToken(token, machineID, ip)
 		if err != nil {
 			c.wsManager.RecordConnectFail(ip)
+			logger.Warnf("[AgentWS] 注册失败: %v, IP=%s, token=%s", err, ip, token[:8]+"...")
 			ctx.JSON(http.StatusUnauthorized, gin.H{"error": err.Error()})
 			return
 		}
+		logger.Infof("[AgentWS] 注册成功: Agent #%d, isNew=%v", agent.ID, isNewAgent)
 	}
 
 	if !agent.Enabled {
 		c.wsManager.RecordConnectFail(ip)
+		logger.Warnf("[AgentWS] Agent #%d 已禁用, IP=%s", agent.ID, ip)
 		ctx.JSON(http.StatusForbidden, gin.H{"error": "Agent 已禁用"})
 		return
 	}
 
+	logger.Infof("[AgentWS] 准备升级连接: Agent #%d, IP=%s", agent.ID, ip)
 	conn, err := agentUpgrader.Upgrade(ctx.Writer, ctx.Request, nil)
 	if err != nil {
-		logger.Errorf("[AgentWS] 升级连接失败: %v", err)
+		logger.Errorf("[AgentWS] 升级连接失败: %v, Agent #%d, IP=%s", err, agent.ID, ip)
 		return
 	}
 
@@ -399,6 +419,8 @@ func (c *AgentController) WSConnect(ctx *gin.Context) {
 		"machine_id":   machineID,
 	})
 
+	logger.Infof("[AgentWS] Agent #%d 连接成功", agent.ID)
+
 	// 启动读写协程
 	go c.wsWritePump(ac)
 	go c.wsReadPump(ac, agent)

internal/router/router.go

@@ -217,16 +217,16 @@ func Setup(c *Controllers) *gin.Engine {
 				agents.DELETE("/tokens/:id", c.Agent.DeleteToken)
 			}
 		}
+	}
 
-		// Agent API（供远程 Agent 调用）
-		agentAPI := api.Group("/agent")
-		{
-			agentAPI.POST("/heartbeat", c.Agent.Heartbeat)
-			agentAPI.GET("/tasks", c.Agent.GetTasks)
-			agentAPI.POST("/report", c.Agent.ReportResult)
-			agentAPI.GET("/download", c.Agent.Download)
-			agentAPI.GET("/ws", c.Agent.WSConnect) // WebSocket 连接
-		}
+	// Agent API（供远程 Agent 调用，不使用 /v1 版本号）
+	agentAPI := root.Group("/api/agent")
+	{
+		agentAPI.POST("/heartbeat", c.Agent.Heartbeat)
+		agentAPI.GET("/tasks", c.Agent.GetTasks)
+		agentAPI.POST("/report", c.Agent.ReportResult)
+		agentAPI.GET("/download", c.Agent.Download)
+		agentAPI.GET("/ws", c.Agent.WSConnect) // WebSocket 连接
 	}
 
 	// SPA fallback - serve index.html (no cache for HTML)
@@ -237,19 +237,19 @@ func Setup(c *Controllers) *gin.Engine {
 			ctx.Status(404)
 			return
 		}
-		
+
 		data, err := static.ReadFile("index.html")
 		if err != nil {
 			ctx.String(500, "index.html not found")
 			return
 		}
-		
+
 		html := string(data)
-		
+
 		// 注入配置变量供前端使用（API 调用和路由）
 		configScript := `<script>window.__BASE_URL__ = "` + urlPrefix + `"; window.__API_VERSION__ = "/api/v1";</script>`
 		html = strings.Replace(html, "</head>", configScript+"</head>", 1)
-		
+
 		ctx.Header("Cache-Control", "no-cache, no-store, must-revalidate")
 		ctx.Data(200, "text/html; charset=utf-8", []byte(html))
 	})