宝塔面板如何配合阿里云OSS进行附件存储_安装阿里OSS插件并配置API密钥-php教程-PHP中文网

宝塔面板8.0起官方下架阿里云OSS插件，需手动安装社区版：下载lizhong1994维护的oss.zip，解压安装后刷新面板；配置时须用RAM子用户密钥、正确Endpoint和已存在Bucket。

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

宝塔面板里找不到阿里云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 重启面板服务。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

配置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 子用户密钥，避免权限泄露风险