BilibiliUpload项目使用指南：从入门到精通

BilibiliUpload项目使用指南：从入门到精通

biliup 项目地址: https://gitcode.com/gh_mirrors/bil/biliup

项目概述

BilibiliUpload是一套功能强大的工具集，专门为B站内容创作者设计，旨在简化视频上传和直播录制流程。该项目提供了比官方Web端和客户端更丰富的功能，包括多P投稿、线路选择、并发上传设置、直播自动录制以及视频搬运等实用特性。

核心功能

1. 多P视频上传：突破官方限制，支持多P视频批量上传
2. 智能线路选择：自动选择最优上传线路，提高上传效率
3. 直播自动录制：支持Twitch等多个平台的直播自动录制
4. 高级投稿设置：支持定时发布、动态关联等高级功能
5. 跨平台支持：兼容Windows、Linux和macOS系统

安装准备

基础环境要求

• Python 3.7或更高版本
• pip包管理工具
• 如需录制斗鱼平台，需额外安装JavaScript解释器（QuickJS或Node.js）

详细安装指南

标准安装流程

1. 创建配置文件：首先需要创建config.toml配置文件，示例如下：

[streamers."主播名称"]
url = ["https://www.twitch.tv/主播名称"]
tags = ["biliup"]

2. 安装Biliup：通过pip安装核心组件

pip3 install biliup

3. 基本操作命令：

# 启动服务
biliup start
# 停止服务
biliup stop
# 重启服务
biliup restart
# 查看版本
biliup --version

Docker部署方案

对于熟悉容器技术的用户，推荐使用Docker部署：

1. 拉取镜像运行：

docker run -P --name biliup -v /宿主机路径:/opt -d 镜像地址

2. 自定义构建：

cd biliup
docker build . -t biliup
docker run -P -d biliup

高级配置技巧

上传线路优化

B站上传支持多种线路模式：

• bup模式（国内常用）：

  • ws（网宿）
  • qn（七牛）
  • bda2（百度）

• bupfetch模式（国外推荐）：

  • kodo（七牛）
  • gcs（谷歌）
  • bos（百度）

建议根据服务器位置选择最优线路，国外云主机推荐使用kodo线路。

登录验证方案

项目支持两种登录方式：

1. 浏览器模拟登录：处理滑动验证码等复杂情况
2. OAuth2接口登录：需要逆向分析获取密钥

推荐使用命令行工具获取cookies.json文件实现持久化登录。

开发者指南

插件开发

项目采用模块化设计，支持自定义插件扩展：

1. 下载插件开发： 继承base_adapter.py中的基类，使用@Plugin.download装饰器注册

2. 上传插件开发： 继承上传基类，使用@Plugin.upload装饰器注册

事件驱动框架

项目内置事件驱动框架，可监听特定事件实现自定义逻辑：

@event_manager.register("download_finish", block=True)
def custom_processing(data):
    # 自定义处理逻辑
    pass

系统集成方案

Linux开机自启

通过systemd实现服务化管理：

1. 创建service文件：

nano ~/.config/systemd/user/biliupd.service

2. 配置示例：

[Unit]
Description=Biliup Startup
After=network-online.target

[Service]
Type=simple
WorkingDirectory=/配置目录
ExecStart=/usr/bin/biliup -v

[Install]
WantedBy=default.target

3. 启用服务：

systemctl --user enable biliupd
systemctl --user start biliupd

最佳实践建议

1. 资源管理：根据服务器配置合理设置并发数，避免磁盘IO瓶颈
2. 日志监控：定期检查日志文件，确保录制和上传任务正常执行
3. 弹幕处理：录制生成的XML弹幕文件可通过工具转换为ASS字幕，增强观看体验
4. 故障恢复：项目内置重试机制，下载失败会自动重试3次

注意事项

1. 多P上传功能受B站账号权重影响，等级>3且粉丝>1000的账号限制较少
2. ARM平台用户需注意stream-gears版本兼容性问题
3. 配置文件支持toml和yaml两种格式，建议使用toml以获得更好可读性
4. 项目持续更新，建议定期检查版本更新获取最新功能

通过本指南，您应该已经掌握了BilibiliUpload项目的核心功能和使用方法。无论是个人创作者还是专业UP主，都能借助这套工具显著提升内容发布效率，专注于创作本身而非技术细节。

biliup 项目地址: https://gitcode.com/gh_mirrors/bil/biliup