Y2A-Auto 详细部署教程

Y2A-Auto 是一个将 YouTube 视频自动搬运到 AcFun / bilibili 的一体化工具，支持从下载、AI 翻译、字幕生成、内容审核到上传的全流程自动化。

一、部署前准备

无论选择哪种部署方式，都必须准备以下 Cookie 文件：

Cookie 文件 用途 格式
cookies/yt_cookies.txt YouTube 登录 Netscape 格式
cookies/ac_cookies.json AcFun 登录 JSON 格式
cookies/bili_cookies.json bilibili 登录 JSON 格式

获取方法：使用浏览器扩展（如 EditThisCookie）从已登录的对应平台导出 Cookie，切勿提交到公开仓库。

如需使用 YouTube 频道/关键词监控功能，还需准备 YouTube Data API v3 密钥。

二、Docker 部署（推荐）

这是最省心的方式，无需手动安装 Python、FFmpeg、yt-dlp。

1. 克隆项目

1
2
git clone https://github.com/fqscfqj/Y2A-Auto.git
cd Y2A-Auto

在项目根目录创建 cookies 文件夹，放入准备好的三个 Cookie 文件：

text

1
2
3
4
5
Y2A-Auto/
└── cookies/
    ├── yt_cookies.txt
    ├── ac_cookies.json
    └── bili_cookies.json

3. 启动服务

1
docker compose up -d

默认从 Docker Hub 拉取镜像 fqscfqj/y2a-auto:latest。

4. 访问 Web 界面

浏览器打开 http://localhost:5000。

常用管理命令

1
2
3
docker compose down      # 停止
docker compose restart   # 重启
docker compose logs -f   # 查看日志

权限问题处理

如果启动日志出现 PermissionError，需调整目录权限：

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

GPU 加速配置（可选）

NVIDIA 用户：在 docker-compose.yml 中取消注释相关配置，并确保主机已安装 nvidia-container-toolkit。

Intel / AMD Linux 用户：添加设备映射：

1
2
3
4
5
devices:
  - /dev/dri:/dev/dri
group_add:
  - video
  - render

三、本地运行（备选）

适合开发者进行调试或二次开发。

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

安装步骤

1
2
3
4
5
6
7
8
9
# 创建虚拟环境（Windows）
py -3.11 -m venv .venv
.\.venv\Scripts\Activate.ps1

# 安装依赖
pip install -r requirements.txt

# 启动
python app.py

访问 http://127.0.0.1:5000。

四、首次配置

启动后进入 Web 后台，建议按以下顺序配置：

  1. 安全设置（强烈建议）：在「设置中心」→「安全」中启用 password_protection_enabled，设置强密码，避免管理界面暴露。
  2. 平台账号认证：在「账号与网络」中配置 AcFun 和 bilibili 的 Cookie，或使用「扫码登录」功能。
  3. AI 模型配置：填入 OPENAI_API_KEY、OPENAI_BASE_URL、OPENAI_MODEL_NAME（支持 OpenAI 兼容接口）。
  4. YouTube 监控（可选）：填入 YOUTUBE_API_KEY 以启用频道/关键词自动抓取。
  5. 投稿目标：设置 UPLOAD_TARGET_DEFAULT（acfun / bilibili / both）。

五、使用流程

  1. 在首页提交 YouTube 链接创建任务。
  2. 自动模式流程：下载 → ASR/字幕处理 → AI 元信息 → 审核 → 上传。
  3. 在「人工审核」页可调整标题、简介、标签、分区后强制上传。
  4. 启用 YouTube 监控后，新视频会自动加入任务队列。

六、常见问题

问题 解决方案
403 / 需要登录 更新 cookies/yt_cookies.txt，或配置 CookieCloud 自动同步
找不到 FFmpeg Docker 环境无需处理；本地运行检查 PATH 或 FFMPEG_LOCATION
上传 AcFun / bilibili 失败 更新对应 Cookie，或在设置页重新扫码登录
云服务器无法访问 5000 端口 不要直接开放公网，推荐使用 SSH 端口转发：ssh -N -L 5000:127.0.0.1:5000 user@服务器IP

安全提醒

Cookie 等同于账号密码，请确保 cookies/ 目录权限设为 600，切勿提交到 Git 仓库。搬运视频前请确认获得原作者授权或素材符合平台转载规则。