环境与依赖检查
安装失败时需优先验证系统环境：确认服务器操作系统版本是否符合宝塔官方要求（推荐CentOS 7.6或Aliyun Linux），检查Python版本是否为2.7.5且安装了EPEL扩展源。若出现解密类报错，需执行yum -y remove python-cryptography卸载旧版本加密模块，再通过pip install cryptography==2.8安装兼容版本。
依赖冲突处理
模块冲突是常见故障原因，建议按顺序执行以下操作：
- 通过面板卸载OSS插件
- 执行
pip uninstall oss2彻底清除残留 - 手动修改
/usr/lib/python2.7/site-packages/oss2/__init__.py中的模块引用名称 - 重启宝塔服务后重新安装插件
网络配置验证
境外服务器需特别注意网络连通性：
- 使用
ping download.bt.cn测试境内下载节点可达性 - 更换为广东或香港镜像的安装命令
- 检查阿里云安全组是否放行8888、80、443端口
| 协议类型 | 端口范围 | 授权对象 |
|---|---|---|
| TCP | 8888 | 0.0.0.0/0 |
| HTTP | 80 | 0.0.0.0/0 |
残留文件清理
多次安装失败后需彻底清理：
- 删除
/www/server/panel/plugin/oss目录 - 检查
/etc/init.d/bt服务状态 - 使用
find / -name "*oss*"查找隐藏文件
通过系统环境验证、依赖版本控制、网络策略调整和彻底清理残留文件四步操作，可解决90%以上的安装失败问题。建议优先检查加密模块版本与服务器区域网络配置，复杂故障可通过宝塔官方日志分析工具定位具体错误源。
