如果你是刚接触服务器运维的小白，想把网站附件或静态资源存到云上，降低本地磁盘压力，宝塔面板对接阿里云OSS是最常见的一个操作。

本文按零基础可执行的方式，一步步带你完成全部配置。

前期准备：注册阿里云并创建 OSS Bucket

1. 登录阿里云控制台，进入对象存储 OSS 服务。


2. 点击“创建 Bucket”，填写名称（全局唯一），选择地域（离你用户最近即可），读写权限设为“公共读”。


3. 创建成功后记录 Bucket 名称和 Endpoint（例如 oss-cn-hangzhou.aliyuncs.com）。


4. 在“访问控制 RAM”中创建一个子账号（或使用主账号），添加 OSS 管理权限（AliyunOSSFullAccess），保存 AccessKey ID 和 AccessKey Secret。

宝塔面板安装阿里云 OSS 插件

1. 登录宝塔面板后台（浏览器访问 http://你的IP:8888）。


2. 左侧菜单点击“软件商店”，搜索“阿里云OSS”。


3. 找到官方插件“阿里云OSS”（或“阿里云OSS存储”），点击“安装”并等待完成。


4. 安装成功后，在左侧“软件商店”已安装列表中找到该插件，点击“设置”。

配置插件并挂载到网站目录

1. 在插件设置页面填入前面记录的参数：

• Bucket 名称


• Endpoint（外网地址，不含bucket前缀）


• AccessKey ID


• AccessKey Secret

1. 挂载路径建议选择一个空目录，例如 /www/wwwroot/你的网站/wp-content/uploads-oss（注意：不要直接挂载到已有文件的目录，否则原文件会被隐藏）。


2. 点击“挂载”按钮，提示成功即可。


3. 返回宝塔文件管理，找到该目录，会显示一个 OSS 图标，表示挂载成功。

常见问题与避坑指南

• 挂载失败：检查 Endpoint 是否写成了内网地址（如 oss-cn-hangzhou-internal.aliyuncs.com），零基础用户务必使用外网地址。


• AccessKey 权限不足：确保子账号已授权 OSS 管理权限，建议直接在插件中使用主账号 AccessKey（测试环境安全，生产环境建议子账号只赋予所需Bucket权限）。


• 文件无法访问：确认 Bucket 权限为“公共读”，且文件路径正确。可以先用阿里云 OSS 控制台直接上传一个文件测试外网访问。


• 卸载挂载：在插件设置中点击“卸载”即可，或重启服务器自动卸载。挂载后不要手动删除该目录，以免影响OSS数据。

效果验证：上传文件并测试访问

1. 进入宝塔文件管理，导航到刚刚挂载的目录。


2. 新建一个空白文件 test.html，写入内容

   Hello OSS!

   。


3. 复制该文件的外网地址：你的OSS Bucket域名（形如 https://.oss-cn-hangzhou.aliyuncs.com/test.html）或通过你的网站域名访问（如果设置了绑定域名）。


4. 用浏览器打开，若能正常显示，则宝塔面板对接阿里云OSS配置成功。

如果你正在处理 宝塔面板对接阿里云OSS，建议先按本文步骤完整执行，再根据自己的环境做微调；

遇到异常时优先回看避坑和高频问题部分。

至此你已经学会了零基础挂载阿里云 OSS 到宝塔面板，可以放心将附件或静态资源迁移到云端了。