packServer/backend/config/config.default.js
liufumingren 993c7acd30 跨公司下载:云端中转成片(分片上传 + Range 下载)
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>
2026-10-22 00:30:09 +08:00

292 lines
14 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

'use strict';
const path = require('path');
const { env } = process;
/**
* 默认配置(所有环境生效),按环境差异请放到 config.{env}.js 覆盖
* @param {Egg.EggAppInfo} appInfo app 信息
*/
module.exports = (appInfo) => {
const config = (exports = {});
// cookie/session 签名用的 key,生产环境请改成随机字符串
config.keys = `${appInfo.name}_1729000000000_1971`;
// 部署在 nginx 后面:信任 X-Forwarded-Proto / X-Forwarded-For,
// 否则 ctx.origin / ctx.protocol 会一直认为是 http,二维码、邮件链接会拼成 http://
config.proxy = true;
// ==================== 站点/产品名 ====================
// 页标题、品牌位、邮件正文都用它 —— **改名字只改这里**(或设环境变量 SITE_NAME)
config.siteName = env.SITE_NAME || '云仓视频溯源系统';
// 中间件(app/middleware/xxx.js 后写 'xxx')
// cors:跨域头(小程序 H5 预览直连后端用;鉴权只靠 header 令牌,不依赖 cookie)
// errorHandler:接口异常统一返回 JSON
// frontend:**后端不渲染页面** —— 开发时把页面请求反代给前端 dev server,生产时托管前端构建产物
config.middleware = [ 'cors', 'errorHandler', 'frontend' ];
// ==================== 跨域 ====================
// `'*'` = 回显任意 Origin;需要收紧就设 CORS_ORIGINS=http://127.0.0.1:7304,https://trace.example.com
config.cors = {
enable: !/^(0|false|no|off)$/i.test(String(env.CORS_ENABLE === undefined ? 'true' : env.CORS_ENABLE)),
origins: String(env.CORS_ORIGINS || '*')
.split(',')
.map(value => value.trim())
.filter(Boolean),
};
// ==================== 安装包分发(软件自动更新) ====================
// 打包脚本会把产物放进按平台划分的子目录:
// - 桌面端 desktop/installer/build.ps1
// MSI → app/public/download/desktop/ (egg-static 提供 /download/desktop/*.msi,长缓存)
// version.json → app/public/version/desktop/ (**不在静态目录里**,由 controller/download.js 提供,
// 因为 koa-static 命中后不 next(),改不了缓存头)
// - Android backend/android_client/build.ps1
// APK → app/public/download/android_client/ (/download/android_client/*.apk)
// version.json → app/public/version/android_client/
// 桌面端软件启动时请求 GET /download/version.json 判断是否有新版本(路径不能改,老客户端写死了)。
config.static = {
prefix: '/download/',
dir: path.join(appInfo.baseDir, 'app/public/download'),
// 这里只会放“文件名带版本号”的 MSI / APK,内容永不变 → 可以放心长缓存
maxAge: 31536000,
buffer: false, // MSI / APK 几十 MB,流式发送
};
// ==================== 前端入口(页面不在后端渲染) ====================
// 开发(env=local):页面请求(非 /api、/health)反代到前端 dev server(frontend/ 里 npm run dev)
// 生产:直接托管前端构建产物 dist(SPA 深链回退到 index.html)
// 联调时只开一个地址:打开 http://127.0.0.1:7300 就是前端页面
config.frontend = {
enable: !/^(0|false|no|off)$/i.test(String(env.FRONTEND_ENABLE || 'true')),
devServer: env.FRONTEND_DEV_SERVER || 'http://127.0.0.1:7301',
distDir: env.FRONTEND_DIST || path.join(appInfo.baseDir, '../frontend/dist'),
};
// ==================== 运维/内部接口鉴权 ====================
// 对应 app/middleware/internal_auth.js:
// - token:给运维脚本 / 后台系统用(header `X-Internal-Token`);**不配则一律不认**
// - adminIds:允许访问内部接口的账号 id(user JWT 的 sub),默认 [1](内置管理员)
config.internal = {
token: env.INTERNAL_TOKEN || '',
adminIds: String(env.INTERNAL_ADMIN_IDS || '1')
.split(',')
.map(value => Number(value.trim()))
.filter(id => Number.isInteger(id) && id > 0),
};
// ==================== 协议(登录前同意) ====================
// 三张表:agreements / agreement_versions / user_agreements(见 database/migrations)
// enforce:
// 'mini_program'(默认)→ 只有声明 client=mini_program 的登录必须带当前协议版本
// 'all' → 所有客户端都必须(Web 登录表单也要先接入协议,否则会被 428 拦住)
// 'off' → 不校验(仍会记录主动提交的同意版本)
config.agreement = {
enforce: String(env.AGREEMENT_ENFORCE || 'mini_program').trim().toLowerCase(),
};
// ==================== 主体(租户)====================
// 新建主体默认赠送的试用天数(app/service/subject.js 用)
config.subject = {
trialDays: Number(env.SUBJECT_TRIAL_DAYS || 7),
// 主体状态(过期 / 停用)缓存秒数:设备心跳与上报判断都读它,续期后由写库方主动失效
stateCacheTtl: Number(env.SUBJECT_STATE_CACHE_TTL || 30),
};
// ==================== 服务端口 ==================== // 本地默认 **7300**(曾用 7001;避免与别的项目撞,也方便和前端 7301 排在一起)
// 临时换口:PORT=7400 npm run dev(PowerShell:$env:PORT=7400; npm run dev)
config.cluster = {
listen: {
port: Number(env.PORT || 7300),
},
};
// 多实例并存时用 LOG_DIR 把日志分到不同目录
// (具体生效位置见文件末尾:这里先不设,避开下面的 config.logger 赋值)
// ==================== 安全 ====================
// 前端是 SPA + **header 令牌**,后端没有任何基于 cookie/session 的表单:
// CSRF 保护(只对 cookie 会话有意义)整个关掉,登录响应里那个多余的 csrfToken cookie 也随之消失。
config.security = {
csrf: {
enable: false,
},
};
// ==================== MySQL ====================
// ==================== MySQL(Sequelize ORM) ====================
// 模型定义在 app/model/ 下,通过 app.model.User / ctx.model.User 访问
config.sequelize = {
dialect: 'mysql',
host: env.MYSQL_HOST || '127.0.0.1',
port: Number(env.MYSQL_PORT || 3307),
// 注意:账号名大小写敏感,必须是 packservice
username: env.MYSQL_USER || 'packservice',
// 密码不要写在这里,放 config.local.js 或环境变量 MYSQL_PASSWORD
password: env.MYSQL_PASSWORD || '',
database: env.MYSQL_DATABASE || 'packservice',
// 固定时区,避免服务器时区不同导致时间偏移
timezone: '+08:00',
charset: 'utf8mb4',
define: {
// 表名用单数形式(不自动加 s)
freezeTableName: true,
// 驼峰属性映射到下划线字段
underscored: true,
createdAt: 'created_at',
updatedAt: 'updated_at',
},
pool: {
max: Number(env.MYSQL_POOL_SIZE || 10),
min: 0,
acquire: 30000,
idle: 10000,
},
// 需要打印 SQL 时改成 console.log(或自定义 logger)
logging: false,
// 只读从库 / 多数据源可改用 datasources 配置
};
// ==================== Redis ====================
config.redis = {
client: {
host: env.REDIS_HOST || '127.0.0.1',
port: Number(env.REDIS_PORT || 6379),
// 无密码必须显式写 null
password: env.REDIS_PASSWORD || null,
db: Number(env.REDIS_DB || 0),
// 弱依赖:Redis 仅作缓存时,启动不阻塞
weakDependent: true,
},
};
// ==================== JWT(扫描器长期令牌) ====================
// 扫描器注册/登录时下发长期 JWT,后续调用本服务时带 Authorization: Bearer <token>
config.jwt = {
// 签名密钥:生产环境必须用环境变量 JWT_SECRET 注入(未设置时下面直接抛错)
secret: env.JWT_SECRET || 'pack-service-dev-secret-please-change',
issuer: 'pack-service',
audience: 'scanner',
// 扫描器令牌有效期(长期),支持 '365d' / '10y' / 秒数
scannerExpiresIn: env.SCANNER_JWT_EXPIRES || '365d',
// 设备扫码登录(GET /api/device/login)下发令牌的**默认时长,同时也是上限**:
// 设备可以用 ?expiresIn=30d 申请更短的,但不能比它长(要整体放宽就改这个)
deviceExpiresIn: env.DEVICE_JWT_EXPIRES || env.SCANNER_JWT_EXPIRES || '365d',
// 刷新令牌有效期(不透明随机串,库里只存 sha256)。每次刷新都会轮换并顺延;
// 默认 2 年:只要服务在跑就会持续续期,停用超过这个时间才需要重新激活。
deviceRefreshExpiresIn: env.DEVICE_REFRESH_EXPIRES || '730d',
// 用户令牌有效期(扫码登录 / 前端接口用的 JWT)
userExpiresIn: env.USER_JWT_EXPIRES || '7d',
};
if (!env.JWT_SECRET && appInfo.env === 'prod') {
throw new Error('[config] 生产环境必须通过环境变量 JWT_SECRET 指定 JWT 签名密钥');
}
// ==================== 支付(续期订单) ====================
// 真实支付渠道还没接:先把「订单 + 支付通知回调」的契约定下来,
// 渠道接入后只要按同样格式回调 `POST /api/pay/notify` 即可完成续期。
config.pay = {
// 模拟模式:允许不带签名直接回调(仅开发/测试;生产默认关闭,需要显式 PAY_MOCK=true)
mock: env.PAY_MOCK === undefined
? appInfo.env !== 'prod'
: !/^(0|false|no|off)$/i.test(String(env.PAY_MOCK)),
// 回调签名密钥(HMAC-SHA256);配了就必须带 X-Pay-Sign
callbackSecret: env.PAY_CALLBACK_SECRET || '',
// 每天默认价格(0 = 不校验金额,方便内部测试)
amountPerDay: Number(env.PAY_AMOUNT_PER_DAY || 0),
};
// ==================== 业务配置 ====================
config.cache = {
// 缓存 key 前缀,多项目共用一个 Redis 时用来隔离
prefix: env.CACHE_PREFIX || 'packs:',
// 默认过期时间(秒)
ttl: Number(env.CACHE_TTL || 300),
};
// 跨网取流的分片上传是**原始字节流**(不是 JSON),必须跳过 bodyParser,
// 否则请求体会被解析成空,控制器里读 ctx.req 也拿不到数据(或直接超时)。
config.bodyParser = {
ignore: ctx => /^\/api\/scanner\/tasks\/[^/]+\/upload$/.test(ctx.path),
};
// 登录页的自助注册(生产环境建议关掉:REGISTER_ENABLED=false,改用 npm run user:pass 建号)
config.register = {
enable: !/^(0|false|no|off)$/i.test(String(env.REGISTER_ENABLED || 'true')),
};
// ==================== 邮件 / 邮箱验证码(注册时需要验证邮箱) ====================
config.email = {
// 未配置 SMTP_HOST 时走开发模式:验证码写日志并在注册页回显(仅本地/测试用)
// ⚠️ 生产环境(env=prod)永远不启用 devMode,避免把验证码 / 重置链接回传给前端
devMode: appInfo.env !== 'prod' && !env.SMTP_HOST,
// 发件人显示名用站点名(邮箱域名保持 pack-service.local,技术标识不动)
from: env.SMTP_FROM || `${config.siteName} <no-reply@pack-service.local>`,
smtp: {
host: env.SMTP_HOST || null,
port: Number(env.SMTP_PORT || 465),
secure: String(env.SMTP_SECURE || 'true') !== 'false',
user: env.SMTP_USER || null,
password: env.SMTP_PASSWORD || null,
},
// 验证码有效期(秒)/ 重发间隔(秒)/ 同一个验证码最多试几次
codeTtl: Number(env.EMAIL_CODE_TTL || 600),
resendInterval: Number(env.EMAIL_CODE_RESEND || 60),
maxAttempts: Number(env.EMAIL_CODE_ATTEMPTS || 5),
// 每个邮箱每天最多发几封验证码 / 重置邮件(跨场景共享,超出要等第二天)
dailyLimit: Number(env.EMAIL_DAILY_LIMIT || 10),
// 重置密码链接有效期(秒,默认 30 分钟)
resetTtl: Number(env.EMAIL_RESET_TTL || 1800),
// 邮件里链接用的站点地址(不配就用请求里的 host)
siteUrl: env.SITE_URL || '',
};
// ==================== 微信扫码登录(登录页右上角三角形切换) ====================
config.wechat = {
// 微信开放平台「网站应用」的 appid / secret;不配则二维码退化为本地演示码
appid: env.WECHAT_APPID || '',
secret: env.WECHAT_SECRET || '',
// 扫码回调地址(不配就按当前请求的 origin 自动拼 /login/wechat/callback)
redirectUri: env.WECHAT_REDIRECT_URI || '',
// 微信接口地址(默认官方;自建网关/联调时可改,如 http://127.0.0.1:7099)
apiBase: env.WECHAT_API_BASE || 'https://api.weixin.qq.com',
// 扫码串码:长度、二维码内容里的 spm 格式(`{code}` 占位)
codeLength: Number(env.WECHAT_CODE_LENGTH || 6),
spmPattern: env.WECHAT_SPM_PATTERN || '1.0.{code}.1',
// 二维码(本地生成 SVG,不引用任何第三方图片):单元格像素、静默区格数(QR 规范建议 ≥ 4)
qrCellSize: Number(env.WECHAT_QR_CELL || 6),
qrMargin: Number(env.WECHAT_QR_MARGIN || 4),
// 扫码状态(二维码)有效期(秒)
stateTtl: Number(env.WECHAT_STATE_TTL || 600),
// 长轮询最长挂起秒数(默认 60s;前端建议再留一点自己的超时,比如 +10s)
pollWait: Number(env.WECHAT_POLL_WAIT || 60),
// 微信小程序(code2Session):与公众号的 appid/secret 不是同一套
mp: {
appid: env.WX_MP_APPID || '',
secret: env.WX_MP_SECRET || '',
// 未配置 appid/secret 时,本地/单测默认走 mock(生产必须显式 WX_MP_MOCK=true 才允许)
mock: /^(1|true|yes|on)$/i.test(String(env.WX_MP_MOCK || '')),
apiBase: env.WECHAT_API_BASE || 'https://api.weixin.qq.com',
},
};
// 日志(生产建议按需调整)
config.logger = {
consoleLevel: 'INFO',
};
// 多实例并存时用 LOG_DIR 把日志分到不同目录,免得到处翻同一个日志文件
// 例(PowerShell):$env:PORT=7400; $env:LOG_DIR='logs-test'; npm run dev
// ⚠️ 必须写在上面 config.logger 赋值之后,否则会被整个覆盖掉
if (env.LOG_DIR) {
config.logger.dir = path.resolve(appInfo.baseDir, env.LOG_DIR);
}
return config;
};