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

154 lines
4.7 KiB
TypeScript

import { createWriteStream, promises as fs } from 'node:fs'
import { join } from 'node:path'
import { pipeline } from 'node:stream/promises'
import * as tar from 'tar'
import { getImageTotals, listAllImageIndexRows } from '../image-index'
import type { ImageIndexRow } from '../image-index'
import {
listStorageBackendRows
} from '../storage-backends'
import { parseS3Config } from '../storage/s3'
import { parseTelegramConfig } from '../storage/telegram'
import { getBackendForKey } from '../storage/resolver'
import { copyDatabaseSnapshot } from './db-snapshot'
import { markJobDone, markJobFailed, updateBackupJob } from './jobs'
import { BACKUP_FORMAT_VERSION, type BackupManifest, type StorageBackendMetaExport } from './manifest'
import {
BACKUP_ARCHIVE_EXT,
getBackupStagingDir,
getBackupsDir
} from './paths'
import type { StorageBackendRow } from '../storage/types'
import { collectMediaAssetKeys } from '../media-assets'
function formatArchiveName(jobId: string): string {
return `pichost-${jobId}${BACKUP_ARCHIVE_EXT}`
}
function buildStorageBackendsMeta(): StorageBackendMetaExport[] {
return listStorageBackendRows().map((row: StorageBackendRow) => ({
id: row.id,
name: row.name,
type: row.type,
config: row.type === 's3'
? (parseS3Config(row.config_json) ?? {})
: row.type === 'telegram'
? (parseTelegramConfig(row.config_json) ?? {})
: {},
servingMode: row.serving_mode,
publicUrl: row.public_url,
quotaBytes: row.quota_bytes,
enabled: row.enabled === 1,
isDefault: row.is_default === 1,
sortOrder: row.sort_order
}))
}
async function writeStreamToFile(stream: NodeJS.ReadableStream, filePath: string): Promise<void> {
await fs.mkdir(join(filePath, '..'), { recursive: true })
await pipeline(stream, createWriteStream(filePath))
}
async function exportMediaAssets(
row: ImageIndexRow,
stagingRoot: string
): Promise<void> {
const backend = await getBackendForKey(row.key)
const keys = await collectMediaAssetKeys(row, backend)
for (const key of keys) {
await writeStreamToFile(
await backend.createStream(key),
join(stagingRoot, 'blobs', key)
)
}
}
export async function runFullExportJob(jobId: string, appVersion: string): Promise<void> {
const stagingRoot = getBackupStagingDir(jobId)
const archiveName = formatArchiveName(jobId)
const archivePath = join(getBackupsDir(), archiveName)
try {
await fs.rm(stagingRoot, { recursive: true, force: true })
await fs.mkdir(stagingRoot, { recursive: true })
await fs.mkdir(getBackupsDir(), { recursive: true })
const totals = getImageTotals()
const rows = listAllImageIndexRows()
updateBackupJob(jobId, {
total: totals.count + 1,
message: '正在备份数据库…'
})
await copyDatabaseSnapshot(join(stagingRoot, 'database', 'pichost.sqlite'))
updateBackupJob(jobId, { progress: 1, message: '正在写入备份元数据…' })
const manifest: BackupManifest = {
formatVersion: BACKUP_FORMAT_VERSION,
appVersion,
createdAt: new Date().toISOString(),
imageCount: totals.count,
imageBytes: totals.bytes,
includesDatabase: true
}
await fs.writeFile(
join(stagingRoot, 'manifest.json'),
JSON.stringify(manifest, null, 2),
'utf8'
)
const metaDir = join(stagingRoot, 'meta')
await fs.mkdir(metaDir, { recursive: true })
await fs.writeFile(
join(metaDir, 'storage_backends.json'),
JSON.stringify(buildStorageBackendsMeta(), null, 2),
'utf8'
)
await fs.writeFile(
join(metaDir, 'readme.txt'),
[
'PicHost site backup package.',
'Restore via Storage → Backup & migration in the admin UI.',
'Object storage secrets are not included; re-enter keys after restore.'
].join('\n'),
'utf8'
)
let processed = 1
for (const row of rows) {
updateBackupJob(jobId, {
progress: processed,
message: `正在导出文件 ${processed}/${totals.count + 1}…`
})
await exportMediaAssets(row, stagingRoot)
processed += 1
updateBackupJob(jobId, { progress: processed })
}
updateBackupJob(jobId, { message: '正在压缩备份包…' })
await tar.c(
{
gzip: true,
file: archivePath,
cwd: stagingRoot,
portable: true
},
['.']
)
await fs.rm(stagingRoot, { recursive: true, force: true })
markJobDone(jobId, {
message: '备份完成',
outputPath: archivePath,
payload: { archiveName }
})
} catch (error) {
await fs.rm(stagingRoot, { recursive: true, force: true }).catch(() => {})
const message = error instanceof Error ? error.message : '导出失败'
markJobFailed(jobId, message)
throw error
}
}