讲师中心 微信公众号
AI工具推荐 视频效率加速

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

陌磊君_9536

陌磊君_9536

发布时间:2026-04-10 19:46:03

|

889人浏览过

|

来源于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 用户。

执行以下命令:

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

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

下载
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 插件的「同步附件」功能仅用于把历史本地附件批量上传,不改变后续程序行为。真正的直传依赖程序自身或其插件支持。

热门AI工具

更多
音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

相关专题

更多
宝塔面板部署ThinkPHP6项目与LNMP环境配置实践
宝塔面板部署ThinkPHP6项目与LNMP环境配置实践

本专题围绕宝塔面板在 ThinkPHP6 项目部署中的实际应用展开,系统讲解 LNMP 环境一键搭建、站点创建、域名绑定、伪静态配置以及 PHP 版本切换等关键操作。内容还包括数据库配置、项目上传部署、运行目录设置及常见部署问题排查。通过完整上线流程演示,帮助开发者快速实现 ThinkPHP 项目的服务器部署与稳定运行,提升网站上线效率与运维能力。

615

2026.03.23

宝塔面板网站安全加固与防攻击配置实践
宝塔面板网站安全加固与防攻击配置实践

本专题围绕宝塔面板在网站安全防护中的应用展开,系统讲解防火墙配置、SSH 安全策略、登录保护、端口管理及恶意访问拦截机制。内容涵盖 CC 攻击防护、文件权限设置、敏感目录保护及安全日志分析,帮助用户全面提升服务器安全性。

92

2026.03.25

宝塔面板多站点管理与虚拟主机配置实践
宝塔面板多站点管理与虚拟主机配置实践

本专题讲解如何通过宝塔面板实现多站点部署与统一管理,包括站点创建、域名绑定、子站配置及资源隔离策略。通过实战案例,帮助用户高效管理多个网站项目,提高服务器利用率。

179

2026.03.25

宝塔面板Nginx性能优化与高并发配置实践
宝塔面板Nginx性能优化与高并发配置实践

本专题围绕宝塔环境下的 Nginx 优化展开,深入讲解缓存策略、连接数调优、Gzip 压缩、静态资源加速及反向代理配置。帮助用户提升网站访问速度与并发处理能力。

916

2026.03.25

宝塔面板数据库管理与MySQL性能调优实践
宝塔面板数据库管理与MySQL性能调优实践

本专题讲解宝塔面板中数据库管理与优化技巧,包括数据库备份恢复、慢查询日志分析、索引优化及连接数配置。通过实际案例,帮助用户提升数据库运行效率。

221

2026.03.25

宝塔面板SSL证书部署与HTTPS配置实践
宝塔面板SSL证书部署与HTTPS配置实践

本专题围绕网站 HTTPS 部署展开,讲解 SSL 证书申请、自动续签、强制 HTTPS 跳转及混合内容问题解决方案,提升网站安全与 SEO 表现。

609

2026.03.25

宝塔面板定时任务与自动化运维实践
宝塔面板定时任务与自动化运维实践

本专题讲解宝塔定时任务功能的使用,包括计划任务创建、Shell 脚本执行、日志管理及自动备份策略,帮助用户实现服务器自动化运维。

187

2026.03.25

宝塔面板FTP与文件权限管理实践
宝塔面板FTP与文件权限管理实践

本专题围绕文件管理与权限控制展开,讲解 FTP 创建、用户权限分配、文件读写控制及安全上传策略,保障网站文件安全。

172

2026.03.25

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

60

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
宝塔入门指引手册
宝塔入门指引手册

共0课时 | 0人学习

宝塔官方实践教程
宝塔官方实践教程

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn