《1Panel 没有升级命令?手动换二进制完成一次全队升级》
给多台服务器上的 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 加忽略证书的方式验证。
整个流程先在一台机器上完整走一遍,验证通过后再推广到全队。我们当时就是先拿一台机器当金丝雀,确认升级路线和验证方法都没问题,才逐台执行。逐台升级还有一个好处:任何一台出问题,都可以先停下来排查,不会把全队的面板同时置于不可用状态。
复盘这次升级,有三点经验值得记下来。第一,升级之前先确认升级通道是否存在。很多软件的升级命令名不副实,不实际试一次,光看命令名字会误判。第二,版本号的存放位置决定了升级动作的完整性。只换文件不改数据库,面板会一直认为自己是旧版,这种“换了一半”的状态比不升级更糟。第三,备份要放在升级动作之前,而且要包含回滚所需的全部材料:数据库、旧二进制、关键配置文件。升级失败不可怕,可怕的是失败之后没有东西可以退回去。
这次升级最终全队完成,面板版本统一,服务全部正常。过程虽然绕了弯路,但手动换二进制的路线本身是可靠的:下载官方包、验哈希、停服务、换文件、改数据库版本号、启服务验证,六步走完,升级就完成了。如果以后再遇到没有升级命令的面板软件,这套流程可以直接复用。
- 点赞
- 收藏
- 关注作者
评论(0)