admibo/alist

alist Docker镜像文档

镜像概述

该镜像用于快速部署alist服务。alist是一款多功能文件列表程序，支持多种存储后端（如本地存储、云存储等），提供Web界面管理文件，可实现文件的上传、下载、分享等功能，适用于个人文件管理、团队协作或服务器文件展示场景。

核心功能与特性

• 数据持久化：通过卷挂载实现配置和用户数据的持久化存储，避免容器重启导致数据丢失
• 端口映射：默认映射5244端口，便于通过Web浏览器访问服务
• 权限控制：支持通过环境变量配置容器内用户ID（PUID）、用户组ID（PGID）及文件权限掩码（UMASK），确保文件操作权限正确
• 自动恢复：支持容器自动重启策略，保障服务持续稳定运行

使用场景

• 个人文件管理：搭建个人私有云存储，管理本地或云端文件
• 团队文件协作：团队内部文件共享与协作，支持多用户访问
• 服务器文件展示：对外展示服务器文件目录，提供便捷的文件下载入口

使用方法

基本部署（docker run）

通过以下命令快速启动alist服务：

bash
docker run -d --restart=always -v /etc/alist:/opt/alist/data -p 5244:5244 -e PUID=0 -e PGID=0 -e UMASK=022 --name="alist" docker.xuanyuan.run/admibo/alist:latest

参数说明：

• -d：后台运行容器
• --restart=always：容器退出时自动重启
• -v /etc/alist:/opt/alist/data：将宿主机/etc/alist目录挂载到容器内/opt/alist/data目录，用于持久化存储配置文件和用户数据
• -p 5244:5244：将容器5244端口映射到宿主机5244端口，通过http://宿主机IP:5244访问服务
• -e PUID=0：设置容器内运行用户ID（0为root用户，可根据需求调整）
• -e PGID=0：设置容器内运行用户组ID（0为root组，需与PUID对应）
• -e UMASK=022：设置文件权限掩码，控制新创建文件的默认权限（022表示文件权限为644，目录权限为755）
• --name="alist"：指定容器名称为"alist"，便于管理
• admibo/alist:latest：使用最新版本的alist镜像

访问服务

部署完成后，在浏览器中访问 http://宿主机IP:5244 即可打开alist的Web管理界面，首次使用需根据引导完成初始配置。

数据管理

• 备份：直接备份宿主机/etc/alist目录即可保存所有配置和用户数据
• 迁移：将备份的/etc/alist目录复制到新环境，重新执行部署命令即可恢复服务