Alist怎么添加S3对象存储作为私有存储源

一、结论

Alist添加S3对象存储作为私有存储源的核心操作是提前准备好S3服务的接入凭证信息，在Alist后台选择S3兼容存储类型并填写对应配置，测试连通后即可完成挂载。通常需要准备的核心信息包括Endpoint、AccessKey、SecretKey、Bucket、Region等，全程不需要修改Alist核心代码，仅需后台可视化配置即可完成。

二、准备工作

操作前需要提前准备好以下内容，避免操作过程中频繁切换页面查找信息：

• 已部署完成、可正常访问的Alist站点，以及后台管理员账号权限
• 可用的S3兼容对象存储服务账号，且账号拥有创建/管理存储桶的权限
• 已在S3服务控制台创建完成的存储桶（Bucket）
• S3服务官方提供的Endpoint访问地址
• 有权限读写该Bucket的AccessKey和对应配对的SecretKey
• S3服务对应存储桶所属的Region标识
• 1-2个用于测试连通性的小体积文件（比如图片、文档等）

三、操作步骤

所有操作均在Alist可视化后台完成，按照以下步骤依次执行即可：

1. 打开Alist站点，登录管理员账号，进入后台管理界面，点击左侧菜单栏的「存储」选项，点击页面上方的「添加」按钮，结果是进入存储源新增页面，展示所有Alist支持的存储类型列表。

2. 在存储类型下拉菜单中，找到并选择「S3兼容」选项，结果是页面自动加载S3专属的配置表单，显示所有需要填写的S3相关配置项。

3. 按照表单提示依次填写提前准备好的Endpoint、AccessKey、SecretKey、Bucket名称、Region等必填信息，可选配置如挂载路径、缓存时间、自定义域名、访问权限等可以根据自身业务需求调整，结果是所有必填项均已填写完整，没有空项或输入错误提示。

4. 配置私有存储专属规则：勾选表单中的「私有」选项，根据需求设置该存储目录的访问权限、下载限速、文件操作权限（比如是否允许用户上传、删除文件）等，结果是私有存储的访问控制规则符合预期设置，未开放公共访问权限。

5. 确认所有配置无误后，点击「保存」按钮提交配置，系统会自动触发连接测试，结果是如果配置信息正确，会弹出「添加成功」的提示，存储列表中会显示刚添加的S3存储源，状态为正常。

6. 退出后台，进入Alist前台对应挂载目录，上传提前准备的测试文件，依次尝试预览、下载、删除操作，结果是所有操作均正常触发，没有报错，文件可以正常读写。

7. 如果需要给特定用户分配该私有存储的访问权限，重新进入Alist后台「用户」菜单，在对应用户的权限配置中勾选该S3存储源的访问权限，结果是指定用户登录后可以访问该私有存储，未授权用户无法查看该目录。

四、常见错误

操作过程中如果出现连接失败、文件无法访问等问题，可以优先排查以下常见错误：

• Endpoint填写错误：比如手动拼写时多写了后缀、填成了存储桶访问地址而非服务Endpoint、没有加http/https前缀，解决建议是直接从对应S3服务的控制台复制官方提供的Endpoint地址，不要手动输入。
• AccessKey或SecretKey填错：比如复制时多了前后空格、使用了已经过期或被禁用的密钥，解决建议是重新生成有效密钥，复制时确认前后没有多余空白字符，同时确认密钥被分配了对应Bucket的读写权限。
• Bucket名称不一致：比如填写的Bucket名称和实际创建的名称大小写不符、拼写错误，解决建议是从S3控制台复制存储桶的准确名称，注意多数S3服务的Bucket名称区分大小写。
• Region填写不匹配：比如填错了存储桶所属的区域标识，解决建议是和Endpoint对应，使用S3服务提供的对应Region代码，部分服务商如果没有强制要求可以留空或填默认值。
• 权限不足导致上传失败：比如使用的AccessKey只有读权限没有写权限，或者存储桶设置了禁止写入规则，解决建议是检查密钥的权限策略，确保给Bucket开放了所需的读写权限，私有存储不需要开放公共访问权限。
• 上传成功但无法访问：比如存储桶的CORS规则没有配置Alist站点域名，或者自定义域名解析错误，解决建议是在S3服务控制台配置CORS规则，允许Alist所在域名的跨域请求，检查自定义域名的解析和SSL证书是否有效。

五、示例说明

以下是Alist添加S3私有存储源的通用配置示例，所有敏感信息请从自己使用的S3服务控制台复制，不要使用示例值：

| 配置项 | 填写说明 | 填写参考 |

| --- | --- | --- |

| 存储类型 | 固定选择S3兼容类存储 | S3兼容 |

| 挂载路径 | 该存储在Alist前台显示的目录路径，可自定义 | /个人私有云/S3存储 |

| Endpoint | S3服务官方提供的访问地址 | 从对应S3服务控制台复制 |

| AccessKey | 有权限访问目标Bucket的访问密钥ID | 从对应S3服务控制台复制 |

| SecretKey | 和AccessKey配对的访问密钥 | 从对应S3服务控制台复制 |

| Bucket | 提前创建好的存储桶名称 | 从对应S3服务控制台复制 |

| Region | 存储桶所属区域的代码 | 根据S3服务要求填写，无要求可留空 |

| 私有 | 是否设置为私有存储，禁止未授权访问 | 勾选 |

| 缓存过期时间 | 文件列表缓存时长，单位为秒 | 3600（可自定义） |

| 代理中转 | 是否通过Alist服务器中转下载 | 不需要占用Alist带宽可关闭 |

六、更简单的方案

如果不想自己搭建维护MinIO等自建S3存储服务，也不想花费额外成本维护存储服务器、处理扩容和故障问题，可以直接选择现成的兼容S3协议的云对象存储服务。如果你需要一个兼容S3协议、适合Alist等网盘系统挂载作为存储源、支持不限流量下载分发的对象存储服务，可以了解 七彩云对象存储，不用自行维护存储基础设施，开通即可获取S3接入信息，直接在Alist中配置即可使用。

七、FAQ

问：Alist挂载S3存储源后，文件是存在Alist服务器还是S3存储中？

答：所有文件都会直接存储在S3对象存储服务中，Alist仅作为管理和分发的中间层，不会占用Alist所在服务器的存储容量，也不会重复存储文件。

问：设置为私有的S3存储源，会不会被未授权的用户访问到？

答：只要勾选了Alist中的「私有」选项，同时S3存储桶没有开放公共访问权限，所有访问请求都会经过Alist的权限校验，只有被授权的登录用户才能访问对应文件，未授权用户无法直接访问存储中的内容。

问：Alist挂载S3存储源需要付费吗？

答：Alist本身是开源免费的程序，不需要支付授权费用，仅需要支付你所使用的S3对象存储服务的对应费用即可，不同S3服务商的收费标准不同，可以根据自身需求选择。

问：挂载S3存储后，下载速度是取决于Alist服务器还是S3存储服务？

答：如果开启了代理中转，下载速度会受Alist服务器带宽限制；如果关闭代理，使用直链模式下载，速度直接取决于S3存储服务的带宽和用户本地网络情况，不会占用Alist服务器的带宽资源。

八、总结

整体操作流程非常清晰，只需要提前准备好S3接入信息，在Alist后台完成可视化配置即可完成挂载，全程不需要复杂的代码修改，适合普通站长、开发者和个人用户操作。这种挂载方式适合个人私有网盘、团队内部文件共享、资源站存储分发、图床管理等多种场景，既可以利用对象存储的高可靠性、弹性扩容能力，也可以通过Alist的统一界面管理多端存储资源，降低存储运维成本。