BiliBiliToolPro 项目配置详解与最佳实践指南

一、配置方式概述

BiliBiliToolPro 提供了多种灵活的配置方式，开发者可以根据实际使用场景选择最适合的配置方法。

1.1 配置文件方式（推荐本地使用）

项目默认提供三种环境配置文件：

• appsettings.json：基础配置文件
• appsettings.Development.json：开发环境专用
• appsettings.Production.json：生产环境专用

对于大多数用户，建议直接修改 appsettings.Production.json 文件。配置格式采用标准的 JSON 结构，修改后保存即可生效。

1.2 命令行参数方式

在启动程序时，可以通过命令行参数动态配置：

dotnet Ray.BiliBiliTool.Console.dll -cookieStr=your_cookie -numberOfCoins=3

Windows 自包含包用户：

Ray.BiliBiliTool.Console.exe -cookieStr=your_cookie -numberOfCoins=3

Linux 自包含包用户：

./Ray.BiliBiliTool.Console -cookieStr=your_cookie -numberOfCoins=3

1.3 环境变量方式（推荐）

所有配置项都支持通过环境变量设置，这是最灵活的配置方式：

Windows 示例：

set Ray_BiliBiliCookies__1=your_cookie
set Ray_DailyTaskConfig__NumberOfCoins=3

Linux 示例：

export Ray_BiliBiliCookies__1=your_cookie
export Ray_DailyTaskConfig__NumberOfCoins=3

1.4 容器化环境配置

在容器化环境中（如青龙面板），可以通过环境变量页或配置文件页进行配置。环境变量页配置会立即生效，而配置文件页修改需要重启容器。

二、配置优先级规则

多种配置方式按优先级从高到低排序：

1. 命令行参数
2. 环境变量
3. 配置文件

高优先级配置会覆盖低优先级配置，这为不同环境下的配置管理提供了极大灵活性。

三、核心配置详解

3.1 Cookie 配置（必填项）

Cookie 是身份验证的关键，获取方法：

1. 登录 B 站网页版
2. 打开开发者工具（F12）
3. 在 Network 标签中找到任意请求
4. 复制 Cookie 头部的值

多账号支持：

"BiliBiliCookies": {
  "1": "cookie1_value",
  "2": "cookie2_value"
}

3.2 安全配置

3.2.1 请求频率控制

"Security": {
  "IntervalSecondsBetweenRequestApi": 20,
  "IntervalMethodTypes": "POST"
}

建议保持默认值，避免请求频率过高触发风控。

3.2.2 随机延迟

"RandomSleepMaxMin": 20

设置程序启动后的随机延迟时间（分钟），避免固定时间执行显得过于机械化。

3.3 每日任务配置

3.3.1 投币策略

"DailyTaskConfig": {
  "NumberOfCoins": 5,
  "SelectLike": false,
  "SupportUpIds": "12345,67890"
}

• 每日最多投5个硬币
• 可选择是否同时点赞
• 支持优先为指定UP主投币

3.3.2 自动充电

"DayOfAutoCharge": -1,
"AutoChargeUpId": -1

• -1 表示月底自动充电
• 可指定为特定UP主充电

3.4 天选时刻抽奖

3.4.1 奖品过滤

"ExcludeAwardNames": "舰|船|代金券",
"IncludeAwardNames": "大会员|实物"

可设置排除和包含的奖品关键词，精准控制参与抽奖的类型。

3.5 消息推送配置

3.5.1 即时通讯推送

"Serilog": {
  "WriteTo": [
    {
      "Name": "InstantMessaging",
      "Args": {
        "botToken": "your_bot_token",
        "chatId": "your_chat_id"
      }
    }
  ]
}

3.5.2 企业微信推送

"webHookUrl": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=your_key"

四、最佳实践建议

1. 多账号管理：使用环境变量方式配置多个账号的Cookie，便于管理和切换。

2. 安全策略：

   • 保持默认的请求间隔
   • 启用随机延迟
   • 配置合理的User-Agent

3. 任务优化：

   • 设置优先支持的UP主列表
   • 合理配置每日投币数量
   • 根据需求开启/关闭特定任务

4. 消息推送：

   • 推荐使用即时通讯或企业微信
   • 配置多个推送渠道确保消息可达
   • 开启单账号独立推送便于问题排查

通过合理配置，BiliBiliToolPro 可以高效稳定地运行，自动化完成各项B站任务，同时保持良好的账号安全状态。建议初次使用时先进行小规模测试，确认配置无误后再长期运行。