命令行工具箱storage与version和debug

除了 server，可执行文件还带一批子命令，救急时比网页后台更直接。以下命令都在程序所在目录执行（Docker 加 docker exec -it 容器名 前缀）。

存储管理：storage

页面卡在「正在加载存储」时的救命命令：

./alist storage list

列出全部存储（ID、驱动、挂载路径、启用状态），交互式表格用上下键翻、Ctrl+C 退出。

./alist storage disable /挂载路径

停用指定存储。停掉失效存储再重启程序，页面就能进去了，完整流程见挂载报错。

账号与安全

• ./alist admin random / ./alist admin set 新密码：管理员密码重置，见管理员密码。
• ./alist cancel2fa：管理员两步验证丢失时的解除命令，见两步验证。

版本与启停

• ./alist version：查当前版本（也可在后台设置 → 站点看）。
• ./alist start / stop / restart：v3.4.0 起的静默启停。
• ./alist server：前台运行本体。

调试模式

日志文件 log.log 看不出问题时，用 debug 参数重启：

• Windows：.\alist.exe server --debug
• Linux：./alist server --debug
• Docker：docker exec -it alist ./alist server --debug

建议先清空旧日志再开 debug，方便定位。注意：debug 日志包含账号密码、刷新令牌等敏感信息，发给别人前必须脱敏。Ctrl+C 结束。

找不到命令？

多半是目录不对：程序读的是「执行命令时所在目录」的 data 配置，先 cd 到程序目录再敲，见密码问题。