Windows 安装教程

INFO

• 测试系统为 Windows 10+，Win7 或 Windows Server 旧版可能产生意料之外的错误。
• 不推荐使用主力机进行操作，你永远不知道windows为什么会杀掉你的进程。

---

方法一：运行 .exe 文件（推荐，无需环境）

biliup 提供了预编译的 .exe 文件，无需安装 Python 即可直接运行。

1. 下载

访问 biliup Releases 页面，在最新版本的 Assets 中下载 biliup.exe。

2. 运行

将下载的 .exe 文件放在一个独立文件夹内（如 D:\biliup\），双击运行即可。

INFO

.exe 所在的目录就是录播文件、配置文件的默认存储目录。

Windows 11 运行 .exe 后可能弹出防火墙窗口，请点击「允许」放行。

3. 使用参数启动

即使是 .exe 文件，也可以通过命令行传递参数：

# 启动 WebUI（--auth 开启登录认证，首次访问时注册管理员账号）
D:\biliup\biliup.exe server --auth

启动后浏览器访问 http://localhost:19159。

---

方法二：使用 winget 安装（Windows 11）

Windows 11 用户可通过系统自带的 winget 包管理器一键安装命令行版本：

winget install biliup

安装后验证：

biliup --version

💡 winget 安装的是命令行版本，如需图形界面请使用方法四（biliup-app 桌面应用）。

---

方法三：使用 uv 安装

先安装 Python（推荐 3.11+），然后：

# 安装 uv（PowerShell）
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# 安装 biliup
uv tool install biliup

# 启动
biliup server --auth

---

方法四：biliup-app（Tauri 桌面应用，推荐小白用户）

biliup-app 将 WebUI 打包为原生桌面客户端，打开即运行，无需命令行操作。

1. 前往 Releases
2. 下载 bbup-app_x.y.z_x64-setup.exe（或 .msi）
3. 运行安装程序，按提示完成安装
4. 从开始菜单或桌面快捷方式启动

详细使用说明请参阅 biliup-app 文档。

---

方法五：预编译二进制（高级用户）

适用于不希望安装 uv 或 winget 的场景。

1. 前往 Releases
2. 根据 CPU 架构下载对应文件：
   • x64（大多数 PC）：biliupR-v1.x.x-x86_64-windows.zip
   • ARM64（Surface Pro X 等）：biliupR-v1.x.x-aarch64-windows.zip
3. 解压到任意目录（如 D:\biliup\）
4. 双击 biliup.exe 运行

---

代理配置（录制国外平台）

Windows 终端默认不走系统代理。如需录制 YouTube、Twitch 等国外平台：

• 推荐方式：在代理软件中开启 TUN 模式 或 全局 VPN 模式。
• 备用方式：参考 Windows 终端代理配置教程。