Alist 是一个用 Go 写的文件列表与 WebDAV 服务,能把 OneDrive、阿里云盘这类存储挂到一个网页里浏览。官方给的是单个 exe,双击就能起一个站点。这篇在 Windows 上把它从空目录跑到登录进后台,记下每一步的实际结果。

45 MB 的 zip 解出 118 MB 单文件,服务起在 5244

release 里的 Windows 包解开只有一个可执行文件。它没有安装程序,也不依赖 .NET 或 Node,数据全放在 --data 指定的目录。

alist-windows-amd64.zip    45,296,856 字节
解压后 alist.exe          118,216,192 字节
启动命令                  alist.exe server --data D:\wb_cache\lab\alist\data
监听地址                  0.0.0.0:5244
data 目录                 config.json / data.db / data.db-wal / log / temp

端口不在命令行里改,--port 会直接报 unknown flag。地址写在 data/config.json 的 scheme 与 port 字段里,改完重启生效。

第一次登录,密码只在首次启动时打印一次

初始密码不会写进配置文件,也没有默认值。第一次启动时它打在控制台,之后只留哈希,找不回来。错过那一眼,就只能重置。

alist admin                       -> Admin user's username: admin
                                     The password can only be output at the first startup
alist admin set ShiceKu_2026      -> 直接改写密码
alist admin random                -> 生成随机密码
操作结果说明
登录页/@login账号固定 admin,只填密码
游客访问默认关闭页面提示 Guest user is disabled
登录成功跳回 /右上角弹「登录成功」

没有挂存储时,首页只报一句话

登录进去并不等于能看文件。Alist 本身不存文件,它只是把各种存储挂进来。空库状态下首页只有一行错误和一个按钮。

failed get storage: storage not found; please add a storage first
[转到存储]

这个设计省掉了「假装有内容」的空页面,但也意味着第一次用的人必须先配一个存储。本地目录也能挂,驱动列表里有一个本地目录的驱动,填一个绝对路径即可。

本地存储填好路径之后,列表页会把该目录下的一级条目全列出来,排序与搜索都走同一套网页,点开文件能直接预览。多个存储可以挂到不同挂载路径下,前端看到的就是一棵合并后的目录树。

后台有 13 个页签,用户默认两个

管理后台是独立的一套页面,左侧一排页签从账号管到备份,覆盖日常运维的几件事。

区域页签
账号个人资料 / 设置 / 用户 / 角色 / 会话
内容存储 / 元信息 / 索引 / 共享
运维任务 / 备份 & 恢复 / 关于 / 文档

用户表默认两行:guest(GUEST,不可用)与 admin(ADMIN,可用)。两个都能编辑或删除,也都能取消两步验证,没有隐藏账号。

数据放在两个文件里

跑过登录与几个页面之后,数据目录的体积是这样。

config.json        2,555 字节
data.db          131,072 字节
data.db-wal       70,072 字节
日志里的一条 WARN   init tool aria2 failed: dial tcp [::1]:6800: connectex: refused

配置和业务数据分开放:前者能直接看,后者是 SQLite。备份就是拷 data 目录。日志里那条 aria2 报错不影响网页浏览,只有用到离线下载功能时,才需要在同一台机器上另起一个 aria2。

适合谁用

场景结论理由
把多个网盘并到一个入口合适挂载多种存储,统一浏览
需要 WebDAV合适自带 WebDAV 端点
只想存本地文件没必要直接开共享目录更省事
公网暴露先做功课默认监听 0.0.0.0,需自己加 HTTPS 与反向代理

实测范围:Windows 10 22H2(10.0.19045.6466),Alist v3.65.0,Chrome 1280×820 视口。云盘挂载与 WebDAV 访问没有验证。离线下载和多用户权限也没有验证,都不作结论。