宝塔面板如何配合阿里云OSS进行附件存储_安装阿里OSS插件并配置API密钥

不少用户发现，宝塔面板从 8.0 版本开始，官方应用商店里已经找不到阿里云 OSS 插件了。无论是直接执行 bt plugin install oss 命令，还是在面板「软件商店」里搜索“OSS”，都只会扑个空。这并非你的操作失误，而是平台方的策略调整——从 8.0 起，所有第三方存储插件已被官方下架。

面对这种情况，实际可行的办法只有两个：一是手动安装社区维护的开源插件（兼容性较好，推荐），二是放弃插件，直接用 ossutil 配合定时任务同步附件目录（适合有运维经验的朋友）。本文重点介绍第一条路：手动安装并配置社区版 OSS 插件。

宝塔面板里找不到阿里云OSS插件怎么办

宝塔官方应用商店从 8.0 版本起已下架所有第三方存储插件（包括阿里云 OSS），bt plugin install oss 这类命令会失败，直接在面板「软件商店」搜索“OSS”也无结果。这不是你操作问题，是平台策略变更。

实际可行路径只有两条：

• 手动安装社区维护的开源插件（推荐，兼容性较好）
• 放弃插件，改用 ossutil + 定时任务同步附件目录（适合有运维经验者）

本文聚焦第一条：手动安装并配置社区版 OSS 插件。

下载并安装社区版阿里云OSS插件

该插件由 GitHub 用户 lizhong1994 维护，适配宝塔 7.x–8.x，核心功能稳定（上传、删除、回源、CDN 绑定）。安装前确认你已登录宝塔终端（SSH）并切换为 root 用户。

执行以下命令：

cd /www/server/panel/plugin/
mkdir oss
cd oss
wget https://github.com/lizhong1994/bt-oss-plugin/releases/download/v2.5.0/oss.zip
unzip oss.zip
rm -f oss.zip
chmod +x install.sh
bash install.sh

成功后刷新宝塔面板，左侧菜单会出现「OSS 对象存储」入口。若不显示，执行 bt restart 重启面板服务。

配置OSS Bucket和API密钥的注意事项

插件界面填写的不是阿里云主账号 AK，而是「RAM 子用户」的 AccessKey ID 和 AccessKey Secret，且该子用户必须被授予最小必要权限：AliyunOSSFullAccess 或自定义策略（含 oss:PutObject、oss:GetObject、oss:DeleteObject）。

常见填错点：

• Endpoint 必须选对地域，例如杭州是 oss-cn-hangzhou.aliyuncs.com，不能填成控制台首页显示的“外网访问域名”
• Bucket 名称区分大小写，且必须已存在——插件不会自动创建 Bucket
• 「CDN 加速域名」可留空；若填写，需提前在阿里云 CDN 控制台完成 CNAME 接入并开启 HTTPS
• 勾选「启用回源」后，当 OSS 中不存在文件时，会自动从本地 /www/wwwroot/你的站点/attachment 目录拉取（适用于迁移过渡期）

WordPress/Typecho等程序如何对接已配置的OSS

注意，插件本身只接管宝塔面板内的「网站 > 附件管理」操作，不影响 PHP 程序自身的上传逻辑。要让 WordPress 上传图片直传 OSS，仍需额外处理：

• WordPress：安装插件 WP Offload Media，在设置中选择「Aliyun OSS」，填入与宝塔插件一致的 AccessKey ID、AccessKey Secret、Bucket、Endpoint
• Typecho：修改 config.inc.php，将 $config['upload']['type'] = 'OSS' 并补全对应配置项（注意：原生不支持，需配合 typecho-plugin-oss 扩展）
• 自建 PHP 系统：不要复用宝塔插件的密钥配置，应单独申请 RAM 子用户密钥，避免权限泄露风险

OSS 插件的「同步附件」功能仅用于把历史本地附件批量上传，不改变后续程序行为。真正的直传依赖程序自身或其插件支持。