nonnichen/alist Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Alist MOD Docker镜像文档

镜像概述

Alist MOD是基于Alist的修改版Docker镜像，主要用于文件列表管理与多存储服务整合。该镜像提供便捷的Web界面，支持多种存储后端（如本地存储、云存储等），可帮助用户集中管理和访问不同来源的文件资源，通过Docker容器化部署，简化安装配置流程，确保数据持久化与服务稳定运行。

核心功能与特性

• 多存储支持：整合多种存储服务，包括本地文件系统、云存储（如阿里云OSS、腾讯云COS等）及网络存储协议（如S3、WebDAV等）。
• Web界面管理：提供直观的Web管理界面，支持文件上传、下载、预览、分享等操作。
• 数据持久化：通过挂载本地目录实现数据持久化，确保容器重启后配置和文件数据不丢失。
• 灵活配置：支持通过环境变量设置用户/组ID（PUID/PGID）及权限掩码（UMASK），适配不同系统权限需求。
• 自动重启：默认配置容器自动重启，保证服务持续可用。

使用场景与适用范围

• 个人文件管理：集中管理本地存储与云存储文件，通过Web界面便捷访问。
• 团队协作：作为团队文件共享平台，整合多成员的存储资源。
• 轻量级文件服务器：快速搭建个人或小型团队的文件访问服务。

使用方法与配置说明

基本部署命令

通过以下docker run命令快速部署Alist MOD容器：

bash
docker run -d --restart=always \
  -v /mnt/app/alist:/opt/alist/data \
  -p 5244:5244 \
  -e PUID=0 \
  -e PGID=0 \
  -e UMASK=022 \
  --name="alist" \
  nonnichen/alist:latest

参数说明

访问与配置

1. 部署完成后，通过浏览器访问 [***] 进入Alist MOD Web界面。
2. 首次登录需使用初始管理员账号密码（可通过容器日志查看，命令：docker logs alist）。
3. 登录后可在Web界面中添加存储后端、配置用户权限、管理文件等。

数据备份

由于数据通过-v参数挂载到本地目录，直接备份本地目录/mnt/app/alist即可实现数据备份。

注意事项

• 确保本地挂载目录/mnt/app/alist存在且具有读写权限，避免因权限问题导致数据无法持久化。
• 根据实际需求调整PUID/PGID，非root用户需确保本地目录权限与容器内用户权限匹配。
• 如需修改端口，可调整-p参数（如-p 8080:5244将主机端口8080映射到容器5244端口）。