一、基础环境准备
- 安装Docker
确保系统已安装Docker和docker-compose工具。可通过以下命令检查：
docker --versiondocker-compose --version
若未安装，请参考官方文档安装Docker和docker-compose。
- 创建数据目录
建议创建持久化存储目录以保留配置：
mkdir -p /etc/alist
二、Docker命令行部署
- 拉取Alist镜像
docker pull xhofe/alist:latest
- 启动容器
使用以下命令部署容器（支持自定义端口和数据目录）：
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部署（推荐）
- 创建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-compose up -d
四、获取管理员密码
- 查看初始密码
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 # 手动设置密码
五、访问与管理
-
本地访问
浏览器打开[http://localhost:5244 ](http://localhost:5244 )（若映射端口不同需替换）。 -
外网访问
- 方案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 ...（原启动命令） # 重新部署
（注意：数据目录需保持不变以保证配置不丢失）
- 备份与恢复
定期备份/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重置。
通过以上步骤，您可以在本地或服务器上快速部署Alist，并实现多网盘统一管理与外网访问。
