AList Linux 安装、更新与卸载：历史步骤与配置说明-未完纪

AList 是使用 Gin 和 SolidJS 的文件列表程序，可以连接不同存储，把文件集中到一个网页里浏览和管理。这里保留 2023 年 1 月的 Linux 安装、更新和卸载流程；截图中的管理界面版本为 v3.9.2。封面里的“2 分钟”是当时的简化介绍，实际耗时取决于下载速度、服务器环境和后续配置。

支持的存储方式

本地存储
阿里云盘
OneDrive
天翼云盘
谷歌云盘（Google Drive）
123 云盘
FTP / SFTP
Cloudreve

这份列表对应历史介绍，更多驱动及当前可用情况请查看项目文档。各网盘的接入条件、授权方式和服务限制会变化，不能仅凭旧截图保证现在仍能直接连接。

1. 连接 SSH，确认安装权限

在有管理权限的 Linux 服务器上连接 SSH。历史示例使用下面的命令切换到 root：

sudo su root

root 可以修改整个系统，只有确认安装脚本来源、内容和权限范围后再执行安装；不把网络下载内容直接管道交给 root 运行。当前官方一键脚本页面列出的 Linux 平台为 amd64/arm64，其他环境应选适配的安装方式。

2. 准备工作目录

可以先创建一个目录，用来保存和检查下载的脚本。把“文件夹名字”替换成你准备使用的目录名，再通过 cd 进入：

mkdir 文件夹名字
cd 文件夹名字

这个工作目录只影响你保存脚本的位置。单纯 mkdir、cd 不会改变 AList 的默认安装目录；官方脚本默认安装在 /opt/alist。自定义安装位置需要传入文档规定的第二个参数，而且必须是绝对路径：若路径以 alist 结尾则直接使用，否则会在该路径下创建 alist 目录。

3. 下载检查脚本，再安装

2023 年示例使用 alist.nn.ci/v3.sh。当前官方文档入口为 alistgo.com，正式版脚本地址也已变化。下面把旧命令保留在注释中用于对照，实际操作分成下载、阅读检查、确认后执行三个步骤：

# 历史命令，仅作对照，不直接执行：
# curl -fsSL "https://alist.nn.ci/v3.sh" | bash -s install

# 先下载，不自动执行
curl -fsSL "https://alistgo.com/v3.sh" -o v3.sh

# 用文本编辑器检查脚本来源、下载目标及将要修改的路径
# 确认后另行执行（默认安装目录 /opt/alist）：
bash v3.sh install
# 如需自定义目录，使用官方支持的绝对路径参数，例如：
# bash v3.sh install /srv/alist

不要把整段当作一条无需检查的“一键命令”。应先单独完成下载并审阅，再决定是否执行安装。本文只整理配置和命令，没有替你下载执行脚本或验证某个服务器上的安装结果。

安装成功后，历史默认访问地址为 http://服务器地址:5244。下面保留成功输出的完整界面，初始管理员密码已遮挡。

首次访问前先妥善保存初始化信息并修改管理员密码，只挂载自己有权访问的存储。当前版本的密码处理与旧图不同，按官方说明在实际安装目录管理账号；不要把终端输出、密码或存储凭据公开。

如果网页打不开，先确认服务是否运行、监听地址和端口是否正确，再检查主机防火墙及云安全组。不要为了排障把 5244 无限制暴露到公网。可以仅在受信任网络访问，或用 HTTPS 反向代理对外提供服务，再按需要限制后台访问。

4. 更新

更新前备份实际安装目录中的 data、配置文件及外部数据库，并查看版本变更和回退条件。若使用自定义路径，更新时沿用同一路径。旧命令保留在注释中，新的脚本仍要先下载和检查：

# 历史命令，仅作对照：
# curl -fsSL "https://alist.nn.ci/v3.sh" | bash -s update
curl -fsSL "https://alistgo.com/v3.sh" -o v3.sh
# 检查新下载的脚本并完成备份后，再执行：
bash v3.sh update
# 自定义路径示例：bash v3.sh update /srv/alist

5. 卸载

卸载可能删除安装目录及其中数据。先备份文件、挂载配置、账号信息和数据库，确认要移除的实例与路径，再执行。自定义安装目录仍需传入相同参数：

# 历史命令，仅作对照：
# curl -fsSL "https://alist.nn.ci/v3.sh" | bash -s uninstall
curl -fsSL "https://alistgo.com/v3.sh" -o v3.sh
# 检查脚本，确认备份和目标路径后，再执行：
bash v3.sh uninstall
# 自定义路径示例：bash v3.sh uninstall /srv/alist