快速安装AList部署Docker (值得收藏)

AList 是一个支持多种存储的文件列表程序，可以把本地磁盘、WebDAV、对象存储等后端整理成一棵统一的目录树，通过网页展示出来。本文记录 Ubuntu 服务器上直接用 Docker 拉官方镜像部署 AList 的全过程：从拉镜像、挂载数据目录、设管理员密码，到浏览器访问和常见故障排查，命令都可以照着敲。

为什么选择用 Docker 部署 AList

AList 的价值在于把一个目录或多种存储挂载成统一入口，加存储是界面点几下的事，鉴权由它自己管，比手工配 nginx 别名目录省事得多。用 Docker 部署的好处是不用和系统包依赖纠缠：运行时都在镜像里，升级换个 tag 就行，容器出问题删掉重拉一个即可。

拉取官方镜像

docker pull xhofe/alist:latest

生产环境建议同时固定一个版本 tag 并用它部署，避免 latest 悄悄变更带来升级风险。

启动容器并挂载数据目录

最关键的一步是把容器内的 /opt/alist/data 挂到宿主机目录，否则容器一删配置全丢。下面这条命令把数据落到 /opt/alist/data，端口映射到宿主机 5244：

docker run -d --restart=always -v /opt/alist/data:/opt/alist/data -p 5244:5244 -e PUID=$(id -u) -e PGID=$(id -g) -e UMASK=022 --name alist xhofe/alist:latest

PUID、PGID 取当前用户的 uid 和 gid，让容器内写出来的文件归属跟宿主机一致，后面其他程序读取时不会因为权限被拒。

查看启动日志并修改管理员密码

docker ps
docker logs alist

AList 首次启动会随机生成管理员密码并打印在日志里，看过之后就没了，需要改密码时用下面这条命令：

docker exec -it alist ./alist admin set NEW_PASSWORD

把 NEW_PASSWORD 换成自己的强密码。如果提示找不到 alist 命令，先进容器看一下 /opt/alist 下的可执行文件路径。

浏览器访问与初始配置

浏览器打开 http://服务器IP:5244/ ，用刚才设的密码登录管理界面。在「存储」里添加要暴露的目录，本地目录选「本地」类型填根路径，远端存储按对应的 WebDAV、S3 等协议填连接参数。加完记得在设置里启用对应存储，否则首页看不到内容。

日常运维常用命令

• 重启容器：docker restart alist
• 停止容器：docker stop alist
• 查看数据目录：ls /opt/alist/data
• 备份配置：直接打包整个 /opt/alist/data 目录
• 彻底重来：docker rm -f alist 后重新 run

常见问题排查

• 页面打不开：先 docker ps 看容器状态，再用 ss -lntp 确认 5244 有没有在监听。
• 容器在跑但连不上：检查服务器防火墙、云安全组有没有放通 5244 端口。
• 登录成功但看不到文件：核对挂载的宿主机目录是否存在、权限是否可读，以及存储配置里的根路径写对了没。
• 重启后密码不对：说明数据卷没挂上，用 docker inspect alist 看 Mounts 字段确认路径映射。

qidao123.com企服评测-应用市场 编辑提示