宝塔下安装 OpenList 教程

发表于 2022-08-24 更新于 2025-06-21 分类于存储本文字数： 1.3k 阅读时长 ≈ 4 分钟

简介

一个支持多种存储的文件列表程序，使用 Gin 和 Solidjs。
OpenList 从一开始就设计为易于安装，并且可以在所有平台上使用。
OpenList 支持多个存储提供商，包括本地存储、阿里云盘、OneDrive、Google Drive 等，且易于拓展。
OpenList 支持所有 WebDAV 存储，这是一种用于访问文件的标准。
为特定路径添加密码保护和身份验证。
支持视频、音频、文档、PDF、图片预览等，甚至支持 ipa 安装。
使用浏览器的 stream api 支持打包下载，无需使用服务器 / 使用Aria2进行批量下载支持文件夹。
使用单点登录自动注册为 OpenList 帐号快速注册。
将种子内容离线下载到指定的目录內，需要苛刻的网络环境。
任何人都可以安全地将加密数据存储在远程存储提供商上。数据存储在保险箱中，提供商只能看到保险箱，看不到您的数据。
包括文本编辑器、README/HTML 渲染、文件永久链接、Cloudflare Workers 代理等。

安装教程

安装宝塔

系统兼容性排序: Debian 12(推荐)、Ubuntu 22、Centos 9、OpenCloud 9、TencentOS Server4、AlibabaCloud 3 > 麒麟、统信、欧拉等Linux系统
稳定版：推荐公司、企事业单位及生产环境使用，特别注重安全和稳定性，只修BUG，不加新功能
正式版：推荐安装，已经公测且稳定的版本，每月会更新新功能，推荐使用Debian12系统

通用安装脚本（推荐）

1	if [ -f /usr/bin/curl ];then curl -sSO https://download.bt.cn/install/install_panel.sh;else wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh;fi;bash install_panel.sh ed8484bec

Centos / OpenCloud / Alibaba

1	url=https://download.bt.cn/install/install_panel.sh;if [ -f /usr/bin/curl ];then curl -sSO $url;else wget -O install_panel.sh $url;fi;bash install_panel.sh ed8484bec

Debian

1	wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh && bash install_panel.sh ed8484bec

Ubuntu / Deepin

1	wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh && sudo bash install_panel.sh ed8484bec

放行端口
- 因为 OpenList 需要使用端口 5244，因此需要提前在宝塔中放行。
- 在宝塔界面里的安全中放行 5244 端口即可！
- 如果有安全组或防火墙的，同样需要在安全组或防火墙中放行 5244 端口。

安装 OpenList

docker-cli

1	docker run -d --restart=unless-stopped -v /etc/openlist:/opt/openlist/data -p 5244:5244 -e PUID=0 -e PGID=0 -e UMASK=022 --name="openlist" openlistteam/openlist:beta

docker-compose

version: '3.3'
services:
  openlist:
    image: 'openlistteam/openlist:beta'
    container_name: openlist
    volumes:
      - '/etc/openlist:/opt/openlist/data'
    ports:
      - '5244:5244'
    environment:
      - PUID=0
      - PGID=0
      - UMASK=022
    restart: unless-stopped

环境变量

名称	默认值	说明
`PUID`	`0`	运行身份 UID
`PGID`	`0`	运行身份 GID
`UMASK`	`022`	https://en.wikipedia.org/wiki/Umask
`RUN_ARIA2`		是否同时运行 ARIA2，当镜像含有 aria2 环境时默认为 `true`，否则为 `false`
`TZ`		默认为 UTC 时区，如果你想指定时区，则可以设置此变量，例如：`Asia/Shanghai`

镜像版本
- 稳定版：openlistteam/openlist:latest 或指定本版，如 openlistteam/openlist:beta(Latest暂未上线)
- 最新镜像版本，请参阅 https://hub.docker.com/r/openlistteam/openlist/tags
- 开发版：openlistteam/openlist:beta
- 预装环境镜像后缀：
  
  后缀说明
  
  aio 同时包含下列所有预装环境的镜像
  
  ffmpeg 预装 ffmpeg 的镜像，用于本地存储缩略图
  
  aria2 预装 aria2 的镜像，用于离线下载

后缀	说明
`aio`	同时包含下列所有预装环境的镜像
`ffmpeg`	预装 ffmpeg 的镜像，用于本地存储缩略图
`aria2`	预装 aria2 的镜像，用于离线下载

查看管理员信息

低于 v3.25.0 版本

1	docker exec -it openlist ./openlist admin

高于 v3.25.0 版本

3.25.0 以上版本将密码改成加密方式存储的 hash 值，无法直接反算出密码，如果忘记了密码只能通过重新 随机生成 或者 手动设置

# 随机生成一个密码
docker exec -it openlist ./openlist admin random
# 手动设置一个密码,`NEW_PASSWORD`是指你需要设置的密码
docker exec -it openlist ./openlist admin set NEW_PASSWORD

添加存储

修改配置文件

删除或注释以下默认配置

1
2
3

- location ~ ^/(\.user.ini|\.htaccess|\.git|\.svn|\.project|LICENSE|README.md
- location ~ .\*\.(gif|jpg|jpeg|png|bmp|swf)$
- location ~ .\*\.(js|css)?$

示例

SSL和反向代理
- 默认 OpenList 是用 http://ip:5244 访问的，为了能够使 OpenList 用 https://domain/ 访问，需要在宝塔中配置 SSL + 反向代理。
- 注意：需先在 SSL 选项中申请证书，然后在设置反向代理。或者设置反向代理之后，关闭反向代理功能，申请 SSL 证书后再次开启代理。
- 配置 SSL
- 配置反向代理
- 按照上述配置完成后即可使用 https://domain/ 的方式访问 OpenList

更新 OpenList

# 拉取最新的镜像
docker-compose pull

# 重新启动容器
docker-compose up -d

# 清理旧容器（可选）
docker system prune -f

修改预览配置

OpenList 安装并配置完成可能会遇到 office 文件不能正常预览的问题，具体请参考：#594

为了解决这个问题，我们需要修改后台配置中的设置 —> 预览 —> Iframe 预览选项，具体如下：

将 
"Microsoft":"https://view.officeapps.live.com/op/view.aspx?src=$e_url",
改为
"Microsoft":"https://view.officeapps.live.com/op/view.aspx?src=$durl",

即：将 Microsoft 预览链接中的 $e_url 改成 $durl ，其它设置保持不变。

宝塔下安装 OpenList 教程

简介

安装教程

安装宝塔

放行端口

安装 OpenList

登录 OpenList 后台

查看管理员信息

低于 v3.25.0 版本

高于 v3.25.0 版本

添加存储

修改配置文件

SSL和反向代理

更新 OpenList

修改预览配置

参考链接