宝塔下安装Alist教程

  • 一个支持多存储的文件列表程序,使用 Gin 和 Solidjs。
  • AList 从一开始就设计为易于安装,并且可以在所有平台上使用。
  • AList 支持多个存储提供商,包括本地存储、阿里云盘、OneDrive、Google Drive 等,且易于拓展。
  • AList 支持所有 WebDAV 存储,这是一种用于访问文件的标准。
  • 支持为特定路径添加密码保护和身份验证。
  • 支持视频、音频、文档、PDF、图片预览等,甚至支持 ipa 安装。
  • 支持文本编辑器、README / HTML 渲染、文件永久链接、Cloudflare Workers 代理等。

安装教程

  1. 安装宝塔

    • 系统兼容性排序: Debian-12(推荐)/ Ubuntu-22 / Centos 9 / OpenCloud 9 / AlibabaCloud 3 麒麟,统信,欧拉等Linux系统
    • 稳定版:推荐公司、企事业单位及生产环境使用,特别注重安全和稳定性,只修BUG,不加新功能
    • 正式版:推荐技术爱好者使用,每月都会更新新功能

    Centos/OpenCloud/Alibaba 安装脚本 v9.0.0

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

    Debian 安装脚本 v9.0.0

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

    Ubuntu/Deepin 安装脚本 v9.0.0

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

    通用安装脚本 v9.0.0

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

    正式版 v9.2.0 通用安装脚本

    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
  2. 放行端口

    • 因为 Alist 需要使用端口 5244,因此需要提前在宝塔中放行。
    • 在宝塔界面里的 安全 中放行 5244 端口即可!
    • 如果有安全组防火墙的,同样需要在安全组防火墙中放行 5244 端口。
  3. 安装Alist

    • docker-cli

      1
      docker run -d --restart=unless-stopped -v /etc/alist:/opt/alist/data -p 5244:5244 -e PUID=0 -e PGID=0 -e UMASK=022 --name="alist" xhofe/alist:latest
    • docker-compose

      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      version: '3.3'
      services:
      alist:
      image: 'xhofe/alist:latest'
      container_name: alist
      volumes:
      - '/etc/alist:/opt/alist/data'
      ports:
      - '5244:5244'
      environment:
      - PUID=0
      - PGID=0
      - UMASK=022
      restart: unless-stopped

    仅适用于 amd64/arm64。不推荐,这可能无法正常工作。

    • docker-cli

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

      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      version: '3.3'
      services:
      alist:
      image: 'xhofe/alist:beta'
      container_name: alist
      volumes:
      - '/etc/alist:/opt/alist/data'
      ports:
      - '5244:5244'
      environment:
      - PUID=0
      - PGID=0
      - UMASK=022
      restart: unless-stopped

    服务运行之后,容器默认的时区为UTC时区,如果你想指定容器运行的时区,则可以通过传递此变量来实现:-e "TZ=Asia/Shanghai"

  4. 登录 Alist 后台

    安装成功后,打开 http://ip:5244 就可以看见后台登陆页面了。

  5. 查看管理员信息

    • 低于 v3.25.0 版本

      1
      docker exec -it alist ./alist admin
    • 高于 v3.25.0 版本

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

      1
      2
      3
      4
      # 随机生成一个密码
      docker exec -it alist ./alist admin random
      # 手动设置一个密码,`NEW_PASSWORD`是指你需要设置的密码
      docker exec -it alist ./alist admin set NEW_PASSWORD
  6. 添加存储

  7. 修改配置文件

    • 删除或注释以下默认配置

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

  8. SSL和反向代理

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

    1
    2
    3
    4
    5
    6
    7
    8
    # 拉取最新的镜像
    docker-compose pull

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

    # 清理旧容器(可选)
    docker system prune -f

修改预览配置

  • Alist 安装并配置完成可能会遇到 office 文件不能正常预览 的问题,具体请参考:#594
  • 为了解决这个问题,我们需要修改后台配置中的 设置 —> 预览 —> Iframe 预览 选项,具体如下:
    1
    2
    3
    4

    "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 ,其它设置保持不变。

参考链接

本文结束 感谢您的阅读
正在加载今日诗词....