宝塔面板（直达官网） 12.0 和 13.0 已支持升级至 Python 3.13 运行环境。这里升级的是宝塔面板自身使用的 Python 运行栈，不会直接更改网站项目、Python 应用或服务器系统默认的 Python 版本。
仍在使用 Python 3.7 运行环境的用户，建议提前安排升级。操作前必须创建完整服务器快照，并确认快照能够正常回滚。升级过程可能重启面板服务，稳定版用户执行脚本时需要通过独立 SSH 客户端连接服务器，不能使用宝塔面板内置终端。
一、为什么需要升级 Python 3.13
Python 3.7 已于 2023 年 6 月结束官方维护，不再获得常规安全更新。越来越多的新版本依赖库也开始停止支持 Python 3.7，继续使用旧运行环境可能带来依赖版本受限、兼容维护困难和安全更新缺失等问题。
宝塔面板计划逐步将自身运行环境统一到 Python 3.13。按照当前升级说明，预计从宝塔面板 13.5 开始不再兼容 Python 3.7。仍在使用旧运行栈的用户，应在后续面板更新前完成迁移。
升级后的运行环境更新了 Python 版本及相关依赖，主要用于改善面板自身的请求处理、安全维护和长期运行稳定性。
二、升级会不会影响网站环境
本次升级针对宝塔面板自身的 Python 运行环境，不等于升级服务器系统 Python，也不会直接替换网站项目使用的 Python 版本。
一般情况下，下列环境不会因本次操作被直接修改。
- PHP 网站运行环境
- Java 应用运行环境
- Node.js 项目版本
- Python 项目的独立虚拟环境
- Docker 容器内的 Python 环境
- 系统软件包管理器使用的 Python
- 网站数据库及文件内容
即使升级对象只是面板自身，操作期间仍可能重启面板进程并更新相关依赖。生产服务器应选择业务低峰期执行，并提前准备可用快照。
不要为了完成这次升级而手动替换 /usr/bin/python、/usr/bin/python3 或修改系统默认 Python 软链接。这类操作可能影响操作系统工具和软件包管理器。
三、升级前需要完成的准备
1、确认宝塔面板版本
本次升级适用于宝塔面板 12.0 和 13.0 用户。
正式版用户建议先升级至 13.0 或更高版本。稳定版用户应确认当前面板已经升级至支持此次操作的 12.0 稳定版。
旧版本用户不要直接运行 Python 3.13 升级脚本，应先按照宝塔面板中的版本更新提示完成面板升级。
2、创建完整服务器快照
升级前应在云服务器或虚拟化平台中创建完整系统快照。快照应覆盖系统盘以及宝塔面板所在磁盘。
创建完成后还需要确认以下事项。
- 快照状态显示创建成功
- 当前账号拥有恢复快照的权限
- 服务器磁盘空间充足
- 重要网站数据库另有独立备份
- 已记录面板登录地址及 SSH 信息
- 已确认服务器能够通过 SSH 登录
只有网站文件备份而没有系统快照，无法完整恢复面板运行环境和相关依赖。
3、选择业务低峰期
升级过程可能重启宝塔面板服务。网站业务通常不依赖面板页面持续在线，但为了降低异常操作带来的影响，仍建议选择访问量较低的时间段执行。
升级期间暂停下列操作。
- 宝塔面板版本更新
- 软件商店安装或升级
- 网站迁移
- 数据库恢复
- PHP 版本切换
- 服务器重启
- 面板修复
- 其他环境升级任务
4、准备独立 SSH 客户端
稳定版用户需要通过 SSH 执行升级脚本。可以使用系统终端、PuTTY、Xshell、FinalShell或其他独立 SSH 客户端。
不要使用宝塔面板内置终端执行脚本。升级过程中面板自身服务及运行环境可能被重启，依赖面板的终端连接可能中断，从而影响操作观察和故障排查。
四、宝塔面板正式版升级方法
正式版用户可以通过面板界面完成 Python 3.13 运行环境更新。
1、更新宝塔面板版本
登录宝塔面板，在首页右上角找到更新按钮，将面板升级至 13.0 或更高版本。
更新完成后重新登录面板，确认首页显示的版本号正确。
2、进入 Python 版本更新页面
再次点击首页右上角的更新按钮，在更新界面中找到 Python 版本更新选项。
确认页面提示的目标版本为 Python 3.13 后，点击更新并等待任务完成。
更新过程中不要关闭服务器、重启面板或同时安装其他软件。
3、确认运行环境版本
升级完成后，将鼠标移动到面板左上方的系统版本区域，查看面板当前使用的 Python 运行环境。
如果已经显示 Python 3.13，说明面板运行栈升级完成。
五、宝塔面板稳定版升级方法
稳定版用户需要先确认面板处于支持升级的 12.0 稳定版，再通过服务器 SSH 执行官方脚本。
1、将旧版本升级至 12.0
仍在使用宝塔面板 9.0 或 10.0 的用户，应先按照面板提示执行修复，再通过首页右上角的更新入口升级至 12.0 稳定版。
更新后重新登录面板，确认版本号及主要功能正常。
2、通过 SSH 登录服务器
使用独立 SSH 客户端连接服务器。建议以具有相应权限的账号登录，并切换至 root 环境。
再次提醒，不要在宝塔面板内置终端中执行下面的升级脚本。
3、运行 Python 3.13 升级脚本
执行以下命令。
bash /www/server/panel/script/upgrade_py313_bundle.sh脚本会自动处理宝塔面板 Python 3.13 运行环境及相关依赖。执行时间受服务器性能、网络和软件源状态影响。
运行过程中应保持 SSH 连接，不要重复执行命令，也不要手动终止脚本。
4、等待脚本完成
终端返回升级完成信息后，检查是否存在明显报错。随后重新打开宝塔面板，确认页面可以正常访问。
如果升级过程中 SSH 连接意外中断，不要立即重新运行脚本。应先重新连接服务器，检查面板状态和终端记录，再决定下一步处理方式。
六、升级后需要检查哪些功能
Python 版本显示正确，只能说明运行环境已经切换。还需要确认面板和服务器管理功能能够正常工作。
1、检查宝塔面板登录
确认面板登录页可以打开，账号能够正常登录，首页没有持续加载或接口报错。
2、检查网站列表
进入网站管理页面，确认网站列表、域名、运行状态及相关设置能够正常读取。
3、检查数据库管理
打开数据库页面，确认数据库列表能够显示。不要在尚未确认面板稳定时执行数据库删除、导入或恢复。
4、检查软件商店
确认软件商店可以加载，已安装软件状态正常。此时无需为了测试而更新所有软件。
5、检查计划任务
查看计划任务列表，确认任务记录仍然存在。可以等待一项低风险任务自然执行，再检查运行日志。
6、检查面板日志
查看面板错误日志和升级输出，确认没有持续出现 Python 模块缺失、依赖冲突或服务启动失败。
7、检查常用管理功能
根据服务器实际用途，测试文件管理、终端入口、监控、备份和安全功能。生产环境只进行必要验证，避免一次修改过多设置。
七、升级失败应该怎么处理
1、保留完整终端输出
升级脚本报错后，不要关闭终端，也不要只截取最后一行信息。应保存从命令执行开始到报错结束的完整输出。
完整日志有助于判断问题来自软件源、网络、磁盘空间、依赖安装还是面板文件异常。
2、不要反复运行升级脚本
脚本第一次失败后，服务器可能处于部分文件已经更新、部分依赖尚未完成的中间状态。反复执行可能覆盖现场信息，并增加后续排查难度。
3、检查服务器基础状态
可以检查磁盘和内存情况。
df -hfree -h再查看宝塔面板服务状态。
bt status不要在没有明确原因的情况下删除面板目录、Python环境或升级备份。
4、通过官方渠道反馈
提交问题时建议提供以下信息。
- 宝塔面板版本
- Linux发行版及版本
- 服务器架构
- 原Python运行环境
- 完整升级输出
- 面板错误日志
- 是否创建系统快照
- 已经执行过的处理步骤
隐私信息、登录密码、API密钥和服务器密钥应在提交前隐藏。
5、必要时使用快照回滚
如果面板无法恢复，并且服务器业务受到影响，可以根据云平台流程回滚升级前快照。
回滚会让服务器恢复到快照创建时间点。期间新增的网站数据、订单和文件可能丢失，因此执行前应评估增量数据，并按照业务要求另行保存。
八、是否可以删除 Python 3.7 备份
升级脚本完成后可能保留旧运行环境备份。不要在刚完成升级时立即删除。
建议先观察一段时间，确认以下项目均正常。
- 面板登录稳定
- 网站与数据库管理正常
- 软件商店可以使用
- 计划任务正常执行
- 面板日志无持续报错
- 服务器经过至少一次正常重启验证
- 快照和独立备份仍然可用
确认没有回退需求后，再根据宝塔官方说明处理旧环境备份。不要自行猜测目录并执行递归删除命令。
九、常见问题
宝塔面板升级 Python 3.13 会修改网站 Python 版本吗
不会直接修改。本次升级针对宝塔面板自身使用的运行环境，网站项目的虚拟环境、Docker环境和系统Python需要单独管理。
宝塔面板 9.0 和 10.0 可以直接执行升级脚本吗
不建议。旧版本用户应先按照宝塔面板指引完成修复和版本升级，确认进入受支持的12.0稳定版后再操作。
为什么不能使用宝塔面板终端
升级过程可能重启宝塔面板及其Python运行环境。面板终端依赖面板服务，操作期间可能断开。独立SSH客户端更适合保留连接和完整输出。
升级期间网站会停止访问吗
此次更新主要影响宝塔面板运行环境，正常情况下不等同于主动停止Nginx、Apache、PHP或数据库。不过，服务器环境存在差异，仍需选择低峰期并准备快照。
升级完成后需要删除Python 3.7吗
不需要立即删除。应先验证面板及相关功能稳定运行，并保留一段观察期。后续清理应以宝塔官方说明为准。
升级脚本报错后可以再次执行吗
不要立即重复执行。应先保存完整输出，检查服务器状态，并通过宝塔官方渠道确认故障原因及处理方式。
更多参考：《宝塔面板教程》
-
广告合作
-
QQ群号：4114653
