Docker部署 Alist

一、基础环境准备

1. 安装Docker
   确保系统已安装Docker和docker-compose工具。可通过以下命令检查：

   docker --version
   docker-compose --version

若未安装，请参考官方文档安装Docker和docker-compose。

2. 创建数据目录
   建议创建持久化存储目录以保留配置：

   mkdir -p /etc/alist

二、Docker命令行部署

1. 拉取Alist镜像

   docker pull xhofe/alist:latest

2. 启动容器
   使用以下命令部署容器（支持自定义端口和数据目录）：

   docker run -d \
     --restart=unless-stopped \
     -v /etc/alist:/opt/alist/data \
     -p 5244:5244 \
     -e PUID=0 \
     -e PGID=0 \
     -e UMASK=022 \
     -e TZ=Asia/Shanghai \
     --name="alist" \
     xhofe/alist:latest

• -v /etc/alist:/opt/alist/data：将本地目录挂载到容器内，实现配置持久化。
• -p 5244:5244：容器端口映射，左侧可自定义主机端口。
• TZ=Asia/Shanghai：设置容器时区。

三、Docker Compose部署（推荐）

1. 创建docker-compose.yml文件

   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
         - TZ=Asia/Shanghai
       restart: unless-stopped

2. 启动服务

   docker-compose up -d

四、获取管理员密码

1. 查看初始密码

   docker exec -it alist ./alist admin

• 对于v3.25.0及以上版本，密码可能随机生成，需使用：

     docker exec -it alist ./alist admin random  # 生成随机密码
     docker exec -it alist ./alist admin set NEW_PASSWORD  # 手动设置密码

五、访问与管理

1. 本地访问
   浏览器打开 [http://localhost:5244 ](http://localhost:5244 )（若映射端口不同需替换）。

2. 外网访问

   • 方案1：直接暴露端口
     确保服务器安全组开放5244端口，通过 http://<公网IP>:5244 访问。
   • 方案2：内网穿透
     使用路由侠、PassNAT等工具映射内网端口5244到公网。
   • 方案3：Nginx反向代理
     配置域名和SSL证书，通过Nginx代理请求到5244端口。

六、更新与维护

1. 更新Alist版本

   docker stop alist && docker rm alist  # 停止并删除旧容器
   docker pull xhofe/alist:latest        # 拉取最新镜像
   docker run ...（原启动命令）          # 重新部署

（注意：数据目录需保持不变以保证配置不丢失）

2. 备份与恢复
   定期备份 /etc/alist 目录，恢复时重新挂载即可。

七、高级功能

1. 挂载云存储
   登录管理后台，支持添加阿里云盘、OneDrive、Google Drive等20+种存储服务。

2. WebDAV支持
   使用客户端通过 http://<IP>:5244/dav 路径连接，账号密码与Web端相同。

常见问题

• 端口冲突：修改 -p 参数左侧端口（如 -p 5255:5244）。
• 时区错误：添加 -e TZ=Asia/Shanghai 环境变量。
• 密码丢失：通过 docker exec -it alist ./alist admin random 重置。

通过以上步骤，您可以在本地或服务器上快速部署Alist，并实现多网盘统一管理与外网访问。