date: 2025-04-23
title: "Docker-Alist"
status: DONE
author:
  - AllenYGY
tags:
  - NOTE
publish: false

AList Docker 安装与配置指南

前提条件

你已经在服务器或本地环境安装了 Docker
（可选）已经安装 Docker Compose

1. 拉取 AList Docker 镜像

docker pull xhofe/alist:latest

2. 创建本地数据目录

用来保存配置文件和数据，防止容器销毁后数据丢失：

mkdir -p /opt/alist/data

3. 启动容器

方式一：直接用 Docker 命令

docker run -d \
  --name=alist \
  -v /opt/alist/data:/opt/alist/data \
  -p 5244:5244 \
  --restart=unless-stopped \
  xhofe/alist:latest

参数解释：

-d：后台运行
--name=alist：容器名称
-v：挂载数据目录（左本地，右容器内部）
-p：端口映射（默认 5244）
--restart=unless-stopped：随 Docker 自动重启

方式二：用 Docker Compose（更推荐，易管理）

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

version: "3"
services:
  alist:
    image: xhofe/alist:latest
    container_name: alist
    volumes:
      - /opt/alist/data:/opt/alist/data
    ports:
      - 5244:5244
    restart: unless-stopped

然后执行：

docker-compose up -d

4. 查看并初始化 Web 管理后台

初次启动后，你需要获取初始管理密码：

docker logs alist

终端会显示一组初始账号和密码。
默认访问地址: http://<你的IP>:5244

5. 更改初始密码

docker exec -it alist ./alist admin set NEW_PASSWORD

6. 后续操作

后台添加你要挂载的网盘（如OneDrive、阿里云盘…）
配置各项参数 & 权限
具体挂载方式请参考官方文档和【后台指南】

常见问题

端口冲突：可自行修改 -p 5244:5244 前面的5244为其他端口
更新AList：重新docker pull拉取新版，然后销毁旧容器再用同样的命令创建即可，数据不会丢失