宝塔面板对接阿里云OSS存储完整教程（零基础也能搞定）

如果你的网站图片、附件或备份文件越来越多，服务器磁盘很快就会被塞满。
阿里云OSS（对象存储）提供低成本、高可靠的海量存储空间，通过宝塔面板可以像操作本地文件夹一样使用OSS。
本文从零开始，带你一步步完成对接。

为什么要用阿里云OSS？

把网站图片、备份文件、日志等静态资源迁移到OSS，既能降低服务器磁盘占用，又能享受CDN加速。
宝塔面板提供了官方插件，无需手敲命令就能完成配置。

需要提前准备什么？

• 一个阿里云账号，并开通OSS服务（控制台搜索“对象存储OSS”）。
• 创建一个Bucket（存储空间），地域建议选择离服务器最近的城市，读写权限设为“公共读”适用于网站附件。
• 创建一个RAM子账号，并授予OSS相关权限（只读或读写），记录下AccessKey ID和AccessKey Secret（注意保存好，不要泄露）。
• 宝塔面板已安装并正常运行，PHP版本建议7.3以上。

一步步完成OSS对接（宝塔面板阿里云OSS插件）

1. 安装阿里云OSS插件

登录宝塔面板，在左侧菜单点击“软件商店”，搜索“阿里云OSS”。
找到名为“阿里云OSS”的官方插件（免费），点击安装。
安装完成后，在面板左侧边栏会出现“阿里云OSS”入口。

2. 配置OSS连接信息

点击“阿里云OSS”进入设置页面，填写以下信息：

• AccessKey ID：你之前记录的RAM子账号AK。
• AccessKey Secret：对应的SK。
• Bucket 名称：创建Bucket时填写的名称（如 my-site-images）。
• Bucket 地域：选择对应的地域，比如杭州是oss-cn-hangzhou。
• Endpoint：一般会自动填充，也可以手动设置为 oss-cn-hangzhou.aliyuncs.com 格式。
• 自定义域名（可选）：如果绑定了CDN域名，可以填入。

点击“测试连接”，如果显示“连接成功”，说明信息无误；
否则检查密钥或网络。

3. 挂载OSS到网站目录（可选）

如果你想把OSS当作一个本地文件夹使用（比如自动同步附件），可以开启“挂载OSS”。
点击“挂载管理”，选择“挂载OSS”，填写挂载点（如 /www/wwwroot/example.com/wp-content/uploads）。
注意挂载点目录必须存在且为空。
挂载后，上传到该目录的文件会自动同步到OSS。
这一功能基于ossfs，建议在非高峰时段操作，避免影响网站读写。

4. 设置自动备份到OSS

宝塔面板的“计划任务”中，可以创建备份任务。
选择“备份到阿里云OSS”，然后选择之前配置好的OSS存储空间。
你可以设置每天、每周自动备份网站文件和数据库，备份文件直接上传到OSS。
这样即使服务器出现故障，也能通过OSS快速恢复。

常见报错与解决办法（避坑指南）

问题1：测试连接时提示“CURL错误”或超时

• 原因：服务器无法访问阿里云OSS域名。检查服务器防火墙是否放行443端口，或者尝试修改Endpoint为内网地址（仅适用于同地域ECS）。
• 解决：在宝塔面板“安全”中放行443端口；或者使用服务器所在地域的OSS内网Endpoint（如 oss-cn-hangzhou-internal.aliyuncs.com）。

问题2：挂载后网站文件写入失败或权限错误

• 原因：挂载点目录权限不足或OSS Bucket权限设置不当。
• 解决：在宝塔面板中，将网站目录的www用户设为所有者；同时检查OSS Bucket的读写权限是否允许上传（推荐使用RAM子账号的“OSS完全控制”权限）。

问题3：OSS存储费用暴增

• 原因：可能开启了OSS的跨区域复制、日志记录或文件版本控制等功能。
• 解决：登录阿里云OSS控制台，关闭不需要的增值功能。另外，建议设置Bucket的“生命周期规则”，自动删除过期文件。

验证对接是否成功

• 文件上传验证：挂载后，通过宝塔文件管理器向挂载目录上传一张图片，然后登录阿里云OSS控制台，打开对应的Bucket，查看是否出现该文件。
• 备份验证：手动执行一次计划任务中的“备份到阿里云OSS”，然后在OSS管理页面中查看备份文件是否生成。
• 网站访问验证：如果你的网站附件路径已经指向OSS（通过插件或修改URL），尝试在前台访问某个图片，查看浏览器地址栏是否显示为OSS域名或CDN域名。

如果以上步骤都顺利，恭喜你，宝塔面板对接阿里云OSS存储已经成功。
今后可以放心地把网站资源交给OSS，服务器磁盘压力小很多，网站访问速度也可能因为CDN而提升。