# Y2A-Auto 将 YouTube 视频自动搬运到 AcFun / bilibili 的一体化工具。 [](LICENSE) [](https://www.python.org/) [](https://www.docker.com/) 从下载、ASR、字幕翻译、字幕质检、内容审核到上传，全流程自动化；内置 Web 管理后台、YouTube 监控和维护能力。 [快速开始](#快速开始) · [功能概览](#功能概览) · [部署与运行](#部署与运行) · [Telegram 机器人](#方案-dtelegram-转发机器人可选) · [配置说明](#配置说明) · [使用指南](#使用指南) · [通知推送](#通知推送) · [CookieCloud](#cookiecloud-集成) · [安全特性](#安全特性) · [常见问题](#常见问题) ---

Telegram 转发机器人（公共实例）： @Y2AAuto_bot
_{⚠️ 公共实例部署在个人 VPS 上，该服务器已被墙，可用性无法保证；若无法连接，请按 自部署说明搭建自己的机器人： Y2A-Auto-tgbot}

项目展示

核心亮点

功能概览

• 自动化流水线
• yt-dlp 下载视频与封面
• 自动或按需进行语音识别生成字幕，支持 Whisper、Voxtral
• 字幕翻译、字幕后处理、字幕质检（QC）与字幕烧录
• AI 生成标题、简介、标签与分区推荐
• 内容安全审核（阿里云 Green）
• 自动上传到 AcFun / bilibili / 双平台
• Web 管理后台
• 任务列表、人工审核、强制上传
• 设置中心分组管理：运行概览、账号与网络、内容审核、AI 模型、字幕处理、语音识别、视频转码、监控与维护、安全
• 登录保护、错误次数锁定和密码管理
• YouTube 监控
• 频道监控与关键词搜索监控
• 支持 latest / historical 模式、视频类型筛选和自动加入任务队列
• 内置历史记录与配置文件恢复
• 通知推送
• 企业微信、Server酱、message-pusher 三种渠道
• 任务添加 / 完成 / 失败、登录成功 / 锁定、QR 登录成功 / 失败等事件推送
• 异步重试队列，递增间隔保证投递
• CookieCloud 集成
• 从 CookieCloud 服务自动拉取 YouTube / Google Cookies
• 支持 auto / legacy / aes-128-cbc-fixed 加密模式
• Web UI 一键测试与同步
• Telegram 转发机器人
• 独立部署的 Y2A-Auto-tgbot，在 Telegram 内直接发送 YouTube 链接提交任务
• 使用最小权限 API Token，公共实例不保证可用，建议自部署
• 字幕变换引擎
• 长行自动拆分、标点标准化、填充词 / 重复词过滤
• 幻觉文本与噪声标签检测、文本密度过高检测
• 时间偏移、最短时长、相邻间隙合并等后处理
• 视频转码
• 支持 CPU / NVIDIA / Intel / AMD 硬件编码
• 默认优先 HEVC / H.265，失败后自动回退到 H.264
• 平台认证
• AcFun / bilibili 支持 QR 码扫码登录
• bilibili 支持 Cookie 导入（Netscape / JSON 格式）
• 维护与环境
• Windows 可自动补齐 FFmpeg
• 支持日志清理、下载清理和自定义 FFmpeg 路径

项目结构

Y2A-Auto/
├── app.py
├── requirements.txt
├── Dockerfile
├── docker-compose.yml
├── docker-compose-build.yml
├── acfunid/
├── build-tools/
├── config/
├── cookies/
├── db/
├── downloads/
├── ffmpeg/
├── fonts/
├── logs/
├── modules/
├── static/
├── temp/
├── templates/
└── tests/

快速开始

推荐使用 Docker（无需手动安装 Python、FFmpeg、yt-dlp）。

1. 准备 Cookie（必须） - cookies/yt_cookies.txt：YouTube 登录 Cookie - cookies/ac_cookies.json：AcFun 登录 Cookie - cookies/bili_cookies.json：bilibili 登录 Cookie - 可使用浏览器扩展导出 cookies.txt，请勿提交到仓库

2. 启动服务

# 默认从 Docker Hub 拉取镜像 fqscfqj/y2a-auto:latest
# 如需使用 GitHub 容器注册表，可切换为 ghcr.io/fqscfqj/y2a-auto:latest
docker compose up -d

3. 打开 Web - 访问 http://localhost:5000 - 首次进入建议先配置登录保护、平台账号和 YouTube Cookie

默认会持久化目录：config/、db/、downloads/、logs/、temp/、cookies/。

说明：fonts/ 中的字体属于项目内置依赖，用于字幕烧录；许可证见 fonts/LICENSE.txt。

部署与运行

方案 A：Docker（推荐）

• 启动：docker compose up -d
• 停止：docker compose down
• 重启：docker compose restart
• 日志：docker compose logs -f

如需本地构建镜像，可使用：

docker compose -f docker-compose-build.yml up -d --build

如果启动日志出现写入 config/、db/ 或 logs/ 等挂载目录的 PermissionError，请在项目目录中创建这些目录，并将其属主改为容器内应用使用的 UID/GID（默认 1000:1000）：

mkdir -p config db downloads logs cookies temp
sudo chown -R 1000:1000 config db downloads logs cookies temp

启用了 rootless Docker 或 userns-remap 时，请使用容器 UID 1000 实际映射到宿主机的 UID/GID；映射方式参见 Docker 官方文档。

方案 B：本地运行

前置要求： - Python 3.11+ - FFmpeg - yt-dlp

py -3.11 -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python app.py

访问 http://127.0.0.1:5000。

方案 C：Windows 便携包

• build-tools/ 提供 Windows 可执行文件构建工具
• 官方 Windows Release 包通常已内置 FFmpeg / FFprobe
• 如果手工打包，保持 ffmpeg/ 目录完整即可

方案 D：Telegram 转发机器人（可选）

Y2A-Auto-tgbot 是一个独立的 Telegram 机器人：在 Telegram 里直接发送 YouTube 视频 / 播放列表链接，机器人会调用本服务的 /tasks/add_via_extension 接口提交上传任务。它需要单独部署，不会随本项目一起启动。

⚠️ 公共实例不保证可用。 @Y2AAuto_bot 运行在个人 VPS 上，该服务器已被墙，可能随时无法访问。需要长期、稳定使用时请自行部署。

自部署要点（Bot Token 创建、Token 作用范围等完整说明见 Y2A-Auto-tgbot README）：

1. 在 Telegram 找 @BotFather，发送 /newbot 创建机器人，拿到 TG_BOT_TOKEN（形如 123456789:AAE...）
2. 克隆并启动机器人：

bash git clone https://github.com/fqscfqj/Y2A-Auto-tgbot.git cd Y2A-Auto-tgbot # 编辑 docker-compose.yml 填写 TG_BOT_TOKEN（可选 ADMIN_TELEGRAM_IDS），然后： docker compose up -d

3. 打开本项目的 设置 → 运维与安全 → Telegram Bot API Token，点击「生成 Token」并立即复制 y2a_tgbot_v1_...（明文只显示一次）
4. 在 Telegram 向新建的机器人发送 /settings，填写 API 地址（机器人所在网络能访问到的本项目地址，例如同机 http://127.0.0.1:5000，跨机器 http://192.168.1.100:5000）和 API Token，再点「🔬 测试」确认连接成功
5. 测试通过后，直接给机器人发送 YouTube 链接即可提交任务

该 Token 只允许调用 /tasks/add_via_extension，无法访问设置、日志等其它接口，并且可以随时在设置页重置或撤销。

配置说明

首次运行会自动生成 config/config.json。推荐先配置以下几类参数：

基础与安全

• AUTO_MODE_ENABLED：无人值守自动投稿总开关，默认 false
• password_protection_enabled：Web 密码保护，默认 false
• LOGIN_MAX_FAILED_ATTEMPTS：连续错误次数上限，默认 5
• LOGIN_LOCKOUT_MINUTES：锁定时长，默认 15
• LOGIN_SESSION_TIMEOUT_MINUTES：登录空闲超时时长，默认 30 分钟，最小 1，访问受保护页面会自动续期
• UPLOAD_TARGET_DEFAULT：默认投稿平台，支持 acfun、bilibili、both
• UPLOAD_APPEND_REPOST_NOTICE：是否自动追加转载声明，默认 true

账号与网络

• YOUTUBE_COOKIES_PATH：YouTube Cookie 路径
• ACFUN_COOKIES_PATH：AcFun Cookie 路径
• BILIBILI_COOKIES_PATH：bilibili Cookie 路径
• BILIBILI_SUBMIT_API：bilibili 投稿接口，auto（默认，优先必剪 PC 接口，失败回退 Web）/ bcut_pc / web（手改成 bcut 等别名也会被归一化后再保存）
• YOUTUBE_PROXY_ENABLED / YOUTUBE_PROXY_URL：YouTube 下载代理
• YOUTUBE_API_PROXY_ENABLED / YOUTUBE_API_PROXY_URL：YouTube 监控 API 独立代理，不继承下载代理
• YOUTUBE_DOWNLOAD_THREADS：下载线程数
• YOUTUBE_THROTTLED_RATE：下载速度限制
• YOUTUBE_API_KEY：YouTube Data API v3 密钥，监控功能需要
• FFMPEG_LOCATION：自定义 FFmpeg 路径
• FFMPEG_AUTO_DOWNLOAD：Windows 缺失时自动下载 FFmpeg，默认 true

FFmpeg 版本要求：≥ 5.1。 字幕烧录使用 -fps_mode cfr 控制帧率模式， 该选项在 FFmpeg 5.1 才引入（5.0 及更早只认已弃用的 -vsync）。仓库自带的 与自动下载的 FFmpeg（BtbN latest）都远高于该版本；但若通过 FFMPEG_LOCATION 指向 5.0 或更早的旧版本，软件编码路径会因 Unrecognized option 'fps_mode' 直接失败（非硬件编码器没有降级重试，任务会直接报错）。

VIDEO_CPU_CODEC=x265 还额外要求该 FFmpeg 构建带 libx265（需 --enable-gpl --enable-libx265，BtbN 与仓库自带版本均满足）。缺失时会自动降级为 libx264 并继续烧录，不会因缺库而丢掉整条字幕。

AI 与投稿

• OPENAI_API_KEY / OPENAI_BASE_URL / OPENAI_MODEL_NAME：全局 AI 配置
• OPENAI_THINKING_ENABLED：是否允许模型使用思考模式；关闭时优先发送厂商文档中的原生开关（DeepSeek Chat 用 thinking、Responses 用 reasoning.effort=none；Qwen Chat/Responses 用 enable_thinking；MiMo Chat 用 thinking、Responses 用 reasoning.effort=none）。原生开关被端点以 400/422 拒绝时，会在同一请求内再尝试标准 reasoning_effort=none / reasoning.effort=none，全部形态都失败才移除控制并记录 warning；此时模型可能恢复默认思考行为。第三方网关上的 DeepSeek/Ling/混元没有可靠原生开关，先尝试标准参数，再尝试通用 thinking 对象。通过反向代理访问官方端点时无法从域名识别厂商，会按第三方顺序逐个尝试，但不会因此跳过关闭思考的尝试。OpenAI o 系列 / GPT-5 等推理模型各代支持的 reasoning_effort 取值不同，本开关不会自动改写，需在模型网关侧控制
• SUBTITLE_OPENAI_*：字幕翻译专用覆盖配置，留空则回退全局
• SUBTITLE_QC_*：字幕质检专用覆盖配置，留空则回退字幕翻译 / 全局配置
• TRANSLATE_TITLE / TRANSLATE_DESCRIPTION / GENERATE_TAGS：自动生成标题、简介、标签
• RECOMMEND_PARTITION：自动推荐分区
• FIXED_PARTITION_ID / FIXED_PARTITION_ID_BILIBILI：固定分区
• YOUTUBE_UPLOADER_AS_FIRST_TAG：将上传者作为首标签
• PRESET_TAGS_ENABLED / PRESET_TAGS：预设标签，每行一个（也接受逗号、顿号、分号分隔）。启用后预设标签排在任务标签之前，GENERATE_TAGS 开启时 AI 只补齐剩余名额；一份预设同时服务 AcFun（前 6 个、每个约 10 字）与 bilibili（最多 12 个、每个 20 字）

AI 文本功能同时兼容 OpenAI Chat Completions 与 Responses API。OPENAI_BASE_URL 可填写 API 根地址（例如 https://api.openai.com/v1，默认使用 Chat Completions）或完整的 /chat/completions、/responses 地址；填写完整端点时会自动选择协议并规范化。Responses 请求会自动转换消息、JSON 输出格式、思考开关和 token 上限参数，返回值也会归一化供翻译、质检、智能分段等现有功能使用。当兼容服务不支持 response_format、token 上限参数、自定义 temperature 或特定指令角色时，系统会根据端点实际错误逐级协商；若网关只返回笼统的请求 schema 错误，则降级为仅含 model + user messages 的最小标准请求。能力只在降级请求成功后按端点、协议和模型缓存。

字幕处理

• SUBTITLE_TRANSLATION_ENABLED：启用字幕翻译，默认 false
• YOUTUBE_AUTO_GENERATED_SUBTITLES_ENABLED：下载 YouTube 自动生成字幕，默认 false
• SUBTITLE_SOURCE_LANGUAGE：源语言，默认 auto
• SUBTITLE_TARGET_LANGUAGE：目标语言，默认 zh
• SUBTITLE_FONT_NAME：烧录字幕字体名，默认 NotoSansCJKsc-Regular.otf
• SUBTITLE_BATCH_SIZE：翻译批次大小
• SUBTITLE_MAX_RETRIES / SUBTITLE_RETRY_DELAY：翻译重试策略
• SUBTITLE_EMBED_IN_VIDEO：是否将字幕嵌入视频
• SUBTITLE_KEEP_ORIGINAL：是否保留原始字幕文件
• SUBTITLE_MAX_WORKERS：字幕翻译并发线程数

烧录字幕外观（默认值即历史观感；对 .ass/.ssa 源的行为变更见下方说明）：

• SUBTITLE_FONT_SIZE_SCALE / SUBTITLE_MARGIN_V_SCALE：字号与底部边距倍率，范围 0.5-2.0，默认 1.0
• SUBTITLE_FONT_COLOR / SUBTITLE_OUTLINE_COLOR：字体色与描边色，#RRGGBB，默认 #FFFFFF / #000000
• SUBTITLE_OUTLINE_ENABLED / SUBTITLE_OUTLINE_SCALE：描边开关与粗细倍率（0-3）
• SUBTITLE_SHADOW_ENABLED / SUBTITLE_SHADOW_SCALE：阴影开关与倍率（0-3）
• SUBTITLE_TEXT_BOLD：是否粗体，默认 true
• SUBTITLE_BACKGROUND_ENABLED / SUBTITLE_BACKGROUND_COLOR / SUBTITLE_BACKGROUND_OPACITY：半透明底板（BorderStyle=4）及其颜色与不透明度（0-1）。开启后 libass 会把阴影当作底框外扩，建议同时关闭阴影

行为变更（.ass / .ssa 源素材）：上述外观配置现在对所有字幕源统一生效。 此前上游只把字体与边距写进 force_style，字色 / 描边色 / 粗体 / 底板这些键对 .ass / .ssa 源不生效（同一份配置喂 .srt 是红字、喂 .ass 仍是创作者的白字）， 现在这些键改为逐键覆盖源样式 —— 也就是说，素材自带的字色 / 粗体 / 底板样式会被 应用配置覆盖，未配置时即默认的白字 + 粗体 + 描边（与 SRT 源行为一致）。 升级后若想保留素材自带外观，请把对应配置项显式设置成与素材一致的取值，或改用 自带样式的外部字幕文件而不依赖本功能。

语音识别（ASR）

• SPEECH_RECOGNITION_ENABLED：是否启用语音识别生成字幕，默认 false
• SPEECH_RECOGNITION_PROVIDER：支持 whisper、voxtral
• VAD_ENABLED：VAD 语音扫描窗，默认 true
• WHISPER 路径默认使用 segment 级时间戳，并自动兼容不支持 timestamp_granularities 的接口
• WHISPER_LANGUAGE / WHISPER_PROMPT / WHISPER_TRANSLATE：Whisper 专用参数
• `VOXTRAL_TIMESTAMP_GRA