onelist能让alist聚合网盘拥有海报墙

发表于 2023-11-24 更新于 2025-10-26 分类于各种折腾 Waline：阅读次数：本文字数： 3.3k 阅读时长 ≈ 3 分钟

onelist 是一个类似 emby 的专注于刮削 alist 聚合网盘形成影视媒体库的程序。

什么是 onelist ？

onelist 是一个类似 emby 的专注于刮削 alist 聚合网盘形成影视媒体库的程序。

主要解决以下痛点：

alist 挂载云盘后能在网页端看视频，却没有分类，没有海报墙；
使用 webdav 挂载本地后，用 jellyfin 或者 emby 刮削会下载视频截取封面导致封号；
用 jellyfin 或者 emby 之类，没有大带宽公网 ip，在外难以访问；

准备

TMDB API 申请

在浏览器中打开 https://www.themoviedb.org，右上角 加入 TMDB

注册一个账号

登录成功后，进入 账户设置，

找到 API –> 创建 –> Developer ，第一次要填写一些应用信息，无非是应用名称、URL、简介一类的，成功之后就能看到API 密钥 了

hosts

TMDB 的访问存在一些限制，如果刮削效果不好，可以尝试修改路由器的自定义 HOST 或者容器的 hosts 文件

路由器不同，可能设置自定义 HOST 的方法也不一样，所以这里就只介绍修改容器内的 hosts 文件

# 进入容器内
docker exec -it onelist /bin/bash

# 编辑 hosts 文件
vi /etc/hosts

在文件的末尾添加官方提供的👇下面的列表，至于效果如何，老苏未并验证

13.224.161.90 api.themoviedb.org
104.16.61.155 image.themoviedb.org
13.35.67.86 api.themoviedb.org
54.192.151.79 www.themoviedb.org
13.225.89.239 api.thetvdb.com
13.249.175.212 api.thetvdb.com
13.35.161.120 api.thetvdb.com
13.226.238.76 api.themoviedb.org
13.35.7.102 api.themoviedb.org
13.225.103.26 api.themoviedb.org
13.226.191.85 api.themoviedb.org
13.225.103.110 api.themoviedb.org
52.85.79.89 api.themoviedb.org
13.225.41.40 api.themoviedb.org
13.226.251.88 api.themoviedb.org

vim 编辑器的使用可以网上搜一下，当然有条件的话，还是科学上网更简单一些

安装

在群晖上以 Docker 方式安装。老苏建议使用 docker-compose 方式安装

【说明】：采用群晖套件 Docker 图形化安装，无法指定 host，可以考虑：

在路由器中添加自定义 HOST ；

或者直接添加科学上网的黑名单；

给容器 hosts 文件增加 dns解析；

来确保 onelist 可以正常访问 api.themoviedb.org

在注册表中搜索 onelist ，选择第一个 msterzhang/onelist，版本选择 latest。

本文写作时， latest 版本对应为 v2.0.5；

卷

在 docker 文件夹中，创建一个新文件夹 onelist，并在其中建一个子文件夹 config

文件夹	装载路径	说明
`docker/onelist/config`	`/config`	存放设置和数据库文件

端口

本地端口不冲突就行，不确定的话可以用命令查一下

1 2	# 查看端口占用 netstat -tunlp \| grep 端口号

本地端口	容器端口
`5245`	`5245`

环境

可变	值
`PUID`	默认值为 `911`，设为 `0`
`PGID`	默认值为 `911`，设为 `0`
`TZ`	时区，默认值为 `Asia/Shanghai`，不需要修改

命令行安装

docker cli 安装

如果你熟悉命令行，可能用 docker cli 更快捷

# 新建文件夹 onelist 和 子目录
mkdir -p /volume1/docker/onelist/config

# 进入 onelist 目录
cd /volume1/docker/onelist

# 运行容器
docker run -d \
   --restart unless-stopped \
   --name onelist \
   --add-host api.themoviedb.org:13.224.161.90 \
   -p 5245:5245 \
   -v $(pwd)/config:/config \
   -e PUID=0 \
   -e PGID=0 \
   -e TZ=Asia/Shanghai \
   msterzhang/onelist:latest

其中：

PUID 和 PGID 均为 0 表示是 root 用户，也就是超级用户或系统管理员；
--add-host api.themoviedb.org:13.224.161.90 会向容器内的 hosts 文件中插入一条记录；

docker-compose 安装

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

version: '3.3'

services:
  onelist:
    restart: always
    container_name: onelist
    image: 'msterzhang/onelist:latest'
    volumes:
      - './config:/config'
    ports:
      - '5245:5245'
    environment:
      - PUID=0
      - PGID=0
      - UMASK=022
      - TZ=Asia/Shanghai
    extra_hosts:
      - 'api.themoviedb.org:13.224.161.90'
      - 'api.themoviedb.org:13.35.67.86'
      - 'api.themoviedb.org:13.249.175.212'
      - 'api.themoviedb.org:13.35.161.120'
      - 'image.themoviedb.org:104.16.61.155'
      - 'www.themoviedb.org:54.192.151.79'

然后执行下面的命令

# 新建文件夹 onelist 和 子目录
mkdir -p /volume1/docker/onelist/config

# 进入 onelist 目录
cd /volume1/docker/onelist

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d