NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules
Go modules, #1220 by repository stars
Latest stable
v0.4.1
Last release 5 months ago
21 Jun 2026
Release timing varies
gaps range from 8 days to 3 months
Most releases are documented
notes for 29 of 34 stable releases
Nothing withdrawn
no release was ever pulled
1 years old
39 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
| 工具 | 用途 | 是否必须 |
|---|---|---|
| yt-dlp | YouTube 视频下载 | ✅ 必须 |
| ffmpeg | 音视频处理 | ✅ 必须 |
api2key.base_url 或服务端兜底 LLM Key |
AI 功能 | 可选 |
安装 yt-dlp:
# macOS
brew install yt-dlp
# Linux
pip install yt-dlp
# 或下载二进制:https://github.com/yt-dlp/yt-dlp/releases/latest
# Windows
winget install yt-dlp安装 ffmpeg:
# macOS
brew install ffmpeg
# Ubuntu / Debian
sudo apt install ffmpeg
# Windows
winget install ffmpeg前往 GitHub Releases 下载对应平台的二进制文件:
| 平台 | 架构 | 文件名 |
|---|---|---|
| Linux | x86_64 (AMD64) | ytb2bili-linux-amd64 |
| Linux | ARM64 (树莓派 / 服务器) | ytb2bili-linux-arm64 |
| macOS | Intel | ytb2bili-darwin-amd64 |
| macOS | Apple Silicon (M1/M2/M3) | ytb2bili-darwin-arm64 |
| Windows | x86_64 | ytb2bili-windows-amd64.exe |
命令行下载示例(Linux / macOS):
# 以 Linux AMD64 为例,替换版本号和文件名
VERSION=v0.4.1
curl -L -o ytb2bili \
"https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"
# 授予执行权限
chmod +x ytb2bili程序启动时会从当前工作目录读取 config.toml。
# 下载配置模板(用于参考)
curl -L -o config.toml \
"https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"或手动创建 config.toml,以下是最小必要配置:
# ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir = "./downloads"
static_path = "/static"
# ── 数据库(SQLite,开箱即用)─────────────────────────
[database]
type = "sqlite"
path = "ytb2bili.db"
auto_migrate = true
# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path = "/usr/local/bin/yt-dlp" # 若不在 PATH 中,取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url = "http://127.0.0.1:7890" # 代理(可选)
# ── AI Agent(可选兜底,不影响 ytb2bili-api 网关模式)──────────────
[agent]
name = "ytb2bili_agent"
[agent.llm]
# api_key = "sk-..." # 可选:仅本地兜底时填写
model = "gpt-4o-mini"
# base_url = "https://open.ytb2bili.com/ai/v1"
# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled = true
auto_update = false
check_interval = 24说明:Web AI 助手默认走 ytb2bili-api /ai/v1 网关,
agent.llm只作为旧流程或离线环境的兜底配置。[agent.llm] api_key = "sk-..." model = "gpt-4o-mini" base_url = "https://open.ytb2bili.com/ai/v1"
# 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili config.toml
# Linux / macOS
./ytb2bili
# Windows
.\ytb2bili-windows-amd64.exe启动成功后,终端输出类似:
🚀 YTB2BILI 启动中... 版本: v0.4.1, 构建时间: 2026-03-04T...
✅ 应用启动成功,按 Ctrl+C 停止...
访问地址:
| 入口 | 地址 |
|---|---|
| Web 界面 | http://localhost:8096 |
| API 健康检查 | http://localhost:8096/health |
| API 文档(Swagger) | http://localhost:8096/swagger/index.html |
通过环境变量 CONFIG_FILE 指定任意路径的配置文件:
CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili若需要下载需要登录的 YouTube 视频,在 config.toml 中配置:
[workflow]
cookies_file = "/path/to/cookies.txt"可通过浏览器插件(如 Get cookies.txt)导出 YouTube cookies。
[workflow]
llm_translation_enabled = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"downloads/ 目录将自动创建,用于存储下载的视频/字幕/缩略图。
可通过 http://localhost:8096/static/<文件名> 直接访问。
Ctrl+C 或 kill)启动后通过 API 检查更新:
# 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check
# 查看当前版本
curl http://localhost:8096/api/v1/updater/version
auto_update = true时程序会在后台自动下载并重启(实验性功能,建议生产环境手动升级)。
Q: 启动报错 config.toml: no such file or directory
A: 确保 config.toml 与可执行文件在同一目录,或通过 CONFIG_FILE 环境变量指定路径。
Q: 下载视频失败,提示 yt-dlp not found
A: 将 yt-dlp 安装后确保在 PATH 中,或在 config.toml 中填写绝对路径:
[workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"Q: macOS 提示"无法验证开发者"
A: 在终端执行以下命令移除隔离标记:
xattr -d com.apple.quarantine ytb2bili-darwin-arm64Q: 端口 8096 被占用
A: 修改 config.toml 中的 server.port 为其他端口。
Q: AI 功能不可用
A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。
Your coding agent can read these notes before it upgrades. Set up the MCP server →
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
| 工具 | 用途 | 是否必须 |
|---|---|---|
| yt-dlp | YouTube 视频下载 | ✅ 必须 |
| ffmpeg | 音视频处理 | ✅ 必须 |
api2key.base_url 或服务端兜底 LLM Key |
AI 功能 | 可选 |
安装 yt-dlp:
# macOS
brew install yt-dlp
# Linux
pip install yt-dlp
# 或下载二进制:https://github.com/yt-dlp/yt-dlp/releases/latest
# Windows
winget install yt-dlp安装 ffmpeg:
# macOS
brew install ffmpeg
# Ubuntu / Debian
sudo apt install ffmpeg
# Windows
winget install ffmpeg前往 GitHub Releases 下载对应平台的二进制文件:
| 平台 | 架构 | 文件名 |
|---|---|---|
| Linux | x86_64 (AMD64) | ytb2bili-linux-amd64 |
| Linux | ARM64 (树莓派 / 服务器) | ytb2bili-linux-arm64 |
| macOS | Intel | ytb2bili-darwin-amd64 |
| macOS | Apple Silicon (M1/M2/M3) | ytb2bili-darwin-arm64 |
| Windows | x86_64 | ytb2bili-windows-amd64.exe |
命令行下载示例(Linux / macOS):
# 以 Linux AMD64 为例,替换版本号和文件名
VERSION=v0.4.0
curl -L -o ytb2bili \
"https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"
# 授予执行权限
chmod +x ytb2bili程序启动时会从当前工作目录读取 config.toml。
# 下载配置模板(用于参考)
curl -L -o config.toml \
"https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"或手动创建 config.toml,以下是最小必要配置:
# ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir = "./downloads"
static_path = "/static"
# ── 数据库(SQLite,开箱即用)─────────────────────────
[database]
type = "sqlite"
path = "ytb2bili.db"
auto_migrate = true
# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path = "/usr/local/bin/yt-dlp" # 若不在 PATH 中,取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url = "http://127.0.0.1:7890" # 代理(可选)
# ── AI Agent(可选兜底,不影响 ytb2bili-api 网关模式)──────────────
[agent]
name = "ytb2bili_agent"
[agent.llm]
# api_key = "sk-..." # 可选:仅本地兜底时填写
model = "gpt-4o-mini"
# base_url = "https://open.ytb2bili.com/ai/v1"
# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled = true
auto_update = false
check_interval = 24说明:Web AI 助手默认走 ytb2bili-api /ai/v1 网关,
agent.llm只作为旧流程或离线环境的兜底配置。[agent.llm] api_key = "sk-..." model = "gpt-4o-mini" base_url = "https://open.ytb2bili.com/ai/v1"
# 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili config.toml
# Linux / macOS
./ytb2bili
# Windows
.\ytb2bili-windows-amd64.exe启动成功后,终端输出类似:
🚀 YTB2BILI 启动中... 版本: v0.4.0, 构建时间: 2026-03-04T...
✅ 应用启动成功,按 Ctrl+C 停止...
访问地址:
| 入口 | 地址 |
|---|---|
| Web 界面 | http://localhost:8096 |
| API 健康检查 | http://localhost:8096/health |
| API 文档(Swagger) | http://localhost:8096/swagger/index.html |
通过环境变量 CONFIG_FILE 指定任意路径的配置文件:
CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili若需要下载需要登录的 YouTube 视频,在 config.toml 中配置:
[workflow]
cookies_file = "/path/to/cookies.txt"可通过浏览器插件(如 Get cookies.txt)导出 YouTube cookies。
[workflow]
llm_translation_enabled = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"downloads/ 目录将自动创建,用于存储下载的视频/字幕/缩略图。
可通过 http://localhost:8096/static/<文件名> 直接访问。
Ctrl+C 或 kill)启动后通过 API 检查更新:
# 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check
# 查看当前版本
curl http://localhost:8096/api/v1/updater/version
auto_update = true时程序会在后台自动下载并重启(实验性功能,建议生产环境手动升级)。
Q: 启动报错 config.toml: no such file or directory
A: 确保 config.toml 与可执行文件在同一目录,或通过 CONFIG_FILE 环境变量指定路径。
Q: 下载视频失败,提示 yt-dlp not found
A: 将 yt-dlp 安装后确保在 PATH 中,或在 config.toml 中填写绝对路径:
[workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"Q: macOS 提示"无法验证开发者"
A: 在终端执行以下命令移除隔离标记:
xattr -d com.apple.quarantine ytb2bili-darwin-arm64Q: 端口 8096 被占用
A: 修改 config.toml 中的 server.port 为其他端口。
Q: AI 功能不可用
A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
| 工具 | 用途 | 是否必须 |
|---|---|---|
| yt-dlp | YouTube 视频下载 | ✅ 必须 |
| ffmpeg | 音视频处理 | ✅ 必须 |
api2key.base_url 或服务端兜底 LLM Key |
AI 功能 | 可选 |
安装 yt-dlp:
# macOS
brew install yt-dlp
# Linux
pip install yt-dlp
# 或下载二进制:https://github.com/yt-dlp/yt-dlp/releases/latest
# Windows
winget install yt-dlp安装 ffmpeg:
# macOS
brew install ffmpeg
# Ubuntu / Debian
sudo apt install ffmpeg
# Windows
winget install ffmpeg前往 GitHub Releases 下载对应平台的二进制文件:
| 平台 | 架构 | 文件名 |
|---|---|---|
| Linux | x86_64 (AMD64) | ytb2bili-linux-amd64 |
| Linux | ARM64 (树莓派 / 服务器) | ytb2bili-linux-arm64 |
| macOS | Intel | ytb2bili-darwin-amd64 |
| macOS | Apple Silicon (M1/M2/M3) | ytb2bili-darwin-arm64 |
| Windows | x86_64 | ytb2bili-windows-amd64.exe |
命令行下载示例(Linux / macOS):
# 以 Linux AMD64 为例,替换版本号和文件名
VERSION=v0.3.9
curl -L -o ytb2bili \
"https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"
# 授予执行权限
chmod +x ytb2bili程序启动时会从当前工作目录读取 config.toml。
# 下载配置模板(用于参考)
curl -L -o config.toml \
"https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"或手动创建 config.toml,以下是最小必要配置:
# ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir = "./downloads"
static_path = "/static"
# ── 数据库(SQLite,开箱即用)─────────────────────────
[database]
type = "sqlite"
path = "ytb2bili.db"
auto_migrate = true
# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path = "/usr/local/bin/yt-dlp" # 若不在 PATH 中,取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url = "http://127.0.0.1:7890" # 代理(可选)
# ── AI Agent(可选兜底,不影响 ytb2bili-api 网关模式)──────────────
[agent]
name = "ytb2bili_agent"
[agent.llm]
# api_key = "sk-..." # 可选:仅本地兜底时填写
model = "gpt-4o-mini"
# base_url = "https://open.ytb2bili.com/ai/v1"
# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled = true
auto_update = false
check_interval = 24说明:Web AI 助手默认走 ytb2bili-api /ai/v1 网关,
agent.llm只作为旧流程或离线环境的兜底配置。[agent.llm] api_key = "sk-..." model = "gpt-4o-mini" base_url = "https://open.ytb2bili.com/ai/v1"
# 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili config.toml
# Linux / macOS
./ytb2bili
# Windows
.\ytb2bili-windows-amd64.exe启动成功后,终端输出类似:
🚀 YTB2BILI 启动中... 版本: v0.3.9, 构建时间: 2026-03-04T...
✅ 应用启动成功,按 Ctrl+C 停止...
访问地址:
| 入口 | 地址 |
|---|---|
| Web 界面 | http://localhost:8096 |
| API 健康检查 | http://localhost:8096/health |
| API 文档(Swagger) | http://localhost:8096/swagger/index.html |
通过环境变量 CONFIG_FILE 指定任意路径的配置文件:
CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili若需要下载需要登录的 YouTube 视频,在 config.toml 中配置:
[workflow]
cookies_file = "/path/to/cookies.txt"可通过浏览器插件(如 Get cookies.txt)导出 YouTube cookies。
[workflow]
llm_translation_enabled = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"downloads/ 目录将自动创建,用于存储下载的视频/字幕/缩略图。
可通过 http://localhost:8096/static/<文件名> 直接访问。
Ctrl+C 或 kill)启动后通过 API 检查更新:
# 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check
# 查看当前版本
curl http://localhost:8096/api/v1/updater/version
auto_update = true时程序会在后台自动下载并重启(实验性功能,建议生产环境手动升级)。
Q: 启动报错 config.toml: no such file or directory
A: 确保 config.toml 与可执行文件在同一目录,或通过 CONFIG_FILE 环境变量指定路径。
Q: 下载视频失败,提示 yt-dlp not found
A: 将 yt-dlp 安装后确保在 PATH 中,或在 config.toml 中填写绝对路径:
[workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"Q: macOS 提示"无法验证开发者"
A: 在终端执行以下命令移除隔离标记:
xattr -d com.apple.quarantine ytb2bili-darwin-arm64Q: 端口 8096 被占用
A: 修改 config.toml 中的 server.port 为其他端口。
Q: AI 功能不可用
A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
| 工具 | 用途 | 是否必须 |
|---|---|---|
| yt-dlp | YouTube 视频下载 | ✅ 必须 |
| ffmpeg | 音视频处理 | ✅ 必须 |
api2key.base_url 或服务端兜底 LLM Key |
AI 功能 | 可选 |
安装 yt-dlp:
# macOS
brew install yt-dlp
# Linux
pip install yt-dlp
# 或下载二进制:https://github.com/yt-dlp/yt-dlp/releases/latest
# Windows
winget install yt-dlp安装 ffmpeg:
# macOS
brew install ffmpeg
# Ubuntu / Debian
sudo apt install ffmpeg
# Windows
winget install ffmpeg前往 GitHub Releases 下载对应平台的二进制文件:
| 平台 | 架构 | 文件名 |
|---|---|---|
| Linux | x86_64 (AMD64) | ytb2bili-linux-amd64 |
| Linux | ARM64 (树莓派 / 服务器) | ytb2bili-linux-arm64 |
| macOS | Intel | ytb2bili-darwin-amd64 |
| macOS | Apple Silicon (M1/M2/M3) | ytb2bili-darwin-arm64 |
| Windows | x86_64 | ytb2bili-windows-amd64.exe |
命令行下载示例(Linux / macOS):
# 以 Linux AMD64 为例,替换版本号和文件名
VERSION=v0.3.8
curl -L -o ytb2bili \
"https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"
# 授予执行权限
chmod +x ytb2bili程序启动时会从当前工作目录读取 config.toml。
# 下载配置模板(用于参考)
curl -L -o config.toml \
"https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"或手动创建 config.toml,以下是最小必要配置:
# ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir = "./downloads"
static_path = "/static"
# ── 数据库(SQLite,开箱即用)─────────────────────────
[database]
type = "sqlite"
path = "ytb2bili.db"
auto_migrate = true
# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path = "/usr/local/bin/yt-dlp" # 若不在 PATH 中,取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url = "http://127.0.0.1:7890" # 代理(可选)
# ── AI Agent(可选兜底,不影响 ytb2bili-api 网关模式)──────────────
[agent]
name = "ytb2bili_agent"
[agent.llm]
# api_key = "sk-..." # 可选:仅本地兜底时填写
model = "gpt-4o-mini"
# base_url = "https://open.ytb2bili.com/ai/v1"
# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled = true
auto_update = false
check_interval = 24说明:Web AI 助手默认走 ytb2bili-api /ai/v1 网关,
agent.llm只作为旧流程或离线环境的兜底配置。[agent.llm] api_key = "sk-..." model = "gpt-4o-mini" base_url = "https://open.ytb2bili.com/ai/v1"
# 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili config.toml
# Linux / macOS
./ytb2bili
# Windows
.\ytb2bili-windows-amd64.exe启动成功后,终端输出类似:
🚀 YTB2BILI 启动中... 版本: v0.3.8, 构建时间: 2026-03-04T...
✅ 应用启动成功,按 Ctrl+C 停止...
访问地址:
| 入口 | 地址 |
|---|---|
| Web 界面 | http://localhost:8096 |
| API 健康检查 | http://localhost:8096/health |
| API 文档(Swagger) | http://localhost:8096/swagger/index.html |
通过环境变量 CONFIG_FILE 指定任意路径的配置文件:
CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili若需要下载需要登录的 YouTube 视频,在 config.toml 中配置:
[workflow]
cookies_file = "/path/to/cookies.txt"可通过浏览器插件(如 Get cookies.txt)导出 YouTube cookies。
[workflow]
llm_translation_enabled = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"downloads/ 目录将自动创建,用于存储下载的视频/字幕/缩略图。
可通过 http://localhost:8096/static/<文件名> 直接访问。
Ctrl+C 或 kill)启动后通过 API 检查更新:
# 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check
# 查看当前版本
curl http://localhost:8096/api/v1/updater/version
auto_update = true时程序会在后台自动下载并重启(实验性功能,建议生产环境手动升级)。
Q: 启动报错 config.toml: no such file or directory
A: 确保 config.toml 与可执行文件在同一目录,或通过 CONFIG_FILE 环境变量指定路径。
Q: 下载视频失败,提示 yt-dlp not found
A: 将 yt-dlp 安装后确保在 PATH 中,或在 config.toml 中填写绝对路径:
[workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"Q: macOS 提示"无法验证开发者"
A: 在终端执行以下命令移除隔离标记:
xattr -d com.apple.quarantine ytb2bili-darwin-arm64Q: 端口 8096 被占用
A: 修改 config.toml 中的 server.port 为其他端口。
Q: AI 功能不可用
A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。
Nothing published for this version
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
| 工具 | 用途 | 是否必须 |
|---|---|---|
| yt-dlp | YouTube 视频下载 | ✅ 必须 |
| ffmpeg | 音视频处理 | ✅ 必须 |
api2key.base_url 或服务端兜底 LLM Key |
AI 功能 | 可选 |
安装 yt-dlp:
# macOS
brew install yt-dlp
# Linux
pip install yt-dlp
# 或下载二进制:https://github.com/yt-dlp/yt-dlp/releases/latest
# Windows
winget install yt-dlp安装 ffmpeg:
# macOS
brew install ffmpeg
# Ubuntu / Debian
sudo apt install ffmpeg
# Windows
winget install ffmpeg前往 GitHub Releases 下载对应平台的二进制文件:
| 平台 | 架构 | 文件名 |
|---|---|---|
| Linux | x86_64 (AMD64) | ytb2bili-linux-amd64 |
| Linux | ARM64 (树莓派 / 服务器) | ytb2bili-linux-arm64 |
| macOS | Intel | ytb2bili-darwin-amd64 |
| macOS | Apple Silicon (M1/M2/M3) | ytb2bili-darwin-arm64 |
| Windows | x86_64 | ytb2bili-windows-amd64.exe |
命令行下载示例(Linux / macOS):
# 以 Linux AMD64 为例,替换版本号和文件名
VERSION=v0.3.7
curl -L -o ytb2bili \
"https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"
# 授予执行权限
chmod +x ytb2bili程序启动时会从当前工作目录读取 config.toml。
# 下载配置模板(用于参考)
curl -L -o config.toml \
"https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"或手动创建 config.toml,以下是最小必要配置:
# ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir = "./downloads"
static_path = "/static"
# ── 数据库(SQLite,开箱即用)─────────────────────────
[database]
type = "sqlite"
path = "ytb2bili.db"
auto_migrate = true
# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path = "/usr/local/bin/yt-dlp" # 若不在 PATH 中,取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url = "http://127.0.0.1:7890" # 代理(可选)
# ── AI Agent(可选兜底,不影响 ytb2bili-api 网关模式)──────────────
[agent]
name = "ytb2bili_agent"
[agent.llm]
# api_key = "sk-..." # 可选:仅本地兜底时填写
model = "gpt-4o-mini"
# base_url = "https://open.ytb2bili.com/ai/v1"
# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled = true
auto_update = false
check_interval = 24说明:Web AI 助手默认走 ytb2bili-api /ai/v1 网关,
agent.llm只作为旧流程或离线环境的兜底配置。[agent.llm] api_key = "sk-..." model = "gpt-4o-mini" base_url = "https://open.ytb2bili.com/ai/v1"
# 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili config.toml
# Linux / macOS
./ytb2bili
# Windows
.\ytb2bili-windows-amd64.exe启动成功后,终端输出类似:
🚀 YTB2BILI 启动中... 版本: v0.3.7, 构建时间: 2026-03-04T...
✅ 应用启动成功,按 Ctrl+C 停止...
访问地址:
| 入口 | 地址 |
|---|---|
| Web 界面 | http://localhost:8096 |
| API 健康检查 | http://localhost:8096/health |
| API 文档(Swagger) | http://localhost:8096/swagger/index.html |
通过环境变量 CONFIG_FILE 指定任意路径的配置文件:
CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili若需要下载需要登录的 YouTube 视频,在 config.toml 中配置:
[workflow]
cookies_file = "/path/to/cookies.txt"可通过浏览器插件(如 Get cookies.txt)导出 YouTube cookies。
[workflow]
llm_translation_enabled = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"downloads/ 目录将自动创建,用于存储下载的视频/字幕/缩略图。
可通过 http://localhost:8096/static/<文件名> 直接访问。
Ctrl+C 或 kill)启动后通过 API 检查更新:
# 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check
# 查看当前版本
curl http://localhost:8096/api/v1/updater/version
auto_update = true时程序会在后台自动下载并重启(实验性功能,建议生产环境手动升级)。
Q: 启动报错 config.toml: no such file or directory
A: 确保 config.toml 与可执行文件在同一目录,或通过 CONFIG_FILE 环境变量指定路径。
Q: 下载视频失败,提示 yt-dlp not found
A: 将 yt-dlp 安装后确保在 PATH 中,或在 config.toml 中填写绝对路径:
[workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"Q: macOS 提示"无法验证开发者"
A: 在终端执行以下命令移除隔离标记:
xattr -d com.apple.quarantine ytb2bili-darwin-arm64Q: 端口 8096 被占用
A: 修改 config.toml 中的 server.port 为其他端口。
Q: AI 功能不可用
A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。
Nothing published for this version
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
| 工具 | 用途 | 是否必须 |
|---|---|---|
| yt-dlp | YouTube 视频下载 | ✅ 必须 |
| ffmpeg | 音视频处理 | ✅ 必须 |
api2key.base_url 或服务端兜底 LLM Key |
AI 功能 | 可选 |
安装 yt-dlp:
# macOS
brew install yt-dlp
# Linux
pip install yt-dlp
# 或下载二进制:https://github.com/yt-dlp/yt-dlp/releases/latest
# Windows
winget install yt-dlp安装 ffmpeg:
# macOS
brew install ffmpeg
# Ubuntu / Debian
sudo apt install ffmpeg
# Windows
winget install ffmpeg前往 GitHub Releases 下载对应平台的二进制文件:
| 平台 | 架构 | 文件名 |
|---|---|---|
| Linux | x86_64 (AMD64) | ytb2bili-linux-amd64 |
| Linux | ARM64 (树莓派 / 服务器) | ytb2bili-linux-arm64 |
| macOS | Intel | ytb2bili-darwin-amd64 |
| macOS | Apple Silicon (M1/M2/M3) | ytb2bili-darwin-arm64 |
| Windows | x86_64 | ytb2bili-windows-amd64.exe |
命令行下载示例(Linux / macOS):
# 以 Linux AMD64 为例,替换版本号和文件名
VERSION=v0.3.5
curl -L -o ytb2bili \
"https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"
# 授予执行权限
chmod +x ytb2bili程序启动时会从当前工作目录读取 config.toml。
# 下载配置模板(用于参考)
curl -L -o config.toml \
"https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"或手动创建 config.toml,以下是最小必要配置:
# ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir = "./downloads"
static_path = "/static"
# ── 数据库(SQLite,开箱即用)─────────────────────────
[database]
type = "sqlite"
path = "ytb2bili.db"
auto_migrate = true
# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path = "/usr/local/bin/yt-dlp" # 若不在 PATH 中,取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url = "http://127.0.0.1:7890" # 代理(可选)
# ── AI Agent(可选兜底,不影响 ytb2bili-api 网关模式)──────────────
[agent]
name = "ytb2bili_agent"
[agent.llm]
# api_key = "sk-..." # 可选:仅本地兜底时填写
model = "gpt-4o-mini"
# base_url = "https://open.api2key.com/ai/v1"
# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled = true
auto_update = false
check_interval = 24说明:Web AI 助手默认走 ytb2bili-api /ai/v1 网关,
agent.llm只作为旧流程或离线环境的兜底配置。[agent.llm] api_key = "sk-..." model = "gpt-4o-mini" base_url = "https://open.api2key.com/ai/v1"
# 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili config.toml
# Linux / macOS
./ytb2bili
# Windows
.\ytb2bili-windows-amd64.exe启动成功后,终端输出类似:
🚀 YTB2BILI 启动中... 版本: v0.3.5, 构建时间: 2026-03-04T...
✅ 应用启动成功,按 Ctrl+C 停止...
访问地址:
| 入口 | 地址 |
|---|---|
| Web 界面 | http://localhost:8096 |
| API 健康检查 | http://localhost:8096/health |
| API 文档(Swagger) | http://localhost:8096/swagger/index.html |
通过环境变量 CONFIG_FILE 指定任意路径的配置文件:
CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili若需要下载需要登录的 YouTube 视频,在 config.toml 中配置:
[workflow]
cookies_file = "/path/to/cookies.txt"可通过浏览器插件(如 Get cookies.txt)导出 YouTube cookies。
[workflow]
llm_translation_enabled = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"downloads/ 目录将自动创建,用于存储下载的视频/字幕/缩略图。
可通过 http://localhost:8096/static/<文件名> 直接访问。
Ctrl+C 或 kill)启动后通过 API 检查更新:
# 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check
# 查看当前版本
curl http://localhost:8096/api/v1/updater/version
auto_update = true时程序会在后台自动下载并重启(实验性功能,建议生产环境手动升级)。
Q: 启动报错 config.toml: no such file or directory
A: 确保 config.toml 与可执行文件在同一目录,或通过 CONFIG_FILE 环境变量指定路径。
Q: 下载视频失败,提示 yt-dlp not found
A: 将 yt-dlp 安装后确保在 PATH 中,或在 config.toml 中填写绝对路径:
[workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"Q: macOS 提示"无法验证开发者"
A: 在终端执行以下命令移除隔离标记:
xattr -d com.apple.quarantine ytb2bili-darwin-arm64Q: 端口 8096 被占用
A: 修改 config.toml 中的 server.port 为其他端口。
Q: AI 功能不可用
A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
| 工具 | 用途 | 是否必须 |
|---|---|---|
| yt-dlp | YouTube 视频下载 | ✅ 必须 |
| ffmpeg | 音视频处理 | ✅ 必须 |
api2key.base_url 或服务端兜底 LLM Key |
AI 功能 | 可选 |
安装 yt-dlp:
# macOS
brew install yt-dlp
# Linux
pip install yt-dlp
# 或下载二进制:https://github.com/yt-dlp/yt-dlp/releases/latest
# Windows
winget install yt-dlp安装 ffmpeg:
# macOS
brew install ffmpeg
# Ubuntu / Debian
sudo apt install ffmpeg
# Windows
winget install ffmpeg前往 GitHub Releases 下载对应平台的二进制文件:
| 平台 | 架构 | 文件名 |
|---|---|---|
| Linux | x86_64 (AMD64) | ytb2bili-linux-amd64 |
| Linux | ARM64 (树莓派 / 服务器) | ytb2bili-linux-arm64 |
| macOS | Intel | ytb2bili-darwin-amd64 |
| macOS | Apple Silicon (M1/M2/M3) | ytb2bili-darwin-arm64 |
| Windows | x86_64 | ytb2bili-windows-amd64.exe |
命令行下载示例(Linux / macOS):
# 以 Linux AMD64 为例,替换版本号和文件名
VERSION=v0.3.4
curl -L -o ytb2bili \
"https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"
# 授予执行权限
chmod +x ytb2bili程序启动时会从当前工作目录读取 config.toml。
# 下载配置模板(用于参考)
curl -L -o config.toml \
"https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"或手动创建 config.toml,以下是最小必要配置:
# ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir = "./downloads"
static_path = "/static"
# ── 数据库(SQLite,开箱即用)─────────────────────────
[database]
type = "sqlite"
path = "ytb2bili.db"
auto_migrate = true
# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path = "/usr/local/bin/yt-dlp" # 若不在 PATH 中,取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url = "http://127.0.0.1:7890" # 代理(可选)
# ── AI Agent(可选兜底,不影响 ytb2bili-api 网关模式)──────────────
[agent]
name = "ytb2bili_agent"
[agent.llm]
# api_key = "sk-..." # 可选:仅本地兜底时填写
model = "gpt-4o-mini"
# base_url = "https://open.api2key.com/ai/v1"
# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled = true
auto_update = false
check_interval = 24说明:Web AI 助手默认走 ytb2bili-api /ai/v1 网关,
agent.llm只作为旧流程或离线环境的兜底配置。[agent.llm] api_key = "sk-..." model = "gpt-4o-mini" base_url = "https://open.api2key.com/ai/v1"
# 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili config.toml
# Linux / macOS
./ytb2bili
# Windows
.\ytb2bili-windows-amd64.exe启动成功后,终端输出类似:
🚀 YTB2BILI 启动中... 版本: v0.3.4, 构建时间: 2026-03-04T...
✅ 应用启动成功,按 Ctrl+C 停止...
访问地址:
| 入口 | 地址 |
|---|---|
| Web 界面 | http://localhost:8096 |
| API 健康检查 | http://localhost:8096/health |
| API 文档(Swagger) | http://localhost:8096/swagger/index.html |
通过环境变量 CONFIG_FILE 指定任意路径的配置文件:
CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili若需要下载需要登录的 YouTube 视频,在 config.toml 中配置:
[workflow]
cookies_file = "/path/to/cookies.txt"可通过浏览器插件(如 Get cookies.txt)导出 YouTube cookies。
[workflow]
llm_translation_enabled = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"downloads/ 目录将自动创建,用于存储下载的视频/字幕/缩略图。
可通过 http://localhost:8096/static/<文件名> 直接访问。
Ctrl+C 或 kill)启动后通过 API 检查更新:
# 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check
# 查看当前版本
curl http://localhost:8096/api/v1/updater/version
auto_update = true时程序会在后台自动下载并重启(实验性功能,建议生产环境手动升级)。
Q: 启动报错 config.toml: no such file or directory
A: 确保 config.toml 与可执行文件在同一目录,或通过 CONFIG_FILE 环境变量指定路径。
Q: 下载视频失败,提示 yt-dlp not found
A: 将 yt-dlp 安装后确保在 PATH 中,或在 config.toml 中填写绝对路径:
[workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"Q: macOS 提示"无法验证开发者"
A: 在终端执行以下命令移除隔离标记:
xattr -d com.apple.quarantine ytb2bili-darwin-arm64Q: 端口 8096 被占用
A: 修改 config.toml 中的 server.port 为其他端口。
Q: AI 功能不可用
A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
| 工具 | 用途 | 是否必须 |
|---|---|---|
| yt-dlp | YouTube 视频下载 | ✅ 必须 |
| ffmpeg | 音视频处理 | ✅ 必须 |
api2key.base_url 或服务端兜底 LLM Key |
AI 功能 | 可选 |
安装 yt-dlp:
# macOS
brew install yt-dlp
# Linux
pip install yt-dlp
# 或下载二进制:https://github.com/yt-dlp/yt-dlp/releases/latest
# Windows
winget install yt-dlp安装 ffmpeg:
# macOS
brew install ffmpeg
# Ubuntu / Debian
sudo apt install ffmpeg
# Windows
winget install ffmpeg前往 GitHub Releases 下载对应平台的二进制文件:
| 平台 | 架构 | 文件名 |
|---|---|---|
| Linux | x86_64 (AMD64) | ytb2bili-linux-amd64 |
| Linux | ARM64 (树莓派 / 服务器) | ytb2bili-linux-arm64 |
| macOS | Intel | ytb2bili-darwin-amd64 |
| macOS | Apple Silicon (M1/M2/M3) | ytb2bili-darwin-arm64 |
| Windows | x86_64 | ytb2bili-windows-amd64.exe |
命令行下载示例(Linux / macOS):
# 以 Linux AMD64 为例,替换版本号和文件名
VERSION=v0.3.3
curl -L -o ytb2bili \
"https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"
# 授予执行权限
chmod +x ytb2bili程序启动时会从当前工作目录读取 config.toml。
# 下载配置模板(用于参考)
curl -L -o config.toml \
"https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"或手动创建 config.toml,以下是最小必要配置:
# ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir = "./downloads"
static_path = "/static"
# ── 数据库(SQLite,开箱即用)─────────────────────────
[database]
type = "sqlite"
path = "ytb2bili.db"
auto_migrate = true
# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path = "/usr/local/bin/yt-dlp" # 若不在 PATH 中,取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url = "http://127.0.0.1:7890" # 代理(可选)
# ── AI Agent(可选兜底,不影响 ytb2bili-api 网关模式)──────────────
[agent]
name = "ytb2bili_agent"
[agent.llm]
# api_key = "sk-..." # 可选:仅本地兜底时填写
model = "gpt-4o-mini"
# base_url = "https://open.api2key.com/ai/v1"
# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled = true
auto_update = false
check_interval = 24说明:Web AI 助手默认走 ytb2bili-api /ai/v1 网关,
agent.llm只作为旧流程或离线环境的兜底配置。[agent.llm] api_key = "sk-..." model = "gpt-4o-mini" base_url = "https://open.api2key.com/ai/v1"
# 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili config.toml
# Linux / macOS
./ytb2bili
# Windows
.\ytb2bili-windows-amd64.exe启动成功后,终端输出类似:
🚀 YTB2BILI 启动中... 版本: v0.3.3, 构建时间: 2026-03-04T...
✅ 应用启动成功,按 Ctrl+C 停止...
访问地址:
| 入口 | 地址 |
|---|---|
| Web 界面 | http://localhost:8096 |
| API 健康检查 | http://localhost:8096/health |
| API 文档(Swagger) | http://localhost:8096/swagger/index.html |
通过环境变量 CONFIG_FILE 指定任意路径的配置文件:
CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili若需要下载需要登录的 YouTube 视频,在 config.toml 中配置:
[workflow]
cookies_file = "/path/to/cookies.txt"可通过浏览器插件(如 Get cookies.txt)导出 YouTube cookies。
[workflow]
llm_translation_enabled = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"downloads/ 目录将自动创建,用于存储下载的视频/字幕/缩略图。
可通过 http://localhost:8096/static/<文件名> 直接访问。
Ctrl+C 或 kill)启动后通过 API 检查更新:
# 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check
# 查看当前版本
curl http://localhost:8096/api/v1/updater/version
auto_update = true时程序会在后台自动下载并重启(实验性功能,建议生产环境手动升级)。
Q: 启动报错 config.toml: no such file or directory
A: 确保 config.toml 与可执行文件在同一目录,或通过 CONFIG_FILE 环境变量指定路径。
Q: 下载视频失败,提示 yt-dlp not found
A: 将 yt-dlp 安装后确保在 PATH 中,或在 config.toml 中填写绝对路径:
[workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"Q: macOS 提示"无法验证开发者"
A: 在终端执行以下命令移除隔离标记:
xattr -d com.apple.quarantine ytb2bili-darwin-arm64Q: 端口 8096 被占用
A: 修改 config.toml 中的 server.port 为其他端口。
Q: AI 功能不可用
A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。
> 通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
| 工具 | 用途 | 是否必须 |
|---|---|---|
| yt-dlp | YouTube 视频下载 | ✅ 必须 |
| ffmpeg | 音视频处理 | ✅ 必须 |
api2key.base_url 或服务端兜底 LLM Key |
AI 功能 | 可选 |
安装 yt-dlp:
# macOS
brew install yt-dlp
# Linux
pip install yt-dlp
# 或下载二进制:https://github.com/yt-dlp/yt-dlp/releases/latest
# Windows
winget install yt-dlp
安装 ffmpeg:
# macOS
brew install ffmpeg
# Ubuntu / Debian
sudo apt install ffmpeg
# Windows
winget install ffmpeg
前往 GitHub Releases 下载对应平台的二进制文件:
| 平台 | 架构 | 文件名 |
|---|---|---|
| Linux | x86_64 (AMD64) | ytb2bili-linux-amd64 |
| Linux | ARM64 (树莓派 / 服务器) | ytb2bili-linux-arm64 |
| macOS | Intel | ytb2bili-darwin-amd64 |
| macOS | Apple Silicon (M1/M2/M3) | ytb2bili-darwin-arm64 |
| Windows | x86_64 | ytb2bili-windows-amd64.exe |
命令行下载示例(Linux / macOS):
# 以 Linux AMD64 为例,替换版本号和文件名
VERSION=v0.3.1
curl -L -o ytb2bili \
"https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"
# 授予执行权限
chmod +x ytb2bili
程序启动时会从当前工作目录读取 config.toml。
# 下载配置模板(用于参考)
curl -L -o config.toml \
"https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"
或手动创建 config.toml,以下是最小必要配置:
# ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir = "./downloads"
static_path = "/static"
# ── 数据库(SQLite,开箱即用)─────────────────────────
[database]
type = "sqlite"
path = "ytb2bili.db"
auto_migrate = true
# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path = "/usr/local/bin/yt-dlp" # 若不在 PATH 中,取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url = "http://127.0.0.1:7890" # 代理(可选)
# ── AI Agent(可选兜底,不影响 ytb2bili-api 网关模式)──────────────
[agent]
name = "ytb2bili_agent"
[agent.llm]
# api_key = "sk-..." # 可选:仅本地兜底时填写
model = "gpt-4o-mini"
# base_url = "https://open.api2key.com/ai/v1"
# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled = true
auto_update = false
check_interval = 24
说明:Web AI 助手默认走 ytb2bili-api /ai/v1 网关,
agent.llm只作为旧流程或离线环境的兜底配置。[agent.llm] api_key = "sk-..." model = "gpt-4o-mini" base_url = "https://open.api2key.com/ai/v1"
# 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili config.toml
# Linux / macOS
./ytb2bili
# Windows
.\ytb2bili-windows-amd64.exe
启动成功后,终端输出类似:
🚀 YTB2BILI 启动中... 版本: v0.3.1, 构建时间: 2026-03-04T...
✅ 应用启动成功,按 Ctrl+C 停止...
访问地址:
| 入口 | 地址 |
|---|---|
| Web 界面 | http://localhost:8096 |
| API 健康检查 | http://localhost:8096/health |
| API 文档(Swagger) | http://localhost:8096/swagger/index.html |
通过环境变量 CONFIG_FILE 指定任意路径的配置文件:
CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili
若需要下载需要登录的 YouTube 视频,在 config.toml 中配置:
[workflow]
cookies_file = "/path/to/cookies.txt"
可通过浏览器插件(如 Get cookies.txt)导出 YouTube cookies。
[workflow]
llm_translation_enabled = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"
downloads/ 目录将自动创建,用于存储下载的视频/字幕/缩略图。
可通过 http://localhost:8096/static/<文件名> 直接访问。
Ctrl+C 或 kill)启动后通过 API 检查更新:
# 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check
# 查看当前版本
curl http://localhost:8096/api/v1/updater/version
auto_update = true时程序会在后台自动下载并重启(实验性功能,建议生产环境手动升级)。
Q: 启动报错 config.toml: no such file or directory
A: 确保 config.toml 与可执行文件在同一目录,或通过 CONFIG_FILE 环境变量指定路径。
Q: 下载视频失败,提示 yt-dlp not found
A: 将 yt-dlp 安装后确保在 PATH 中,或在 config.toml 中填写绝对路径:
[workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"
Q: macOS 提示"无法验证开发者"
A: 在终端执行以下命令移除隔离标记:
xattr -d com.apple.quarantine ytb2bili-darwin-arm64
Q: 端口 8096 被占用
A: 修改 config.toml 中的 server.port 为其他端口。
Q: AI 功能不可用
A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。
> 通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
| 工具 | 用途 | 是否必须 |
|---|---|---|
| yt-dlp | YouTube 视频下载 | ✅ 必须 |
| ffmpeg | 音视频处理 | ✅ 必须 |
api2key.base_url 或服务端兜底 LLM Key |
AI 功能 | 可选 |
安装 yt-dlp:
# macOS
brew install yt-dlp
# Linux
pip install yt-dlp
# 或下载二进制:https://github.com/yt-dlp/yt-dlp/releases/latest
# Windows
winget install yt-dlp
安装 ffmpeg:
# macOS
brew install ffmpeg
# Ubuntu / Debian
sudo apt install ffmpeg
# Windows
winget install ffmpeg
前往 GitHub Releases 下载对应平台的二进制文件:
| 平台 | 架构 | 文件名 |
|---|---|---|
| Linux | x86_64 (AMD64) | ytb2bili-linux-amd64 |
| Linux | ARM64 (树莓派 / 服务器) | ytb2bili-linux-arm64 |
| macOS | Intel | ytb2bili-darwin-amd64 |
| macOS | Apple Silicon (M1/M2/M3) | ytb2bili-darwin-arm64 |
| Windows | x86_64 | ytb2bili-windows-amd64.exe |
命令行下载示例(Linux / macOS):
# 以 Linux AMD64 为例,替换版本号和文件名
VERSION=v0.3.0
curl -L -o ytb2bili \
"https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"
# 授予执行权限
chmod +x ytb2bili
程序启动时会从当前工作目录读取 config.toml。
# 下载配置模板(用于参考)
curl -L -o config.toml \
"https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"
或手动创建 config.toml,以下是最小必要配置:
# ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir = "./downloads"
static_path = "/static"
# ── 数据库(SQLite,开箱即用)─────────────────────────
[database]
type = "sqlite"
path = "ytb2bili.db"
auto_migrate = true
# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path = "/usr/local/bin/yt-dlp" # 若不在 PATH 中,取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url = "http://127.0.0.1:7890" # 代理(可选)
# ── AI Agent(可选兜底,不影响 ytb2bili-api 网关模式)──────────────
[agent]
name = "ytb2bili_agent"
[agent.llm]
# api_key = "sk-..." # 可选:仅本地兜底时填写
model = "gpt-4o-mini"
# base_url = "https://open.api2key.com/ai/v1"
# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled = true
auto_update = false
check_interval = 24
说明:Web AI 助手默认走 ytb2bili-api /ai/v1 网关,
agent.llm只作为旧流程或离线环境的兜底配置。[agent.llm] api_key = "sk-..." model = "gpt-4o-mini" base_url = "https://open.api2key.com/ai/v1"
# 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili config.toml
# Linux / macOS
./ytb2bili
# Windows
.\ytb2bili-windows-amd64.exe
启动成功后,终端输出类似:
🚀 YTB2BILI 启动中... 版本: v0.3.0, 构建时间: 2026-03-04T...
✅ 应用启动成功,按 Ctrl+C 停止...
访问地址:
| 入口 | 地址 |
|---|---|
| Web 界面 | http://localhost:8096 |
| API 健康检查 | http://localhost:8096/health |
| API 文档(Swagger) | http://localhost:8096/swagger/index.html |
通过环境变量 CONFIG_FILE 指定任意路径的配置文件:
CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili
若需要下载需要登录的 YouTube 视频,在 config.toml 中配置:
[workflow]
cookies_file = "/path/to/cookies.txt"
可通过浏览器插件(如 Get cookies.txt)导出 YouTube cookies。
[workflow]
llm_translation_enabled = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"
downloads/ 目录将自动创建,用于存储下载的视频/字幕/缩略图。
可通过 http://localhost:8096/static/<文件名> 直接访问。
Ctrl+C 或 kill)启动后通过 API 检查更新:
# 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check
# 查看当前版本
curl http://localhost:8096/api/v1/updater/version
auto_update = true时程序会在后台自动下载并重启(实验性功能,建议生产环境手动升级)。
Q: 启动报错 config.toml: no such file or directory
A: 确保 config.toml 与可执行文件在同一目录,或通过 CONFIG_FILE 环境变量指定路径。
Q: 下载视频失败,提示 yt-dlp not found
A: 将 yt-dlp 安装后确保在 PATH 中,或在 config.toml 中填写绝对路径:
[workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"
Q: macOS 提示"无法验证开发者"
A: 在终端执行以下命令移除隔离标记:
xattr -d com.apple.quarantine ytb2bili-darwin-arm64
Q: 端口 8096 被占用
A: 修改 config.toml 中的 server.port 为其他端口。
Q: AI 功能不可用
A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。
> 通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
| 工具 | 用途 | 是否必须 |
|---|---|---|
| yt-dlp | YouTube 视频下载 | ✅ 必须 |
| ffmpeg | 音视频处理 | ✅ 必须 |
api2key.base_url 或服务端兜底 LLM Key |
AI 功能 | 可选 |
安装 yt-dlp:
# macOS
brew install yt-dlp
# Linux
pip install yt-dlp
# 或下载二进制:https://github.com/yt-dlp/yt-dlp/releases/latest
# Windows
winget install yt-dlp
安装 ffmpeg:
# macOS
brew install ffmpeg
# Ubuntu / Debian
sudo apt install ffmpeg
# Windows
winget install ffmpeg
前往 GitHub Releases 下载对应平台的二进制文件:
| 平台 | 架构 | 文件名 |
|---|---|---|
| Linux | x86_64 (AMD64) | ytb2bili-linux-amd64 |
| Linux | ARM64 (树莓派 / 服务器) | ytb2bili-linux-arm64 |
| macOS | Intel | ytb2bili-darwin-amd64 |
| macOS | Apple Silicon (M1/M2/M3) | ytb2bili-darwin-arm64 |
| Windows | x86_64 | ytb2bili-windows-amd64.exe |
命令行下载示例(Linux / macOS):
# 以 Linux AMD64 为例,替换版本号和文件名
VERSION=v0.2.7
curl -L -o ytb2bili \
"https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"
# 授予执行权限
chmod +x ytb2bili
程序启动时会从当前工作目录读取 config.toml。
# 下载配置模板(用于参考)
curl -L -o config.toml \
"https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"
或手动创建 config.toml,以下是最小必要配置:
# ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir = "./downloads"
static_path = "/static"
# ── 数据库(SQLite,开箱即用)─────────────────────────
[database]
type = "sqlite"
path = "ytb2bili.db"
auto_migrate = true
# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path = "/usr/local/bin/yt-dlp" # 若不在 PATH 中,取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url = "http://127.0.0.1:7890" # 代理(可选)
# ── AI Agent(可选兜底,不影响 ytb2bili-api 网关模式)──────────────
[agent]
name = "ytb2bili_agent"
[agent.llm]
# api_key = "sk-..." # 可选:仅本地兜底时填写
model = "gpt-4o-mini"
# base_url = "https://open.api2key.com/ai/v1"
# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled = true
auto_update = false
check_interval = 24
说明:Web AI 助手默认走 ytb2bili-api /ai/v1 网关,
agent.llm只作为旧流程或离线环境的兜底配置。[agent.llm] api_key = "sk-..." model = "gpt-4o-mini" base_url = "https://open.api2key.com/ai/v1"
# 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili config.toml
# Linux / macOS
./ytb2bili
# Windows
.\ytb2bili-windows-amd64.exe
启动成功后,终端输出类似:
🚀 YTB2BILI 启动中... 版本: v0.2.7, 构建时间: 2026-03-04T...
✅ 应用启动成功,按 Ctrl+C 停止...
访问地址:
| 入口 | 地址 |
|---|---|
| Web 界面 | http://localhost:8096 |
| API 健康检查 | http://localhost:8096/health |
| API 文档(Swagger) | http://localhost:8096/swagger/index.html |
通过环境变量 CONFIG_FILE 指定任意路径的配置文件:
CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili
若需要下载需要登录的 YouTube 视频,在 config.toml 中配置:
[workflow]
cookies_file = "/path/to/cookies.txt"
可通过浏览器插件(如 Get cookies.txt)导出 YouTube cookies。
[workflow]
llm_translation_enabled = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"
downloads/ 目录将自动创建,用于存储下载的视频/字幕/缩略图。
可通过 http://localhost:8096/static/<文件名> 直接访问。
Ctrl+C 或 kill)启动后通过 API 检查更新:
# 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check
# 查看当前版本
curl http://localhost:8096/api/v1/updater/version
auto_update = true时程序会在后台自动下载并重启(实验性功能,建议生产环境手动升级)。
Q: 启动报错 config.toml: no such file or directory
A: 确保 config.toml 与可执行文件在同一目录,或通过 CONFIG_FILE 环境变量指定路径。
Q: 下载视频失败,提示 yt-dlp not found
A: 将 yt-dlp 安装后确保在 PATH 中,或在 config.toml 中填写绝对路径:
[workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"
Q: macOS 提示"无法验证开发者"
A: 在终端执行以下命令移除隔离标记:
xattr -d com.apple.quarantine ytb2bili-darwin-arm64
Q: 端口 8096 被占用
A: 修改 config.toml 中的 server.port 为其他端口。
Q: AI 功能不可用
A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。
> 通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
| 工具 | 用途 | 是否必须 |
|---|---|---|
| yt-dlp | YouTube 视频下载 | ✅ 必须 |
| ffmpeg | 音视频处理 | ✅ 必须 |
api2key.base_url 或服务端兜底 LLM Key |
AI 功能 | 可选 |
安装 yt-dlp:
# macOS
brew install yt-dlp
# Linux
pip install yt-dlp
# 或下载二进制:https://github.com/yt-dlp/yt-dlp/releases/latest
# Windows
winget install yt-dlp
安装 ffmpeg:
# macOS
brew install ffmpeg
# Ubuntu / Debian
sudo apt install ffmpeg
# Windows
winget install ffmpeg
前往 GitHub Releases 下载对应平台的二进制文件:
| 平台 | 架构 | 文件名 |
|---|---|---|
| Linux | x86_64 (AMD64) | ytb2bili-linux-amd64 |
| Linux | ARM64 (树莓派 / 服务器) | ytb2bili-linux-arm64 |
| macOS | Intel | ytb2bili-darwin-amd64 |
| macOS | Apple Silicon (M1/M2/M3) | ytb2bili-darwin-arm64 |
| Windows | x86_64 | ytb2bili-windows-amd64.exe |
命令行下载示例(Linux / macOS):
# 以 Linux AMD64 为例,替换版本号和文件名
VERSION=v0.2.5
curl -L -o ytb2bili \
"https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"
# 授予执行权限
chmod +x ytb2bili
程序启动时会从当前工作目录读取 config.toml。
# 下载配置模板(用于参考)
curl -L -o config.toml \
"https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"
或手动创建 config.toml,以下是最小必要配置:
# ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir = "./downloads"
static_path = "/static"
# ── 数据库(SQLite,开箱即用)─────────────────────────
[database]
type = "sqlite"
path = "ytb2bili.db"
auto_migrate = true
# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path = "/usr/local/bin/yt-dlp" # 若不在 PATH 中,取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url = "http://127.0.0.1:7890" # 代理(可选)
# ── AI Agent(可选兜底,不影响 ytb2bili-api 网关模式)──────────────
[agent]
name = "ytb2bili_agent"
[agent.llm]
# api_key = "sk-..." # 可选:仅本地兜底时填写
model = "gpt-4o-mini"
# base_url = "https://open.api2key.com/ai/v1"
# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled = true
auto_update = false
check_interval = 24
说明:Web AI 助手默认走 ytb2bili-api /ai/v1 网关,
agent.llm只作为旧流程或离线环境的兜底配置。[agent.llm] api_key = "sk-..." model = "gpt-4o-mini" base_url = "https://open.api2key.com/ai/v1"
# 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili config.toml
# Linux / macOS
./ytb2bili
# Windows
.\ytb2bili-windows-amd64.exe
启动成功后,终端输出类似:
🚀 YTB2BILI 启动中... 版本: v0.2.5, 构建时间: 2026-03-04T...
✅ 应用启动成功,按 Ctrl+C 停止...
访问地址:
| 入口 | 地址 |
|---|---|
| Web 界面 | http://localhost:8096 |
| API 健康检查 | http://localhost:8096/health |
| API 文档(Swagger) | http://localhost:8096/swagger/index.html |
通过环境变量 CONFIG_FILE 指定任意路径的配置文件:
CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili
若需要下载需要登录的 YouTube 视频,在 config.toml 中配置:
[workflow]
cookies_file = "/path/to/cookies.txt"
可通过浏览器插件(如 Get cookies.txt)导出 YouTube cookies。
[workflow]
llm_translation_enabled = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"
downloads/ 目录将自动创建,用于存储下载的视频/字幕/缩略图。
可通过 http://localhost:8096/static/<文件名> 直接访问。
Ctrl+C 或 kill)启动后通过 API 检查更新:
# 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check
# 查看当前版本
curl http://localhost:8096/api/v1/updater/version
auto_update = true时程序会在后台自动下载并重启(实验性功能,建议生产环境手动升级)。
Q: 启动报错 config.toml: no such file or directory
A: 确保 config.toml 与可执行文件在同一目录,或通过 CONFIG_FILE 环境变量指定路径。
Q: 下载视频失败,提示 yt-dlp not found
A: 将 yt-dlp 安装后确保在 PATH 中,或在 config.toml 中填写绝对路径:
[workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"
Q: macOS 提示"无法验证开发者"
A: 在终端执行以下命令移除隔离标记:
xattr -d com.apple.quarantine ytb2bili-darwin-arm64
Q: 端口 8096 被占用
A: 修改 config.toml 中的 server.port 为其他端口。
Q: AI 功能不可用
A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。
> 通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
| 工具 | 用途 | 是否必须 |
|---|---|---|
| yt-dlp | YouTube 视频下载 | ✅ 必须 |
| ffmpeg | 音视频处理 | ✅ 必须 |
api2key.base_url 或服务端兜底 LLM Key |
AI 功能 | 可选 |
安装 yt-dlp:
# macOS
brew install yt-dlp
# Linux
pip install yt-dlp
# 或下载二进制:https://github.com/yt-dlp/yt-dlp/releases/latest
# Windows
winget install yt-dlp
安装 ffmpeg:
# macOS
brew install ffmpeg
# Ubuntu / Debian
sudo apt install ffmpeg
# Windows
winget install ffmpeg
前往 GitHub Releases 下载对应平台的二进制文件:
| 平台 | 架构 | 文件名 |
|---|---|---|
| Linux | x86_64 (AMD64) | ytb2bili-linux-amd64 |
| Linux | ARM64 (树莓派 / 服务器) | ytb2bili-linux-arm64 |
| macOS | Intel | ytb2bili-darwin-amd64 |
| macOS | Apple Silicon (M1/M2/M3) | ytb2bili-darwin-arm64 |
| Windows | x86_64 | ytb2bili-windows-amd64.exe |
命令行下载示例(Linux / macOS):
# 以 Linux AMD64 为例,替换版本号和文件名
VERSION=v0.2.4
curl -L -o ytb2bili \
"https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"
# 授予执行权限
chmod +x ytb2bili
程序启动时会从当前工作目录读取 config.toml。
# 下载配置模板(用于参考)
curl -L -o config.toml \
"https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"
或手动创建 config.toml,以下是最小必要配置:
# ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir = "./downloads"
static_path = "/static"
# ── 数据库(SQLite,开箱即用)─────────────────────────
[database]
type = "sqlite"
path = "ytb2bili.db"
auto_migrate = true
# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path = "/usr/local/bin/yt-dlp" # 若不在 PATH 中,取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url = "http://127.0.0.1:7890" # 代理(可选)
# ── AI Agent(可选兜底,不影响 ytb2bili-api 网关模式)──────────────
[agent]
name = "ytb2bili_agent"
[agent.llm]
# api_key = "sk-..." # 可选:仅本地兜底时填写
model = "gpt-4o-mini"
# base_url = "https://open.api2key.com/ai/v1"
# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled = true
auto_update = false
check_interval = 24
说明:Web AI 助手默认走 ytb2bili-api /ai/v1 网关,
agent.llm只作为旧流程或离线环境的兜底配置。[agent.llm] api_key = "sk-..." model = "gpt-4o-mini" base_url = "https://open.api2key.com/ai/v1"
# 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili config.toml
# Linux / macOS
./ytb2bili
# Windows
.\ytb2bili-windows-amd64.exe
启动成功后,终端输出类似:
🚀 YTB2BILI 启动中... 版本: v0.2.4, 构建时间: 2026-03-04T...
✅ 应用启动成功,按 Ctrl+C 停止...
访问地址:
| 入口 | 地址 |
|---|---|
| Web 界面 | http://localhost:8096 |
| API 健康检查 | http://localhost:8096/health |
| API 文档(Swagger) | http://localhost:8096/swagger/index.html |
通过环境变量 CONFIG_FILE 指定任意路径的配置文件:
CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili
若需要下载需要登录的 YouTube 视频,在 config.toml 中配置:
[workflow]
cookies_file = "/path/to/cookies.txt"
可通过浏览器插件(如 Get cookies.txt)导出 YouTube cookies。
[workflow]
llm_translation_enabled = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"
downloads/ 目录将自动创建,用于存储下载的视频/字幕/缩略图。
可通过 http://localhost:8096/static/<文件名> 直接访问。
Ctrl+C 或 kill)启动后通过 API 检查更新:
# 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check
# 查看当前版本
curl http://localhost:8096/api/v1/updater/version
auto_update = true时程序会在后台自动下载并重启(实验性功能,建议生产环境手动升级)。
Q: 启动报错 config.toml: no such file or directory
A: 确保 config.toml 与可执行文件在同一目录,或通过 CONFIG_FILE 环境变量指定路径。
Q: 下载视频失败,提示 yt-dlp not found
A: 将 yt-dlp 安装后确保在 PATH 中,或在 config.toml 中填写绝对路径:
[workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"
Q: macOS 提示"无法验证开发者"
A: 在终端执行以下命令移除隔离标记:
xattr -d com.apple.quarantine ytb2bili-darwin-arm64
Q: 端口 8096 被占用
A: 修改 config.toml 中的 server.port 为其他端口。
Q: AI 功能不可用
A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。
> 通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
| 工具 | 用途 | 是否必须 |
|---|---|---|
| yt-dlp | YouTube 视频下载 | ✅ 必须 |
| ffmpeg | 音视频处理 | ✅ 必须 |
api2key.base_url 或服务端兜底 LLM Key |
AI 功能 | 可选 |
安装 yt-dlp:
# macOS
brew install yt-dlp
# Linux
pip install yt-dlp
# 或下载二进制:https://github.com/yt-dlp/yt-dlp/releases/latest
# Windows
winget install yt-dlp
安装 ffmpeg:
# macOS
brew install ffmpeg
# Ubuntu / Debian
sudo apt install ffmpeg
# Windows
winget install ffmpeg
前往 GitHub Releases 下载对应平台的二进制文件:
| 平台 | 架构 | 文件名 |
|---|---|---|
| Linux | x86_64 (AMD64) | ytb2bili-linux-amd64 |
| Linux | ARM64 (树莓派 / 服务器) | ytb2bili-linux-arm64 |
| macOS | Intel | ytb2bili-darwin-amd64 |
| macOS | Apple Silicon (M1/M2/M3) | ytb2bili-darwin-arm64 |
| Windows | x86_64 | ytb2bili-windows-amd64.exe |
命令行下载示例(Linux / macOS):
# 以 Linux AMD64 为例,替换版本号和文件名
VERSION=v0.2.3
curl -L -o ytb2bili \
"https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"
# 授予执行权限
chmod +x ytb2bili
程序启动时会从当前工作目录读取 config.toml。
# 下载配置模板(用于参考)
curl -L -o config.toml \
"https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"
或手动创建 config.toml,以下是最小必要配置:
# ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir = "./downloads"
static_path = "/static"
# ── 数据库(SQLite,开箱即用)─────────────────────────
[database]
type = "sqlite"
path = "ytb2bili.db"
auto_migrate = true
# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path = "/usr/local/bin/yt-dlp" # 若不在 PATH 中,取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url = "http://127.0.0.1:7890" # 代理(可选)
# ── AI Agent(可选兜底,不影响 ytb2bili-api 网关模式)──────────────
[agent]
name = "ytb2bili_agent"
[agent.llm]
# api_key = "sk-..." # 可选:仅本地兜底时填写
model = "gpt-4o-mini"
# base_url = "https://open.api2key.com/ai/v1"
# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled = true
auto_update = false
check_interval = 24
说明:Web AI 助手默认走 ytb2bili-api /ai/v1 网关,
agent.llm只作为旧流程或离线环境的兜底配置。[agent.llm] api_key = "sk-..." model = "gpt-4o-mini" base_url = "https://open.api2key.com/ai/v1"
# 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili config.toml
# Linux / macOS
./ytb2bili
# Windows
.\ytb2bili-windows-amd64.exe
启动成功后,终端输出类似:
🚀 YTB2BILI 启动中... 版本: v0.2.3, 构建时间: 2026-03-04T...
✅ 应用启动成功,按 Ctrl+C 停止...
访问地址:
| 入口 | 地址 |
|---|---|
| Web 界面 | http://localhost:8096 |
| API 健康检查 | http://localhost:8096/health |
| API 文档(Swagger) | http://localhost:8096/swagger/index.html |
通过环境变量 CONFIG_FILE 指定任意路径的配置文件:
CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili
若需要下载需要登录的 YouTube 视频,在 config.toml 中配置:
[workflow]
cookies_file = "/path/to/cookies.txt"
可通过浏览器插件(如 Get cookies.txt)导出 YouTube cookies。
[workflow]
llm_translation_enabled = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"
downloads/ 目录将自动创建,用于存储下载的视频/字幕/缩略图。
可通过 http://localhost:8096/static/<文件名> 直接访问。
Ctrl+C 或 kill)启动后通过 API 检查更新:
# 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check
# 查看当前版本
curl http://localhost:8096/api/v1/updater/version
auto_update = true时程序会在后台自动下载并重启(实验性功能,建议生产环境手动升级)。
Q: 启动报错 config.toml: no such file or directory
A: 确保 config.toml 与可执行文件在同一目录,或通过 CONFIG_FILE 环境变量指定路径。
Q: 下载视频失败,提示 yt-dlp not found
A: 将 yt-dlp 安装后确保在 PATH 中,或在 config.toml 中填写绝对路径:
[workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"
Q: macOS 提示"无法验证开发者"
A: 在终端执行以下命令移除隔离标记:
xattr -d com.apple.quarantine ytb2bili-darwin-arm64
Q: 端口 8096 被占用
A: 修改 config.toml 中的 server.port 为其他端口。
Q: AI 功能不可用
A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。
> 通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
| 工具 | 用途 | 是否必须 |
|---|---|---|
| yt-dlp | YouTube 视频下载 | ✅ 必须 |
| ffmpeg | 音视频处理 | ✅ 必须 |
api2key.base_url 或服务端兜底 LLM Key |
AI 功能 | 可选 |
安装 yt-dlp:
# macOS
brew install yt-dlp
# Linux
pip install yt-dlp
# 或下载二进制:https://github.com/yt-dlp/yt-dlp/releases/latest
# Windows
winget install yt-dlp
安装 ffmpeg:
# macOS
brew install ffmpeg
# Ubuntu / Debian
sudo apt install ffmpeg
# Windows
winget install ffmpeg
前往 GitHub Releases 下载对应平台的二进制文件:
| 平台 | 架构 | 文件名 |
|---|---|---|
| Linux | x86_64 (AMD64) | ytb2bili-linux-amd64 |
| Linux | ARM64 (树莓派 / 服务器) | ytb2bili-linux-arm64 |
| macOS | Intel | ytb2bili-darwin-amd64 |
| macOS | Apple Silicon (M1/M2/M3) | ytb2bili-darwin-arm64 |
| Windows | x86_64 | ytb2bili-windows-amd64.exe |
命令行下载示例(Linux / macOS):
# 以 Linux AMD64 为例,替换版本号和文件名
VERSION=v0.2.1
curl -L -o ytb2bili \
"https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"
# 授予执行权限
chmod +x ytb2bili
程序启动时会从当前工作目录读取 config.toml。
# 下载配置模板(用于参考)
curl -L -o config.toml \
"https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"
或手动创建 config.toml,以下是最小必要配置:
# ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir = "./downloads"
static_path = "/static"
# ── 数据库(SQLite,开箱即用)─────────────────────────
[database]
type = "sqlite"
path = "ytb2bili.db"
auto_migrate = true
# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path = "/usr/local/bin/yt-dlp" # 若不在 PATH 中,取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url = "http://127.0.0.1:7890" # 代理(可选)
# ── AI Agent(可选兜底,不影响 ytb2bili-api 网关模式)──────────────
[agent]
name = "ytb2bili_agent"
[agent.llm]
# api_key = "sk-..." # 可选:仅本地兜底时填写
model = "gpt-4o-mini"
# base_url = "https://open.api2key.com/ai/v1"
# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled = true
auto_update = false
check_interval = 24
说明:Web AI 助手默认走 ytb2bili-api /ai/v1 网关,
agent.llm只作为旧流程或离线环境的兜底配置。[agent.llm] api_key = "sk-..." model = "gpt-4o-mini" base_url = "https://open.api2key.com/ai/v1"
# 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili config.toml
# Linux / macOS
./ytb2bili
# Windows
.\ytb2bili-windows-amd64.exe
启动成功后,终端输出类似:
🚀 YTB2BILI 启动中... 版本: v0.2.1, 构建时间: 2026-03-04T...
✅ 应用启动成功,按 Ctrl+C 停止...
访问地址:
| 入口 | 地址 |
|---|---|
| Web 界面 | http://localhost:8096 |
| API 健康检查 | http://localhost:8096/health |
| API 文档(Swagger) | http://localhost:8096/swagger/index.html |
通过环境变量 CONFIG_FILE 指定任意路径的配置文件:
CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili
若需要下载需要登录的 YouTube 视频,在 config.toml 中配置:
[workflow]
cookies_file = "/path/to/cookies.txt"
可通过浏览器插件(如 Get cookies.txt)导出 YouTube cookies。
[workflow]
llm_translation_enabled = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"
downloads/ 目录将自动创建,用于存储下载的视频/字幕/缩略图。
可通过 http://localhost:8096/static/<文件名> 直接访问。
Ctrl+C 或 kill)启动后通过 API 检查更新:
# 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check
# 查看当前版本
curl http://localhost:8096/api/v1/updater/version
auto_update = true时程序会在后台自动下载并重启(实验性功能,建议生产环境手动升级)。
Q: 启动报错 config.toml: no such file or directory
A: 确保 config.toml 与可执行文件在同一目录,或通过 CONFIG_FILE 环境变量指定路径。
Q: 下载视频失败,提示 yt-dlp not found
A: 将 yt-dlp 安装后确保在 PATH 中,或在 config.toml 中填写绝对路径:
[workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"
Q: macOS 提示"无法验证开发者"
A: 在终端执行以下命令移除隔离标记:
xattr -d com.apple.quarantine ytb2bili-darwin-arm64
Q: 端口 8096 被占用
A: 修改 config.toml 中的 server.port 为其他端口。
Q: AI 功能不可用
A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。
> 通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
| 工具 | 用途 | 是否必须 |
|---|---|---|
| yt-dlp | YouTube 视频下载 | ✅ 必须 |
| ffmpeg | 音视频处理 | ✅ 必须 |
membership_api.base_url 或服务端兜底 LLM Key |
AI 功能 | 可选 |
安装 yt-dlp:
# macOS
brew install yt-dlp
# Linux
pip install yt-dlp
# 或下载二进制:https://github.com/yt-dlp/yt-dlp/releases/latest
# Windows
winget install yt-dlp
安装 ffmpeg:
# macOS
brew install ffmpeg
# Ubuntu / Debian
sudo apt install ffmpeg
# Windows
winget install ffmpeg
前往 GitHub Releases 下载对应平台的二进制文件:
| 平台 | 架构 | 文件名 |
|---|---|---|
| Linux | x86_64 (AMD64) | ytb2bili-linux-amd64 |
| Linux | ARM64 (树莓派 / 服务器) | ytb2bili-linux-arm64 |
| macOS | Intel | ytb2bili-darwin-amd64 |
| macOS | Apple Silicon (M1/M2/M3) | ytb2bili-darwin-arm64 |
| Windows | x86_64 | ytb2bili-windows-amd64.exe |
命令行下载示例(Linux / macOS):
# 以 Linux AMD64 为例,替换版本号和文件名
VERSION=v0.2.0
curl -L -o ytb2bili \
"https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"
# 授予执行权限
chmod +x ytb2bili
程序启动时会从当前工作目录读取 config.toml。
# 下载配置模板(用于参考)
curl -L -o config.toml \
"https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"
或手动创建 config.toml,以下是最小必要配置:
# ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir = "./downloads"
static_path = "/static"
# ── 数据库(SQLite,开箱即用)─────────────────────────
[database]
type = "sqlite"
path = "ytb2bili.db"
auto_migrate = true
# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path = "/usr/local/bin/yt-dlp" # 若不在 PATH 中,取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url = "http://127.0.0.1:7890" # 代理(可选)
# ── AI Agent(可选兜底,不影响 ytb2bili-api 网关模式)──────────────
[agent]
name = "ytb2bili_agent"
[agent.llm]
# api_key = "sk-..." # 可选:仅本地兜底时填写
model = "gpt-4o-mini"
# base_url = "https://open.api2key.com/ai/v1"
# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled = true
auto_update = false
check_interval = 24
说明:Web AI 助手默认走 ytb2bili-api /ai/v1 网关,
agent.llm只作为旧流程或离线环境的兜底配置。[agent.llm] api_key = "sk-..." model = "gpt-4o-mini" base_url = "https://open.api2key.com/ai/v1"
# 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili config.toml
# Linux / macOS
./ytb2bili
# Windows
.\ytb2bili-windows-amd64.exe
启动成功后,终端输出类似:
🚀 YTB2BILI 启动中... 版本: v0.2.0, 构建时间: 2026-03-04T...
✅ 应用启动成功,按 Ctrl+C 停止...
访问地址:
| 入口 | 地址 |
|---|---|
| Web 界面 | http://localhost:8096 |
| API 健康检查 | http://localhost:8096/health |
| API 文档(Swagger) | http://localhost:8096/swagger/index.html |
通过环境变量 CONFIG_FILE 指定任意路径的配置文件:
CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili
若需要下载需要登录的 YouTube 视频,在 config.toml 中配置:
[workflow]
cookies_file = "/path/to/cookies.txt"
可通过浏览器插件(如 Get cookies.txt)导出 YouTube cookies。
[workflow]
llm_translation_enabled = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"
downloads/ 目录将自动创建,用于存储下载的视频/字幕/缩略图。
可通过 http://localhost:8096/static/<文件名> 直接访问。
Ctrl+C 或 kill)启动后通过 API 检查更新:
# 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check
# 查看当前版本
curl http://localhost:8096/api/v1/updater/version
auto_update = true时程序会在后台自动下载并重启(实验性功能,建议生产环境手动升级)。
Q: 启动报错 config.toml: no such file or directory
A: 确保 config.toml 与可执行文件在同一目录,或通过 CONFIG_FILE 环境变量指定路径。
Q: 下载视频失败,提示 yt-dlp not found
A: 将 yt-dlp 安装后确保在 PATH 中,或在 config.toml 中填写绝对路径:
[workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"
Q: macOS 提示"无法验证开发者"
A: 在终端执行以下命令移除隔离标记:
xattr -d com.apple.quarantine ytb2bili-darwin-arm64
Q: 端口 8096 被占用
A: 修改 config.toml 中的 server.port 为其他端口。
Q: AI 功能不可用
A: 先检查是否已登录、membership_api.base_url 是否指向可用的 ytb2bili-api、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。
> 通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
| 工具 | 用途 | 是否必须 |
|---|---|---|
| yt-dlp | YouTube 视频下载 | ✅ 必须 |
| ffmpeg | 音视频处理 | ✅ 必须 |
membership_api.base_url 或服务端兜底 LLM Key |
AI 功能 | 可选 |
安装 yt-dlp:
# macOS
brew install yt-dlp
# Linux
pip install yt-dlp
# 或下载二进制:https://github.com/yt-dlp/yt-dlp/releases/latest
# Windows
winget install yt-dlp
安装 ffmpeg:
# macOS
brew install ffmpeg
# Ubuntu / Debian
sudo apt install ffmpeg
# Windows
winget install ffmpeg
前往 GitHub Releases 下载对应平台的二进制文件:
| 平台 | 架构 | 文件名 |
|---|---|---|
| Linux | x86_64 (AMD64) | ytb2bili-linux-amd64 |
| Linux | ARM64 (树莓派 / 服务器) | ytb2bili-linux-arm64 |
| macOS | Intel | ytb2bili-darwin-amd64 |
| macOS | Apple Silicon (M1/M2/M3) | ytb2bili-darwin-arm64 |
| Windows | x86_64 | ytb2bili-windows-amd64.exe |
命令行下载示例(Linux / macOS):
# 以 Linux AMD64 为例,替换版本号和文件名
VERSION=v0.1.9
curl -L -o ytb2bili \
"https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"
# 授予执行权限
chmod +x ytb2bili
程序启动时会从当前工作目录读取 config.toml。
# 下载配置模板(用于参考)
curl -L -o config.toml \
"https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"
或手动创建 config.toml,以下是最小必要配置:
# ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir = "./downloads"
static_path = "/static"
# ── 数据库(SQLite,开箱即用)─────────────────────────
[database]
type = "sqlite"
path = "ytb2bili.db"
auto_migrate = true
# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path = "/usr/local/bin/yt-dlp" # 若不在 PATH 中,取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url = "http://127.0.0.1:7890" # 代理(可选)
# ── AI Agent(可选兜底,不影响 ytb2bili-api 网关模式)──────────────
[agent]
name = "ytb2bili_agent"
[agent.llm]
# api_key = "sk-..." # 可选:仅本地兜底时填写
model = "gpt-4o-mini"
# base_url = "https://open.api2key.com/ai/v1"
# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled = true
auto_update = false
check_interval = 24
说明:Web AI 助手默认走 ytb2bili-api /ai/v1 网关,
agent.llm只作为旧流程或离线环境的兜底配置。[agent.llm] api_key = "sk-..." model = "gpt-4o-mini" base_url = "https://open.api2key.com/ai/v1"
# 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili config.toml
# Linux / macOS
./ytb2bili
# Windows
.\ytb2bili-windows-amd64.exe
启动成功后,终端输出类似:
🚀 YTB2BILI 启动中... 版本: v0.1.9, 构建时间: 2026-03-04T...
✅ 应用启动成功,按 Ctrl+C 停止...
访问地址:
| 入口 | 地址 |
|---|---|
| Web 界面 | http://localhost:8096 |
| API 健康检查 | http://localhost:8096/health |
| API 文档(Swagger) | http://localhost:8096/swagger/index.html |
通过环境变量 CONFIG_FILE 指定任意路径的配置文件:
CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili
若需要下载需要登录的 YouTube 视频,在 config.toml 中配置:
[workflow]
cookies_file = "/path/to/cookies.txt"
可通过浏览器插件(如 Get cookies.txt)导出 YouTube cookies。
[workflow]
llm_translation_enabled = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"
downloads/ 目录将自动创建,用于存储下载的视频/字幕/缩略图。
可通过 http://localhost:8096/static/<文件名> 直接访问。
Ctrl+C 或 kill)启动后通过 API 检查更新:
# 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check
# 查看当前版本
curl http://localhost:8096/api/v1/updater/version
auto_update = true时程序会在后台自动下载并重启(实验性功能,建议生产环境手动升级)。
Q: 启动报错 config.toml: no such file or directory
A: 确保 config.toml 与可执行文件在同一目录,或通过 CONFIG_FILE 环境变量指定路径。
Q: 下载视频失败,提示 yt-dlp not found
A: 将 yt-dlp 安装后确保在 PATH 中,或在 config.toml 中填写绝对路径:
[workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"
Q: macOS 提示"无法验证开发者"
A: 在终端执行以下命令移除隔离标记:
xattr -d com.apple.quarantine ytb2bili-darwin-arm64
Q: 端口 8096 被占用
A: 修改 config.toml 中的 server.port 为其他端口。
Q: AI 功能不可用
A: 先检查是否已登录、membership_api.base_url 是否指向可用的 ytb2bili-api、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。
> 通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
通过 GitHub Releases 下载预构建安装包,无需本地编译即可运行。
| 工具 | 用途 | 是否必须 |
|---|---|---|
| yt-dlp | YouTube 视频下载 | ✅ 必须 |
| ffmpeg | 音视频处理 | ✅ 必须 |
membership_api.base_url 或服务端兜底 LLM Key |
AI 功能 | 可选 |
安装 yt-dlp:
# macOS
brew install yt-dlp
# Linux
pip install yt-dlp
# 或下载二进制:https://github.com/yt-dlp/yt-dlp/releases/latest
# Windows
winget install yt-dlp
安装 ffmpeg:
# macOS
brew install ffmpeg
# Ubuntu / Debian
sudo apt install ffmpeg
# Windows
winget install ffmpeg
前往 GitHub Releases 下载对应平台的二进制文件:
| 平台 | 架构 | 文件名 |
|---|---|---|
| Linux | x86_64 (AMD64) | ytb2bili-linux-amd64 |
| Linux | ARM64 (树莓派 / 服务器) | ytb2bili-linux-arm64 |
| macOS | Intel | ytb2bili-darwin-amd64 |
| macOS | Apple Silicon (M1/M2/M3) | ytb2bili-darwin-arm64 |
| Windows | x86_64 | ytb2bili-windows-amd64.exe |
命令行下载示例(Linux / macOS):
# 以 Linux AMD64 为例,替换版本号和文件名
VERSION=v0.1.8
curl -L -o ytb2bili \
"https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"
# 授予执行权限
chmod +x ytb2bili
程序启动时会从当前工作目录读取 config.toml。
# 下载配置模板(用于参考)
curl -L -o config.toml \
"https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"
或手动创建 config.toml,以下是最小必要配置:
# ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir = "./downloads"
static_path = "/static"
# ── 数据库(SQLite,开箱即用)─────────────────────────
[database]
type = "sqlite"
path = "ytb2bili.db"
auto_migrate = true
# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path = "/usr/local/bin/yt-dlp" # 若不在 PATH 中,取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url = "http://127.0.0.1:7890" # 代理(可选)
# ── AI Agent(可选兜底,不影响 ytb2bili-api 网关模式)──────────────
[agent]
name = "ytb2bili_agent"
[agent.llm]
# api_key = "sk-..." # 可选:仅本地兜底时填写
model = "gpt-4o-mini"
# base_url = "https://open.api2key.com/ai/v1"
# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled = true
auto_update = false
check_interval = 24
说明:Web AI 助手默认走 ytb2bili-api /ai/v1 网关,
agent.llm只作为旧流程或离线环境的兜底配置。[agent.llm] api_key = "sk-..." model = "gpt-4o-mini" base_url = "https://open.api2key.com/ai/v1"
# 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili config.toml
# Linux / macOS
./ytb2bili
# Windows
.\ytb2bili-windows-amd64.exe
启动成功后,终端输出类似:
🚀 YTB2BILI 启动中... 版本: v0.1.8, 构建时间: 2026-03-04T...
✅ 应用启动成功,按 Ctrl+C 停止...
访问地址:
| 入口 | 地址 |
|---|---|
| Web 界面 | http://localhost:8096 |
| API 健康检查 | http://localhost:8096/health |
| API 文档(Swagger) | http://localhost:8096/swagger/index.html |
通过环境变量 CONFIG_FILE 指定任意路径的配置文件:
CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili
若需要下载需要登录的 YouTube 视频,在 config.toml 中配置:
[workflow]
cookies_file = "/path/to/cookies.txt"
可通过浏览器插件(如 Get cookies.txt)导出 YouTube cookies。
[workflow]
llm_translation_enabled = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"
downloads/ 目录将自动创建,用于存储下载的视频/字幕/缩略图。
可通过 http://localhost:8096/static/<文件名> 直接访问。
Ctrl+C 或 kill)启动后通过 API 检查更新:
# 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check
# 查看当前版本
curl http://localhost:8096/api/v1/updater/version
auto_update = true时程序会在后台自动下载并重启(实验性功能,建议生产环境手动升级)。
Q: 启动报错 config.toml: no such file or directory
A: 确保 config.toml 与可执行文件在同一目录,或通过 CONFIG_FILE 环境变量指定路径。
Q: 下载视频失败,提示 yt-dlp not found
A: 将 yt-dlp 安装后确保在 PATH 中,或在 config.toml 中填写绝对路径:
[workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"
Q: macOS 提示"无法验证开发者"
A: 在终端执行以下命令移除隔离标记:
xattr -d com.apple.quarantine ytb2bili-darwin-arm64
Q: 端口 8096 被占用
A: 修改 config.toml 中的 server.port 为其他端口。
Q: AI 功能不可用
A: 先检查是否已登录、membership_api.base_url 是否指向可用的 ytb2bili-api、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。
Nothing published for this version
任务队列服务端分页:任务管理页支持按 Tab(全部 / 处理中 / 已完成 / 失败)服务端过滤,新增 /api/v1/videos/counts 接口,每页 10 条,避免一次加载所有数据。
/api/v1/videos/counts 接口,每页 10 条,避免一次加载所有数据。operation_type=submit 记录。| 项目 | 最低要求 |
|---|---|
| Docker | 20.10+ |
| Docker Compose | v2.0+ |
| 内存 | 2 GB |
| 磁盘 | 10 GB(含视频缓存) |
| 架构 | linux/amd64 或 linux/arm64 |
自动启动 MySQL + 应用,无需单独配置数据库。
从 Releases 下载对应架构的压缩包:
ytb2bili-linux-amd64.tar.gzytb2bili-linux-arm64.tar.gz# amd64 示例
tar -xzf ytb2bili-linux-amd64.tar.gz
cd ytb2bili-linux-amd64
config.toml# 用你常用的编辑器打开
nano config.toml
必须修改的项:
[server]
port = 8096 # 访问端口,可自行修改
[database]
host = "mysql" # Docker 网络内保持 "mysql",无需修改
user = "ytb2bili"
password = "ytb2bili@123"
dbname = "bili_up"
[workflow]
download_dir = "./media"
ytdlp_path = "/usr/local/bin/yt-dlp"
ffmpeg_path = "/usr/bin/ffmpeg"
可选项(不需要时留空):
[agent.llm]
provider = "openai" # 支持 openai / deepseek / openrouter
api_key = "" # 留空则不启用 AI 助手
model = "gpt-4o"
docker compose up -d
启动后会自动:
# 查看所有服务日志
docker compose logs -f
# 只看应用日志
docker compose logs -f ytb2bili
打开浏览器访问:
http://localhost:8096
如修改过端口,替换
8096为你配置的端口。
如果你已经有外部 MySQL 实例,可以只启动应用容器:
docker run -d \
--name ytb2bili-app \
--restart unless-stopped \
-p 8096:8096 \
-v $(pwd)/config.toml:/app/config.toml:ro \
-v ytb2bili_media:/app/media \
difyz9/ytb2bili:latest
将 config.toml 中 [database] 的 host 改为实际数据库地址。
# 停止服务(保留数据)
docker compose stop
# 停止并删除容器(数据卷保留)
docker compose down
# 停止并删除容器 + 数据卷(⚠️ 会清空数据库和媒体文件)
docker compose down -v
# 重启服务
docker compose restart
# 更新到最新版本
docker compose pull
docker compose up -d
ytb2bili-linux-amd64/
├── config.toml # ← 主配置文件,部署前必须编辑
├── docker-compose.yml # ← 一键启动文件
├── Dockerfile # 镜像构建文件
├── Shanghai.zone # 时区文件
├── start.sh # 直接运行(不用 Docker)
└── ytb2bili-linux-amd64 # 可执行文件
Docker Compose 使用具名卷持久化数据:
| 卷名 | 内容 |
|---|---|
ytb2bili_mysql_data |
MySQL 数据库文件 |
ytb2bili_app_data |
应用运行数据 |
ytb2bili_media |
下载的视频、音频、缩略图等媒体文件 |
重新部署不会丢失数据,除非使用 docker compose down -v。
Q: 启动后访问页面空白?
等待约 30 秒让 MySQL 完成初始化,然后刷新页面。可通过 docker compose logs ytb2bili 确认应用是否已正常启动。
Q: 端口 8096 被占用?
修改 docker-compose.yml 中 ports 的宿主机端口(冒号左边的数字):
ports:
- "9000:8096" # 改为 9000
Q: 如何在 ARM 设备(如树莓派)上运行?
使用 ytb2bili-linux-arm64 包,其 docker-compose.yml 中已设置 platform: linux/arm64,直接 docker compose up -d 即可。
Q: 如何配置 HTTPS?
推荐在前面放置 Nginx / Traefik 反向代理处理 HTTPS,应用本身监听 HTTP。
Q: AI 助手不可用怎么办?
在 config.toml 中补全 [agent.llm] 的 api_key 字段(支持 OpenAI、DeepSeek、OpenRouter),然后重启容器:
docker compose restart ytb2bili
任务队列服务端分页:任务管理页支持按 Tab(全部 / 处理中 / 已完成 / 失败)服务端过滤,新增 /api/v1/videos/counts 接口,每页 10 条,避免一次加载所有数据。
/api/v1/videos/counts 接口,每页 10 条,避免一次加载所有数据。operation_type=submit 记录。| 项目 | 最低要求 |
|---|---|
| Docker | 20.10+ |
| Docker Compose | v2.0+ |
| 内存 | 2 GB |
| 磁盘 | 10 GB(含视频缓存) |
| 架构 | linux/amd64 或 linux/arm64 |
自动启动 MySQL + 应用,无需单独配置数据库。
从 Releases 下载对应架构的压缩包:
ytb2bili-linux-amd64.tar.gzytb2bili-linux-arm64.tar.gz# amd64 示例
tar -xzf ytb2bili-linux-amd64.tar.gz
cd ytb2bili-linux-amd64
config.toml# 用你常用的编辑器打开
nano config.toml
必须修改的项:
[server]
port = 8096 # 访问端口,可自行修改
[database]
host = "mysql" # Docker 网络内保持 "mysql",无需修改
user = "ytb2bili"
password = "ytb2bili@123"
dbname = "bili_up"
[workflow]
download_dir = "./media"
ytdlp_path = "/usr/local/bin/yt-dlp"
ffmpeg_path = "/usr/bin/ffmpeg"
可选项(不需要时留空):
[agent.llm]
provider = "openai" # 支持 openai / deepseek / openrouter
api_key = "" # 留空则不启用 AI 助手
model = "gpt-4o"
docker compose up -d
启动后会自动:
# 查看所有服务日志
docker compose logs -f
# 只看应用日志
docker compose logs -f ytb2bili
打开浏览器访问:
http://localhost:8096
如修改过端口,替换
8096为你配置的端口。
如果你已经有外部 MySQL 实例,可以只启动应用容器:
docker run -d \
--name ytb2bili-app \
--restart unless-stopped \
-p 8096:8096 \
-v $(pwd)/config.toml:/app/config.toml:ro \
-v ytb2bili_media:/app/media \
difyz9/ytb2bili:latest
将 config.toml 中 [database] 的 host 改为实际数据库地址。
# 停止服务(保留数据)
docker compose stop
# 停止并删除容器(数据卷保留)
docker compose down
# 停止并删除容器 + 数据卷(⚠️ 会清空数据库和媒体文件)
docker compose down -v
# 重启服务
docker compose restart
# 更新到最新版本
docker compose pull
docker compose up -d
ytb2bili-linux-amd64/
├── config.toml # ← 主配置文件,部署前必须编辑
├── docker-compose.yml # ← 一键启动文件
├── Dockerfile # 镜像构建文件
├── Shanghai.zone # 时区文件
├── start.sh # 直接运行(不用 Docker)
└── ytb2bili-linux-amd64 # 可执行文件
Docker Compose 使用具名卷持久化数据:
| 卷名 | 内容 |
|---|---|
ytb2bili_mysql_data |
MySQL 数据库文件 |
ytb2bili_app_data |
应用运行数据 |
ytb2bili_media |
下载的视频、音频、缩略图等媒体文件 |
重新部署不会丢失数据,除非使用 docker compose down -v。
Q: 启动后访问页面空白?
等待约 30 秒让 MySQL 完成初始化,然后刷新页面。可通过 docker compose logs ytb2bili 确认应用是否已正常启动。
Q: 端口 8096 被占用?
修改 docker-compose.yml 中 ports 的宿主机端口(冒号左边的数字):
ports:
- "9000:8096" # 改为 9000
Q: 如何在 ARM 设备(如树莓派)上运行?
使用 ytb2bili-linux-arm64 包,其 docker-compose.yml 中已设置 platform: linux/arm64,直接 docker compose up -d 即可。
Q: 如何配置 HTTPS?
推荐在前面放置 Nginx / Traefik 反向代理处理 HTTPS,应用本身监听 HTTP。
Q: AI 助手不可用怎么办?
在 config.toml 中补全 [agent.llm] 的 api_key 字段(支持 OpenAI、DeepSeek、OpenRouter),然后重启容器:
docker compose restart ytb2bili
任务队列服务端分页:任务管理页支持按 Tab(全部 / 处理中 / 已完成 / 失败)服务端过滤,新增 /api/v1/videos/counts 接口,每页 10 条,避免一次加载所有数据。
/api/v1/videos/counts 接口,每页 10 条,避免一次加载所有数据。operation_type=submit 记录。| 项目 | 最低要求 |
|---|---|
| Docker | 20.10+ |
| Docker Compose | v2.0+ |
| 内存 | 2 GB |
| 磁盘 | 10 GB(含视频缓存) |
| 架构 | linux/amd64 或 linux/arm64 |
自动启动 MySQL + 应用,无需单独配置数据库。
从 Releases 下载对应架构的压缩包:
ytb2bili-linux-amd64.tar.gzytb2bili-linux-arm64.tar.gz# amd64 示例
tar -xzf ytb2bili-linux-amd64.tar.gz
cd ytb2bili-linux-amd64
config.toml# 用你常用的编辑器打开
nano config.toml
必须修改的项:
[server]
port = 8096 # 访问端口,可自行修改
[database]
host = "mysql" # Docker 网络内保持 "mysql",无需修改
user = "ytb2bili"
password = "ytb2bili@123"
dbname = "bili_up"
[workflow]
download_dir = "./media"
ytdlp_path = "/usr/local/bin/yt-dlp"
ffmpeg_path = "/usr/bin/ffmpeg"
可选项(不需要时留空):
[agent.llm]
provider = "openai" # 支持 openai / deepseek / openrouter
api_key = "" # 留空则不启用 AI 助手
model = "gpt-4o"
docker compose up -d
启动后会自动:
# 查看所有服务日志
docker compose logs -f
# 只看应用日志
docker compose logs -f ytb2bili
打开浏览器访问:
http://localhost:8096
如修改过端口,替换
8096为你配置的端口。
如果你已经有外部 MySQL 实例,可以只启动应用容器:
docker run -d \
--name ytb2bili-app \
--restart unless-stopped \
-p 8096:8096 \
-v $(pwd)/config.toml:/app/config.toml:ro \
-v ytb2bili_media:/app/media \
difyz9/ytb2bili:latest
将 config.toml 中 [database] 的 host 改为实际数据库地址。
# 停止服务(保留数据)
docker compose stop
# 停止并删除容器(数据卷保留)
docker compose down
# 停止并删除容器 + 数据卷(⚠️ 会清空数据库和媒体文件)
docker compose down -v
# 重启服务
docker compose restart
# 更新到最新版本
docker compose pull
docker compose up -d
ytb2bili-linux-amd64/
├── config.toml # ← 主配置文件,部署前必须编辑
├── docker-compose.yml # ← 一键启动文件
├── Dockerfile # 镜像构建文件
├── Shanghai.zone # 时区文件
├── start.sh # 直接运行(不用 Docker)
└── ytb2bili-linux-amd64 # 可执行文件
Docker Compose 使用具名卷持久化数据:
| 卷名 | 内容 |
|---|---|
ytb2bili_mysql_data |
MySQL 数据库文件 |
ytb2bili_app_data |
应用运行数据 |
ytb2bili_media |
下载的视频、音频、缩略图等媒体文件 |
重新部署不会丢失数据,除非使用 docker compose down -v。
Q: 启动后访问页面空白?
等待约 30 秒让 MySQL 完成初始化,然后刷新页面。可通过 docker compose logs ytb2bili 确认应用是否已正常启动。
Q: 端口 8096 被占用?
修改 docker-compose.yml 中 ports 的宿主机端口(冒号左边的数字):
ports:
- "9000:8096" # 改为 9000
Q: 如何在 ARM 设备(如树莓派)上运行?
使用 ytb2bili-linux-arm64 包,其 docker-compose.yml 中已设置 platform: linux/arm64,直接 docker compose up -d 即可。
Q: 如何配置 HTTPS?
推荐在前面放置 Nginx / Traefik 反向代理处理 HTTPS,应用本身监听 HTTP。
Q: AI 助手不可用怎么办?
在 config.toml 中补全 [agent.llm] 的 api_key 字段(支持 OpenAI、DeepSeek、OpenRouter),然后重启容器:
docker compose restart ytb2bili
任务队列服务端分页:任务管理页支持按 Tab(全部 / 处理中 / 已完成 / 失败)服务端过滤,新增 /api/v1/videos/counts 接口,每页 10 条,避免一次加载所有数据。
/api/v1/videos/counts 接口,每页 10 条,避免一次加载所有数据。operation_type=submit 记录。| 项目 | 最低要求 |
|---|---|
| Docker | 20.10+ |
| Docker Compose | v2.0+ |
| 内存 | 2 GB |
| 磁盘 | 10 GB(含视频缓存) |
| 架构 | linux/amd64 或 linux/arm64 |
自动启动 MySQL + 应用,无需单独配置数据库。
从 Releases 下载对应架构的压缩包:
ytb2bili-linux-amd64.tar.gzytb2bili-linux-arm64.tar.gz# amd64 示例
tar -xzf ytb2bili-linux-amd64.tar.gz
cd ytb2bili-linux-amd64
config.toml# 用你常用的编辑器打开
nano config.toml
必须修改的项:
[server]
port = 8096 # 访问端口,可自行修改
[database]
host = "mysql" # Docker 网络内保持 "mysql",无需修改
user = "ytb2bili"
password = "ytb2bili@123"
dbname = "bili_up"
[workflow]
download_dir = "./media"
ytdlp_path = "/usr/local/bin/yt-dlp"
ffmpeg_path = "/usr/bin/ffmpeg"
可选项(不需要时留空):
[agent.llm]
provider = "openai" # 支持 openai / deepseek / openrouter
api_key = "" # 留空则不启用 AI 助手
model = "gpt-4o"
docker compose up -d
启动后会自动:
# 查看所有服务日志
docker compose logs -f
# 只看应用日志
docker compose logs -f ytb2bili
打开浏览器访问:
http://localhost:8096
如修改过端口,替换
8096为你配置的端口。
如果你已经有外部 MySQL 实例,可以只启动应用容器:
docker run -d \
--name ytb2bili-app \
--restart unless-stopped \
-p 8096:8096 \
-v $(pwd)/config.toml:/app/config.toml:ro \
-v ytb2bili_media:/app/media \
difyz9/ytb2bili:latest
将 config.toml 中 [database] 的 host 改为实际数据库地址。
# 停止服务(保留数据)
docker compose stop
# 停止并删除容器(数据卷保留)
docker compose down
# 停止并删除容器 + 数据卷(⚠️ 会清空数据库和媒体文件)
docker compose down -v
# 重启服务
docker compose restart
# 更新到最新版本
docker compose pull
docker compose up -d
ytb2bili-linux-amd64/
├── config.toml # ← 主配置文件,部署前必须编辑
├── docker-compose.yml # ← 一键启动文件
├── Dockerfile # 镜像构建文件
├── Shanghai.zone # 时区文件
├── start.sh # 直接运行(不用 Docker)
└── ytb2bili-linux-amd64 # 可执行文件
Docker Compose 使用具名卷持久化数据:
| 卷名 | 内容 |
|---|---|
ytb2bili_mysql_data |
MySQL 数据库文件 |
ytb2bili_app_data |
应用运行数据 |
ytb2bili_media |
下载的视频、音频、缩略图等媒体文件 |
重新部署不会丢失数据,除非使用 docker compose down -v。
Q: 启动后访问页面空白?
等待约 30 秒让 MySQL 完成初始化,然后刷新页面。可通过 docker compose logs ytb2bili 确认应用是否已正常启动。
Q: 端口 8096 被占用?
修改 docker-compose.yml 中 ports 的宿主机端口(冒号左边的数字):
ports:
- "9000:8096" # 改为 9000
Q: 如何在 ARM 设备(如树莓派)上运行?
使用 ytb2bili-linux-arm64 包,其 docker-compose.yml 中已设置 platform: linux/arm64,直接 docker compose up -d 即可。
Q: 如何配置 HTTPS?
推荐在前面放置 Nginx / Traefik 反向代理处理 HTTPS,应用本身监听 HTTP。
Q: AI 助手不可用怎么办?
在 config.toml 中补全 [agent.llm] 的 api_key 字段(支持 OpenAI、DeepSeek、OpenRouter),然后重启容器:
docker compose restart ytb2bili
任务队列服务端分页:任务管理页支持按 Tab(全部 / 处理中 / 已完成 / 失败)服务端过滤,新增 /api/v1/videos/counts 接口,每页 10 条,避免一次加载所有数据。
/api/v1/videos/counts 接口,每页 10 条,避免一次加载所有数据。operation_type=submit 记录。| 项目 | 最低要求 |
|---|---|
| Docker | 20.10+ |
| Docker Compose | v2.0+ |
| 内存 | 2 GB |
| 磁盘 | 10 GB(含视频缓存) |
| 架构 | linux/amd64 或 linux/arm64 |
自动启动 MySQL + 应用,无需单独配置数据库。
从 Releases 下载对应架构的压缩包:
ytb2bili-linux-amd64.tar.gzytb2bili-linux-arm64.tar.gz# amd64 示例
tar -xzf ytb2bili-linux-amd64.tar.gz
cd ytb2bili-linux-amd64
config.toml# 用你常用的编辑器打开
nano config.toml
必须修改的项:
[server]
port = 8096 # 访问端口,可自行修改
[database]
host = "mysql" # Docker 网络内保持 "mysql",无需修改
user = "ytb2bili"
password = "ytb2bili@123"
dbname = "bili_up"
[workflow]
download_dir = "./media"
ytdlp_path = "/usr/local/bin/yt-dlp"
ffmpeg_path = "/usr/bin/ffmpeg"
可选项(不需要时留空):
[agent.llm]
provider = "openai" # 支持 openai / deepseek / openrouter
api_key = "" # 留空则不启用 AI 助手
model = "gpt-4o"
docker compose up -d
启动后会自动:
# 查看所有服务日志
docker compose logs -f
# 只看应用日志
docker compose logs -f ytb2bili
打开浏览器访问:
http://localhost:8096
如修改过端口,替换
8096为你配置的端口。
如果你已经有外部 MySQL 实例,可以只启动应用容器:
docker run -d \
--name ytb2bili-app \
--restart unless-stopped \
-p 8096:8096 \
-v $(pwd)/config.toml:/app/config.toml:ro \
-v ytb2bili_media:/app/media \
difyz9/ytb2bili:latest
将 config.toml 中 [database] 的 host 改为实际数据库地址。
# 停止服务(保留数据)
docker compose stop
# 停止并删除容器(数据卷保留)
docker compose down
# 停止并删除容器 + 数据卷(⚠️ 会清空数据库和媒体文件)
docker compose down -v
# 重启服务
docker compose restart
# 更新到最新版本
docker compose pull
docker compose up -d
ytb2bili-linux-amd64/
├── config.toml # ← 主配置文件,部署前必须编辑
├── docker-compose.yml # ← 一键启动文件
├── Dockerfile # 镜像构建文件
├── Shanghai.zone # 时区文件
├── start.sh # 直接运行(不用 Docker)
└── ytb2bili-linux-amd64 # 可执行文件
Docker Compose 使用具名卷持久化数据:
| 卷名 | 内容 |
|---|---|
ytb2bili_mysql_data |
MySQL 数据库文件 |
ytb2bili_app_data |
应用运行数据 |
ytb2bili_media |
下载的视频、音频、缩略图等媒体文件 |
重新部署不会丢失数据,除非使用 docker compose down -v。
Q: 启动后访问页面空白?
等待约 30 秒让 MySQL 完成初始化,然后刷新页面。可通过 docker compose logs ytb2bili 确认应用是否已正常启动。
Q: 端口 8096 被占用?
修改 docker-compose.yml 中 ports 的宿主机端口(冒号左边的数字):
ports:
- "9000:8096" # 改为 9000
Q: 如何在 ARM 设备(如树莓派)上运行?
使用 ytb2bili-linux-arm64 包,其 docker-compose.yml 中已设置 platform: linux/arm64,直接 docker compose up -d 即可。
Q: 如何配置 HTTPS?
推荐在前面放置 Nginx / Traefik 反向代理处理 HTTPS,应用本身监听 HTTP。
Q: AI 助手不可用怎么办?
在 config.toml 中补全 [agent.llm] 的 api_key 字段(支持 OpenAI、DeepSeek、OpenRouter),然后重启容器:
docker compose restart ytb2bili
任务队列服务端分页:任务管理页支持按 Tab(全部 / 处理中 / 已完成 / 失败)服务端过滤,新增 /api/v1/videos/counts 接口,每页 10 条,避免一次加载所有数据。
/api/v1/videos/counts 接口,每页 10 条,避免一次加载所有数据。operation_type=submit 记录。| 项目 | 最低要求 |
|---|---|
| Docker | 20.10+ |
| Docker Compose | v2.0+ |
| 内存 | 2 GB |
| 磁盘 | 10 GB(含视频缓存) |
| 架构 | linux/amd64 或 linux/arm64 |
自动启动 MySQL + 应用,无需单独配置数据库。
从 Releases 下载对应架构的压缩包:
ytb2bili-linux-amd64.tar.gzytb2bili-linux-arm64.tar.gz# amd64 示例
tar -xzf ytb2bili-linux-amd64.tar.gz
cd ytb2bili-linux-amd64
config.toml# 用你常用的编辑器打开
nano config.toml
必须修改的项:
[server]
port = 8096 # 访问端口,可自行修改
[database]
host = "mysql" # Docker 网络内保持 "mysql",无需修改
user = "ytb2bili"
password = "ytb2bili@123"
dbname = "bili_up"
[workflow]
download_dir = "./media"
ytdlp_path = "/usr/local/bin/yt-dlp"
ffmpeg_path = "/usr/bin/ffmpeg"
可选项(不需要时留空):
[agent.llm]
provider = "openai" # 支持 openai / deepseek / openrouter
api_key = "" # 留空则不启用 AI 助手
model = "gpt-4o"
docker compose up -d
启动后会自动:
# 查看所有服务日志
docker compose logs -f
# 只看应用日志
docker compose logs -f ytb2bili
打开浏览器访问:
http://localhost:8096
如修改过端口,替换
8096为你配置的端口。
如果你已经有外部 MySQL 实例,可以只启动应用容器:
docker run -d \
--name ytb2bili-app \
--restart unless-stopped \
-p 8096:8096 \
-v $(pwd)/config.toml:/app/config.toml:ro \
-v ytb2bili_media:/app/media \
difyz9/ytb2bili:latest
将 config.toml 中 [database] 的 host 改为实际数据库地址。
# 停止服务(保留数据)
docker compose stop
# 停止并删除容器(数据卷保留)
docker compose down
# 停止并删除容器 + 数据卷(⚠️ 会清空数据库和媒体文件)
docker compose down -v
# 重启服务
docker compose restart
# 更新到最新版本
docker compose pull
docker compose up -d
ytb2bili-linux-amd64/
├── config.toml # ← 主配置文件,部署前必须编辑
├── docker-compose.yml # ← 一键启动文件
├── Dockerfile # 镜像构建文件
├── Shanghai.zone # 时区文件
├── start.sh # 直接运行(不用 Docker)
└── ytb2bili-linux-amd64 # 可执行文件
Docker Compose 使用具名卷持久化数据:
| 卷名 | 内容 |
|---|---|
ytb2bili_mysql_data |
MySQL 数据库文件 |
ytb2bili_app_data |
应用运行数据 |
ytb2bili_media |
下载的视频、音频、缩略图等媒体文件 |
重新部署不会丢失数据,除非使用 docker compose down -v。
Q: 启动后访问页面空白?
等待约 30 秒让 MySQL 完成初始化,然后刷新页面。可通过 docker compose logs ytb2bili 确认应用是否已正常启动。
Q: 端口 8096 被占用?
修改 docker-compose.yml 中 ports 的宿主机端口(冒号左边的数字):
ports:
- "9000:8096" # 改为 9000
Q: 如何在 ARM 设备(如树莓派)上运行?
使用 ytb2bili-linux-arm64 包,其 docker-compose.yml 中已设置 platform: linux/arm64,直接 docker compose up -d 即可。
Q: 如何配置 HTTPS?
推荐在前面放置 Nginx / Traefik 反向代理处理 HTTPS,应用本身监听 HTTP。
Q: AI 助手不可用怎么办?
在 config.toml 中补全 [agent.llm] 的 api_key 字段(支持 OpenAI、DeepSeek、OpenRouter),然后重启容器:
docker compose restart ytb2bili
任务队列服务端分页:任务管理页支持按 Tab(全部 / 处理中 / 已完成 / 失败)服务端过滤,新增 /api/v1/videos/counts 接口,每页 10 条,避免一次加载所有数据。
/api/v1/videos/counts 接口,每页 10 条,避免一次加载所有数据。operation_type=submit 记录。| 项目 | 最低要求 |
|---|---|
| Docker | 20.10+ |
| Docker Compose | v2.0+ |
| 内存 | 2 GB |
| 磁盘 | 10 GB(含视频缓存) |
| 架构 | linux/amd64 或 linux/arm64 |
自动启动 MySQL + 应用,无需单独配置数据库。
从 Releases 下载对应架构的压缩包:
ytb2bili-linux-amd64.tar.gzytb2bili-linux-arm64.tar.gz# amd64 示例
tar -xzf ytb2bili-linux-amd64.tar.gz
cd ytb2bili-linux-amd64
config.toml# 用你常用的编辑器打开
nano config.toml
必须修改的项:
[server]
port = 8096 # 访问端口,可自行修改
[database]
host = "mysql" # Docker 网络内保持 "mysql",无需修改
user = "ytb2bili"
password = "ytb2bili@123"
dbname = "bili_up"
[workflow]
download_dir = "./media"
ytdlp_path = "/usr/local/bin/yt-dlp"
ffmpeg_path = "/usr/bin/ffmpeg"
可选项(不需要时留空):
[agent.llm]
provider = "openai" # 支持 openai / deepseek / openrouter
api_key = "" # 留空则不启用 AI 助手
model = "gpt-4o"
docker compose up -d
启动后会自动:
# 查看所有服务日志
docker compose logs -f
# 只看应用日志
docker compose logs -f ytb2bili
打开浏览器访问:
http://localhost:8096
如修改过端口,替换
8096为你配置的端口。
如果你已经有外部 MySQL 实例,可以只启动应用容器:
docker run -d \
--name ytb2bili-app \
--restart unless-stopped \
-p 8096:8096 \
-v $(pwd)/config.toml:/app/config.toml:ro \
-v ytb2bili_media:/app/media \
difyz9/ytb2bili:latest
将 config.toml 中 [database] 的 host 改为实际数据库地址。
# 停止服务(保留数据)
docker compose stop
# 停止并删除容器(数据卷保留)
docker compose down
# 停止并删除容器 + 数据卷(⚠️ 会清空数据库和媒体文件)
docker compose down -v
# 重启服务
docker compose restart
# 更新到最新版本
docker compose pull
docker compose up -d
ytb2bili-linux-amd64/
├── config.toml # ← 主配置文件,部署前必须编辑
├── docker-compose.yml # ← 一键启动文件
├── Dockerfile # 镜像构建文件
├── Shanghai.zone # 时区文件
├── start.sh # 直接运行(不用 Docker)
└── ytb2bili-linux-amd64 # 可执行文件
Docker Compose 使用具名卷持久化数据:
| 卷名 | 内容 |
|---|---|
ytb2bili_mysql_data |
MySQL 数据库文件 |
ytb2bili_app_data |
应用运行数据 |
ytb2bili_media |
下载的视频、音频、缩略图等媒体文件 |
重新部署不会丢失数据,除非使用 docker compose down -v。
Q: 启动后访问页面空白?
等待约 30 秒让 MySQL 完成初始化,然后刷新页面。可通过 docker compose logs ytb2bili 确认应用是否已正常启动。
Q: 端口 8096 被占用?
修改 docker-compose.yml 中 ports 的宿主机端口(冒号左边的数字):
ports:
- "9000:8096" # 改为 9000
Q: 如何在 ARM 设备(如树莓派)上运行?
使用 ytb2bili-linux-arm64 包,其 docker-compose.yml 中已设置 platform: linux/arm64,直接 docker compose up -d 即可。
Q: 如何配置 HTTPS?
推荐在前面放置 Nginx / Traefik 反向代理处理 HTTPS,应用本身监听 HTTP。
Q: AI 助手不可用怎么办?
在 config.toml 中补全 [agent.llm] 的 api_key 字段(支持 OpenAI、DeepSeek、OpenRouter),然后重启容器:
docker compose restart ytb2bili
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
| 🪟 Windows | x64 | ytb2bili-windows-amd64.zip | 11M |
| 平台 | 架构 | 下载 | 大小 |
|---|---|---|---|
| 🪟 Windows | x64 | ytb2bili-windows-amd64.zip | 11M |
| 🐧 Linux | x64 | ytb2bili-linux-amd64.tar.gz | 11M |
| 🐧 Linux | ARM64 | ytb2bili-linux-arm64.tar.gz | 9.5M |
| 🍎 macOS | Intel | ytb2bili-darwin-amd64.tar.gz | 11M |
| 🍎 macOS | Apple Silicon | ytb2bili-darwin-arm64.tar.gz | 9.9M |
config.toml 文件start.sh 或 start.bat构建时间: 2025-11-17 09:52:24 UTC
Go版本: go version go1.24.1 linux/amd64
| 🪟 Windows | x64 | ytb2bili-windows-amd64.zip | 11M |
| 平台 | 架构 | 下载 | 大小 |
|---|---|---|---|
| 🪟 Windows | x64 | ytb2bili-windows-amd64.zip | 11M |
| 🐧 Linux | x64 | ytb2bili-linux-amd64.tar.gz | 11M |
| 🐧 Linux | ARM64 | ytb2bili-linux-arm64.tar.gz | 9.5M |
| 🍎 macOS | Intel | ytb2bili-darwin-amd64.tar.gz | 11M |
| 🍎 macOS | Apple Silicon | ytb2bili-darwin-arm64.tar.gz | 9.9M |
config.toml 文件start.sh 或 start.bat构建时间: 2025-11-14 09:35:20 UTC
Go版本: go version go1.24.1 linux/amd64
| 🪟 Windows | x64 | ytb2bili-windows-amd64.zip | 11M |
| 平台 | 架构 | 下载 | 大小 |
|---|---|---|---|
| 🪟 Windows | x64 | ytb2bili-windows-amd64.zip | 11M |
| 🐧 Linux | x64 | ytb2bili-linux-amd64.tar.gz | 11M |
| 🐧 Linux | ARM64 | ytb2bili-linux-arm64.tar.gz | 9.5M |
| 🍎 macOS | Intel | ytb2bili-darwin-amd64.tar.gz | 11M |
| 🍎 macOS | Apple Silicon | ytb2bili-darwin-arm64.tar.gz | 9.9M |
config.toml 文件start.sh 或 start.bat构建时间: 2025-11-14 04:34:24 UTC
Go版本: go version go1.24.1 linux/amd64
| 🪟 Windows | x64 | ytb2bili-windows-amd64.zip | 11M |
| 平台 | 架构 | 下载 | 大小 |
|---|---|---|---|
| 🪟 Windows | x64 | ytb2bili-windows-amd64.zip | 11M |
| 🐧 Linux | x64 | ytb2bili-linux-amd64.tar.gz | 11M |
| 🐧 Linux | ARM64 | ytb2bili-linux-arm64.tar.gz | 9.5M |
| 🍎 macOS | Intel | ytb2bili-darwin-amd64.tar.gz | 11M |
| 🍎 macOS | Apple Silicon | ytb2bili-darwin-arm64.tar.gz | 9.9M |
config.toml 文件start.sh 或 start.bat构建时间: 2025-11-14 04:27:47 UTC
Go版本: go version go1.24.1 linux/amd64
Nothing published for this version
Nothing published for this version
One column per month.