1 前言

前段时间，Alist 被出售并且疑似提交收集用户信息代码的消息，在网络上引起了广泛关注。一时间各种替代产品出现，其中 OpenList 做到在短短几日斩获数千 Star，成为最佳替代产品。
OpenList 来自 Alist 一个分支，最初它相比 Alist 并没有什么大的功能新增或改变，很多用户选择留在 Alist 低版本，但随着时间推移和 OpenList不断更新，让绝大数 Alist 用户心甘情愿转移到 OpenList 阵营。

2 安装教程

官方推荐使用 Docker 进行部署，这里我们将配合宝塔面板来完成安装部署。

极速部署

在 Docker 应用商店中找到 OpenList 进行安装，建议在安装配置时设置域名，避免后续的额外操作，注意将域名进行解析，安装配置中的其它配置项根据实际需要进行设置。

image-20250830150507140

步骤部署

针对正在学习宝塔面板和 Docker 的用户，建议按照一般流程分步骤完成部署。

首先，在 Docker 容器编排中添加编排。

image-20250830163614043

然后定义编排名称和 compose 内容。名称自定义，compose 内容参考下方模板。

1
2
3
4
5
6
7
8
9
10
11
12
services:
  openlist:
    image: 'openlistteam/openlist:latest'
    container_name: openlist
    user: '0:0'
    volumes:
      - '/var/openlist:/opt/openlist/data'
    ports:
      - '8080:5244'
    environment:
      - UMASK=022
    restart: unless-stopped
  • ports：端口映射。用于外部访问，例如此处为 IP:8080，冒号前根据需要修改，记得放行端口。
  • volumes：目录映射。将容器内关键数据目录关联到宿主机的指定位置，冒号前根据需要修改。

容器编排添加完成后，就可以在面板看到运行中字样，并且日志中反馈 start HTTP server @ 0.0.0.0:5244。这时在浏览器访问 IP:端口 就可以正常进入 OpenList 网页了。

image-20250830165149858

最后在 Docker 网站中添加该容器反代，就可以用域名访问这个网站了。

  • 域名：填写可以正常解析的域名，以后就可以通过该域名进行网站访问了。
  • 容器：选择刚刚部署的容器，名称是你前面自定义的名称。
  • 端口：选择容器后自动填充。

image-20250830165519310

3 使用教程

来到这里，无论是极速部署还是分步骤部署，都证明你已经完成了 OpenList 的安装并且顺利进入到了登录页面。

image-20250830170552960

那么现在问题来了，没有注册按钮，我如何登录到管理员账号。其实在官方文档中已经给出了问题的解决答案。

我们需要先使用 ssh 连接服务器，或者在宝塔面板终端里操作，执行下方命令就可以设置管理员密码了，默认管理员用户名则是 admin。

1
2
# 手动设置密码为 `NEW_PASSWORD`（替换为您要设置的密码）
docker exec -it openlist ./openlist admin set NEW_PASSWORD

image-20250831160950504

知道了管理员用户名和密码，我们就可以顺利进入 OpenList 管理后台了。

image-20250831161130241

之后就可以完成修改用户名、站点全局配置、添加存储、设置访客等各项操作，具体可查看官方文档。

4 写在最后

使用 Docker 安装应用是非常方便的，本文旨在演示新版宝塔面板如何快捷使用面板 Docker 来安装应用，同时分享这一款强大的文件列表管理程序 OpenList，感兴趣的朋友可以部署尝试。（好久没更新了，水一篇吧）