小皮面板怎么升级面板程序版本

学完这篇，你能自己把小皮面板（Windows 版和 Linux 版）的面板程序升到最新版本，并且升级过程中网站和数据库不会丢。

第一步：升级前先看清版本、把数据备份好

这一步要做的，是确认你现在用的版本号，以及把「升级失败也能退回来」的底牌留好。Windows 版打开小皮面板，点主界面右上角的齿轮图标进入「设置」，切到「关于」页，就能看到当前版本号（形如 8.1.1.3）。Linux 版在 SSH 里敲 xp -v，或者看面板登录页底部也能看到版本号。

备份三样东西就够：网站根目录（Windows 默认在 D:\phpstudy_pro\WWW，Linux 默认在 /www/wwwroot）、数据库数据目录（Windows 在 D:\phpstudy_pro\Extensions\MySQL8.0.12\data 这种以版本号命名的文件夹里，Linux 在 /www/server/data）、还有面板自身的配置目录。

注意：数据库不要直接复制 data 文件夹就算完，最稳的是在面板「数据库」菜单里对每个库点一次「导出」，同时再手动复制一份 data 目录，双保险。

第二步：Windows 版优先用面板自带的检查更新

这一步要做的，是让面板自己下载新版本并替换程序文件，做完后版本号会变。路径是：主界面右上角齿轮图标 →「关于」→ 点「检查更新」按钮；如果这个位置没有，就右键任务栏右下角的小皮面板托盘图标，菜单里同样有「检查更新」。检测到新版本后会弹出提示，点「立即更新」，面板会自动停掉服务、下载、替换文件、重启。

注意：更新过程网站会短暂中断，挑访问量低的时段做；更新弹窗出现后不要手动关掉，也别同时去点「启动」按钮，等它跑完自己重启。

第三步：自动更新失败，就手动覆盖安装

这一步要做的，是绕开内置更新通道，用官网安装包覆盖旧程序，数据和网站都保留。打开浏览器进 xp.cn，下载最新的 Windows 版安装包，双击运行。安装路径要选成和原来一样的目录（默认是 D:\phpstudy_pro），安装向导检测到旧版本会给出提示，选保留数据的那一项，不要勾选任何带「清空」「初始化数据库」字样的选项。装完面板会自动启动。

注意：覆盖安装前先把面板里的服务全部停止（首页每个服务右侧的「停止」按钮），否则文件被占用会装出问题。

第四步：Linux 版用 xp 命令菜单升级

这一步要做的，是通过命令行菜单升级面板。用 root 登录服务器，输入 xp 回车，进入面板命令行菜单，找到「更新面板」或「升级面板」这一项（不同小版本叫法略有差异，通常排在菜单靠下的位置），输入它前面的编号回车，脚本会自动拉取最新版并重启面板服务。如果你的版本菜单里确实没有这一项，就重新执行一遍官方安装脚本，它默认只更新面板程序，不动 /www/server 下的网站和数据库。

注意：Linux 版升级必须用 root，普通用户执行会卡在权限报错；升级前用 bt 之外的方式确认一下磁盘剩余空间，低于 1GB 容易下载解压失败。

第五步：升级后逐项验证

这一步要做的，是确认升级真的成功、业务真的没坏。刷新面板页面，再看一次「关于」里的版本号是否已变；回首页点「启动」把 Nginx/Apache、MySQL、PHP 逐个起起来，看指示灯是不是绿色；浏览器打开自己的站点，后台登录一次，能正常读写数据才算过关。

注意：万一 MySQL 起不来，多半是数据目录权限或配置被覆盖，先看面板「数据库」菜单里的备份列表，用「导入」把最近一次导出的库恢复回来。

小结

• 升级前必做：查版本号、导出所有数据库、复制 WWW 和 data 目录。
• Windows 版：齿轮设置 →「关于」→「检查更新」，或托盘右键「检查更新」。
• 自动更新失败就官网下安装包，装到原目录、保留数据覆盖安装。
• Linux 版：root 登录后输入 xp，在菜单里选「更新面板」。
• 升级后逐项验证：版本号、服务是否启动、网站和数据库是否正常读写。
• 全程避开访问高峰，升级中不要手动干预。