一、基础环境准备
- 安装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,并实现多网盘统一管理与外网访问。