使用Docker Compose部署AList文件列表程序的完整指南

AList是一个功能强大的文件列表程序，能够帮助用户轻松管理和分享各种存储服务中的文件。本文将详细介绍如何使用Docker Compose来部署AList服务，让您快速搭建个人或团队的文件管理系统。

准备工作

在开始部署前，请确保您的系统已安装以下组件：

• Docker引擎（版本17.06.0或更高）
• Docker Compose（版本1.18.0或更高）

部署配置详解

让我们逐项分析docker-compose.yml文件中的关键配置：

服务定义

services:
  alist:

这里定义了一个名为"alist"的服务，对应AList文件列表程序的容器实例。

容器重启策略

restart: always

设置容器为"always"重启策略，意味着无论容器因何原因退出，Docker都会自动重新启动它。这确保了AList服务的高可用性。

数据持久化

volumes:
  - '/etc/alist:/opt/alist/data'

将主机上的/etc/alist目录挂载到容器内的/opt/alist/data路径。这样做有两个重要目的：

1. 持久化存储AList的配置和数据，避免容器重启后数据丢失
2. 方便在主机上直接访问和备份AList的数据文件

端口映射

ports:
  - '5244:5244'
  - '5245:5245'

将容器的5244和5245端口映射到主机的相同端口。这两个端口分别是：

• 5244：AList的Web管理界面端口
• 5245：AList的API服务端口（如果有）

环境变量配置

environment:
  - PUID=0
  - PGID=0
  - UMASK=022
  - TZ=UTC

这些环境变量控制着容器的运行环境：

• PUID=0和PGID=0：指定容器以root用户身份运行（生产环境建议使用非root用户）
• UMASK=022：设置文件创建时的默认权限掩码
• TZ=UTC：设置容器的时区为UTC（可根据需要修改为本地时区，如Asia/Shanghai）

容器名称与镜像

container_name: alist
image: 'xhofe/alist:latest'

• container_name：为容器指定一个明确的名称，便于管理
• image：指定使用的AList镜像，这里使用官方提供的最新版本

部署步骤

1. 创建docker-compose.yml文件，将上述配置内容复制进去
2. 在终端中切换到包含docker-compose.yml的目录
3. 执行以下命令启动服务：

   docker-compose up -d
   

4. 等待容器启动完成后，通过浏览器访问http://服务器IP:5244即可使用AList

常见问题与优化建议

1. 权限问题：生产环境中不建议使用root用户运行容器，可以创建专用用户并修改PUID/PGID
2. 数据备份：定期备份/etc/alist目录中的内容
3. 资源限制：可以为容器添加CPU和内存限制，防止资源占用过高
4. 时区设置：将TZ环境变量设置为本地时区以获得正确的时间显示
5. 版本控制：生产环境建议使用特定版本标签而非latest，以确保稳定性

后续管理

• 停止服务：docker-compose down
• 查看日志：docker-compose logs -f alist
• 更新版本：先停止服务，然后拉取新镜像docker-compose pull，最后重新启动

通过以上配置和步骤，您已经成功部署了一个稳定可靠的AList文件列表服务。根据实际需求，您可以进一步调整配置，如添加HTTPS支持、集成其他存储服务等。