AList部署实战：从Docker到原生安装全攻略

你是否还在为多网盘管理烦恼？是否想搭建一个统一的文件管理系统却被复杂的部署步骤劝退？本文将带你从零开始，用两种最主流的方式部署AList——无论是追求便捷的Docker一键部署，还是需要深度定制的原生安装，都能在这里找到答案。读完本文，你将获得：

• 3分钟Docker快速启动AList的完整命令
• 原生环境编译安装的避坑指南
• 数据持久化与端口配置的最佳实践
• 官方配置文件的深度解读

关于AList

AList是一款支持多种存储后端的文件列表程序，采用Gin和Solidjs开发，能够将阿里云盘、OneDrive、本地存储等多种存储服务聚合管理。项目核心特性包括：

• 支持40+种存储类型(完整列表)
• 开箱即用的文件预览功能(源码实现)
• 支持WebDav协议(配置指南)

Docker部署（推荐新手）

准备工作

确保你的系统已安装Docker和Docker Compose。项目提供了预配置的docker-compose.yml文件，包含以下核心配置：

version: '3.3'
services:
  alist:
    restart: always
    volumes:
      - '/etc/alist:/opt/alist/data'  # 数据持久化目录
    ports:
      - '5244:5244'  # Web访问端口
    environment:
      - PUID=0
      - PGID=0
      - TZ=UTC  # 时区设置
    image: 'xhofe/alist:latest'

一键部署步骤

1. 克隆仓库

git clone https://gitcode.com/GitHub_Trending/al/alist.git
cd alist

2. 启动服务

docker-compose up -d

3. 获取初始密码

docker exec -it alist ./alist admin

配置说明

• 数据卷映射：/etc/alist目录存放配置文件和用户数据，需确保有读写权限
• 端口映射：默认5244端口，如需修改可调整docker-compose.yml中的端口映射
• 环境变量：PUID/PGID控制容器内用户权限，TZ设置时区（如Asia/Shanghai）

原生安装（适合开发者）

编译环境要求

• Go 1.20+
• Git
• GCC编译器

编译步骤

1. 克隆源码

git clone https://gitcode.com/GitHub_Trending/al/alist.git
cd alist

2. 编译可执行文件

go mod download
bash build.sh release  # 使用官方构建脚本[build.sh](https://gitcode.com/GitHub_Trending/al/alist/blob/81a7f28ba2dea62873dfcfd782928ac2acd0c52c/build.sh?utm_source=gitcode_repo_files)

3. 安装到系统路径

sudo cp bin/alist /usr/local/bin/

服务配置

创建系统服务文件（以systemd为例）：

[Unit]
Description=AList service
After=network.target

[Service]
Type=simple
User=root
ExecStart=/usr/local/bin/alist server
WorkingDirectory=/etc/alist
Restart=on-failure

[Install]
WantedBy=multi-user.target

核心配置文件解析

数据目录结构

AList的所有配置和数据都保存在data目录下，关键文件包括：

• config.json：主配置文件(示例)
• users.db：用户数据库
• storage.json：存储后端配置

端口与安全设置

默认Web服务端口为5244，可在启动时通过--port参数修改：

./alist server --port 8080

验证部署

访问http://服务器IP:5244，使用初始密码登录后即可开始添加存储。管理界面支持可视化配置各种存储后端，包括：

• 阿里云盘(驱动实现)
• FTP/SFTP(连接模块)
• 本地文件系统(实现代码)

常见问题解决

Docker部署后忘记密码

docker exec -it alist ./alist admin set NEW_PASSWORD

原生安装启动失败

检查日志输出：

./alist server --log-level debug

总结

本文详细介绍了AList的两种部署方式，Docker方式适合快速上手，原生安装适合需要深度定制的场景。项目的Dockerfile和部署脚本都经过官方优化，建议生产环境优先采用容器化部署。

如果觉得本文对你有帮助，欢迎点赞收藏，关注项目更新获取更多功能。下一教程我们将深入探讨多存储策略与访问控制配置，敬请期待！

官方文档：docs
源码仓库：GitHub_Trending/al/alist