
AList 网盘聚合上手指南从启动服务到接入第一个存储源【免费下载链接】alist️A file list/WebDAV program that supports multiple storages, powered by Gin and Solidjs. / 一个支持多存储的文件列表/WebDAV程序使用 Gin 和 Solidjs。项目地址: https://gitcode.com/GitHub_Trending/al/alistAList 是一款支持多存储的文件列表 / WebDAV 程序可将本地磁盘与各类云盘聚合到一个浏览器页面中支持在线预览、上传和目录管理也能以 WebDAV 协议接入桌面端。本文面向新手按「启动服务、登录控制台、接入第一个存储源、验证访问」四步带你走通。部署完成后你会得到哪些入口AList 启动后文件并不是散落在各处的链接而是集中到几个固定入口浏览器列表页打开服务地址即可浏览目录、在线预览 PDF / 图片 / 视频 / Office 文档并执行上传、删除、重命名、移动、复制等操作。独立挂载路径每个接入的存储源都分配一个自己的网页路径例如/files多个网盘并列出现在同一棵目录树下。WebDAV 服务服务内置 WebDAV 接口可挂载到支持该协议的桌面客户端把网盘当成本地文件夹使用。先记住这几点后面所有配置目的就是把文件挂到这些入口上。最短上手路径启动 AList 服务方式一使用预编译版本到项目的发布页面下载与操作系统匹配的压缩包解压后在解压目录内执行./alist server这条命令用于 Linux / macOSWindows 对应alist.exe server作用是启动 Web 服务。首次运行时会在当前目录自动生成data/目录其中包含主配置文件config.json和数据库文件。成功标志终端打印出 HTTP 监听地址默认端口 5244并输出管理员账号的初始密码请把密码复制保存。方式二从源码编译需要本机已安装 Go用go version确认。执行git clone https://gitcode.com/GitHub_Trending/al/alist cd alist go build -o alist main.go构建成功后目录中会生成可执行文件alist之后启动方式与方式一完全相同。如何进入 AList 控制台并登录管理员在启动服务的同一台机器上用浏览器打开http://localhost:5244如果服务跑在另一台机器上把 localhost 换成该机器 IP。登录时注意两点管理员用户名固定为admin。初始密码是首次启动时随机生成、并打印在终端日志中的日志行提示 initial password is。如果已经关掉终端看不到密码可以删除data目录后重新初始化生成新密码也可以在启动前通过环境变量ALIST_ADMIN_PASSWORD预先指定。登录成功后建议先在用户管理里改掉这个初始密码再继续配置存储。第一个存储源怎么配置先接本地存储它不需要任何账号凭证是最快验证整条链路的方式。操作路径界面文案以实际版本为准控制台侧边栏进入「存储」点击「添加存储」。存储类型选择Local本地。填写两个关键字段根目录服务器上真实存在的目录如/srv/filesWeb 路径该存储映射到网页上的路径如/files。点击保存回到主页刷新。保存后主页目录树中会出现/files这一项它指向的就是你在根目录里放的文件。怎么验证文件可以正常访问验证只需做两件事在浏览器中进入刚才配置的挂载路径如/files能看到目录和文件列表即说明存储源生效。双击一个图片、PDF 或文本文件页面直接渲染出内容说明在线预览可用。如果之后要挂载到桌面客户端可以在配置中开启 WebDAV 入口再用任意 WebDAV 客户端挂载WebDAV 的具体用法以仓库 README 和官方文档说明为准。端口冲突与访问失败怎么排查遇到问题时按「先看现象、再查对应位置」的顺序来现象先查什么页面打不开、连接被拒绝服务进程是否还在运行日志里的监听端口是否仍为 5244启动日志提示端口被占用打开data/config.json把 HTTP 端口改成未被占用的值后重启主页看不到挂载路径Web 路径是否以/开头填写对应存储是否被禁用进入挂载路径后提示存储错误根目录路径是否存在、运行服务的账号是否有读取权限本机正常、其他机器打不开防火墙 / 安全组是否放行了该端口端口和地址配置都在data/config.json中改完后需要重启服务才生效。下一步扩展存储与常用命令常用命令一览Linux / macOS 示例Windows 将./alist换成alist.exe命令作用./alist version查看当前版本号./alist help列出全部可用命令./alist restart重启服务接下来可以做的事在「添加存储」的类型列表中选择其他网盘类型如 OneDrive、阿里云盘等流程与本地存储相同只是多一步填写账号或凭证。想确认当前版本支持哪些存储查看仓库 README 的 Features 一节即可drivers/目录中则是每种存储驱动的对应实现。需要多用户、权限控制或 WebDAV 细节时以仓库 README 和官方文档为准。到这里一个可浏览、可预览、可扩展的网盘聚合入口已经搭好。按上面的顺序接入下一个存储源整个过程通常只需要几分钟。【免费下载链接】alist️A file list/WebDAV program that supports multiple storages, powered by Gin and Solidjs. / 一个支持多存储的文件列表/WebDAV程序使用 Gin 和 Solidjs。项目地址: https://gitcode.com/GitHub_Trending/al/alist创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考