difyz9/ytb2bili-base repository overview

⁠Docker Hub 使用指南

⁠📋 镜像信息

Docker Hub 地址: difyz9/ytb2bili-base⁠

这是 YTB2BILI 项目的基础 Docker 镜像，基于 Ubuntu 22.04，预装了 yt-dlp、ffmpeg、whisper.cpp 和 Node.js 等核心依赖。

⁠🏷️ 镜像标签

⁠标签格式

difyz9/ytb2bili-base:<tag>

⁠可用标签

• latest - 最新稳定版本（推荐）
• v<version> - 特定版本号（如 v3.0, v2.1）
• <date> - 特定日期构建（如 2026-01-29）
• ubuntu-22.04 - 指定 Ubuntu 版本

⁠示例

# 拉取最新版本
docker pull difyz9/ytb2bili-base:latest

# 拉取特定版本
docker pull difyz9/ytb2bili-base:v3.0

# 拉取特定日期构建
docker pull difyz9/ytb2bili-base:2026-01-29

⁠🚀 快速使用

⁠1. 拉取镜像

docker pull difyz9/ytb2bili-base:latest

⁠2. 运行容器

⁠交互式运行

docker run -it difyz9/ytb2bili-base:latest /bin/bash

⁠后台运行

docker run -d --name ytb2bili-base difyz9/ytb2bili-base:latest

⁠3. 验证安装

# 检查 yt-dlp 版本
docker run --rm difyz9/ytb2bili-base:latest yt-dlp --version

# 检查 ffmpeg 版本
docker run --rm difyz9/ytb2bili-base:latest ffmpeg -version

# 检查 Node.js 版本
docker run --rm difyz9/ytb2bili-base:latest node --version

# 检查 whisper.cpp
docker run --rm difyz9/ytb2bili-base:latest whisper --version

⁠🔨 基于此镜像构建

⁠Dockerfile 示例

FROM difyz9/ytb2bili-base:latest

# 设置工作目录
WORKDIR /app

# 复制应用文件
COPY . .

# 安装应用依赖
RUN npm install

# 暴露端口
EXPOSE 3000

# 启动命令
CMD ["npm", "start"]

⁠Docker Compose 示例

version: '3.8'

services:
  ytb2bili:
    image: difyz9/ytb2bili-base:latest
    container_name: ytb2bili
    volumes:
      - ./app:/app
      - ./data:/data
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
    restart: unless-stopped

⁠📦 镜像内容

⁠预装软件

⁠系统工具

• git - 版本控制
• curl - 数据传输工具
• build-essential - 编译工具链
• cmake - 构建系统
• supervisor - 进程管理器

⁠环境变量

CGO_LDFLAGS="-L/usr/local/lib"
CGO_CFLAGS="-I/usr/local/include"
LD_LIBRARY_PATH="/usr/local/lib"

⁠🔄 自动更新

该镜像通过 GitHub Actions 自动构建和更新：

• ⏰ 定时任务: 每天自动检查依赖更新
• 🔍 版本检测: 自动检测 yt-dlp 新版本
• 🏗️ 自动构建: 发现更新后自动构建新镜像
• 📤 自动推送: 构建成功后自动推送到 Docker Hub

⁠🌍 多平台支持

镜像支持以下架构：

• ✅ linux/amd64 - x86_64 架构
• ✅ linux/arm64 - ARM64 架构（如 Apple Silicon）

拉取时会自动选择适合您系统的架构。

⁠📊 镜像大小

• 压缩大小: 约 800MB
• 解压后大小: 约 2GB

⁠🔐 安全性

• 定期更新基础镜像
• 及时更新依赖包
• 最小化安装范围
• 清理构建缓存

⁠📝 版本历史

⁠v3.0 (2026-01-29)

• ✨ 添加 whisper.cpp 支持
• ⬆️ 升级 Node.js 到 20.x
• 🐛 修复依赖问题

⁠v2.x

• 基础功能实现
• 集成 yt-dlp 和 ffmpeg

⁠🤝 贡献

如果您发现问题或有改进建议：

1. 访问 GitHub 仓库⁠
2. 提交 Issue 或 Pull Request
3. 查看 BUILD_GUIDE.md⁠ 了解构建详情

⁠📚 相关文档

• README.md⁠ - 项目总览
• BUILD_GUIDE.md⁠ - 构建指南
• GITHUB_ACTIONS_SETUP.md⁠ - CI/CD 配置

⁠💡 常见问题

⁠Q: 如何选择合适的标签？

A: 生产环境建议使用版本号标签（如 v3.0），开发环境可以使用 latest。

⁠Q: 镜像拉取速度慢怎么办？

A: 可以配置 Docker 镜像加速器，或使用国内的容器镜像服务。

⁠Q: 如何查看镜像的具体构建时间？

A: 使用 docker inspect difyz9/ytb2bili-base:latest 查看详细信息。

⁠Q: 支持哪些平台架构？

A: 支持 amd64 和 arm64，Docker 会自动选择匹配的架构。

⁠📧 联系方式

如有问题或建议，欢迎通过以下方式联系：

• GitHub Issues: ytb2bili-base/issues⁠
• Docker Hub: difyz9/ytb2bili-base⁠

Happy Coding! 🚀