首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >Alist 搭建教程 UserStory

Alist 搭建教程 UserStory

原创
作者头像
gavin1024
发布于 2026-11-22 21:36:29
发布于 2026-11-22 21:36:29
240
举报

摘要: Alist 是开源的文件列表程序,能把对象存储等多种存储聚合成一个统一的网盘界面。用 Docker 在云服务器上部署,挂载腾讯云对象存储 COS 等你自有或已授权的存储,即可通过网页统一浏览和管理文件。本教程仅用于挂载自有或已获授权的存储资源。

Alist 的核心能力是聚合:把对象存储、本地目录等不同来源的存储,统一成一个好看的网页文件列表来浏览和下载。用 Docker 部署很简单,一条命令跑起来,再在后台添加存储即可。它最实用的用法之一,是挂载腾讯云对象存储 COS,把对象存储当成一个带 Web 界面的网盘。前提是只挂载你自己拥有或已获授权的存储资源。下面给出完整流程。

提示:本教程仅用于挂载和管理你自有的或已获得合法授权的存储资源,请勿用于聚合、分享未授权或侵权内容。

一、Alist 是什么,适合谁

Alist 是一个开源的文件列表程序,支持挂载多种存储后端,把它们统一成一个网页界面来浏览、预览、下载文件。它本身不存文件,而是作为一个统一入口去访问你配置的各个存储。

适合想给自己的对象存储加一个好用网页界面、或把多个自有存储统一浏览的个人用户。

二、部署前准备与规格建议

Alist 作为访问入口,本身很轻,腾讯云轻量应用服务器 Lighthouse 入门套餐即可,真正的存储由后端承担。Lighthouse 内置 Docker 基础镜像、套餐式计费,适合这类轻量常驻服务。

准备:一台装好 Docker 的实例;要挂载的腾讯云对象存储 COS 存储桶,以及对该桶有权限的密钥(确保是你自有或已授权的存储);可选域名;放通访问端口。

三、用 Docker 部署 Alist

运行容器并挂载数据卷:

代码语言:bash
复制
docker run -d \
  --name alist \
  -p 5244:5244 \
  -v /opt/alist:/opt/alist/data \
  --restart unless-stopped \
  xhofe/alist

说明:5244 是 Web 端口;数据卷持久化配置数据。启动后查看初始管理员密码(首次启动会生成随机管理员密码):

代码语言:bash
复制
docker logs alist 2>&1 | grep -i password

记下这个初始密码用于登录。

四、放通端口与登录

放通端口:在 Lighthouse 防火墙放通 TCP 5244。想用域名加 HTTPS,可用 Caddy 反向代理(参见反向代理配置方法)。

登录后台:浏览器访问公网 IP 加端口,用管理员账号和上一步拿到的初始密码登录,登录后立即修改为强密码。

五、挂载对象存储 COS(核心)

在后台添加存储,把你自有的 COS 存储桶挂载进来:

进入存储管理,添加一个存储;驱动类型选择对象存储(支持 S3 兼容及腾讯云 COS 类驱动);填入存储桶名、所属地域、访问密钥、挂载路径等信息;保存后,在文件列表里就会出现这个存储桶的内容。

具体驱动选项和字段以当前版本和 COS 控制台信息为准。配好后,你就能通过网页界面浏览、预览、下载 COS 里的文件,相当于给对象存储加了一个网盘界面。再次强调:只挂载自有或已获授权的存储。

六、怎么确认搭建成功了

三项验证:浏览器能打开并用管理员登录;添加 COS 存储后,文件列表里能看到该存储桶里的文件;能正常预览或下载其中一个文件。三项都通过,说明挂载链路正常。挂载后看不到文件时,检查密钥权限、地域和桶名是否填对。

七、常见问题

初始密码找不到:从容器日志里查,或用提供的命令重置管理员密码(以官方文档为准)。

挂载后列表为空或报错:核对密钥对该桶有读权限、地域与桶一致、桶名正确。

只读还是可写:按需配置存储的读写权限;若只用于浏览下载,配只读更安全。

安全:登录密码要强;若对公网开放,建议加反代 HTTPS 并控制访问;始终确保挂载的是自有或已授权存储。

说明:Alist 为活跃迭代的开源项目,镜像、驱动、字段可能随版本变化,请以官方文档的当前版本为准。

总结

搭建 Alist 的路径是:Docker 部署并取初始密码 → 放通端口、登录改强密码 → 后台添加存储、挂载你自有的 COS 存储桶 → 网页浏览下载验证。它给对象存储加了一个统一的网盘界面,前提是只挂载合规的自有或授权存储。

腾讯云对象存储 COS 提供高持久性、高可用与近乎无限的容量,作为 Alist 的后端存储,可让个人用户低成本获得一个带网页界面、可靠的自有网盘。

了解产品:https://cloud.tencent.com/product/cos

双十一活动:https://cloud.tencent.com/act/pro/double11-202611

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 一、Alist 是什么,适合谁
  • 二、部署前准备与规格建议
  • 三、用 Docker 部署 Alist
  • 四、放通端口与登录
  • 五、挂载对象存储 COS(核心)
  • 六、怎么确认搭建成功了
  • 七、常见问题
  • 总结
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档