BitComet WebUI 远程管理 — 浏览器控制家里的下载任务

什么是 WebUI

WebUI 是 BitComet 内置的一个轻量级 Web 服务器——开启后，你可以在任何设备的浏览器里访问 http://你电脑的IP:端口，就像打开普通网页一样管理家里 BitComet 上的所有下载任务。

想象一下这个场景：你在公司用手机或电脑，突然想起家里的 BitComet 正在下载一个大文件——想看看进度、想加一个新任务、想暂停某个太吃带宽的做种任务。用 WebUI 都能搞定，不需要远程桌面、不需要 TeamViewer。

开启与安全配置

步骤一：开启 WebUI

BitComet 主界面 → 选项 → 高级设置。
在搜索框里输入 webui，找到以下配置项：

键名	默认值	建议值	说明
`webui.enable`	false	true	总开关
`webui.port`	18080	自定义（如 28080）	WebUI 监听端口，不要用默认值
`webui.username`	admin	自定义用户名	登录用户名，不要用 admin
`webui.password`	空（无密码）	强密码	必须设置，空密码等于把家里下载面板给全世界看
`webui.allow_remote`	false	true	允许外网访问（只局域网用可以保持 false）
`webui.https`	false	true（如果有证书）	用 HTTPS 加密连接

修改完成后保存，BitComet 会自动重启 WebUI 服务（不需要重启整个 BitComet）。

步骤二：防火墙与端口映射

如果希望外网能访问 WebUI：

Windows 防火墙：BitComet 开启 WebUI 时会自动请求添加防火墙入站规则。如果没自动添加，手动加：新建入站规则 → TCP → 允许特定端口（你设置的 WebUI 端口）→ 允许 → 所有配置文件 → 命名为"BitComet WebUI"。
路由器端口映射：如果家里用路由器上网，需要把路由器 WAN 口的一个端口转发到电脑内网 IP 的 WebUI 端口。详见"端口映射与 UPnP"专门文章。
DDNS：如果家用宽带 IP 是动态变化的（绝大多数都是），建议装一个 DDNS 服务（花生壳、阿里云 DDNS、Cloudflare Tunnel 等），给家里分配一个固定域名。这样外网访问用域名而不是 IP，IP 变了也不影响。

只在局域网用就简单多了——打开防火墙放行即可，不需要路由器端口映射和 DDNS。局域网内直接用电脑内网 IP（比如 192.168.1.105:28080）访问。

步骤三：测试

本机浏览器测试：在运行 BitComet 的电脑上打开浏览器，访问 http://127.0.0.1:端口。能看到登录页面说明 WebUI 已经跑起来了。
局域网测试：同一局域网内的另一台设备上访问 http://内网IP:端口。
外网测试：手机关 Wi-Fi 用 4G/5G 访问 http://公网IP:端口。能打开 = 端口映射和防火墙都对了。

连接 BitComet 内置视频播放器

这是一个容易被忽略的功能——BitComet 的 WebUI 可以直接调用浏览器或外部视频播放器播放正在下载的视频文件：

在 WebUI 里选中一个正在下载或已完成的视频任务。
点击任务详情里的"预览"或"播放"按钮。
WebUI 会尝试用浏览器内置的视频播放器（HTML5 <video> 标签）播放——大部分主流格式（MP4、WebM、TS 等）都能直接播。
如果浏览器不支持该格式（AVI、RMVB、MKV 等），会弹出提示让你下载文件或用外部播放器。

这个功能配合"边下载边播放"特别好用——在公司用手机就能一边看家里正在下的视频，不用等下载完。

WebUI 的功能边界

WebUI 不是 BitComet 完整 GUI 的一比一复刻，它的设计目标是轻量远程控制。能用 WebUI 做的事：

✅ 查看所有任务的实时状态（进度、速度、对等者数量等）
✅ 添加新任务（粘贴磁链、HTTP/FTP URL、上传 torrent 文件）
✅ 暂停/继续/删除/重排任务优先级
✅ 修改单个任务的限速值
✅ 预览/播放正在下载的视频
✅ 查看日志和错误信息

不能用 WebUI 做的事：

❌ 修改全局选项（限速、缓存、连接数等）
❌ 创建/管理标签
❌ 制作 torrent 文件
❌ 登录通行证或查看通行证积分
❌ 打开文件所在目录（WebUI 在远程，不知道远程电脑的文件系统）
❌ 应用商店式的浏览和搜索

所以 WebUI 是"远程控制台"而不是"远程完整克隆"——简单操作足够，深度配置还是得坐在电脑前用 GUI。

HTTPS 加密（重要）

如果在外网访问 WebUI，强烈建议开启 HTTPS。明文 HTTP 意味着你的 WebUI 密码、控制指令、甚至任务名都会在公网上裸奔——任何中间人都能看到甚至篡改。

方法一：让 BitComet 自带自签名证书

高级设置里找到 webui.https.enable 设为 true。
BitComet 会自动生成一个自签名证书。
浏览器访问时会提示"证书不受信任"——这是正常的，点"高级 → 继续访问"即可（在只有自己用的前提下）。
想消除警告？可以自签一个 CA、把它加入操作系统的信任根——但对大多数用户来说太折腾。

方法二：用 Cloudflare Tunnel 或内网穿透工具

更现代的做法——用 Cloudflare Tunnel 或 frp、ngrok 等工具把本地 WebUI 暴露到一个 HTTPS 域名下。Cloudflare Tunnel 完全免费、自带 HTTPS、不需要路由器端口映射（隧道是从你家里主动连出去的，绕过了防火墙和端口映射）。

安全注意事项

必须做的

设置强密码——不要用默认的 admin / admin。
换默认端口——不要用 18080，改成一个随机高位端口（比如 31808）。
HTTPS 加密——外网访问一定开 HTTPS。
定期检查访问日志——如果有人在暴力破解你的 WebUI，日志里会出现大量失败登录尝试。

可选但推荐的

IP 白名单：如果 WebUI 只在手机用，可以把你手机的公网 IP 加进白名单，其他 IP 一律拒绝。高级设置里有 webui.allowed_ips 项。
双因子认证：BitComet 原生不支持 TOTP 等 2FA，但可以通过 Cloudflare Access 等上层方案间接实现。
不在公网暴露 WebUI：如果只有自己用，始终只在局域网访问，通过 VPN（WireGuard / OpenVPN）回家时顺便访问 WebUI。这比直接把 WebUI 暴露在公网安全得多。

移动端体验

BitComet 官方没有出专门的 WebUI 移动版界面，但 WebUI 本身的响应式做得还行——用手机浏览器打开后布局会自动适配小屏。如果觉得默认 WebUI 在手机上不好用，有几个第三方 WebUI 前端（搜索 "BitComet WebUI mobile" 可以找到），但需要额外部署、安全性也要自己评估。

常见问题

外网访问不了 WebUI

按以下顺序排查：

本机能不能用 http://127.0.0.1:端口 打开 WebUI？→ 能 = BitComet WebUI 服务正常。
同一局域网的另一台设备能不能用内网 IP 打开？→ 能 = Windows 防火墙已放行。不能 = 检查防火墙规则。
路由器端口映射有没有生效？→ 进路由器管理界面看端口转发状态。
你家宽带是不是 CGNAT（运营商级 NAT）？→ 如果是，直接从公网打过来的连接会被运营商挡住——用 Cloudflare Tunnel 或 VPN 绕过。

手机上 WebUI 加载很慢

带宽问题：WebUI 本身很轻（只有几 KB 的 HTML + 少量 JS），但任务列表会每几秒刷新一次——几十个任务的 JSON 数据量不小。
延迟问题：从手机外网到家里的 WebUI 延迟通常 50~200ms（取决于两地距离和运营商），不是 WebUI 本身慢。
优化：关闭 BitComet 的实时速度图表显示（高级设置里找 webui.show_charts 设为 false），能减少每次刷新的数据量。

想让 WebUI 显示中文

高级设置里找到 webui.language 设为 zh_CN（或 zh_TW）。默认跟随 BitComet 主程序的界面语言。