# BT 种子预览台（DSL）

搜索 / 解析 / 预览 BT 种子内容，并一键投递到本机下载工具（qBittorrent / Transmission / aria2）的 Web 控制台。

## 功能特性

- **多源聚合搜索**：同时搜索多个公开磁力站并自动按 infoHash 去重、按做种数排序。
  - The Pirate Bay（apibay）
  - Nyaa
  - SolidTorrents
  - 磁力搜索（cilisousuo.cc）
- **种子内容预览**：通过 WebTorrent 的 DHT / Tracker 解析磁力链，取得文件清单、总大小、做种/下载人数（无需真正下载文件）。
- **一键投递**：把选中的磁力链直接发给本机 BT 客户端开始下载，并记录投递历史。
- **可配置**：搜索代理、超时、启用哪些搜索源、BT 客户端地址都可在「设置」页或 `.env` 中调整。

## 技术栈

- 前端/全栈：[Nuxt 4](https://nuxt.com/)（Vue 3 + Nitro 服务端）
- 数据库：[MongoDB](https://www.mongodb.com/)（搜索历史、投递记录、配置持久化；不连库时回落到 `.env` 默认值）
- 关键依赖：`webtorrent`（种子解析）、`mongodb`、`parse-torrent`、`undici`（带代理的 fetch）、`fast-xml-parser`

## 环境要求

- Node.js ≥ 18（推荐 20 LTS）
- MongoDB（可选；不安装也能跑，只是配置和历史记录不会持久化）

## 快速开始（本地开发）

```bash
# 1. 安装依赖
npm install

# 2. 配置环境变量（可选，见下文「配置项」）
cp .env.example .env

# 3. 启动开发服务器
npm run dev
```

打开 http://localhost:3000 即可。

构建并本地预览生产版本：

```bash
npm run build
npm run preview
```

## 配置项

所有配置都可写入 `.env`（项目根目录），未设置时使用括号内默认值。

| 变量 | 说明 | 默认 |
| --- | --- | --- |
| `MONGODB_URI` | MongoDB 连接串 | `mongodb://127.0.0.1:27017` |
| `MONGODB_DB` | 数据库名 | `torrent_console` |
| `SEARCH_PROXY` | 访问搜索源时使用的 HTTP 代理（如 `http://127.0.0.1:7890`），留空直连 | 空 |
| `SEARCH_TIMEOUT` | 单次搜索源请求超时（毫秒） | `12000` |
| `METADATA_TIMEOUT` | 磁力链元数据解析超时（毫秒） | `30000` |
| `APIBAY_BASE` | The Pirate Bay 接口地址 | `https://apibay.org` |
| `NYAA_BASE` | Nyaa 地址 | `https://nyaa.si` |
| `CILISOUSUO_BASE` | 磁力搜索（cilisousuo）地址 | `https://cilisousuo.cc` |

> 这些项也可在「设置」页通过 UI 修改（保存后写入 MongoDB 的 `settings` 集合，优先级高于 `.env`）。

## 搜索源说明

cilisousuo.cc 的列表页只暴露名称、大小和详情页短链，不含 infoHash，因此该源会**逐条抓取详情页**补全磁力链（单次搜索最多取前 24 条、5 路并发）。若服务端网络连不上该站，请在「设置」里配置 `SEARCH_PROXY`。

## 部署

### 方式一：Docker（推荐）

已提供 `Dockerfile` 与 `docker-compose.yml`（自带 MongoDB）：

```bash
# 构建并启动（后台）
docker compose up -d --build

# 查看日志
docker compose logs -f app
```

访问 http://<服务器IP>:3000 。

仅构建镜像单独运行：

```bash
docker build -t bt-preview .
docker run -d --name bt-preview -p 3000:3000 \
  -e MONGODB_URI=mongodb://mongo:27017 \
  bt-preview
```

### 方式二：直接运行（Node 服务器）

```bash
# 生产构建，产物在 .output/
npm run build

# 用任意进程管理器跑起来（以 PM2 为例）
npm install -g pm2
pm2 start .output/server/index.mjs --name bt-preview
pm2 save
```

关键运行环境变量：

```bash
HOST=0.0.0.0   # 监听地址
PORT=3000      # 监听端口
MONGODB_URI=mongodb://127.0.0.1:27017
```

### 方式三：反向代理（Nginx 示例）

```nginx
server {
    listen 80;
    server_name your.domain;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
```

## 常见问题

- **搜索源"打不开" / 搜不到结果**：公开磁力站在部分网络下被墙。在「设置」里填一个可用的 HTTP 代理（`SEARCH_PROXY`），保存后重试。
- **MongoDB 未连接提示**：不影响基础搜索；只是配置和历史不会持久化。安装并启动 MongoDB，或设置 `MONGODB_URI` 指向可用的实例即可。
- **磁力解析不可用**：WebTorrent 依赖 Node 网络环境（DHT/UDP）。在受限网络下可能只能显示 infoHash，拿不到文件清单，属正常现象。

## 目录结构

```
app/            前端页面与组件（Nuxt pages / components / composables）
server/
  api/         Nitro 接口（search / torrent / clients / history / downloads ...）
  utils/
    search/    各搜索源实现（apibay / nyaa / solidtorrents / cilisousuo）
    mongo.ts   MongoDB 连接与索引
    appconfig.ts  配置读写与默认值
    torrent.ts    磁力链 / 种子解析工具
```