285 lines
3.0 KiB
Markdown
285 lines
3.0 KiB
Markdown
# TMDB Cloudflare Worker Proxy
|
||
|
||
一个基于 Cloudflare Worker 的 TMDB API 与图片代理服务。
|
||
|
||
支持：
|
||
|
||
* TMDB API 代理
|
||
* TMDB 图片代理
|
||
* 隐藏 API Key
|
||
* Cloudflare Edge Cache
|
||
* KV 二级缓存
|
||
* 多 API Key 轮换
|
||
* 自定义域名
|
||
|
||
---
|
||
|
||
# 文件说明
|
||
|
||
项目包含两个版本：
|
||
|
||
| 文件 | 说明 | 适合场景 |
|
||
| -------- | --- | --------------------------- |
|
||
| index.js | 轻量版 | 个人使用、小规模部署 |
|
||
| tmdb.js | 生产版 | ATV-Player、影视TV、TvBox 等公开服务 |
|
||
|
||
---
|
||
|
||
## index.js（轻量版）
|
||
|
||
特点：
|
||
|
||
* 单文件
|
||
* 无 KV 依赖
|
||
* API 代理
|
||
* 图片代理
|
||
* Edge Cache
|
||
* API Key 隐藏
|
||
|
||
适合：
|
||
|
||
* 自用
|
||
* 测试
|
||
* 小规模用户
|
||
|
||
部署时直接复制到 Cloudflare Worker 即可。
|
||
|
||
---
|
||
|
||
## tmdb.js（生产版）
|
||
|
||
特点：
|
||
|
||
* API 代理
|
||
* 图片代理
|
||
* API Key 隐藏
|
||
* Cloudflare Edge Cache
|
||
* KV 二级缓存
|
||
* 多 API Key 自动轮换
|
||
* IP 限流
|
||
* CORS
|
||
* 热门接口缓存
|
||
|
||
适合：
|
||
|
||
* ATV-Player
|
||
* TvBox
|
||
* 影视TV
|
||
* 公共 API 服务
|
||
|
||
推荐使用 Wrangler 部署。
|
||
|
||
---
|
||
|
||
# 获取 TMDB API Key
|
||
|
||
注册：
|
||
|
||
https://www.themoviedb.org/
|
||
|
||
创建 API Key：
|
||
|
||
https://www.themoviedb.org/settings/api
|
||
|
||
---
|
||
|
||
# 部署方式
|
||
|
||
## 方案一：Dashboard（推荐新手）
|
||
|
||
### 创建 Worker
|
||
|
||
Cloudflare Dashboard
|
||
|
||
Workers & Pages
|
||
|
||
Create Worker
|
||
|
||
---
|
||
|
||
### 使用轻量版
|
||
|
||
复制：
|
||
|
||
```text
|
||
index.js
|
||
```
|
||
|
||
内容到 Worker。
|
||
|
||
---
|
||
|
||
### 添加环境变量
|
||
|
||
Settings
|
||
|
||
Variables
|
||
|
||
新增：
|
||
|
||
```text
|
||
TMDB_KEYS
|
||
```
|
||
|
||
值：
|
||
|
||
```text
|
||
your_tmdb_api_key
|
||
```
|
||
|
||
部署即可。
|
||
|
||
---
|
||
|
||
## 方案二：Wrangler（推荐生产环境）
|
||
|
||
### 安装
|
||
|
||
```bash
|
||
npm install -g wrangler
|
||
```
|
||
|
||
---
|
||
|
||
### 登录
|
||
|
||
```bash
|
||
wrangler login
|
||
```
|
||
|
||
---
|
||
|
||
### 创建 KV
|
||
|
||
```bash
|
||
wrangler kv namespace create TMDB_CACHE
|
||
```
|
||
|
||
记录返回的 Namespace ID。
|
||
|
||
---
|
||
|
||
### wrangler.toml
|
||
|
||
```toml
|
||
name = "tmdb-proxy"
|
||
main = "tmdb.js"
|
||
compatibility_date = "2026-06-06"
|
||
|
||
[[kv_namespaces]]
|
||
binding = "TMDB_CACHE"
|
||
id = "YOUR_KV_NAMESPACE_ID"
|
||
```
|
||
|
||
---
|
||
|
||
### 配置 API Key
|
||
|
||
```bash
|
||
wrangler secret put TMDB_KEYS
|
||
```
|
||
|
||
输入：
|
||
|
||
```text
|
||
key1,key2,key3
|
||
```
|
||
|
||
支持多个 Key。
|
||
|
||
---
|
||
|
||
### 本地运行
|
||
|
||
```bash
|
||
wrangler dev
|
||
```
|
||
|
||
---
|
||
|
||
### 部署
|
||
|
||
```bash
|
||
wrangler deploy
|
||
```
|
||
|
||
---
|
||
|
||
# API 示例
|
||
|
||
请求：
|
||
|
||
```text
|
||
https://tmdb.example.com/3/movie/550
|
||
```
|
||
|
||
实际访问：
|
||
|
||
```text
|
||
https://api.themoviedb.org/3/movie/550
|
||
```
|
||
|
||
并自动附加 API Key。
|
||
|
||
---
|
||
|
||
# 图片示例
|
||
|
||
请求：
|
||
|
||
```text
|
||
https://tmdb.example.com/t/p/w500/abc.jpg
|
||
```
|
||
|
||
实际访问：
|
||
|
||
```text
|
||
https://image.tmdb.org/t/p/w500/abc.jpg
|
||
```
|
||
|
||
---
|
||
|
||
# ATV-Player 配置
|
||
|
||
```text
|
||
TMDB API URL:
|
||
https://tmdb.example.com
|
||
```
|
||
|
||
---
|
||
|
||
# 缓存策略
|
||
|
||
轻量版：
|
||
|
||
| 类型 | 缓存 |
|
||
| --- | --- |
|
||
| API | 1小时 |
|
||
| 图片 | 30天 |
|
||
|
||
生产版：
|
||
|
||
| 类型 | 缓存 |
|
||
| ---------- | ---- |
|
||
| Edge Cache | 1小时 |
|
||
| KV Cache | 24小时 |
|
||
| 图片 | 30天 |
|
||
|
||
---
|
||
|
||
# 推荐选择
|
||
|
||
个人使用：
|
||
|
||
```text
|
||
index.js
|
||
```
|
||
|
||
公开服务：
|
||
|
||
```text
|
||
tmdb.js
|
||
```
|
||
|
||
如果预计用户超过 1000 人，推荐直接使用生产版。
|