Files
FileHost/server/utils/backup/runner.ts
T
tianmo a64be50b73 feat: 完善媒体管理与备份迁移流程
- 视频上传生成缩略图并提供占位封面和失败原因展示
- 支持 HLS 按需重新封装 MP4,并限制临时文件生命周期与访问权限
- 完善视频、文件 API 文档、搜索、批量删除和单次转码质量参数
- 修复备份恢复与跨后端迁移遗漏缩略图、HLS 清单和分片的问题
- 将备份任务、归档和下载权限按用户隔离
- 增加仅清理当前用户数据的高危存储清空流程和二次文字确认
- 修复 S3 中文文件名元数据及 CLI 数据库连接问题
- 补充备份恢复、用户隔离、媒体资源和转码相关测试
2026-10-17 13:46:02 +08:00

117 lines
2.9 KiB
TypeScript

import { runBackendSyncJob } from './backend-sync'
import { runFullExportJob } from './full-export'
import { runFullRestoreJob } from './full-restore'
import {
createBackupJob,
getBackupJob,
markJobFailed,
markJobRunning,
recoverInterruptedBackupJobs,
type BackupJob
} from './jobs'
interface BackupRunnerState {
running: boolean
currentJobId: string | null
}
const runnerState: BackupRunnerState = (globalThis as typeof globalThis & {
__pichostBackupRunner?: BackupRunnerState
}).__pichostBackupRunner ?? {
running: false,
currentJobId: null
}
;(globalThis as typeof globalThis & {
__pichostBackupRunner?: BackupRunnerState
}).__pichostBackupRunner = runnerState
export function isBackupRunnerBusy(): boolean {
return runnerState.running
}
function claimJobSlot(): void {
if (runnerState.running) {
throw new Error('BACKUP_JOB_RUNNING')
}
recoverInterruptedBackupJobs()
}
export function cancelBackupJob(jobId: string): boolean {
const job = getBackupJob(jobId)
if (!job || (job.status !== 'running' && job.status !== 'pending')) {
return false
}
markJobFailed(jobId, '任务已取消')
if (runnerState.currentJobId === jobId) {
runnerState.running = false
runnerState.currentJobId = null
}
return true
}
export function scheduleBackupJob(
job: BackupJob,
runner: () => Promise<void>
): void {
if (runnerState.running) {
throw new Error('BACKUP_JOB_RUNNING')
}
runnerState.running = true
runnerState.currentJobId = job.id
markJobRunning(job.id)
setImmediate(() => {
runner()
.catch(() => {})
.finally(() => {
runnerState.running = false
runnerState.currentJobId = null
})
})
}
export function startFullExportJob(appVersion: string, userId?: number | null): BackupJob {
claimJobSlot()
const job = createBackupJob({
type: 'full_export',
userId,
message: '等待开始…'
})
scheduleBackupJob(job, () => runFullExportJob(job.id, appVersion))
return getBackupJob(job.id)!
}
export function startFullRestoreJob(
archivePath: string,
conflictMode: 'skip' | 'overwrite',
userId?: number | null
): BackupJob {
claimJobSlot()
const job = createBackupJob({
type: 'full_restore',
userId,
message: '等待开始…',
payload: { archivePath, conflictMode }
})
scheduleBackupJob(job, () => runFullRestoreJob(job.id, archivePath, { conflictMode }))
return getBackupJob(job.id)!
}
export function startBackendSyncJob(options: {
fromBackendId: string
toBackendId: string
deleteSource?: boolean
setDefault?: boolean
dryRun?: boolean
}, userId?: number | null): BackupJob {
claimJobSlot()
const job = createBackupJob({
type: 'backend_sync',
userId,
message: options.dryRun ? '预检中…' : '等待开始…',
payload: options
})
scheduleBackupJob(job, () => runBackendSyncJob(job.id, options))
return getBackupJob(job.id)!
}