injectrl/biliclonline

BiliCommentLottery Online 镜像文档

概述

BiliCommentLottery Online 是一个基于Docker容器化的B站评论抽奖工具，旨在帮助UP主及运营人员快速实现从指定B站视频评论区中随机抽取获奖者的功能，简化抽奖流程并确保结果公平性。

核心功能

• 评论数据获取：自动爬取指定B站视频的全部评论数据（含楼中楼评论）
• 随机抽奖：基于伪随机算法从评论中抽取指定数量获奖者
• 规则自定义：支持排除UP主自身评论、设置抽奖数量、过滤特定关键词评论
• 结果导出：支持将抽奖结果导出为CSV或JSON格式文件
• 轻量部署：Docker容器化封装，无需复杂环境配置，即开即用

使用场景

• B站UP主举办视频互动抽奖活动
• 品牌方在B站评论区开展用户回馈活动
• 社区运营需要从评论区随机选取用户参与后续活动
• 教学演示或测试环境中模拟评论抽奖场景

使用方法

环境要求

• Docker Engine 20.10+
• 可访问B站API的网络环境（国内网络直接访问，海外网络需配置代理）

快速启动命令

bash
docker run -d \
  --name bili-comment-lottery \
  -e VIDEO_ID="BV1xx4y1z789" \  # 目标B站视频的BV号或AV号
  -e LOTTERY_NUM=5 \             # 抽奖数量，默认1
  -e EXCLUDE_UP=true \           # 是否排除UP主自身评论，默认true
  -v $(pwd)/results:/app/output \ # 挂载结果输出目录
  bili-comment-lottery:latest

环境变量配置说明

高级配置（通过配置文件）

1. 创建本地配置文件 config.yaml：

yaml
video_id: "BV1xx4y1z789"
lottery_num: 3
exclude_up: true
filter_keywords: ["抽奖", "福利", "测试"]
output_format: "json"
proxy_url: "http://127.0.0.1:7890"

2. 通过配置文件启动容器：

bash
docker run -d \
  --name bili-comment-lottery \
  -v $(pwd)/config.yaml:/app/config.yaml \
  -v $(pwd)/results:/app/output \
  bili-comment-lottery:latest --config /app/config.yaml

结果查看与导出

抽奖完成后，结果文件将保存至挂载的本地目录（如./results），文件命名格式为lottery_result_YYYYMMDDHHMMSS.xxx（xxx为配置的输出格式）。示例CSV结果格式：

用户ID,用户名,评论内容,评论时间,是否中奖
12345678,用户A,"支持UP主！",2023-10-01 12:00:00,true
87654321,用户B,"期待抽奖结果",2023-10-01 12:05:30,false

常见问题排查

• 问题：容器启动后无结果输出
  解决：检查VIDEO_ID是否有效，通过docker logs bili-comment-lottery查看日志，确认网络是否可访问B站API

• 问题：评论数量与实际不符
  解决：B站API存在评论分页限制，工具默认获取前1000条评论，如需更多可通过配置MAX_COMMENTS参数调整（最大值5000）

• 问题：导出文件为空
  解决：检查目标视频是否有评论，或是否因关键词过滤导致无符合条件的评论