From 993c7acd30b89ab0fb8b0e41f2593a95db803152 Mon Sep 17 00:00:00 2001 From: liufumingren Date: Thu, 22 Oct 2026 00:30:09 +0800 Subject: [PATCH] =?UTF-8?q?=E8=B7=A8=E5=85=AC=E5=8F=B8=E4=B8=8B=E8=BD=BD?= =?UTF-8?q?=EF=BC=9A=E4=BA=91=E7=AB=AF=E4=B8=AD=E8=BD=AC=E6=88=90=E7=89=87?= =?UTF-8?q?=EF=BC=88=E5=88=86=E7=89=87=E4=B8=8A=E4=BC=A0=20+=20Range=20?= =?UTF-8?q?=E4=B8=8B=E8=BD=BD=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit A(查询机)和 B(仓库)不同网络、B 无公网 IP。B 出站领任务后把成片传回云端中转, A 再从云端取回本地 —— 全程不需要任何一方有公网入口。 云端 - POST /api/web/edge/download 建任务(按主体选在线设备 → 下发 download) - GET /api/web/edge/download/:id 查进度(queued/uploading/done/failed) - GET /api/web/edge/download/:id/file 取成片,支持 Range(浏览器播放要拖动进度条) - POST /api/scanner/tasks/:id/upload 设备分片上传(原始字节流,不是 base64) - bodyParser 对该上传路由禁用:否则原始请求体会被解析掉 - 成片落 run/edge-files(run/ 属部署保留目录,不会被发布覆盖) - 每次建任务顺手清理过期文件;元数据按主体校验,越权一律 404 桌面端 - AgentHost 新增 download 任务执行:worker 拉流合并 → 分片上传 → 传完删本地临时文件 - 失败时把 uploadTaskId 带回云端,立刻落 failed,查询机不用干等到超时 - ApiClient 新增建任务 / 查状态 / 取文件 / 分片上传 - PlaybackDownloadService 改为三级选路: LAN 设备管理服务 → 云端中转 → 本机直连 实测(真实 NVR) 建任务 → 设备拉流 1.9MB → 上传 → 下载:7.5 秒,字节数一致,ftypisom Range: bytes=0-99 → HTTP 206 + Content-Range 正确 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- backend/app/controller/device/edge.js | 34 ++++ backend/app/controller/web/edge.js | 127 ++++++++++++ backend/app/router.js | 6 + backend/app/service/edge_task.js | 212 ++++++++++++++++++++ backend/config/config.default.js | 6 + desktop/Services/Agent/AgentHost.cs | 79 +++++++- desktop/Services/ApiClient.cs | 119 +++++++++++ desktop/Services/PlaybackDownloadService.cs | 97 ++++++++- 8 files changed, 674 insertions(+), 6 deletions(-) diff --git a/backend/app/controller/device/edge.js b/backend/app/controller/device/edge.js index e4304b8..0156b96 100644 --- a/backend/app/controller/device/edge.js +++ b/backend/app/controller/device/edge.js @@ -47,9 +47,43 @@ class DeviceEdgeController extends Controller { const body = ctx.request.body || {}; await ctx.service.edgeTask.submitResult(id, body); + // 跨网下载失败时,设备把 uploadTaskId 带回来 —— 立刻落 failed, + // 查询机不用干等到超时。 + if (body.ok === false && body.uploadTaskId) { + await ctx.service.edgeTask.markFailed(String(body.uploadTaskId), body.error || '设备下载失败'); + } + ctx.logger.info('[edge] 设备 %s 回任务 %s:ok=%s', ctx.state.scanner.sn, id, body.ok); ctx.body = { ok: true }; } + + /** + * 上传成片分片(跨网下载用) + * + * `POST /api/scanner/tasks/:id/upload?last=0|1`,body 是**原始字节**。 + * 用原始流而不是 JSON/base64:几 MB 的分片做 base64 会膨胀 33%,没有意义。 + * 该路由已在 config.bodyParser.ignore 里排除,所以这里直接读 `ctx.req`。 + * + * ⚠️ 分片必须按顺序追加(设备侧是顺序读文件的),不校验 seq 是为了少一次往返。 + */ + async upload() { + const { ctx } = this; + const id = String(ctx.params.id || '').trim(); + if (!id) ctx.throw(400, '缺少任务 id'); + + const last = String(ctx.query.last || '0') === '1'; + + try { + const meta = await ctx.service.edgeTask.appendChunk(id, ctx.req, { last }); + ctx.body = { ok: true, data: { size: meta.size, state: meta.state } }; + } catch (err) { + ctx.logger.warn('[edge] 上传分片失败 %s:%s', id, err.message); + + // 上传失败要落状态,否则查询机要白等两分钟 + await ctx.service.edgeTask.markFailed(id, err.message); + ctx.throw(500, `上传失败:${err.message}`); + } + } } module.exports = DeviceEdgeController; diff --git a/backend/app/controller/web/edge.js b/backend/app/controller/web/edge.js index 74242ca..bc18a34 100644 --- a/backend/app/controller/web/edge.js +++ b/backend/app/controller/web/edge.js @@ -1,6 +1,8 @@ 'use strict'; const { Controller } = require('egg'); +const fs = require('fs'); +const path = require('path'); /** * web 用户端:边缘能力(`/api/web/edge/*`) @@ -35,6 +37,131 @@ class WebEdgeController extends Controller { ctx.body = { ok: true, data }; } + + /** + * POST /api/web/edge/download { code } + * + * 跨网下载:云端让能访问 NVR 的扫码服务去拉流合并,传回云端中转, + * 查询机拿到 `taskId` 后再取文件(不会占住这个请求)。 + */ + async download() { + const { ctx } = this; + const body = ctx.request.body || {}; + const code = String(body.code || ctx.query.code || '').trim(); + if (!code) ctx.throw(422, '缺少运单号'); + + const data = await ctx.service.edgeTask.createDownloadTask({ + subjectId: ctx.state.subjectId, + code, + }); + + ctx.logger.info('[edge] 主体 %s 跨网下载 %s → %s', ctx.state.subjectId, code, data.state); + ctx.body = { ok: true, data }; + } + + /** + * GET /api/web/edge/download/:taskId —— 查进度 + * + * 只能查自己主体创建的任务(元数据里记了 subjectId)。 + */ + async downloadStatus() { + const { ctx } = this; + const meta = await this.requireOwnTask(ctx.params.taskId); + + ctx.body = { + ok: true, + data: { + state: meta.state, + size: meta.size || 0, + error: meta.error || null, + scannerSn: meta.scannerSn || null, + }, + }; + } + + /** + * GET /api/web/edge/download/:taskId/file —— 取成片 + * + * 支持 `Range`(浏览器 `