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 是一个基于 Gin 与 Solidjs 构建的文件列表/WebDAV 程序把散落在本地磁盘、各大云盘与对象存储中的文件聚合到一个 Web 界面中并以 WebDAV、S3、FTP 等标准协议对外提供访问。核心能力90 存储驱动本地、OneDrive、阿里云盘、百度网盘、夸克、PikPak、115、S3、WebDAV 等完整实现见 drivers/ 目录多协议访问同一批文件可挂成 WebDAV、S3 或 FTP直接对接播放器、备份工具完整的文件操作图片、音视频、Office 文档与代码在线预览配合搜索、离线下载和跨存储复制 部署前需要确认的运行条件项目要求说明Go 版本1.25 及以上仅源码编译时需要内存512MB 以上启用搜索索引建议 1GB磁盘100MB存放 data 目录与 SQLite 数据库网络可访问各云盘服务云盘驱动依赖有效登录凭据 从源码编译到最小化启动获取二进制或源码编译直接从发布页下载对应系统的预编译包即可运行选择源码编译时只需两条命令git clone https://gitcode.com/GitHub_Trending/al/alist cd alist go build -o alist main.go最小化启动命令./alist server首次启动会在data/目录自动生成config.json、data.dbSQLite与日志默认监听 0.0.0.0:5244。打开 http://localhost:5244 在首屏设置管理员账号密码即完成初始化。⚙️ 修改端口与添加本地存储驱动服务端口与地址由data/config.json中的scheme字段控制例如改成 8080{ scheme: { address: 0.0.0.0, http_port: 8080 } }保存后执行./alist restart生效。之后在管理面板的“存储管理”中添加本地驱动JSON 参数如下{ root: /media/videos, webdav_path: /videos }root是服务器上的实际目录webdav_path决定该存储通过 WebDAV 对外暴露的路径前缀。 三类高频问题的排查路径Web 页面打不开浏览器提示拒绝连接。先确认进程存活再用ss -lntp | grep 5244核对端口监听若被占用改配置中的http_port后重启。云盘驱动登录失败提示 token 或 cookie 无效。最常见原因是凭据过期或驱动与云盘服务类型个人版、家庭版、开放平台不匹配。到云盘官方网页重新获取凭据同一云盘的不同版本驱动不要混用。视频预览黑屏或 403云盘原始链接普遍带 referrer 限制。为服务绑定一个域名并在管理面板的 CDN 字段填入该域名后重试预览。 上线后的进阶实践建议data/目录单独挂载或纳入 Docker 卷并定期备份其中存有管理员密码与云盘凭据文件量大时启用 Meilisearch 或内置 Bleve 索引搜索体验明显更好公网暴露前在反代层处理 TLS避免 5244 端口直接对外配置离线下载前确认 aria2、qBittorrent 等工具服务可用支持列表可参考 internal/offline_download/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/alist创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考