免魔法刮削：利用 Vercel 免费自建 TMDB 代理

前言

还在为 Emby 或 Jellyfin 里的空白海报墙烦恼吗？这通常不是软件本身的问题，而是因为获取元数据的 TMDB 数据库（api.themoviedb.org 和 image.tmdb.org）在国内访问不稳定，时常遭遇 DNS 污染或直接被“墙”，时不时就“失联”了。

你可能试过网上流传的“土方法”：尝试手动修改 hosts 文件，结果 TMDB 的 IP 天天变，你得天天改，比上班打卡还准时。但这些方法往往治标不治本，要么需要频繁手动更新，要么配置复杂且可能影响其他网络。

https://www.ugnas.com/tutorial-detail/id-80.html

不过，现在有了一个更优雅、一劳永逸的免费方案。本文将介绍一个名为 imaliang/tmdb-proxy 的开源项目，它能让你利用 Vercel 平台，一键免费部署一个专属于你自己的 TMDB 代理。你只需要一个 GitHub 账户和一个自己的域名，就能彻底解决刮削难题，还你一个漂亮的海报墙！。

https://github.com/imaliang/tmdb-proxy

优雅的架构：`tmdb-proxy` 与无服务器反向代理

面对上述困境，一个名为 imaliang/tmdb-proxy 的开源项目提供了一种无限白嫖且一劳永逸的解决方案。该项目巧妙地利用了现代云平台的能力，为用户构建了一个专属的、稳定的 TMDB 访问通道。

以下是理论部分也可以直接跳过

核心武器：反向代理

要理解该方案的精妙之处，首先需要了解什么是“反向代理”（Reverse Proxy）。一个反向代理服务器位于真正的目标服务器（在这里是 TMDB）的前端，它接收来自客户端（在这里是 Emby）的请求，然后将这些请求转发给目标服务器，并将从目标服务器收到的响应再传回给客户端 。

可以将其比作一个私人礼宾服务。您的Emby媒体服务器（客户端）不再需要亲自去一个难以到达的地方（被封锁的 TMDB）获取信息。相反，它只需告诉它的私人礼宾（反向代理），“请帮我从 TMDB 获取《盗梦空间》的海报”。这位礼宾拥有通畅的路径可以轻松到达 TMDB，他会取回海报，然后优雅地递还给您的媒体服务器。在这个过程中，您的媒体服务器从未直接与遥远且难以访问的 TMDB 服务器通信，所有复杂的网络穿越都由这个可靠的中间人完成了。

驱动引擎：Vercel 平台的“无服务器”能力

tmdb-proxy 项目的核心是利用 Vercel 这一先进的云平台来部署上述的反向代理。Vercel 是一个为前端和 Web 项目设计的部署平台，它极大地简化了从代码构建到全球托管的整个流程，并能与 GitHub 进行无缝的持续集成/持续部署（CI/CD）。

此方案利用了 Vercel 的两大关键特性：无服务器函数（Serverless Functions）和重写（Rewrites）规则。这些功能允许开发者部署一小段代码，使其在 Vercel 的全球边缘网络上运行，充当反向代理的角色，而无需管理任何传统的服务器。

这种模式的真正颠覆性在于它实现了零成本和零维护。在传统模式下，搭建一个高可用的反向代理需要租用一台虚拟专用服务器（VPS），安装和配置 Nginx 等 Web 服务器软件，处理安全补丁，并持续监控其运行状态。而 tmdb-proxy 方案将所有这些繁重的底层设施管理工作完全外包给了 Vercel。用户可以享受到一个由全球分布式、高可用、自动伸缩的边缘网络驱动的反向代理服务，而无需支付一分钱或花费任何精力去维护服务器。Vercel 提供的免费套餐中包含每月 100GB 的流量额度，对于元数据刮削所涉及的少量文本和图片数据来说绰绰有余，使得该解决方案对于个人用户而言是真正免费的。

简单点就是——可以白嫖

一键部署：搭建您的专属 TMDB 代理

注册GitHub账号（有了可以直接跳过）

https://github.com/

注册很简单，科学上网+邮箱认证即可注册。

这是部署过程的基础，用于 Fork（复刻）项目代码，并作为登录和授权 Vercel 平台的身份凭证。

自定义域名

这是强制性要求。由于 Vercel 平台自带的 *.vercel.app 域名在中国大陆地区同样存在访问困难的问题，因此必须绑定一个您自己拥有的域名才能确保代理的可用性。

没有域名的小伙伴也可以可以看一下阿里云，腾讯云的活动，几块钱就能搞到年抛域名。如果不想实名认证的话也可以点击购买(NameSilo）、点击购买（Dynadot），都支持支付宝付款。

一键部署至 Vercel

部署过程被设计得极其简单：

点击该按钮后，浏览器将跳转到 Vercel 平台。Vercel 会引导您完成授权过程，它会自动将 tmdb-proxy 项目复刻到您的 GitHub 账户中，并在您的 Vercel 账户下创建一个新项目，然后开始部署。您只需按照屏幕提示，为项目命名并确认即可。

点击编辑域名

添加域名后，Vercel 会提示您需要配置的 DNS 记录。通常，它会要求您为子域名添加一条 A 记录，并提供一个具体的 IP 地址 。请按照以下：

直接选择第二个

添加域名解析

以CloudFlare为例

登录您购买域名的服务商（如 GoDaddy, Namecheap, 腾讯云等）的管理后台。
找到您域名的 DNS 管理或解析设置页面。
创建一条新的 DNS 记录。记录类型选择 A，主机记录（或名称）填写您的子域名部分（例如，如果您使用 tmdb.yourdomain.com，则填写 tmdb），记录值填写 Vercel 提供给您的别名域名。
保存更改。

返回`Vercel`查看

等待验证与 SSL 证书签发：DNS 记录的全球生效（称为“传播”）可能需要几分钟到几小时不等的时间。一旦 Vercel 检测到您的 DNS 配置正确，其项目仪表盘中的域名状态将显示为蓝色的“Valid Configuration”。同时，Vercel 会自动为您的这个域名申请并续签免费的 SSL 证书，确保所有数据传输都是通过 HTTPS 加密的，增强了安全性。

至此，您已经拥有了一个专属的、安全的 TMDB 代理地址：https://tmdb.yourdomain.com（比如我的为：https://tmdb.keba.host)。