docker-compose 安装Alist

一、基础环境准备

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

bash 复制代码

docker --version
docker compose --version

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

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

bash 复制代码

mkdir -p /etc/alist

二、Docker Compose部署

创建docker-compose.yml文件

bash 复制代码

   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

三、获取管理员密码

查看初始密码

bash 复制代码

docker exec -it alist ./alist admin

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

bash 复制代码

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

四、访问与管理

本地访问

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

五、更新与维护

更新Alist版本

bash 复制代码

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

复制代码

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

2.备份与恢复

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

六、高级功能

挂载云存储

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

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

常见问题

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