宝塔面板8.x及以上版本中阿里云OSS插件已从官方软件商店下架，需手动安装社区版（如lizhong1994维护的bt-oss），或改用腾讯云COS/七牛云插件；密钥须用RAM子用户AK/SK并授AliyunOSSFullAccess权限，region填标准ID（如oss-cn-hangzhou），bucket名全小写且不含域名。
阿里云OSS插件在哪安装
宝塔面板 8.x 及以上版本中，阿里云OSS 插件已下架官方软件商店，不再提供一键安装入口。当前（2026年4月）仍可用的方案是手动安装社区维护的兼容版插件，或改用更稳定的 腾讯云COS / 七牛云存储 插件替代。
如果你坚持使用 OSS，需从 GitHub 拉取第三方适配包（如 bt-oss），上传至 /www/server/panel/plugin/ 后解压并补全 info.json 和 index.py ——但要注意：这类插件无官方签名，重启面板后可能被自动清理，且不支持新版 OSS 的 STS 临时凭证模式。
secret_id 和 secret_key 怎么填才不报错
填错密钥是 Connection refused 或 InvalidAccessKeyId 错误的最常见原因。必须确认以下三点：
-
secret_id和secret_key必须来自阿里云 RAM 控制台，不是主账号 AK/SK（主账号密钥已被阿里云强制禁用） - RAM 子用户需至少拥有
AliyunOSSFullAccess策略，且该策略已绑定到对应 AccessKey - 密钥不能含空格、换行或中文标点；复制时建议用纯文本编辑器粘贴后二次校验
如果仍提示 SignatureDoesNotMatch，大概率是系统时间偏差超过 15 分钟 —— 运行 ntpdate -u ntp.aliyun.com 同步时间后再试。
region 和 bucket 填写格式要严格匹配
OSS 的 region 不是城市名，也不是控制台 URL 里的路径，而是标准地域 ID，例如 oss-cn-hangzhou、oss-cn-shenzhen。填成 cn-hangzhou 或 hangzhou 都会连接失败。
bucket 名称必须全小写、只能含字母、数字和短横线（-），且不能以短横线开头或结尾；长度 3–63 字符。常见错误包括：
- 误填 Bucket 的外网访问域名（如
my-bucket.oss-cn-hangzhou.aliyuncs.com） - 混用内网 endpoint（如
my-bucket.oss-cn-hangzhou-internal.aliyuncs.com） - Bucket 实际未在对应 region 创建（跨 region 访问不支持）
计划任务执行后没文件？先查这三处日志
备份任务显示“执行成功”，但 OSS 控制台看不到文件，问题往往不在插件本身，而在权限链路断点：
- 检查宝塔计划任务日志：
/www/wwwlogs/cron.log，搜索关键词oss或upload，看是否出现PermissionDenied - 登录 OSS 控制台 → 对应 Bucket → “基础设置” → “防盗链设置”，确认未开启 Referer 白名单（否则上传会被拦截）
- 查看插件日志：
/www/server/panel/plugin/oss/logs/oss_backup.log，重点关注 timestamp 后的 HTTP 状态码，403 多为权限问题，404 多为 bucket/region 错误
另外注意：OSS 默认不展示空目录，备份压缩包若生成失败（比如磁盘满、tar 权限不足），插件可能静默跳过上传 —— 所以务必先在本地确认 /www/backup/site/ 下有最新 .zip 文件。
