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 访问没有验证。离线下载和多用户权限也没有验证,都不作结论。










