docker-compose 安装Alist

一、基础环境准备

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

docker --version
docker compose --version

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

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

mkdir -p /etc/alist

二、Docker Compose部署

1. 创建docker-compose.yml文件

      version: '3.3'services:alist:image: xhofe/alist:latestcontainer_name: alistvolumes:- '/etc/alist:/opt/alist/data'ports:- '5244:5244'environment:- PUID=0- PGID=0- UMASK=022- TZ=Asia/Shanghairestart: unless-stopped

三、获取管理员密码

• 查看初始密码

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（若映射端口不同需替换）。

2. 外网访问

   • 方案1：直接暴露端口
     确保服务器安全组开放5244端口，通过 http://<公网IP>:5244 访问。
   • 方案2：内网穿透
     使用路由侠、PassNAT、frp等工具映射内网端口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 重置。