Doudarr: 将豆瓣榜单/片单/豆列转换为Radarr列表
介绍
Doudarr是一个将豆瓣榜单/片单/豆列（以下统称豆瓣列表）转换为Radarr列表的工具。它可以将任意豆瓣列表中的电影列表转换为Radarr列表，从而实现自动监控豆瓣列表中的电影，并自动下载。
使用
-
使用Docker部署Doudarr:
docker run -d --name doudarr -p 8000:8000 -v /path/to/cache:/app/cache kfstorm/doudarr:latest。可配置的参数参见Doudar服务参数。 -
访问http://localhost:8000/collection/movie_weekly_best，测试是否能够获取到该豆瓣列表中的电影列表。(对应的豆瓣网页为https://m.douban.com/subject_collection/movie_weekly_best。)
-
进入Radarr，在
设置 -> 列表中新增一个列表，选择Advanced List中的StevenLu Custom，设置好参数后保存。一些常用参数：
- 名称: 可以和豆瓣列表的名字一样，方便记忆。
- 启用自动添加：打开后会自动添加豆瓣列表里的电影到库中。（建议打开）
- 添加时搜索：打开后在添加电影到库中时会自动开始搜索下载。（建议打开）
- URL: 填写完整的Doudarr链接。（请参考豆瓣列表链接与Doudarr链接的映射关系）
- 片刻后，应该能看到Radarr自动添加了豆瓣列表中的电影。也可以在Radarr的
电影 -> 发现中查看。（右上角选项里取消勾选包含Radarr推荐，右上角过滤里选择全部。）
Doudarr服务参数
Doudarr服务支持以环境变量的方式配置服务参数。参数列表如下：
| 环境变量 | 默认值 | 说明 |
|---|---|---|
DOUDARR_CACHE_BASE_DIR |
cache |
缓存路径。默认值为相对路径，也可以填写绝对路径。 |
DOUDARR_DOUBAN_API_REQUEST_DELAY_MAX_SECONDS |
1 |
请求豆瓣API时的最大延迟（秒）。两次请求之间的延迟是随机的，这里配置的是最大值。 |
DOUDARR_LIST_CACHE_TTL_SECONDS |
86400 |
列表缓存的TTL（秒）。列表缓存会在一段时间后过期，过期后会重新抓取。如果豆瓣列表的条目有更新，重新抓取后会拿到最新的条目。 |
DOUDARR_IMDB_REQUEST_DELAY_MAX_SECONDS |
30 |
抓取IMDb信息时的最大延迟（秒）。两次请求之间的延迟是随机的，这里配置的是最大值。 |
DOUDARR_IMDB_CACHE_TTL_ID_NOT_FOUND_SECONDS |
86400 |
IMDb ID未找到时的缓存TTL（秒）。部分豆瓣条目没有IMDb ID（可能是暂时的），没有找到时会缓存一段时间，避免重复查询。TTL到期后会再次查询。 |
DOUDARR_PROXY_ADDRESS |
无 | 代理地址，所有HTTP请求将通过代理转发。 |
DOUDARR_BOOTSTRAP_INTERVAL_SECONDS |
86400 |
缓存预热的时间间隔（秒）。缓存预热会在后台定期执行，用于抓取IMDb信息并缓存，加快后续查询速度。设置间隔可以避免短时间内抓取太多信息，导致访问受限。 |
DOUDARR_BOOTSTRAP_LIST_INTERVAL_SECONDS |
30 |
缓存预热时抓取两个列表之间的时间间隔（秒）。设置间隔可以避免短时间内抓取太多列表，导致访问受限。 |
DOUDARR_BOOTSTRAP_LISTS_MAX |
100 |
缓存预热时抓取的列表最大数量。每次缓存预热只会抓取部分列表，这个值越大，抓取的列表数量越多，IMDb信息的预热越充分。 |
DOUDARR_DOUBAN_RATE_LIMIT_DELAY_SECONDS |
3600 |
豆瓣API的速率限制延迟（秒）。当遇到豆瓣API返回访问限制时，在配置的时间范围内不再请求豆瓣API，避免访问受限更严重。 |
DOUDARR_APIKEY |
无 | API密钥。API密钥用于对外提供访问权限，部分API只有在提供了正确的API密钥时才能访问，例如/sync API。 |
DOUDARR_SYNC_IMDB_CACHE_INTERVAL_SECONDS |
3600 |
同步IMDb缓存到其他Doudarr实例的时间间隔（秒）。同步IMDb缓存会定期将缓存同步到其他Doudarr实例上，以便多个Doudarr实例之间共享IMDb缓存。 |
DOUDARR_SYNC_IMDB_CACHE_TO |
[] |
同步IMDb缓存到其他Doudarr实例的URL列表。同步IMDb缓存会定期将缓存同步到其他Doudarr实例上，以便多个Doudarr实例之间共享IMDb缓存。该参数可以包括多个URL，用于同步到多个Doudarr实例。参数示例：["http://doudarr-another-1:8000/sync?apikey=another-apikey-1", "http://doudarr-another-2:8000/sync?apikey=another-apikey-2"]。注意这里的apikey需要填写对应实例的apikey，而不是自己的。该参数的值较为复杂，配置环境变量时注意转义。 |
DOUDARR_COOKIE_DOUBAN_COM_DBCL2 |
无 | 豆瓣网站的cookie中key为dbcl2 cookie的值。如果想让Doudarr以登录用户的身份去访问豆瓣的接口，请配置该参数。 |
豆瓣列表链接与Doudarr链接的映射关系
豆瓣列表的链接有两种格式，请根据情况选择对应的Doudarr链接。
| 豆瓣列表链接格式 | Doudarr链接格式 | Doudarr链接示例 |
|---|---|---|
https://m.douban.com/subject_collection/<豆瓣列表ID> |
http://<Doudarr服务地址>/collection/<豆瓣列表ID> |
http://localhost:8000/collection/movie_weekly_best |
https://www.douban.com/doulist/<豆瓣列表ID>/ |
http://<Doudarr服务地址>/doulist/<豆瓣列表ID> |
http://localhost:8000/doulist/43556565 |
URL参数
可以通过额外的query参数来控制返回的内容。
| 参数 | 说明 | 示例 |
|---|---|---|
min_rating |
最低评分要求。只有不低于指定评分的电影才会被返回。 | http://localhost:8000/collection/movie_weekly_best?min_rating=8 |
注意事项
- 因为豆瓣的反爬策略，Doudarr限制了请求频率。首次启动Doudarr时，API请求较慢，需耐心等待。
- 记得将容器内的
/app/cache目录映射到宿主机上，以免后续容器重建或升级时丢失缓存数据。
公共服务地址
为了方便大家使用，可以使用公共的Doudarr服务：https://doudarr.azurewebsites.net。公共服务的IMDb ID缓存可能更全面，可以更快加载出豆瓣列表中的电影。
请注意，这是一个公共服务，不保证稳定性和可用性。如果有条件，建议自行部署Doudarr。
项目特色
- 支持任意豆瓣列表。
- 使用IMDb ID作为电影的唯一标识，不会因为电影名字相近而导致添加错误的电影。
FAQ
-
如何找到喜欢的豆瓣列表？
- 在豆瓣手机App中，依次选择
书影音 -> 电影 -> 豆瓣榜单，可以浏览所有的榜单/片单（也叫豆列）。选择一个想要监控的豆瓣列表，点击进入，然后打开分享菜单，选择复制链接，即可获得该豆瓣列表的URL。 - 使用Google搜索
site:douban.com/subject_collection或site:douban.com/doulist。 - 关于电影的豆列。
- 在豆瓣手机App中，依次选择
TODO
下面是我想到的可能会做的功能，但不一定会实现。欢迎提出新的功能需求。
- [x] 支持在列表上增加筛选逻辑，如最低评分要求。
- [ ] 支持以导演、演员为ID创建列表。