宝塔面板对接阿里云OSS，手把手远程存储配置教程
前置准备
开始宝塔面板对接阿里云OSS前，请确保以下条件满足：
- 已安装并运行 宝塔面板（7.7+版本），网站功能正常。
- 拥有一个阿里云账号，并且已经开通对象存储OSS服务。
- 在OSS控制台创建一个Bucket，记录Bucket名称和所在地域（Endpoint），例如
oss-cn-hangzhou.aliyuncs.com。 - 在阿里云RAM中创建子用户，并授权OSS相关权限（
AliyunOSSFullAccess），生成AccessKey ID和AccessKey Secret。 - 确认服务器能访问外网（特别是
*.aliyuncs.com域名），必要时放行443端口。
小贴士：如果Bucket用于存放网站附件，建议选择与服务器同地域的节点，减少延迟。
分步操作
以下步骤在宝塔面板Web界面完成，无需命令行基础。
第一步：安装阿里云OSS插件
- 登录宝塔面板，进入左侧软件商店。
- 在搜索框输入 “阿里云OSS”，找到阿里云OSS（对象存储） 插件（官方认证）。
- 点击 安装，版本选择5.x（最新稳定版），安装过程约1分钟。
第二步：配置插件
- 安装完成后，在软件商店已安装列表中找到该插件，点击设置。
- 填写配置信息：
- AccessKey ID：粘贴你创建的子用户AccessKey ID。
- AccessKey Secret：粘贴对应Secret。
- Bucket名称：例如
my-site-backup。 - Endpoint：填写你的Bucket地域节点，例如
oss-cn-hangzhou.aliyuncs.com。 - 存储目录：可留空（默认根目录），也可指定子文件夹如
/uploads/。
- 点击 测试连接，如果显示 连接成功，则保存配置。
第三步：挂载OSS到网站目录（可选）
如果你需要将OSS的某个目录直接挂载到网站附件目录（如/www/wwwroot/你的站点/wp-content/uploads），可以：
- 在插件设置页找到 挂载目录 功能。
- 输入本地目录绝对路径，例如
/www/wwwroot/mysite/wp-content/uploads。 - 点击 挂载，插件会自动安装ossfs（首次需要确认）。
- 挂载成功后，访问网站上传文件，文件会直接写入OSS，同时本地保留一份缓存。
第四步：自动备份到OSS（加分功能）
- 在宝塔面板左侧点击 计划任务。
- 点击 添加任务，类型选 备份网站 或 备份数据库。
- 备份策略选择 备份到阿里云OSS，选择刚才配置的OSS存储。
- 设置执行时间和保留份数，保存即可。
避坑指南
- 权限不足错误：检查子用户是否拥有
oss:PutObject和oss:GetObject权限，建议直接授予AliyunOSSFullAccess。 - Endpoint填写错误：无需添加
https://，只填节点域名如oss-cn-hangzhou.aliyuncs.com。 - 地域不匹配：Bucket的Endpoint必须与实际Bucket所在地域一致，否则报错。
- 挂载目录为空：如果挂载后目录无文件，检查ossfs是否正常运行，可查看插件状态页。
- 上传文件失败：确认服务器防火墙未屏蔽OSS域名，可用
curl -I https://你的Bucket名称.oss-cn-hangzhou.aliyuncs.com测试连通性。
高频问题解答
- 问：宝塔面板对接阿里云OSS后，如何查看已上传文件？ 答：直接登录阿里云OSS控制台，进入对应Bucket即可看到。也可在宝塔插件设置页点击 文件管理。
- 问：可以挂载多个Bucket吗？ 答：目前一个插件实例只对一个Bucket，如需多个可多次安装插件或使用不同配置。
- 问：卸载插件会影响已存储在OSS的数据吗？ 答：不会，OSS数据独立存储，卸载只移除宝塔本地配置，文件依然在阿里云上。
- 问：为什么挂载后网站上传速度变慢？ 答：OSS需要网络传输，如果服务器带宽不足或地域跨区，建议使用同地域Bucket。
效果验证
配置完成后，做以下检查确保成功：
- 测试连接：在插件设置页再次点击 测试连接，仍显示成功。
- 挂载验证：如果使用了挂载功能，SSH登录服务器，执行
df -h，能看到类似ossfs的挂载记录。 - 上传文件：通过网站后台上传一张图片，然后登录阿里云OSS控制台，在对应的Bucket中找到该文件。
- 备份测试：手动执行一次计划任务，查看备份日志是否成功上传到OSS。
如果你正在处理宝塔面板对接阿里云OSS，建议先按本文步骤完整执行，再根据自己的环境做微调；
遇到异常时优先回看避坑和高频问题部分。
