{"id":17300691,"url":"https://github.com/gnattu/bbdown-webui","last_synced_at":"2025-07-13T01:09:15.012Z","repository":{"id":207178825,"uuid":"718616401","full_name":"gnattu/bbdown-webui","owner":"gnattu","description":"BBDown的自建WebUI","archived":false,"fork":false,"pushed_at":"2024-03-27T05:54:43.000Z","size":2410,"stargazers_count":40,"open_issues_count":0,"forks_count":7,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-28T00:41:49.550Z","etag":null,"topics":["bbdown","bilibili","bilibili-download"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gnattu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-11-14T13:07:01.000Z","updated_at":"2025-03-25T09:39:34.000Z","dependencies_parsed_at":"2024-11-08T04:03:09.126Z","dependency_job_id":"41c881a4-11b4-4142-a354-d14de89d4766","html_url":"https://github.com/gnattu/bbdown-webui","commit_stats":null,"previous_names":["gnattu/bbdown-webui"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnattu%2Fbbdown-webui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnattu%2Fbbdown-webui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnattu%2Fbbdown-webui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gnattu%2Fbbdown-webui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gnattu","download_url":"https://codeload.github.com/gnattu/bbdown-webui/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248870074,"owners_count":21174978,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bbdown","bilibili","bilibili-download"],"created_at":"2024-10-15T11:29:47.336Z","updated_at":"2025-04-14T11:25:00.224Z","avatar_url":"https://github.com/gnattu.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BBDown WebUI\n\nBBDown WebUI是一个Web前端，适用于[BBDown](https://github.com/nilaoda/BBDown)的[JSON API](https://github.com/nilaoda/BBDown/blob/master/json-api-doc.md)模式。旨在方便将BBDown作为自建服务使用。\n\n## 特性\n\n- 不使用服务端框架，仅需简单的 HTTP 服务器提供静态文件\n- 响应式布局设计，兼容计算机和移动设备\n- 简洁的界面设计，专注于核心功能\n- 可修改的用户配置文件，允许更改BBDown所有命令行选项的默认值\n\n## 截图\n\n### 电脑\n\n| 深色模式 | 浅色模式 |\n| --- | --- |\n| ![深色模式 - 电脑](./doc/images/tasks-pc-dark.png) | ![浅色模式 - 电脑](./doc/images/tasks-pc-light.png) |\n| ![深色模式 - 电脑](./doc/images/add-task-pc-dark.png) | ![浅色模式 - 电脑](./doc/images/add-task-pc-light.png) |\n\n### 手机\n\n| 深色模式 | 浅色模式 |\n| --- | --- |\n| ![深色模式 - 电脑](./doc/images/tasks-mobile-dark.png) | ![浅色模式 - 电脑](./doc/images/tasks-mobile-light.png) |\n| ![深色模式 - 手机](./doc/images/add-task-mobile-dark.png) | ![浅色模式 - 手机](./doc/images/add-task-mobile-light.png) |\n\n\n\n### 使用说明\n\n在[release](./release)页面下载预先打包好的文件并部署到Web服务器上\n\n以下以nginx为例， 编辑你的 nginx 配置文件：\n\n```nginx\nserver {\n    listen 80;\n    server_name bbdown.local;\n\n    root /var/www/bbdown-webui;\n    index index.html;\n\n    location / {\n        try_files $uri $uri/ =404;\n    }\n}\n```\n\n确保将 `root /var/www/bbdown-webui;` 替换为你解压后的文件路径\n并将`server_name bbdown.local;`改为你希望的域名和IP\n\n## 构建\n\n1. 克隆或下载本仓库。\n\n    ```bash\n    git clone https://github.com/gnattu/bbdown-webui.git\n    ```\n\n2. 进入项目目录。\n\n    ```bash\n    cd bbdown-webui\n    ```\n\n3. 安装依赖。\n\n    ```bash\n    npm install\n    ```\n\n4. 启动 WebUI。\n\n    ```bash\n    npm run dev\n    ```\n\n如果你想构建生产版本，可以运行以下命令：\n\n```bash\nnpm run build\n```\n\n打包好的生产版本会在`dist`目录中\n\n## 配置\n\nBBDown WebUI 将尝试从服务器获取配置信息，包括用户配置和 BBDown 工具的配置。在构建生产版本后，会生成一个 `userconfig.json` 文件，用户可以修改该文件来设置 BBDown 的服务器地址和默认下载配置。\n\n`userconfig.json` 文件示例：\n\n```json\n{\n  \"bbdownUrl\": \"http://127.0.0.1:23333\",\n  \"bbdownMyOptions\": {\n    \"MultiThread\": true,\n    \"ForceHttp\": true,\n    \"SkipAi\": true,\n    \"ForceReplaceHost\": true,\n    // 其他可用选项请参考 src/datatype.ts 中的 BBDownMyOption 类定义\n    // 在Interface IBBDownMyOption中定义的选项是GUI中不会出现的隐藏选项，这些选项依然会被发送到BBDown\n  }\n}\n```\n\n## 局限性\n\n目前版本的BBDown-WebUI存在一些功能上的局限性，主要受BBDown后端的限制，这些问题将在未来更新中改善。以下是当前版本的一些局限性：\n\n### 1. 无法中断和暂停下载中的任务\n\nBBDown暂时没有提供太好的中断和暂停下载任务的方法，在命令行模式下中断下载是直接退出进程，因此BBDown-WebUI无法执行这些操作。在极端情况下如果出现任务卡死，可能需要重新启动服务。\n\n### 2. 多P下载任务缺乏分P进度显示\n\nBBDown后端接口尚未提供多P下载任务的分P进度信息，因此BBDown-WebUI无法展示多P下载任务的详细进度。\n\n### 3. 并行任务过多可能导致失败\n\n由于BBDown后端目前未实现下载队列，所有提交的任务都会并行下载。并行任务较多时可能导致任务失败。\n\n## 许可证\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgnattu%2Fbbdown-webui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgnattu%2Fbbdown-webui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgnattu%2Fbbdown-webui/lists"}