driverfromyihe/alist

Alist Docker镜像文档

镜像概述

Alist Docker镜像是基于Alist项目（https://github.com/Xhofe/alist）构建的容器化部署方案。Alist是一款功能强大的文件列表程序，支持多种存储后端（如本地存储、云存储等），提供Web界面用于文件管理、预览和访问，适用于个人或企业搭建私有文件服务。

核心功能与特性

• 多存储后端支持：兼容本地存储、阿里云OSS、腾讯云COS、OneDrive、Google Drive等多种存储服务
• Web管理界面：提供直观的Web界面，支持文件上传、下载、分享、重命名等操作
• 权限控制：支持用户管理和权限配置，可设置不同用户对文件的访问权限
• 文件预览：支持常见文件格式（如图片、文档、视频等）在线预览
• 轻量高效：容器化部署，资源占用低，易于维护和升级

使用场景

• 个人文件管理：搭建个人私有云存储，集中管理本地和云端文件
• 团队协作：企业或团队内部文件共享与协作
• 资源展示：作为文件下载站或资源分享平台，提供公开或密码保护的文件访问

使用方法

基本部署（docker run）

通过以下命令快速启动Alist容器：

bash
docker run -d -p 5244:5244 -v /root/alist/conf.yml:/app/conf.yml --name alist docker.xuanyuan.run/driverfromyihe/alist

参数说明：

• -d：后台运行容器
• -p 5244:5244：将容器内5244端口映射到主机5244端口（Alist默认端口）
• -v /root/alist/conf.yml:/app/conf.yml：挂载主机的配置文件到容器内，确保配置持久化
• --name alist：指定容器名称为alist
• driverfromyihe/alist：使用的Docker镜像名称

配置文件说明

Alist的配置通过conf.yml文件进行管理，挂载该文件可自定义存储后端、用户设置、端口等。配置文件示例及详细说明可参考Alist官方文档（https://github.com/Xhofe/alist）。

docker-compose部署（推荐）

创建docker-compose.yml文件：

yaml
version: '3'
services:
  alist:
    image: docker.xuanyuan.run/driverfromyihe/alist
    container_name: alist
    ports:
      - "5244:5244"
    volumes:
      - /path/to/your/conf.yml:/app/conf.yml
    restart: always

运行命令启动服务：

bash
docker-compose up -d

访问与管理

容器启动后，通过浏览器访问 http://主机IP:5244 即可打开Alist Web界面。初始管理员账号和密码可在容器日志中查看，或通过配置文件设置。

注意事项

• 确保挂载的conf.yml文件具有正确的权限，避免容器无法读取配置
• 根据实际需求调整端口映射和存储后端配置
• 定期备份配置文件，防止数据丢失