/**
* WMS 内置海康取流服务(HTTP 快照模式,监听 127.0.0.1:17320)
*
* 协议与 printServer(打印电脑服务)的 live-stream 一致,但端口独立:
* printServer 用 17311(被占时回退 17312/17313),WMS 用 17320,互不冲突。
* 前端 src/api/camera.ts 的 getLiveStreamUrl() 固定请求
* http://localhost:17320/api/hikvision/live-stream,因此 WMS exe 单机即可
* 预览退件摄像头,无需另装 printServer。
*
* 端口策略:仅绑定 127.0.0.1 回环(不暴露局域网);17320 被占用时放弃并告警。
*
* 仅使用 Node 标准库(http/net/crypto),无第三方依赖,兼容
* electron-builder "dependencies 为空、不打 node_modules" 的打包配置。
*/
'use strict'
const http = require('http')
const net = require('net')
const crypto = require('crypto')
const PORT = 17320
const SNAPSHOT_INTERVAL_MS = 200
const LOGIN_CACHE_TTL_MS = 20 * 60 * 1000
const REQ_TIMEOUT_MS = 10000
/** printServer 无 ffmpeg 时的兜底错误图(1x1 JPEG),保持 502 行为与之一致 */
const FALLBACK_JPEG = Buffer.from(
'/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAYEBAUEBAYFBQUGBgYHCQ4JCQgICRINDgoRFWGBEXFBUWFhcbHR8lJx4eHiAhIyUoKSkrLC0tHyE3NTcoNSooKSv/2wBDAQcHBwkJCRYJCQ0XFhUWFxcXFxcXFxcXFxcXFxcXFxcXFxcXFxcXFxcXFxcXFxcXFxcXFxcXFxcXFxcXFxcXFxf/wAARCAABAAEDAREAAhEBAxEB/8QAFAABAAAAAAAAAAAAAAAAAAAACf/EABQQAQAAAAAAAAAAAAAAAAAAAAD/xAAUAQEAAAAAAAAAAAAAAAAAAAAA/8QAFBEBAAAAAAAAAAAAAAAAAAAAAP/aAAwDAQACEQMRAD8AKwA//9k=',
'base64'
)
/** 简单 XML 文本提取(海康 ISAPI XML 字段,支持命名空间前缀,大小写敏感与 printServer 一致) */
function xmlText(xml, tag) {
if (!xml) return ''
const re = new RegExp(
'<(?:[\\w.-]+:)?' + tag + '(?:\\s[^>]*)?>([\\s\\S]*?)<\\/(?:[\\w.-]+:)?' + tag + '\\s*>'
)
const m = xml.match(re)
return m ? m[1].trim() : ''
}
function sha256Hex(text) {
return crypto.createHash('sha256').update(text, 'utf-8').digest('hex')
}
function sendJson(res, code, obj) {
const body = Buffer.from(JSON.stringify(obj), 'utf-8')
res.writeHead(code, {
'Content-Type': 'application/json; charset=utf-8',
'Content-Length': body.length,
'Access-Control-Allow-Origin': '*',
'Cache-Control': 'no-cache',
})
res.end(body)
}
/** 创建海康认证/请求服务实例(含登录缓存与并发锁) */
function createHikvisionService() {
const loginCache = new Map() // key `${ip}:${port}` -> { ts, httpBase, cookieJar, sessionTag }
const loginLocks = new Map() // key -> Promise
/** 通用 HTTP 请求(复刻 printServer services/hikvision.js _req) */
function _req(method, url, body, headers, cookieJar, binary = false, agent = null) {
const u = new URL(url)
const bodyBuf = body ? Buffer.from(typeof body === 'string' ? body : body, 'utf-8') : null
const cookies = Object.entries(cookieJar || {})
.map(([k, v]) => `${k}=${v}`)
.join('; ')
const hdrs = { Accept: '*/*', 'User-Agent': 'Mozilla/5.0', ...headers }
if (cookies) hdrs['Cookie'] = cookies
if (bodyBuf) hdrs['Content-Length'] = bodyBuf.length
return new Promise((resolve, reject) => {
const reqOpts = {
hostname: u.hostname,
port: u.port || 80,
path: u.pathname + u.search,
method,
headers: hdrs,
timeout: REQ_TIMEOUT_MS,
}
if (agent) reqOpts.agent = agent
const req = http.request(reqOpts, (res) => {
const chunks = []
res.on('data', (c) => chunks.push(c))
res.on('end', () => {
const raw = Buffer.concat(chunks)
const bodyOut = binary ? raw : raw.toString('utf-8')
if (res.headers['set-cookie'] && cookieJar) {
const list = Array.isArray(res.headers['set-cookie'])
? res.headers['set-cookie']
: [res.headers['set-cookie']]
list.forEach((sc) => {
const m = sc.match(/^([^=;]+)=([^;]*)/)
if (m) cookieJar[m[1]] = m[2]
})
}
resolve({ statusCode: res.statusCode, headers: res.headers, body: bodyOut })
})
})
req.on('error', reject)
req.on('timeout', () => {
req.destroy()
reject(new Error('请求超时'))
})
if (bodyBuf) req.write(bodyBuf)
req.end()
})
}
/** 获取一次性 token(需要已有 session) */
async function _getToken(httpBase, sessionTag, cookieJar) {
const tokenHeaders = sessionTag ? { SessionTag: sessionTag } : {}
const tokenRes = await _req(
'GET',
`${httpBase}/ISAPI/Security/token?format=json`,
null,
tokenHeaders,
cookieJar
)
if (!String(tokenRes.body || '').includes('"Token"')) {
throw new Error(`Token获取失败(session失效,status=${tokenRes.statusCode})`)
}
try {
return JSON.parse(tokenRes.body).Token.value
} catch (e) {
throw new Error(`Token解析失败(status=${tokenRes.statusCode})`)
}
}
/** 完整 digest 登录(复刻 printServer _doLogin,XML 解析用正则替代 @xmldom) */
async function _doLogin(ip, httpPort, user, pass) {
const httpBase = `http://${ip}:${httpPort}`
const cookieJar = {}
const capsUrl = `${httpBase}/ISAPI/Security/sessionLogin/capabilities?username=${encodeURIComponent(user)}&random:${String(Date.now()).slice(-8)}`
const capsRes = await _req('GET', capsUrl, null, {}, cookieJar)
if (capsRes.statusCode !== 200) {
throw Object.assign(new Error(`获取登录能力失败: HTTP ${capsRes.statusCode}`), {
statusCode: capsRes.statusCode,
})
}
const capsBody = String(capsRes.body || '')
const sid = xmlText(capsBody, 'sessionID')
const challenge = xmlText(capsBody, 'challenge')
const salt = xmlText(capsBody, 'salt')
const itr = parseInt(xmlText(capsBody, 'iterations')) || 1
const ver = xmlText(capsBody, 'sessionIDVersion') || '1'
const vl = xmlText(capsBody, 'isSessionIDValidLongTerm') || 'false'
const st = xmlText(capsBody, 'isSupportSessionTag') || 'false'
const irreversible = xmlText(capsBody, 'isIrreversible') === 'true'
let digest
if (irreversible) {
digest = sha256Hex(user + salt + pass)
digest = sha256Hex(digest + challenge)
for (let i = 2; i < itr; i++) digest = sha256Hex(digest)
} else {
digest = sha256Hex(pass + challenge)
for (let i = 1; i < itr; i++) digest = sha256Hex(digest)
}
let loginXml
if (ver === '2') {
loginXml = `${user}${digest}${sid}${vl}2${st}`
} else {
loginXml = `${user}${digest}${sid}`
}
const loginRes = await _req(
'POST',
`${httpBase}/ISAPI/Security/sessionLogin?timeStamp=${Date.now()}`,
loginXml,
{ 'Content-Type': 'text/plain;charset=UTF-8' },
cookieJar
)
if (loginRes.statusCode !== 200) {
throw Object.assign(new Error(`登录失败: HTTP ${loginRes.statusCode}`), {
statusCode: loginRes.statusCode,
})
}
const sessionTag = xmlText(String(loginRes.body || ''), 'sessionTag')
const token = await _getToken(httpBase, sessionTag, cookieJar)
return { token, cookieJar, sessionTag, httpBase }
}
/** 登录(带 20 分钟 session 缓存与并发锁) */
async function login(ip, httpPort, user, pass) {
const key = `${ip}:${httpPort}`
const cached = loginCache.get(key)
if (cached && Date.now() - cached.ts < LOGIN_CACHE_TTL_MS) {
try {
const token = await _getToken(cached.httpBase, cached.sessionTag, cached.cookieJar)
return { token, cookieJar: cached.cookieJar, sessionTag: cached.sessionTag, httpBase: cached.httpBase }
} catch (e) {
console.log('[hik-live] 缓存 session 取 token 失败,清除缓存重新登录:', e.message)
loginCache.delete(key)
}
}
if (loginLocks.has(key)) {
return loginLocks.get(key)
}
const promise = _doLogin(ip, httpPort, user, pass)
loginLocks.set(key, promise)
try {
const result = await promise
loginCache.set(key, {
cookieJar: result.cookieJar,
sessionTag: result.sessionTag,
httpBase: result.httpBase,
ts: Date.now(),
})
return result
} finally {
loginLocks.delete(key)
}
}
return { login }
}
/** 发送 502 兜底错误图(与 printServer 无 ffmpeg 时行为一致,触发前端公网回退逻辑) */
function sendErrorImage(res) {
res.writeHead(502, {
'Content-Type': 'image/jpeg',
'Content-Length': FALLBACK_JPEG.length,
'Access-Control-Allow-Origin': '*',
'Cache-Control': 'no-cache',
})
res.end(FALLBACK_JPEG)
}
/**
* GET /api/hikvision/live-stream —— HTTP 快照轮询模式 MJPEG
* 复刻 printServer _handleHikvisionLiveStreamHttp(仅保留 HTTP 快照分支)
*/
async function handleLiveStream(svc, res, params) {
const ip = params.get('ip')
const user = params.get('user')
const pass = params.get('pass')
const channel = parseInt(params.get('channel')) || 33
const rawStreamType = parseInt(params.get('streamType'))
const streamType = Number.isNaN(rawStreamType) ? 1 : rawStreamType
const interval = Number.isFinite(parseInt(params.get('interval')))
? Math.max(0, parseInt(params.get('interval')))
: SNAPSHOT_INTERVAL_MS
if (!ip || !user || !pass) {
sendJson(res, 400, { success: false, message: '缺少参数: ip, user, pass' })
return
}
// 海康通道号 = 100*channel + 流后缀(1=主码流/2=子码流)。
// 前端 streamType: 0/1 均按主码流(101),2 按子码流(102)——
// 直接用 100*channel+0 会得到无效通道(100),NVR 返回 503 statusCode 2。
// 与 printServer RTSP 分支的 rtspStreamType 映射保持一致。
const streamSuffix = streamType === 2 ? 2 : 1
const channelCode = 100 * channel + streamSuffix
// 端口候选回退:httpPort -> port -> 80。
// 前端 getLiveStreamUrl 透传的 port 是 NVR 端口(常为 RTSP 554),
// 而 ISAPI HTTP 服务通常在 80 端口;554 上发 HTTP 会秒拒,登录失败自动回退。
const explicitHttpPort = parseInt(params.get('httpPort'))
const portParam = parseInt(params.get('port'))
const portCandidates = []
for (const p of [explicitHttpPort, portParam, 80]) {
if (Number.isFinite(p) && p > 0 && p < 65536 && !portCandidates.includes(p)) {
portCandidates.push(p)
}
}
let closed = false
let cookieJar = {}
let sessionTag = ''
let usedHttpPort = null
let agent = null
let lastPictureErrLog = 0
const doCleanup = () => {
if (closed) return
closed = true
if (agent) {
try {
agent.destroy()
} catch {}
}
if (!res.writableEnded) {
try {
res.end()
} catch {}
}
}
res.on('close', doCleanup)
res.on('error', doCleanup)
// Step 1: 登录(候选端口逐个尝试,单端口限时 3.5s;NVR 的 RTSP 端口对 HTTP
// 请求可能挂住不响应,限时后快速回退到下一候选)
const CANDIDATE_LOGIN_TIMEOUT_MS = 3500
let loginResult = null
for (const candidate of portCandidates) {
try {
loginResult = await Promise.race([
svc.login(ip, candidate, user, pass),
new Promise((_, reject) =>
setTimeout(() => reject(new Error('登录超时')), CANDIDATE_LOGIN_TIMEOUT_MS)
),
])
usedHttpPort = candidate
break
} catch (e) {
console.log('[hik-live] 端口 %d 登录失败(%s),尝试下一候选', candidate, e.message)
}
}
if (!loginResult || !usedHttpPort) {
console.error('[hik-live] live-stream 登录失败(所有候选端口):', ip)
sendErrorImage(res)
doCleanup()
return
}
cookieJar = loginResult.cookieJar
sessionTag = loginResult.sessionTag
try {
// 连接复用:避免每帧 TCP 握手开销
agent = new http.Agent({ keepAlive: true, maxSockets: 2 })
// Step 2: 发送 MJPEG 响应头
res.writeHead(200, {
'Content-Type': 'multipart/x-mixed-replace; boundary=snapshot',
'Cache-Control': 'no-cache, no-store, must-revalidate',
Pragma: 'no-cache',
Expires: '0',
Connection: 'keep-alive',
'Access-Control-Allow-Origin': '*',
})
// 关键:首帧到达前没有任何 body 写入时,Node 不会把响应头发出去,
// 必须显式 flush,否则前端 fetch 探测一直挂起(表现为本地服务未启动)。
res.flushHeaders()
const snapshotUrl = `http://${ip}:${usedHttpPort}/ISAPI/Streaming/channels/${channelCode}/picture`
// Step 3: 单路轮询(均匀节奏,避免并发乱序导致的画面跳帧)
const fetchFrame = async () => {
try {
const hdrs = sessionTag ? { SessionTag: sessionTag } : {}
const result = await _reqWithAgent('GET', snapshotUrl, null, hdrs, cookieJar, agent)
if (result.statusCode !== 200) {
// 节流日志:同一流上 picture 失败(503 Device Busy 等)每 10 秒最多一条
if (Date.now() - lastPictureErrLog > 10000) {
lastPictureErrLog = Date.now()
console.log(
'[hik-live] picture 非 200:',
result.statusCode,
result.body.toString('utf-8').replace(/\s+/g, ' ').slice(0, 220)
)
}
}
if (result.statusCode === 200 && result.body && result.body.length > 500) {
return result.body
}
if (result.statusCode === 401) {
// Session 过期,重新登录(login 内部有锁)
const relogin = await svc.login(ip, usedHttpPort, user, pass)
cookieJar = relogin.cookieJar
sessionTag = relogin.sessionTag
}
} catch (e) {
// 单次失败忽略
}
return null
}
const writeFrame = (jpeg) => {
if (!jpeg || closed || res.destroyed) return
// 背压保护:客户端消费慢(如预览窗最小化)时丢帧,避免内存持续增长
if (res.writableLength < 512 * 1024) {
res.write(`--snapshot\r\nContent-Type: image/jpeg\r\nContent-Length: ${jpeg.length}\r\n\r\n`)
res.write(jpeg)
res.write('\r\n')
}
}
while (!closed) {
const loopStart = Date.now()
const jpeg = await fetchFrame()
writeFrame(jpeg)
if (interval > 0) {
const delay = Math.max(0, interval - (Date.now() - loopStart))
if (delay > 0) await new Promise((r) => setTimeout(r, delay))
}
}
} catch (err) {
console.error('[hik-live] live-stream 启动失败:', err.message)
if (!res.headersSent) {
sendErrorImage(res)
}
doCleanup()
}
}
/** 与 fetchFrame 复用的二进制请求(复用 agent) */
function _reqWithAgent(method, url, body, headers, cookieJar, agent) {
return new Promise((resolve, reject) => {
const u = new URL(url)
const cookies = Object.entries(cookieJar || {})
.map(([k, v]) => `${k}=${v}`)
.join('; ')
const hdrs = { Accept: '*/*', 'User-Agent': 'Mozilla/5.0', ...headers }
if (cookies) hdrs['Cookie'] = cookies
const req = http.request(
{
hostname: u.hostname,
port: u.port || 80,
path: u.pathname + u.search,
method,
headers: hdrs,
timeout: REQ_TIMEOUT_MS,
agent,
},
(res) => {
const chunks = []
res.on('data', (c) => chunks.push(c))
res.on('end', () => {
const raw = Buffer.concat(chunks)
resolve({
statusCode: res.statusCode,
headers: res.headers,
body: raw, // 快照接口返回二进制 JPEG
})
})
}
)
req.on('error', reject)
req.on('timeout', () => {
req.destroy()
reject(new Error('请求超时'))
})
req.end()
})
}
function handleRequest(svc, req, res) {
const url = new URL(req.url, `http://${req.headers.host || '127.0.0.1'}`)
const pathname = url.pathname
if (pathname === '/api/hikvision/live-stream' && req.method === 'GET') {
return handleLiveStream(svc, res, url.searchParams)
}
if (pathname === '/api/hikvision/status' && req.method === 'GET') {
return sendJson(res, 200, { success: true, source: 'wms-worker-station' })
}
if (pathname === '/api/hikvision/config' && req.method === 'GET') {
return sendJson(res, 200, { success: true, hikvision: {} })
}
return sendJson(res, 404, { success: false, message: 'Not Found' })
}
/** 探测端口是否有监听:true=被占用 / false=空闲 */
function probePort(port = PORT) {
return new Promise((resolve) => {
const sock = net.createConnection({ host: '127.0.0.1', port })
let settled = false
const finish = (result) => {
if (settled) return
settled = true
try {
sock.destroy()
} catch {}
resolve(result)
}
sock.setTimeout(1200)
sock.once('connect', () => finish(true))
sock.once('timeout', () => finish(false))
sock.once('error', () => finish(false))
})
}
let activeServer = null
/**
* 启动内置取流服务。
* 返回 { mode: 'builtin' | 'blocked' | 'error', ... }
* port 仅测试用,生产默认 17320(前端 URL 固定)。
*/
async function startHikvisionLiveServer(port = PORT) {
if (activeServer) {
return { mode: 'builtin', port }
}
const occupied = await probePort(port)
if (occupied) {
console.warn(`[hik-live] ${port} 被占用,放弃启动内置取流服务`)
return { mode: 'blocked', port }
}
return new Promise((resolve) => {
const svc = createHikvisionService()
const server = http.createServer((req, res) => handleRequest(svc, req, res))
server.on('error', (err) => {
if (err.code === 'EADDRINUSE') {
console.warn(`[hik-live] 监听 ${port} 失败(竞态占用)`)
resolve({ mode: 'blocked', port })
return
}
resolve({ mode: 'error', error: err.message })
})
server.listen(port, '127.0.0.1', () => {
activeServer = server
console.log('[hik-live] 内置海康取流服务已启动,端口:', port, '(HTTP 快照模式,~5fps,仅本机回环)')
resolve({ mode: 'builtin', port })
})
})
}
function stopHikvisionLiveServer() {
if (!activeServer) return
try {
activeServer.close()
} catch {}
activeServer = null
console.log('[hik-live] 内置取流服务已停止')
}
module.exports = { startHikvisionLiveServer, stopHikvisionLiveServer, PORT }