v1.2.6 · 开源免费

上手 biliup

直播录制、自动投稿、WebUI 管理 —— 一个命令行工具，几分钟跑通第一条视频。

docker run -d --name biliup --restart unless-stopped -p 19159:19159 -v "$PWD/data":/opt ghcr.io/biliup/caution:latest server --bind 0.0.0.0 --auth

选择安装方式跑通首次投稿

⚠️ 首次使用必读（3 条高频踩坑）

1. 默认只录不传，且可能删除录像：新建主播默认上传器为 Noop（只录制不上传），且默认带 rm 后处理。直接用默认配置，录完的文件可能被删除，请先跟着首次录制并投稿建好投稿模板再正式使用。
2. 默认只监听本机：biliup server 的 --bind 默认是 127.0.0.1，其他设备访问不了。需要远程访问请用 biliup server --bind 0.0.0.0 --auth（不加 --auth 会拒绝启动）。
3. WebUI 管理员用户名固定为 biliup：开启 --auth 后首次访问设置密码，不是在终端生成，也别和 B站投稿账号混淆。忘记密码需重置数据库（会丢失全部配置）。
4. 别把 19159 直接暴露公网，并定期备份：至少开启 --auth，有域名建议反代 + HTTPS；B站 Cookie 约 1-3 个月过期（过期后 WebUI 重新扫码即可），配置与 Cookie 都在数据目录，请定期备份。

安装方式

🐧Linuxuv 一键安装，可注册 systemd 服务→🪟Windows下载 exe 直接运行→🐳Docker官方镜像，一键起服务→🍎macOSuv 安装，支持 Apple Silicon→

其他环境： Termux · Docker 进阶部署 · FFmpeg 安装

下一步：跑通第一次录制与投稿

装好之后，直接跟着工作原理与快速引导走一遍「启动 → 登录 → 建投稿模板 → 绑定主播 → 完成录制投稿」。这是唯一一条需要按顺序做完的路径，做完之后 biliup 就能无人值守运行了。

只想手动下一次命令行，不看 WebUI：命令行参考

日常使用

⌨️命令行参考子命令与参数说明、常用示例→🖱️WebUI 使用指南空间配置、主播管理、投稿模板→⚙️全局设置下载器、分段、上传与后处理策略→📡各平台设置斗鱼 / 虎牙 / B站 等平台专属参数→🎬按平台查看各平台单独的链接格式与注意事项→🔐登录与凭据B站投稿账号与录制平台 Cookie→

深入了解

📺平台总览19 个内置平台一览与弹幕支持矩阵→🏗️系统架构Rust 引擎 + WebUI 的分层结构→🖥️桌面客户端biliup-app：投稿与稿件管理→🔌REST API接口清单与调用示例→

运维与帮助

❓常见问题安装、录制、上传分类解答→🆘帮助与反馈提问技巧、反馈渠道、日志排查→🏢生产部署基线固定版本、健康检查、备份回滚→🔒安全与运维认证边界、网络暴露、备份恢复→

⚠️ 使用声明

1. 仅供个人学习与研究使用，使用本工具所产生的一切后果由使用者自行承担；
2. 严禁录制、上传任何侵犯他人版权或违反平台规定的内容；
3. 本项目不保证稳定性，不提供任何形式的技术支持与担保；
4. 请在使用前仔细阅读并遵守 B 站及相关平台的服务条款与当地法律法规；
5. 仓库 LICENSE 为 MIT，但上游 README 的免责声明中另写有「禁止商业用途」，两者尚未澄清，商用前请以维护者官方说明为准。

本文档对应 biliup v1.2.6，更新可能不及时，请以 biliup 主仓库实际代码为准 · 桌面客户端（biliup-app）在独立仓库维护