Alist启动报错：failed get storage: storage not found，请问如何解决？

Question

**Alist启动报错：failed get storage: storage not found，请问如何解决？** 在使用Alist时，如果遇到“failed get storage: storage not found”错误，通常是因为配置文件中未正确指定存储类型或路径。Alist需要明确的存储后端（如本地存储、Google Drive、OneDrive等）才能正常运行。 解决方法如下： 1. 检查`config.json`或通过Web界面确认是否已正确配置存储类型和参数。 2. 确保所选存储类型已启用，并正确填写相关凭证（如API密钥、访问令牌等）。 3. 如果使用本地存储，确保指定的目录存在且程序有读写权限。 4. 清除缓存或重新初始化配置文件后重试。 例如，配置Google Drive时需提供客户端ID和秘密；使用本地存储时需设置正确的路径。若问题仍未解决，可尝试更新Alist到最新版本或查看官方文档获取更多支持。

Answer 1

1. 问题概述

在使用Alist时，如果遇到“failed get storage: storage not found”错误，通常是因为配置文件中未正确指定存储类型或路径。Alist需要明确的存储后端（如本地存储、Google Drive、OneDrive等）才能正常运行。

此错误可能由以下原因引起：

• 配置文件`config.json`中缺少必要的存储信息。
• 所选存储类型未启用或相关参数填写不完整。
• 使用本地存储时，指定的目录不存在或程序没有读写权限。

2. 解决方案分析

以下是逐步排查和解决问题的方法：

1. 检查配置文件：确保`config.json`或通过Web界面已正确配置存储类型和参数。
2. 验证存储类型：确认所选存储类型是否已启用，并正确填写相关凭证（如API密钥、访问令牌等）。
3. 本地存储路径验证：如果使用本地存储，确保指定的目录存在且程序有读写权限。
4. 清除缓存或重新初始化配置文件：尝试删除缓存文件或重新生成配置文件后重试。

例如，配置Google Drive时需提供客户端ID和秘密；使用本地存储时需设置正确的路径。

3. 示例与代码参考

以下是一些常见存储类型的配置示例：

存储类型	必要参数	说明
本地存储	`path`	指定本地文件夹路径，例如`/data/alist/files`。
Google Drive	`client_id`, `client_secret`	需要OAuth认证的客户端ID和秘密。
OneDrive	`refresh_token`	通过OAuth获取的刷新令牌。

以下是本地存储的`config.json`示例：

{
    "storage": "local",
    "path": "/data/alist/files"
}

4. 流程图解析

以下是解决此问题的流程图：

5. 进一步建议

如果上述方法仍未解决问题，可以尝试以下步骤：

• 更新Alist到最新版本，确保修复了已知问题。
• 查看官方文档或社区支持，寻找类似问题的解决方案。
• 启用调试日志，进一步定位问题所在。

启用调试日志的方法如下：

./alist -log-level=debug