Debian 使用 Docker 部署 Alist 网盘挂载

Alist 一个支持多种存储的文件列表程序，使用 Gin 和 Solidjs。

1、部署

按官方文档介绍，直接使用 docker 部署，docker 安装参考文章：Debian 安装国内源 Docker 及其他常用软件

可以参考文章：使用 Docker Compose 命令部署常用服务，更方便的部署。

1.1、创建文件夹

1	mkdir -p ~/.docker/alist/data

1.2、拉取最新镜像

1	docker pull xhofe/alist:latest

1.3、部署命令

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

2、生成管理员密码

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

随机生成一个密码

1	docker exec -it alist ./alist admin random

手动设置一个密码，NEW_PASSWORD 是指你需要设置的密码

1	docker exec -it alist ./alist admin set NEW_PASSWORD

忘记密码也可以通过这些命令进行重置。

3、配置 `Nginx`

Nginx 安装参考文章：Debian 安装国内源 Docker 及其他常用软件

3.1、生成证书

如果服务器已经安装 certbot，只需要运行以下指令

1	certbot certonly --dns-cloudflare --dns-cloudflare-credentials ~/.secrets/certbot/cloudflare.ini -d alist.ysbzcn.com --email 'email@ysbzcn.com'

如果没有 certbot，需要一些前置安装，参考文章：Debian 安装国内源 Docker 及其他常用软件

3.2、新建 `nginx` 配置文件

将域名解析到服务器，利用 Nginx 代理请求 127.0.0.1:5255
进入 /etc/nginx/conf.d 文件夹，新建一个 alist.conf 配置

upstream alist {
  server 127.0.0.1:5255;
}

# HTTP 重定向到 HTTPS
server {
    listen 80;
    listen [::]:80;
    server_name alist.ysbzcn.com;

    if ($host = alist.ysbzcn.com) {
        return 301 https://$host$request_uri;
    }
    return 403;

  # 隐藏 Nginx 版本号
    server_tokens off;
}

server {
    listen 443 ssl;
    listen [::]:443 ssl;
    http2 on;

    server_name alist.ysbzcn.com;

  # 隐藏 Nginx 版本号
    server_tokens off;

  # 判断 $host 如果不是设置好的域名，就返回403页面，可以禁止 IP 访问 Web。
    if ($host !~ (alist.ysbzcn.com)$){
      return 403;
   }
 
  # 证书位置
    ssl_certificate      /etc/letsencrypt/live/alist.ysbzcn.com/fullchain.pem; 
    ssl_certificate_key  /etc/letsencrypt/live/alist.ysbzcn.com/privkey.pem;

  # 可选 SSL 配置
    ssl_protocols TLSv1.2 TLSv1.3; # 支持的协议版本
    ssl_ciphers HIGH:!aNULL:!MD5; # 加密套件
    ssl_prefer_server_ciphers on; # 优先使用服务器加密套件

  # 访问和错误日志路径
    access_log   /var/log/nginx/nginx.alist.access.log;
    error_log    /var/log/nginx/nginx.alist.error.log;

  # 反向代理配置
    location / {
        proxy_pass http://alist;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

  # 拒绝访问隐藏文件： 此配置拒绝对隐藏文件（以点开头）的访问，这可以防止信息泄露。    
    location ~ /\. {
        deny all;
    }
}

3.3、验证并重载 `nginx` 配置

nginx -t

1	nginx -s reload

4、更新

4.1、停止并移除旧容器

1	docker stop alist && docker rm alist

4.2、拉取最新镜像

1	docker pull xhofe/alist:latest

4.3、重新部署

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