driverfromyihe/alist

Alist Docker镜像文档

镜像概述

Alist Docker镜像是基于Alist项目（https://github.com/Xhofe/alist%EF%BC%89%E6%9E%84%E5%BB%BA%E7%9A%84%E5%AE%B9%E5%99%A8%E5%8C%96%E9%83%A8%E7%BD%B2%E6%96%B9%E6%A1%88%E3%80%82Alist%E6%98%AF%E4%B8%80%E6%AC%BE%E5%8A%9F%E8%83%BD%E5%BC%BA%E5%A4%A7%E7%9A%84%E6%96%87%E4%BB%B6%E5%88%97%E8%A1%A8%E7%A8%8B%E5%BA%8F%EF%BC%8C%E6%94%AF%E6%8C%81%E5%A4%9A%E7%A7%8D%E5%AD%98%E5%82%A8%E5%90%8E%E7%AB%AF%EF%BC%88%E5%A6%82%E6%9C%AC%E5%9C%B0%E5%AD%98%E5%82%A8%E3%80%81%E4%BA%91%E5%AD%98%E5%82%A8%E7%AD%89%EF%BC%89%EF%BC%8C%E6%8F%90%E4%BE%9BWeb%E7%95%8C%E9%9D%A2%E7%94%A8%E4%BA%8E%E6%96%87%E4%BB%B6%E7%AE%A1%E7%90%86%E3%80%81%E9%A2%84%E8%A7%88%E5%92%8C%E8%AE%BF%E9%97%AE%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E4%B8%AA%E4%BA%BA%E6%88%96%E4%BC%81%E4%B8%9A%E6%90%AD%E5%BB%BA%E7%A7%81%E6%9C%89%E6%96%87%E4%BB%B6%E6%9C%8D%E5%8A%A1%E3%80%82

核心功能与特性

• 多存储后端支持：兼容本地存储、阿里云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 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%EF%BC%89%E3%80%82

docker-compose部署（推荐）

创建docker-compose.yml文件：

yaml
version: '3'
services:
  alist:
    image: 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文件具有正确的权限，避免容器无法读取配置
• 根据实际需求调整端口映射和存储后端配置
• 定期备份配置文件，防止数据丢失