常见问题

安装、录制、上传、WebUI、配置分类解答。如有其他问题欢迎到 GitHub Issues 反馈。

---

安装相关

提示找不到 biliup 命令？

• 检查 uv 是否正确安装：uv --version
• 检查 pip 是否正确安装：pip3 --version
• Docker 用户确认容器已启动：docker ps -a

Windows 下 .exe 无法运行？

• 确认下载的是最新版 biliup.exe
• 检查杀毒软件是否拦截

---

录制相关

只能录制 5 个主播，第 6 个不工作？

• 默认下载线程池大小为 5。修改「空间配置」→「下载线程池大小 (pool1_size)」后重启 biliup。

快手录制不稳定？

• 快手风控严格，目前没有完美的解决方案。

HLS 流不会录制（如 B站 APEX 分区）？

• 下载器改为 streamlink，安装 FFmpeg，配置 Cookie 和协议为 hls_fmp4。

境外服务器录制 B站？

• 需要自备国内机器反代 https://api.live.bilibili.com，将反代地址填入「各平台设置」→「哔哩哔哩」→「直播主 API」。

---

上传相关

配置了自动上传但没有上传行为？

• 检查模板中「上传插件」是否为 biliup-rs（非默认的 Noop）。
• 检查文件名模板是否包含 {streamer}，缺少此标识符将无法识别。

上传日志出现 Retry attempt？

• 调整上传并发数，从 1 开始逐渐增加。

上传速度慢？

• B站上传速度主要取决于上行带宽，国内用户使用境外服务器通常更快。

边录边传对机器要求高吗？

• 极低：1核 0.5G 内存即可同时录制 10 个直播间。但需要稳定上传带宽。

---

画质相关

录制画质模糊/不高？

• 户外主播码率不稳定，属于源流问题。
• 部分平台（如抖音）需要 Cookie 才能拉取最高画质。
• B站会对上传视频进行二压，原视频 10000 码率上传后可能只有 6000。

---

WebUI 相关

无法访问 WebUI？

• 确认端口 19159 未被防火墙/安全组拦截。
• 检查 biliup server 是否正确启动。
• Docker 用户确认端口映射正确。

修改配置后不生效？

• 全局设置修改后必须重启 biliup。

docker 容器数据丢失？

• 确保挂载了 /opt 目录：-v /你的目录:/opt。

---

配置相关

如何启用自动投稿？

• 进入「空间配置」→ 在模板中将「上传插件」从 Noop 改为 biliup-rs。

如何添加多个 B站账号？

• 进入「投稿管理」→ 点击左上角图标 →「新增」→ 扫码登录。

如何修改录制保存路径？

• 修改 biliup server 的运行目录，或 Docker 用户修改 -v 挂载路径。