Windows 安装教程
INFO
- 测试系统为 Windows 10+,Win7 或 Windows Server 旧版可能产生意料之外的错误。
- 不推荐使用主力机进行操作,你永远不知道 Windows 为什么会杀掉你的进程。
方法一:运行预编译 CLI(Rust 构建,无需 Python)
biliup 在 Releases 的 Assets 中提供预编译的 Rust CLI 压缩包,无需安装 Python。
WARNING
Rust CLI 是一个命令行程序,必须带子命令运行。直接双击 biliup.exe 不会自动启动 WebUI(窗口会一闪而过)。请通过终端执行 biliup.exe server 启动服务,详见下方「3. 使用参数启动」。若想要「双击即运行」的体验,请改用方法四:biliup-app 桌面应用 或方法三:uv 安装。
1. 下载
访问 biliup Releases 页面,在最新版本的 Assets 中下载对应架构的压缩包:
- x64(大多数 PC):
biliupR-v1.x.x-x86_64-windows.zip - ARM64(Surface Pro X 等):
biliupR-v1.x.x-aarch64-windows.zip
解压后得到 biliup.exe(Rust 命令行可执行文件)。
2. 放置
将解压出的 biliup.exe 放在一个独立文件夹内(如 D:\biliup\)。
INFO
biliup.exe 所在的目录就是录播文件、配置文件的默认存储目录。
3. 使用参数启动
在 biliup.exe 所在目录打开终端(PowerShell / CMD),执行:
# 启动 WebUI(--auth 开启登录认证;首次访问时管理员用户名固定为 biliup,请设置密码)
D:\biliup\biliup.exe server --auth启动后浏览器访问 http://localhost:19159。
INFO
Windows 11 运行 biliup.exe 后可能弹出防火墙窗口,请点击「允许」放行对应端口(默认 19159)。
方法二:使用 winget 安装(Windows 11)
Windows 11 用户可通过系统自带的 winget 包管理器一键安装命令行版本:
winget install biliup安装后验证:
biliup --version💡
winget安装的是命令行版本(Rust CLI),启动同样需要server子命令:biliup server --auth。如需图形界面请使用方法四(biliup-app 桌面应用)。
方法三:使用 uv 安装
先安装 Python(推荐 3.11+),然后:
# 安装 uv(PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
# 安装 biliup
uv tool install biliup
# 启动(uv 安装的入口会自动补 server 子命令,直接 biliup 即可;显式写法为 biliup server --auth)
biliup server --auth方法四:biliup-app(Tauri 桌面应用,推荐小白用户)
biliup-app 将 WebUI 打包为原生桌面客户端,打开即运行,无需命令行操作。
- 前往 Releases
- 下载
bbup-app_x.y.z_x64-setup.exe(或.msi) - 运行安装程序,按提示完成安装
- 从开始菜单或桌面快捷方式启动
详细使用说明请参阅 biliup-app 文档。
方法五:预编译二进制(高级用户)
适用于不希望安装 uv 或 winget 的场景(本质上与方法一相同的 Rust CLI)。
- 前往 Releases
- 根据 CPU 架构下载对应文件:
- x64(大多数 PC):
biliupR-v1.x.x-x86_64-windows.zip - ARM64(Surface Pro X 等):
biliupR-v1.x.x-aarch64-windows.zip
- x64(大多数 PC):
- 解压到任意目录(如
D:\biliup\) - 通过终端启动(不要直接双击,Rust CLI 需子命令):
D:\biliup\biliup.exe server --auth代理配置(录制国外平台)
Windows 终端默认不走系统代理。如需录制 YouTube、Twitch 等国外平台:
- 推荐方式:在代理软件中开启 TUN 模式 或 全局 VPN 模式。
- 备用方式:参考 Windows 终端代理配置教程。