自部署的完整路书

Docker 一键部署：从克隆到出第一条片

一条命令拉起 MySQL 8 + Redis + API + Worker + Web 全栈，含密钥生成、健康检查与数据备份恢复。

域名解析与站点上线 checklist：从买域名到能访问

域名从注册到解析生效的完整流程：DNS 记录类型怎么选、解析生效时间、常见解析错误，以及上线前的最后一公里检查。

nginx 静态部署与 HTTPS 配置指南：把站点安全地上线

用 nginx 托管逐日 AI 静态导出站点并配置 HTTPS 证书的完整流程：反代 /api、SSE 支持、强制 HTTPS、证书自动续期，以及上线前的检查清单。

CDN 配置指南：静态站点的加速、缓存与防护

静态导出的站点天然适合上 CDN：全球加速、扛流量峰值、隐藏源站。本文讲 CDN 的接入配置、缓存规则设计、与防盗链/限流的安全配合。

网站备案流程：从域名到合法上线

国内服务器上线网站必须的 ICP 备案全流程：前置条件、材料清单、各环节耗时、常见退回原因，以及公安联网备案的后续步骤。

备案被退回的十大原因：第一次备案一次过的秘诀

第一次备案最怕反复退回。本文整理高频退回原因：网站名称不合规、材料照片问题、前置审批缺失——每条给"怎么改"，附备案全流程的时间预期。

HTTPS 证书故障排查：过期、续期失败、 mixed content

证书相关的三类故障：过期（浏览器红锁警告）、certbot 自动续期失败、全站 mixed content 警告。每类给出诊断命令与修复动作。

主流云服务器怎么选：国内三家与大厂对比的实用视角

选云服务器不看参数表看三件事：价格与性能的平衡、生态配套（备案/CDN/OSS 的联动）、以及迁移的便利性。本文给选型的实用视角与常见的配置建议。

内网部署方案：无公网 IP 环境下的完整使用

企业内网/无公网环境（涉密、隔离网络）能不能用逐日 AI？能——纯内网部署方案：本地模型、本地存储、内网访问，以及"内网里少了什么"的诚实清单。

模型 API Key 配置：按能力类型接入你的 Key

大模型 / 语音合成 / 生图 / 生视频四类能力分别怎么配：OpenAI 兼容接口、阿里云 DashScope、本地 ComfyUI。

ComfyUI 接入：生图工作流与数字人 GPU 环境

连接本地或远程 ComfyUI 做生图与 H3 图生视频；MuseTalk 数字人的显卡要求与注意事项。

MuseTalk 部署教程：给逐日 AI 接上数字人口型合成

从零部署 MuseTalk 数字人口型同步环境：GPU/显存要求、ComfyUI 工作流配置、逐日 AI 的远程接入方法，以及常见报错（人脸检测失败、显存不足、生成过慢）的自查清单。

阿里云 OSS 存储配置指南：视频素材与成片的云端存储

把逐日 AI 的素材与成片存储接到阿里云 OSS 的配置方法：Bucket 规划、权限与安全、生命周期与成本控制，以及本地存储与 OSS 的混合方案。

AI 视频生产怎么选显卡：从入门到数字人的显存账（2026）

跑 AI 生图、视频生成、数字人口型同步分别需要什么显卡？本文按显存需求分档（8GB/12GB/24GB），给出消费级显卡的选型建议和"没有显卡怎么办"的租用方案。

模型切换指南：平滑迁移到新模型的步骤与验证

换模型（大模型/TTS/生图）不是改个配置就完事——本文给平滑切换的完整步骤：切换前的评估、灰度验证、质量对比方法，以及回滚预案。

模型 API 常见报错排查：401 / 429 / 超时 / 余额不足

调用大模型、TTS、生图 API 时的高频报错逐个拆解：401 认证失败、403 权限/地域、429 限流、超时与重试、余额与配额。每条给出原因判断顺序和具体处理动作。

ComfyUI 常见报错排查手册：装不上、跑不动、图不对

ComfyUI 接入逐日 AI 前后的高频报错排查：安装与依赖、模型加载失败、显存不足、节点缺失、工作流出图异常。每条按"报错现象 → 原因 → 处理动作"组织。

MySQL 连接失败与权限问题排查：从报错到修复

MySQL 的三类高频故障：连接被拒（1045/2002）、权限不足（1044/1142）、以及"时好时坏"的连接超时。每类给诊断命令与修复动作。

Redis 队列与缓存问题排查：任务卡住、连接失败、内存告警

逐日 AI 的任务队列跑在 Redis（BullMQ）上。本文排查三类高频问题：任务卡住不动、连接失败、内存告警，以及重启 Redis 前必须知道的事。

OSS 上传失败与签名错误排查：AccessDenied 的七种姿势

对象存储（OSS/S3）的高频报错排查：签名不匹配、AccessDenied、上传中断、跨域失败。每类给诊断思路与修复动作，附预签名 URL 的注意事项。

ffmpeg 报错与版本问题排查：合成环节的自救手册

视频合成环节的高频 ffmpeg 问题：版本过旧、编码器缺失、文件损坏、音画不同步、内存爆掉。按"报错 → 原因 → 处理"组织，附常用的自检命令。

TTS 配音报错与质量问题排查：无声、截断与发音错误

TTS 配音的故障排查：生成无声、音频截断、多音字发音错误、语气平淡。技术报错与"听感问题"分开诊断，每类给处理动作。

AI 生图失败与画质差的排查清单：从报错到出图不对

AI 生图的两大类问题分开排查：报错类（直接失败）与质量类（出了图但不对）。覆盖内容安全拒绝、参数超限、肢体崩坏、风格漂移的高频原因与处理动作。

图生视频报错排查：生成失败、画面闪烁、动作失真

图生视频（I2V）的高频问题：生成失败、画面闪烁变形、运动过猛或不动、主体漂移。每类给原因分析与处理动作，附输入素材的准备清单。

视频导出问题排查：失败、花屏、文件打不开

成片导出环节的高频问题排查：导出失败、播放花屏、文件大小异常、特定平台上传失败。多数问题源于编码参数或存储环节，逐项对号处理。

SSE 实时进度不工作的排查：代理缓冲、超时与连接断开

工作台的实时进度走 SSE（Server-Sent Events）。进度条不动、进度"一顿一顿"、或长时间后断开——三类问题的排查链路：代理配置、超时设置、网络环境。

Next.js 构建失败排查：从类型错误到 SSG 数据收集

next build 的高频失败排查：类型错误、SSG 数据收集失败（generateStaticParams 的坑）、环境变量缺失、以及"本地好好的构建挂了"的常见原因。

Prisma 迁移与查询报错排查：从 migrate 到连接池

逐日 AI 的数据层基于 Prisma（MySQL）。本文排查三类高频问题：migrate 失败、连接池耗尽、以及查询超时——每类给诊断命令与修复动作。

BullMQ 任务队列排错：重试、失败、优先级与卡死

逐日 AI 的生成任务由 BullMQ（Redis）调度。本文排查队列的四个高频问题：任务不消费、重试风暴、失败堆积、优先级失效。

pm2 进程管理指南：自部署服务的日常运维

用 pm2 管理逐日 AI 三件套（API/worker/web）的日常操作：进程状态解读、日志查看、异常重启、开机自启，以及"服务突然挂了"的排查顺序。

日志轮转与磁盘管理：别让日志写满你的服务器

日志失控是服务器磁盘写满的头号原因。本文讲日志轮转的配置（pm2-logrotate/nginx/MySQL）与磁盘监控的自动化，附一套每周磁盘巡检脚本。

storage 目录管理与素材生命周期：磁盘不再告警

逐日 AI 的 storage 目录存放素材与成片，是磁盘增长的主要来源。本文讲目录结构、增长预估、清理策略与生命周期自动化。

数据备份实操手册：从 mysqldump 到可恢复验证

一套可以直接抄的备份方案：每日自动备份数据库与素材、上传异地、保留策略，以及最重要的——"备份是可以恢复的"如何验证。

备份策略的设计：RPO、RTO 与你的钱袋

备份策略的两个专业指标其实很好懂：RPO（能接受丢多少数据）和 RTO（能接受停多久）。本文用这两个指标反推你的备份方案，附不同规模团队的建议配置。

MySQL 自动备份的完整配置：从 crontab 到异地存储

一份可以直接抄的 MySQL 自动备份配置：备份脚本、crontab 定时、异地同步（rclone 到 OSS）、保留策略与失败告警——20 分钟配好，永久安心。

MySQL 与 Redis 日常维护：自部署系统的数据底线

自部署视频生产系统的两大数据依赖的维护要点：MySQL 的备份与慢查询、Redis 的内存与持久化，以及一套"每周十分钟"的维护例行。

每日运维打卡表：十分钟的服务器健康检查

服务器的稳定靠的不是技术高，是"每天看一眼"。一张每日打卡表：五项检查各一条命令，异常的信号写清楚——把"突然出事"变成"提前发现"。

服务器内存优化：从 OOM 到稳定运行的排查手册

服务器内存吃满（OOM）会让服务随机崩溃。本文排查内存消耗的四大来源（应用/缓存/数据库/系统），给逐日 AI 场景的内存配置建议与监控方法。

API 用量监控与告警：把"账单惊喜"变成"预算内运行"

模型 API 按量计费的最大风险是"账单失控"——异常重试、被刷、配置错误都可能在半夜烧钱。本文给一套三层监控告警方案：平台侧、应用侧、账单侧。

批量任务的调度策略：并发、限流与错峰

批量生成几百个切片时，调度策略决定"多快跑完"和"花多少钱"：并发怎么设、限流怎么配合、错峰怎么省心。本文是批量生产场景的调度手册。

Node.js 版本升级与依赖迁移：从 18 到 20/22 的安全路径

Node.js LTS 版本升级是自部署系统的周期性工程：升级的评估、步骤、依赖兼容性排查与回滚方案。逐日 AI 的 Node 升级按此路径执行。

逐日 AI 版本升级与数据迁移指南：升级不丢数据

自部署系统的升级流程：升级前备份什么、怎么平滑升级不中断任务、升级后验证哪些功能，以及换服务器时的完整数据迁移清单。

站点慢的性能排查：从 TTFB 到首屏的完整链路

「网站慢」的系统性排查：TTFB（服务器响应）、资源加载、渲染阻塞、移动网络——按链路逐环测量与优化，附 Lighthouse 的正确用法。

网速慢排查：网站打开慢，先查这五处

用户说"网站慢"，别急着升级服务器——先按链路排查五处：DNS 解析、TTFB、资源体积、渲染阻塞、移动网络。每处给测量方法与优化动作。

首屏加载优化：白屏时间从 5 秒到 1 秒的实操记录

一次真实的首屏优化记录：测量 → 发现三个问题（大图、阻塞 JS、无缓存）→ 逐个修复 → 数据对比。照着这个流程排查你自己的站点。

移动端适配检查：你的站一半流量在手机上

内容站的移动流量占比过半，但多数桌面开发的站点在手机上"能用但难用"。本文给移动端适配的检查清单：导航、触达、字号、性能四组。

微信分享卡片不显示的排查：从 SDK 到缓存

网页分享到微信时卡片图/标题/摘要不生效的排查手册：JS-SDK 签名、域名验证、缓存问题，以及无 SDK 场景的默认行为说明。

服务器安全加固清单：SSH、防火墙与 fail2ban

自部署服务器的安全底线配置：SSH 密钥登录、禁 root 密码、防火墙白名单、fail2ban 防爆破。十二项按优先级排列，一小时配完，挡住 99% 的常规攻击。

API Key 安全管理：加密存储、权限最小化与轮换

模型 API Key 是能直接花钱的凭据，管理不当轻则账单爆炸重则数据泄漏。本文给一套自部署环境下的 Key 安全实践：存储加密、子账号最小权限、泄露应急与轮换节奏。

权限设计入门：给团队配账号的原则与实践

「谁能看什么、谁能改什么」——权限设计的最小可行方案：角色三分法（管理员/编辑/访客）、最小权限原则、以及多项目团队的项目隔离实践。

团队多用户与权限管理：从单人体验到多人协作

自部署系统如何支撑多人团队：角色与权限的划分、账号资源的隔离与共享、新人入离职的账号流程，以及多账号矩阵场景的组织方式。

多客户项目的数据隔离：一个系统服务多个客户的正确姿势

用一套逐日 AI 服务多个客户/多个品牌时，数据隔离是底线：项目怎么分组、素材怎么隔离、权限怎么分配——一份"多租户"的实践清单。

AI 视频的完整生产流程：从想法到发布的 14 步

把"做一条 AI 视频"拆成 14 个步骤，每步标注：是否需要人工、耗时、常见问题。这是一份新人可以直接照做、老手可以对照优化的流程手册。

工具联动的工作流：让每个工具只做最擅长的事

没有一个工具能做好所有环节——高效的内容工作流是工具联动：生产系统的集成闭环（生成→合成→导出）、单点工具的按需插入（专业环节）、手工工具的最终把关。本文给一个环节×工具的联动矩阵。

画质提升链路：从素材到导出的清晰度全攻略

观众划走有一半原因是"画质不行"。本文按生产链路逐环节给出清晰度要点：素材规格、生图参数、合成导出、平台二压——每个环节的画质损耗点与补救方法。

引流私域的合规方式：平台红线与安全钩子

把公域流量导进私域是平台监管的重点区域。本文讲清诱导导流的红线在哪里、安全的钩子设计长什么样，以及"内容价值换私域关注"的正确姿势。

视频二次剪辑的版权边界：剪自己的素材也会翻车吗

二次剪辑的版权问题清单：自己的素材随便剪、别人的素材要看授权、平台的素材库分"站内"与"商用"。一份"能不能剪、怎么剪才安全"的判断指南。