家用伺服器折腾手记-4：Mac mini 部署 AList 服务 📁

发布时间：2025-03-10 | 分类：服务器, Docker, 文件管理

前言 📝

在前几篇文章中，我们已经在 Mac mini 上搭建了 Docker 环境并部署了多个服务。这次我们将探索如何部署 AList，这是一个强大的文件管理工具，支持多种存储方式，包括本地存储、网盘、对象存储等。AList 不仅提供了美观的 Web 界面，还支持 WebDAV、FTP 等协议，是一个功能丰富的文件管理解决方案。

为什么选择 AList 🤔

相比其他文件管理工具，AList 具有以下优势：

环境准备 🛠️

在开始部署之前，请确保你已经安装了 Docker 和 Docker Compose。如果还没有安装，可以参考第一篇文章中的安装步骤。

1. 确认 Docker 环境

首先确保你的 Docker 环境正常运行：

docker --version
docker compose version

2. 创建工作目录

mkdir -p ~/docker/alist/{config,data}
cd ~/docker/alist

3. 拉取最新镜像

docker pull xhofe/alist:latest

部署 AList 🚀

以下配置已经过优化，适用于大多数使用场景。如果你有特殊需求，可以参考进阶设置部分进行调整。

1. 创建 Docker Compose 配置

在工作目录下创建 docker-compose.yml 文件：

version: '3'
services:
  alist:
    container_name: alist
    image: xhofe/alist:latest
    ports:
      - "5244:5244"
    volumes:
      - ./config:/opt/alist/config
      - ./data:/opt/alist/data
    environment:
      - PUID=0
      - PGID=0
      - TZ=Asia/Shanghai
    restart: always

2. 启动服务

docker compose up -d

启动后，可以通过 http://localhost:5244 访问 AList 界面。

基础配置 ⚙️

1. 初始账户设置

首次访问时需要注意以下几点：

2. 存储管理

添加存储时，建议先使用本地存储进行测试，确保基本功能正常后再添加其他存储。

AList 支持多种存储方式，包括：

进阶设置 🎯

1. 反向代理

如果你使用 Nginx 作为反向代理，可以添加以下配置：

location /alist/ {
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_pass http://localhost:5244/;
}
启用 HTTPS 可以保护你的数据安全，建议在生产环境中使用。

2. 文件预览

AList 支持多种文件格式的预览，包括：

3. 自动更新

可以使用 Watchtower 自动更新容器：

docker run --rm \
  --volume /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --run-once alist

使用技巧 💡

1. 文件管理

2. 性能优化

常见问题 ❓

1. 连接问题

如果遇到连接错误，通常是因为容器无法正常启动。可以尝试以下解决方案：

2. 性能问题

如果遇到性能问题，可以：

后续计划 📅

在完成 AList 的部署和配置后，我们还可以进一步优化和扩展系统：

在下一篇文章中，我们将介绍如何使用 AList 搭建个人文件管理系统，包括存储配置、权限管理、文件预览等内容，敬请期待！