biliup/README.md at 2c3592f1174e4e9d5cb07684dfa5e05f7c2d07d1

0 Fork 0

Files

T

ForgQi 03b7a84f55 Allow remote Web UI bootstrap with auth

This change updates the server default bind to 127.0.0.1 for safer local-only access while documenting how to expose the Web UI via --bind 0.0.0.0 --auth for remote or Docker use. It also removes the previous restriction that blocked first-time admin bootstrap on non-loopback addresses, allowing authenticated remote initialization and bumping the workspace version to 1.2.4.

2026-08-24 01:13:29 +08:00

8.6 KiB

Raw Blame History

🛠️ 功能

提供 skill，让你的 Agent 成为 up 主: npx skills add biliup/biliup
开箱即用，多种安装方式，提供可视化 WebUi 界面
多主播录制/上传，24X7 无人值守运行，高自定义元信息
作为自动化流程中的命令行工具封装使用

论坛：BBS

📜 更新日志

Important

Disclaimer / 免责声明

本项目仅供个人学习研究，不保证稳定性，不提供技术支持

使用本项目产生的一切后果由用户自行承担

禁止商业用途，请遵守版权及平台规定

This project is for personal learning and research purposes only

No stability guarantee or technical support provided

Users are solely responsible for any consequences of using this project

Commercial use is strictly prohibited

Please respect copyright and platform ToS

更新日志 »

📜 使用文档

B 站命令行投稿工具，支持短信登录、账号密码登录、扫码登录、浏览器登录以及网页Cookie登录，并将登录后返回的 cookie 和 token 保存在 cookie.json 中，可用于其他项目。

下载 Release: biliupR
获取命令帮助 biliup --help

文档地址：https://biliup.github.io/biliup-rs

Upload video to bilibili.

Usage: biliup [OPTIONS] <COMMAND>

Commands:
  login     登录B站并保存登录信息
  renew     手动验证并刷新登录信息
  upload    上传视频
  append    是否要对某稿件追加视频
  show      打印视频详情
  comments  查看视频评论
  reply     回复视频评论，默认只打印将要回复的内容
  dump-flv  输出flv元数据
  download  下载视频
  server    启动web服务，默认端口19159
  list      列出所有已上传的视频
  help      Print this message or the help of the given subcommand(s)

Options:
  -p, --proxy <PROXY>              配置代理
  -u, --user-cookie <USER_COOKIE>  登录信息文件 [default: cookies.json]
      --rust-log <RUST_LOG>        [default: tower_http=debug,info]
  -h, --help                       Print help
  -V, --version                    Print version

启动录制服务

启动web服务，默认端口19159

Usage: biliup server [OPTIONS]

Options:
  -b, --bind <BIND>            Specify bind address [default: 127.0.0.1]
  -p, --port <PORT>            Port to use [default: 19159]
      --auth                   开启登录密码认证
      --secure-session-cookie  为会话 Cookie 附加 Secure 属性。仅当通过 HTTPS 反向代理访问 Web UI 时开启； 直接通过 HTTP 远程访问时开启会导致浏览器丢弃登录态
  -c, --config <FILE>          使用 biliup 1.0.7 风格配置文件启动录制
  -h, --help                   Print help

Important

自 #1660 起，--bind 的默认值由 0.0.0.0 改为 127.0.0.1，即默认只监听本机，局域网/公网无法直接访问。如需从其他设备访问，请加上 --bind 0.0.0.0 --auth，详见下方「🔓 远程访问」一节。Docker 镜像已内置该参数，不受影响。

使用文档 »

🚀 快速开始

Windows

下载 Release: bbup-app_0.1.0_x64

Linux 或 macOS

安装 uv
安装：uv tool install biliup
启动：biliup server --auth
访问 WebUI：http://127.0.0.1:19159（默认只监听本机，远程访问见下方说明）

后台运行
1. nohup biliup server --auth &
2. 请查看参考

Termux

详见Wiki

🔓 远程访问（监听 0.0.0.0）

默认的 127.0.0.1 只允许本机访问。需要从其他设备访问时，显式指定 --bind 0.0.0.0 并开启 --auth：

biliup server --bind 0.0.0.0 --auth

首次打开 http://your-ip:19159 会引导设置管理员密码（用户名固定为 biliup），之后即可正常登录使用。

Note

绑定非回环地址时必须同时开启 --auth，否则会拒绝启动，避免无认证的 Web API 被暴露：
refusing to expose the unauthenticated Web API on 0.0.0.0:19159; use a loopback bind address or enable --auth

Warning

将 Web UI 暴露到公网存在风险，建议仅在可信局域网内使用，或置于反向代理之后。若通过 HTTPS 反向代理访问，请加上 --secure-session-cookie；直接以 HTTP 远程访问时不要加，否则浏览器会丢弃登录态（见 #1669）。

Docker

镜像已内置 --bind 0.0.0.0 --auth，开箱即用，无需额外配置：

docker compose up -d

打开 http://your-ip:19159 设置管理员密码即可。

Important

若要自定义 command，必须带上 --bind 0.0.0.0。容器内若监听 127.0.0.1，宿主机的端口映射无法转发进容器，Web UI 将完全无法访问。

🧑‍💻开发

架构概览

Rust后端 + 精简 Python 包 + Next.js前端的混合架构。

graph TB
    subgraph "🌐 前端层"
        UI[Next.js Web界面<br/>React + TypeScript<br/>Semi UI组件库]
    end

    subgraph "⚡ Rust后端服务"
        CLI[命令行与 Web API<br/>biliup-cli<br/>REST API / WebUI / 配置导入]
        CORE[核心库<br/>biliup<br/>直播解析 / 下载 / 上传]
        DANMAKU[弹幕库<br/>danmaku<br/>多平台协议 / XML输出]
        GEARS[Python绑定<br/>stream-gears<br/>python -m biliup 入口]
    end

    subgraph "🐍 Python包"
        PYENTRY[最小入口<br/>biliup.__main__<br/>调用 stream_gears.main_loop]
        PYUPLOAD[投稿库<br/>bili_webup / bili_webup_sync<br/>供外部项目调用]
    end

    subgraph "🗄️ 数据层"
        DB[(SQLite数据库<br/>配置存储<br/>任务状态 & 日志)]
        FILES[文件系统<br/>视频分段 / 弹幕XML<br/>缓存与临时文件]
    end

    subgraph "🌍 外部服务"
        BILI[Bilibili API<br/>视频上传服务]
        STREAMS[直播平台<br/>B站/斗鱼/虎牙/抖音/Twitch等]
    end

    UI --> CLI
    CLI --> CORE
    CLI --> DANMAKU
    CLI --> DB
    CLI --> FILES
    CORE --> STREAMS
    CORE --> BILI
    DANMAKU --> STREAMS
    DANMAKU --> FILES
    GEARS --> CLI
    PYENTRY --> GEARS
    PYUPLOAD --> BILI

    style UI fill:#e1f5fe
    style CLI fill:#f3e5f5
    style CORE fill:#f3e5f5
    style DANMAKU fill:#f3e5f5
    style GEARS fill:#f3e5f5
    style PYENTRY fill:#e8f5e8
    style PYUPLOAD fill:#e8f5e8
    style DB fill:#fff3e0
    style FILES fill:#fff3e0
    style BILI fill:#ffebee
    style STREAMS fill:#ffebee

frontend

确保 Node.js 版本 ≥ 18
安装依赖：npm i
启动开发服务器：npm run dev
访问：http://localhost:3000

Python

安装依赖 maturin dev
npm run build
启动 Biliup：python3 -m biliup

Rust-cli

npm run build
构建 cargo build --release --bin biliup
开发启动 BiliupR：cargo run

🤝Credits

Thanks ykdl, youtube-dl, streamlink provides downloader.
Thanks THMonster/danmaku.

💴捐赠

爱发电 »

8.6 KiB Raw Blame History Unescape Escape