shuzhuoi/alist

alist Docker镜像（中国优化版）

镜像概述

本镜像基于官方alist项目构建，针对中国用户进行优化，默认配置中国上海时区，支持通过环境变量直接设置管理员密码，且发布版本与官方版本保持同步，旨在为中国用户提供更便捷的部署和使用体验。

核心功能与特性

• 时区优化：默认时区设置为中国上海（Asia/Shanghai），无需额外配置时间同步。
• 密码指定：支持通过PASSWORD环境变量直接设置管理员密码，简化初始配置流程。
• 版本同步：发布版本与官方alist保持一致，确保功能更新和安全补丁同步获取。

使用场景

• 个人文件管理与共享服务部署
• 多存储源（本地存储、云存储等）整合管理
• 轻量级文件服务器快速搭建

使用方法与配置说明

环境变量说明

Docker CLI 部署

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

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

参数说明：

• -v /etc/alist:/opt/alist/data：挂载本地目录用于持久化存储数据
• -p 5244:5244：映射容器端口到主机，默认访问端口为5244
• -e PASSWORD=123456：设置管理员密码为***（请替换为自定义密码）

Docker Compose 部署

创建docker-compose.yml文件，内容如下：

yaml
version: '3.3'
services:
  alist:
    image: 'shuzhuoi/alist:latest'
    container_name: alist
    volumes:
      - './etc/alist:/opt/alist/data'  # 本地数据持久化目录
    ports:
      - '5244:5244'  # 端口映射
    environment:
      - PUID=0        # 用户ID
      - PGID=0        # 组ID
      - UMASK=022     # 权限掩码
      - PASSWORD=123456  # 管理员密码（替换为自定义密码）
    restart: always  # 容器异常时自动重启

启动容器：

bash
docker-compose up -d

访问服务

容器启动后，通过浏览器访问 http://<主机IP>:5244，使用设置的PASSWORD登录管理界面。