OpenAlist 搭建教程 – 手把手带你部署私人云盘

一、OpenAlist 是什么

OpenAlist 是一个支持多存储的文件列表程序。你可以把它部署在自己的电脑或云服务器上，然后通过浏览器访问，像使用自己的网盘一样管理文件。

它能把阿里云盘、百度网盘、夸克网盘、OneDrive、天翼云盘、123 云盘、本地硬盘等几十种不同的存储服务整合在一个统一的网页界面中。你可以在线预览视频、音频、图片、文档，还能通过 WebDAV 协议让手机、电视、播放器等设备直接访问你的文件。

OpenAlist 是社区在官方 Alist 基础上二次开发的增强版本。它在保留官方所有功能的同时，额外增加了更多第三方存储驱动（如夸克网盘、UC 网盘等）和一些界面优化。

项目完全开源免费。

二、部署前准备

在开始部署之前，你需要准备以下东西：

准备项	说明	是否必须
一台电脑或云服务器	Windows/Mac/Linux 都可以。长期 24 小时使用推荐云服务器	✅ 必须
基本的终端操作能力	会打开命令提示符（Windows）或终端（Mac/Linux），会复制粘贴命令	✅ 必须
网盘账号（可选）	如果要挂载网盘，需要准备对应网盘的账号，以及获取刷新令牌（refresh_token）	❌ 可选

三、部署方式一：Windows 电脑直接部署

适用场景：你有一台 Windows 10 或 Windows 11 电脑，想在本地快速搭建起来体验。缺点是电脑关机后服务就停了。

3.1 下载 OpenAlist

1. 打开浏览器，在 GitHub 中搜索 OpenAlist，找到星标（Star）最多的仓库。
2. 进入仓库后，点击右侧的 Releases（发行版）。
3. 在最新版本的 Assets（附件）列表中，找到 Windows 版本。文件名通常为 alist-windows-amd64.zip。
4. 点击下载。如果 GitHub 下载速度很慢，可以右键复制下载链接，然后用迅雷或 IDM 下载，或者使用 GitHub 加速服务。

3.2 创建文件夹并解压

1. 在你的电脑上找一个位置（比如 D 盘根目录），新建一个文件夹，命名为 openalist。
2. 重要：文件夹路径中不能包含中文字符或空格。正确示例：D:\openalist、C:\Users\用户名\Desktop\openalist。错误示例：D:\我的文件\open alist。
3. 把下载好的 ZIP 文件里的所有内容解压到这个文件夹中。解压后，文件夹内应该能看到一个名为 alist.exe 的文件。

3.3 启动 OpenAlist 并获取初始密码

1. 打开刚才创建的 openalist 文件夹。
2. 在文件夹的地址栏（不是搜索框，是显示路径的那个长条）中单击，路径会变成蓝色选中状态。
3. 直接输入 cmd 然后按键盘上的回车键。这时会弹出一个黑底白字的命令提示符窗口。
4. 在命令提示符窗口中输入以下命令，然后按回车：
   

   alist.exe server

   
   
5. 如果这是第一次启动，程序会自动生成一个配置文件和一个数据文件夹。稍等几秒钟，终端会输出类似以下内容：
   

   init password: aB3xK9mP
   start server @ 0.0.0.0:5244

   
   
6. 记下这行 init password 后面的随机密码。这是管理员的初始密码，非常重要。你可以选中这行文字，按 Ctrl+C 复制，粘贴到记事本中保存。
7. 如果忘记保存密码，可以按 Ctrl+C 停止程序，然后执行 alist.exe admin random 重新生成一个随机密码。

命令提示符窗口不要关闭。一旦关闭，OpenAlist 服务就停止了。

3.4 首次登录后台

1. 打开你的浏览器（Chrome、Edge 等），在地址栏输入以下地址，然后按回车：
   

   http://127.0.0.1:5244

   
   

   你会看到 OpenAlist 的前台页面。目前是空的，因为我们还没有添加任何文件来源。

2. 在地址栏中，把地址改成以下内容，然后按回车：
   

   http://127.0.0.1:5244/@manage

   
   

   注意：/@manage 前面是斜杠，不要漏掉。

3. 你会看到一个登录页面。用户名输入 admin，密码输入刚才终端显示的随机密码。
4. 点击登录，进入管理后台。

3.5 修改管理员密码

登录后的第一件事，把随机密码改成你自己能记住的密码：

1. 在后台左侧菜单中，点击最下方的 个人资料。
2. 在“新密码”框中输入你的新密码，在“确认密码”框中再输入一遍。
3. 点击 保存。

至此，OpenAlist 已经可以正常访问了。接下来需要添加存储才能在首页看到文件。请跳到第六章“添加存储”继续阅读。

四、部署方式二：Linux 云服务器部署

适用场景：你购买了一台云服务器（阿里云/腾讯云/华为云等），希望 OpenAlist 24 小时在线，随时随地都能访问。

4.1 连接到你的云服务器

Windows 用户：推荐使用 FinalShell 或 Xshell 连接服务器。

1. 下载并安装 FinalShell（百度搜索即可，免费）。
2. 打开 FinalShell，点击左上角的文件夹图标（连接管理器）。
3. 点击“新建”按钮，选择 SSH 连接。
4. 填写以下信息：
   • 名称：随便填，比如“我的服务器”。
   • 主机：你的云服务器公网 IP 地址（在云服务商控制台可以看到）。
   • 端口：22（默认不需要改）。
   • 用户名：root（Linux 系统的管理员账号）。
   • 密码：你购买服务器时设置的密码。
5. 点击确定，然后双击这个连接。如果提示“是否接受主机密钥”，点击“接受并保存”。

Mac 用户：使用系统自带的“终端”应用。

1. 打开“终端”应用（在“启动台”的“其他”文件夹中）。
2. 输入以下命令后按回车：
   

   ssh root@你的服务器公网IP

   
   

   例如：ssh root@47.100.123.45

3. 输入密码（输入时屏幕不会显示任何字符，这是正常的安全机制），按回车。

4.2 一键安装 OpenAlist

连接服务器后，在终端中执行以下命令：

curl -fsSL "https://alist.nn.ci/v3.sh" | bash -s install

这个命令会自动完成以下操作：

• 检测你的 Linux 系统类型和架构
• 下载最新版本的 Alist
• 将程序安装到 /opt/alist/ 目录
• 注册为系统服务（开机自启）

安装完成后，终端会显示类似以下信息：

Alist 安装成功！
访问地址：http://你的IP:5244
管理员用户名：admin
管理员密码：xxxxxxxx

记下这个密码。如果没记到，可以执行 cd /opt/alist && ./alist admin random 重新生成。

4.3 放行防火墙端口

云服务器有两层防火墙需要检查：

第一层：云服务商的安全组（在网页控制台操作）

1. 登录你的云服务商控制台（阿里云/腾讯云/华为云）。
2. 找到你的服务器，进入 安全组 或 防火墙 设置。
3. 点击 添加规则 或 入方向规则。
4. 填写：
   • 协议：TCP
   • 端口：5244
   • 来源/授权对象：0.0.0.0/0（表示允许所有 IP 访问）
5. 点击保存。

第二层：服务器系统防火墙（在终端操作）

如果你用的是 Ubuntu 系统，执行：

sudo ufw allow 5244

如果你用的是 CentOS 系统，执行：

sudo firewall-cmd --zone=public --add-port=5244/tcp --permanent
sudo firewall-cmd --reload

4.4 访问后台

1. 打开浏览器，输入 http://你的服务器公网IP:5244，回车。
2. 输入 http://你的服务器公网IP:5244/@manage，进入管理后台。
3. 用户名 admin，密码输入安装时显示的随机密码。

至此 Linux 部署完成。请跳到第六章“添加存储”继续阅读。

五、部署方式三：Docker 部署

适用场景：你的电脑或服务器上已经安装了 Docker，希望通过容器化方式快速部署。

5.1 确认 Docker 已安装

在终端中执行：

docker --version

如果显示版本号（如 Docker version 24.0.7），说明已安装。如果没有，请先去 https://www.docker.com 下载安装 Docker Desktop（Windows/Mac）或用 sudo apt install docker.io（Linux）安装。

5.2 拉取镜像并启动

OpenAlist 的 Docker 镜像可能有多个来源。如果 OpenAlist 官方提供了镜像，直接使用。如果没有，可以使用官方 Alist 镜像，然后后续在后台中手动替换或使用支持的第三方驱动。

使用官方 Alist 镜像（最稳定）：

# 创建数据目录
mkdir -p ~/openalist/data

# 拉取并启动容器
docker run -d \
  --name openalist \
  --restart unless-stopped \
  -p 5244:5244 \
  -v ~/openalist/data:/opt/alist/data \
  xhofe/alist:latest

命令逐行解释：

• docker run -d：创建并启动一个容器，-d 表示在后台运行。
• --name openalist：给容器起个名字叫 openalist，方便后续管理。
• --restart unless-stopped：容器崩溃或宿主机重启后，自动重新启动容器。
• -p 5244:5244：把宿主机的 5244 端口映射到容器内的 5244 端口。这样你访问宿主机 IP 的 5244 端口，就能访问到容器里的 Alist。
• -v ~/openalist/data:/opt/alist/data：把宿主机上的 ~/openalist/data 目录挂载到容器内的 /opt/alist/data 目录。这样容器的配置和数据会持久化保存在宿主机上，删除容器后数据不会丢失。
• xhofe/alist:latest：使用的 Docker 镜像名称。:latest 表示最新版本。

5.3 获取管理员密码

docker logs openalist

在输出的日志中，找到类似 init password: xxxxxxxx 或 password: xxxxxxxx 的行。这就是管理员初始密码。

如果日志很长，可以用以下命令过滤：

docker logs openalist 2>&1 | grep -i password

5.4 访问后台

和前面一样，浏览器访问 http://你的IP:5244/@manage，用 admin 和密码登录。

5.5 Docker 常用管理命令

# 查看运行中的容器
docker ps

# 停止容器
docker stop openalist

# 启动容器
docker start openalist

# 重启容器（修改配置后使用）
docker restart openalist

# 查看实时日志
docker logs -f openalist

# 更新到最新版本
docker pull xhofe/alist:latest
docker stop openalist
docker rm openalist
# 然后重新执行上面的 docker run 命令

六、添加存储——让 OpenAlist 显示文件

OpenAlist 搭建好之后，首页是空的，因为你还没有添加任何文件来源。你需要添加存储——告诉 OpenAlist 你的文件在哪里。

以下以添加本地存储和添加阿里云盘为例，其他存储的添加方式类似。

6.1 添加本地存储（显示自己电脑上的文件）

1. 登录 OpenAlist 后台。
2. 在左侧菜单中点击 存储。
3. 点击页面上的 添加 按钮。
4. 在 驱动 下拉菜单中，选择 本地存储。
5. 填写以下信息：
   • 挂载路径：填写 /本地文件（这是在前台首页显示的目录名称，斜杠不能省略，中文英文都可以）。
   • 根文件夹路径：填写你电脑上实际存放文件的文件夹的完整路径。
     • Windows 示例：D:\我的文件\资料 或 C:\Users\你的用户名\Documents
     • Linux 示例：/home/user/files 或 /mnt/data
6. 其他选项保持默认，点击页面底部的 保存 按钮。

现在回到 OpenAlist 首页（http://你的IP:5244），你应该能看到一个名为“本地文件”的文件夹。点击进入，里面就是你电脑上对应文件夹的内容。

6.2 添加阿里云盘

1. 在后台的存储页面，点击 添加。
2. 驱动选择 阿里云盘 Open。
3. 挂载路径填写 /阿里云盘。
4. 刷新令牌（refresh_token） 的获取方式：
   1. 在新标签页打开 https://alist.nn.ci/tool/aliyundrive/request
   2. 用手机上的阿里云盘 APP 扫描页面上的二维码。
   3. 扫描成功后，页面上会出现一段长长的字符串。点击 复制。
   4. 粘贴到 OpenAlist 后台的 刷新令牌 输入框中。
5. 点击 保存。

刷新首页，你会看到一个“阿里云盘”的目录，里面就是你阿里云盘里的所有文件。

6.3 添加其他网盘

OpenAlist 支持的存储类型包括但不限于：百度网盘、夸克网盘、OneDrive、天翼云盘、123 云盘、UC 网盘、谷歌网盘、SFTP、WebDAV 等。

添加步骤都是类似的：选择驱动 → 填写挂载路径 → 填写对应的认证信息。每种驱动的刷新令牌或认证方式不同，具体可以参考官方文档：https://alist.nn.ci/zh/guide/drivers/

七、进阶设置

7.1 开启 WebDAV

WebDAV 允许你用其他设备（手机、电视、播放器）直接访问 OpenAlist 中的文件。

• WebDAV 地址：http://你的IP:5244/dav
• 用户名：admin（或你创建的其他用户）
• 密码：管理员密码

在支持 WebDAV 的应用（如 RaiDrive、Infuse、PotPlayer、ES 文件浏览器）中填写以上信息，即可把 OpenAlist 挂载为本地磁盘或网络位置。

7.2 绑定自己的域名（可选）

如果你有自己的域名，并且使用云服务器，可以通过 Nginx 反向代理 实现用域名访问。

1. 在域名服务商处添加一条 A 记录，指向你的服务器 IP。
2. 在服务器上安装 Nginx：sudo apt install nginx -y
3. 创建 Nginx 配置文件 /etc/nginx/sites-available/alist：

server {
    listen 80;
    server_name 你的域名.com;   # 改成你的域名

    location / {
        proxy_pass http://127.0.0.1:5244;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

4. 启用配置：sudo ln -s /etc/nginx/sites-available/alist /etc/nginx/sites-enabled/
5. 测试配置：sudo nginx -t
6. 重载 Nginx：sudo systemctl reload nginx

现在就可以用 http://你的域名.com 来访问 OpenAlist 了。如果需要 HTTPS，可以使用 certbot 免费申请 SSL 证书。

八、常见问题与排查

Q1：忘记管理员密码

Windows：打开命令提示符，进入 alist.exe 所在目录，执行：

alist.exe admin random

终端会输出一个新的随机密码。用这个密码登录后立即修改。

Linux：进入安装目录执行：

cd /opt/alist
./alist admin random

Docker：

docker exec -it openalist ./alist admin random

Q2：云服务器访问不了 5244 端口

可能原因一：安全组未放行。
去云服务商控制台 → 安全组 → 入方向规则，添加：TCP 端口 5244，来源 0.0.0.0/0。

可能原因二：系统防火墙拦截。
Ubuntu 执行 sudo ufw allow 5244。
CentOS 执行 sudo firewall-cmd --add-port=5244/tcp --permanent && sudo firewall-cmd --reload。

Q3：启动时报“端口已被占用”

说明 5244 端口已经被其他程序使用了。可以指定其他端口启动：

alist.exe server --port 5245

然后访问 http://127.0.0.1:5245。

Q4：添加网盘后显示“failed get objs”

这通常是因为刷新令牌（refresh_token）过期或无效。重新获取令牌，在后台编辑该存储，替换新的令牌后保存。

Q5：遇到之前排查的 Connection refused 错误

如果你在添加存储时填写了某个 API 地址（比如 http://zk1.leapteam.cn:8080），这通常是因为：

• 你填写了某个内网穿透服务的地址，但该服务已经失效或没有启动。
• 你填写了某个第三方存储的 API 端点，但该服务不可用。

解决方案：

1. 登录后台 → 存储 → 逐一检查每个存储的配置，找到包含 zk1.leapteam.cn 或 8080 的存储。
2. 如果该存储的地址是你自己填的，确认该地址对应的服务是否正常运行。
3. 如果该存储不再使用，直接点击删除。
4. 如果该存储是你依赖的外部服务，联系服务提供者确认状态。

九、总结

OpenAlist 的完整搭建流程可以概括为：

1. 下载/拉取：获取对应系统的安装包或 Docker 镜像。
2. 启动：运行命令启动服务，记下随机生成的密码。
3. 登录：浏览器访问 /@manage，用 admin 和密码登录后台。
4. 添加存储：根据需要添加本地存储、阿里云盘或其他网盘。
5. 使用：在前台浏览文件、在线预览、通过 WebDAV 挂载到其他设备。

整个流程熟悉后，十分钟内就能完成部署。如果你需要挂载官方 Alist 暂未支持的网盘，OpenAlist 的社区驱动生态会是很好的补充。