《1Panel 没有升级命令?手动换二进制完成一次全队升级》

举报
yd_252071992 发表于 2026/11/11 08:32:39 2026/11/11
【摘要】 给多台服务器上的 1Panel 升一次级,本以为是点几下鼠标的事,结果发现这条路根本走不通。面板版本停在旧版,升级按钮背后没有可用的升级命令,最后是靠手动换二进制、一台一台升上去的。这篇记录整个过程:先踩过的弯路、最后走通的路线、以及几个容易翻车的关键点。先说结论:1Panel 没有提供命令行升级入口。1pctl update 这个命令看起来像升级,实际作用只是修改面板信息,比如端口、用户名...

给多台服务器上的 1Panel 升一次级,本以为是点几下鼠标的事,结果发现这条路根本走不通。面板版本停在旧版,升级按钮背后没有可用的升级命令,最后是靠手动换二进制、一台一台升上去的。这篇记录整个过程:先踩过的弯路、最后走通的路线、以及几个容易翻车的关键点。

先说结论:1Panel 没有提供命令行升级入口。1pctl update 这个命令看起来像升级,实际作用只是修改面板信息,比如端口、用户名、密码;核心二进制自带的 update 子命令同样不是升级。去官网下载发行包再跑安装脚本也不行,install.sh 检测到本机已经安装过,会直接拒绝,提示已经安装、请勿重复安装。面板界面里倒是有在线升级的入口,但那需要面板的登录凭据才能操作。几条常规路都堵死之后,只剩下一条路:手动替换二进制文件。

手动升级的思路并不复杂,难在细节不能错。第一步是拿到官方发行包,从官方资源站下载对应版本的 tar.gz,同时下载 checksums.txt,用 sha256sum 核对哈希值,确认包没有损坏、没有被调换过,再往下走。

第二步是停服务。升级期间要先停掉 1panel-core 和 1panel-agent 两个服务,文件正在被进程占用的时候替换,轻则替换失败,重则留下半新半旧的文件,服务起不来。停服务之前先做备份,至少把数据库文件和旧的二进制文件留一份,万一新版本起不来,还能原样退回去。

第三步是替换文件。发行包里的核心二进制有两个,1panel-core 和 1panel-agent,实体在 /usr/local/bin 下面,/usr/bin 里的只是软链,换实体文件即可。同时要覆盖 GeoIP 数据库文件和语言文件,分别放到 geo 目录和二进制所在目录。只换主二进制、不换配套文件,面板可能出现功能缺失或者界面错乱。

第四步是最容易被忽略的一点:版本号存在数据库里。只换二进制文件,面板打开后仍然显示旧版本号,还会反复提示升级。这是因为版本信息写在 core.db 和 agent.db 的配置表里,不改数据库,面板就认旧版本。正确做法是在服务停止期间,用 sqlite3 把两个数据库里 settings 表的 SystemVersion 字段改成新版本号,再用 sed 同步修改 1pctl 脚本里的 ORIGINAL_VERSION。这里有一个大坑:千万不要整体替换 1pctl 这个脚本,它里面嵌着本机的端口、入口路径、用户名、密码等配置行,整体覆盖等于把本机的面板配置抹掉。只改版本号那一行。

第五步是服务单元文件。发行包里一般也带 .service 文件,先拿新旧版本比对一下,内容相同就不用动;只有内容变化时才替换,替换后记得 daemon-reload。我们的实测里,新旧版本的服务单元文件完全相同,所以这一步直接跳过。

第六步是验证,分三层。先跑 1panel version,看输出的版本号是不是新版;再查两个服务的状态,确认都是 active;最后用 curl 访问本机面板端口,确认面板能正常响应。这里还有一个细节:如果某台机器的面板开了 SSL,用 HTTP 请求会返回 400,这是正常的,要用 HTTPS 加忽略证书的方式验证。

整个流程先在一台机器上完整走一遍,验证通过后再推广到全队。我们当时就是先拿一台机器当金丝雀,确认升级路线和验证方法都没问题,才逐台执行。逐台升级还有一个好处:任何一台出问题,都可以先停下来排查,不会把全队的面板同时置于不可用状态。

复盘这次升级,有三点经验值得记下来。第一,升级之前先确认升级通道是否存在。很多软件的升级命令名不副实,不实际试一次,光看命令名字会误判。第二,版本号的存放位置决定了升级动作的完整性。只换文件不改数据库,面板会一直认为自己是旧版,这种“换了一半”的状态比不升级更糟。第三,备份要放在升级动作之前,而且要包含回滚所需的全部材料:数据库、旧二进制、关键配置文件。升级失败不可怕,可怕的是失败之后没有东西可以退回去。

这次升级最终全队完成,面板版本统一,服务全部正常。过程虽然绕了弯路,但手动换二进制的路线本身是可靠的:下载官方包、验哈希、停服务、换文件、改数据库版本号、启服务验证,六步走完,升级就完成了。如果以后再遇到没有升级命令的面板软件,这套流程可以直接复用。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。