哔哩哔哩推送插件教程哔哩哔哩推送插件教程
BilibiliPush_Cedar
BilibiliPush_Cedar
  • 快速开始

QQ群:219014255

你需要准备什么

  • 一套可用的 OneBot V11 服务端(你的 QQ 机器人框架/协议端),并确保:
    • WebSocket 正向地址可连接(用于接收事件)
    • HTTP API 地址可访问(用于发送消息)
  • Google 谷歌浏览器的安装 用于动态图片的生成,当然你可以不选择图片生成,失败后会默认采用文字模板生成
  • 本程序的配置文件:程序目录下 config.yml

提示

本程序仅负责 订阅与推送逻辑 + Web 管理后台,消息的收发依赖你的 OneBot 服务端。

程序下载

你可以在主页或下方链接获取最新版本下载方式。

  • 前往下载说明:点此查看详细下载教程 & 最新链接
  • Windows 直链:
    更新器下载
    http://cb.cedarx.cn/update_bilibili/update_bilibili_win10.zip
    或
    压缩包下载
    http://cb.cedarx.cn/update_bilibili/Bilibili_1.0.2.zip
    
    
  • Linux 直链:
    更新器下载
    http://cb.cedarx.cn/update_bilibili/update_bilibili_linux.zip
    或
    压缩包下载
    http://cb.cedarx.cn/update_bilibili/BilbiliPush_Linux_1.0.2.zip
    
    

注意

若遇“未知发布者”/“下载失败”等问题,请参考 下载 底部的 FAQ 说明。


Google 下载安装

  • Windows: 你可以前往 Google 官网下载安装 Google 获取前往群文件下载
  • Linux: 前往群文件下载 ,或者自己百度安装

如何启动主程序

  • Windows:
    解压后,双击运行 bilibili.exe,或在命令行中运行。

  • Linux:
    解压后,赋予权限: 最好是直接赋予整个目录权限

    比如BilibiliPush当前路径是/home/cedar/BilibiliPush 路径可以使用命令 pwd 查看

    执行:

    sudo chmod -R 777 /home/cedar/BilibiliPush
    

    然后运行主程序:

    ./bilibili
    

    或者运行sh脚本,注意别用 sudo 启动

    sh cedar_push.sh start
    

    停止和重启命令

    sh cedar_push.sh stop
    sh cedar_push.sh restart
    

提示

首次运行会根据配置自动连接 OneBot 服务端并启动 Web 管理后台。

提示

因为群文件提供的整合包可能没包括 config.yml 在执行一次 bilibili 后会在当前路径生成一个 config.yml 编辑后再次启动即可

第一次运行(建议按顺序)

  1. 配置 OneBot 连接信息

    • 打开 config.yml
    • 填写/确认:
      • websocket.url:OneBot 的 WebSocket 地址(示例:ws://127.0.0.1:3001)
      • http.api_url:OneBot 的 HTTP API 地址(示例:http://127.0.0.1:3000)
      • 如 OneBot 设置了 token,同步填写 access_token
  2. 配置 Web 管理后台地址(可选)

    • web.host:默认 127.0.0.1 改为 0.0.0.0 可以让局域网/外网访问(外网需公网)
    • web.port:默认 5068
  3. 配置 Chrome 路径(推荐)

    • chrome.executable_path:用于动态图片生成/渲染。
    • 如果你的系统没有安装 Chrome 或安装路径非默认,建议填写为绝对路径。
  4. 启动程序

    • 正常启动后,程序会连接 OneBot,并启动推送与 Web 管理后台。
  5. 按提示完成 B 站登录

    • 首次运行一般会引导进行 二维码登录。
    • 登录成功后,会保存登录信息,后续通常无需重复登录。

打开 Web 管理后台

在浏览器访问:

  • http://{web.host}:{web.port}/#/login
  • 如: http://127.0.0.1:5068/#/login

默认账号密码在 config.yml 的 web.admin.username / web.admin.password 中配置。

立刻验证是否可用

  • 验证 1:后台能打开
    • 能进入登录页并成功登录
  • 验证 2:命令能响应
    • 私聊机器人发送:直播列表 或 动态列表
    • 没有订阅时会提示“暂无列表”
  • 验证 3:订阅能成功
    • 私聊发送:订阅动态 hanser(填写任意 UP 的 UID 或用户名)
    • 或群里发送:群订阅直播 hanser(房间号/UID/用户名均可尝试)

继续阅读

  • 下一篇:命令使用
  • 下载:下载
  • 配置:配置说明
  • 后台:Web管理后台
  • 更新:自动更新
  • 排障:常见问题FAQ