《1Panel 没有升级命令?一次手动换二进制的版本升级手记》
给服务器面板升个级,本该是点一下按钮的事。直到某天要把一批机器上的 1Panel 从 v2.3.2 升到 v2.4.2,我才发现这件事没有现成的路:官方没有提供一条能真正完成升级的命令行,面板里的在线升级又需要登录凭据。最后走通的办法,是手动换二进制——过程不复杂,但有几个坑,踩中任何一个都会让面板显示的版本号和实际跑的版本对不上。
先说结论:升级的核心就四步,拿官方安装包、校验哈希、停服务换二进制、改数据库里的版本号。听起来简单,细节决定成败。
第一步,先确认手里到底有没有升级命令。1pctl update 这个名字最容易误导人,实测它只是修改面板信息,比如密码、端口、用户名,和版本升级没有关系。核心二进制自带的 update 子命令同样如此。发行包里的 install.sh 检测到已安装会直接拒绝,提示已经安装、请勿重复安装。所以不要在这些命令上浪费时间,升级不走这条路。
第二步,拿官方安装包并验哈希。安装包在官方资源站的固定路径下,按版本组织,文件名形如 1panel-版本-linux-amd64.tar.gz,同目录有 checksums.txt。下载后先对 sha256,哈希对不上就不要往下走。这一步花不了几分钟,但它是整个流程里唯一能证明“手里的包就是官方发的那个包”的环节,值得做。
第三步,停服务、换二进制。先停掉 1panel-core 和 1panel-agent 两个服务,再替换可执行文件。实体在 /usr/local/bin 下面,/usr/bin 下的只是软链,换对地方。除了两个主二进制,还要覆盖 GeoIP 数据库文件和语言包文件,路径分别是面板数据目录下的 geo 目录和 /usr/local/bin 下的 lang 目录。漏掉语言包不会导致启动失败,但界面文字可能停留在旧版本,容易让人误以为没升上去。
第四步,也是最容易漏的一步:改数据库里的版本号。面板显示的版本号不是从二进制文件读出来的,而是存在 SQLite 数据库里的。core.db 和 agent.db 各有一张 settings 表,里面的 SystemVersion 字段就是面板认定的当前版本。如果只换了二进制、不改这个字段,服务照常跑新版本,面板却仍然显示旧版,还会反复提示升级。用系统自带的 python3 sqlite3 模块就能改,两行语句的事,改完再启动服务。
还有一处要同步改:1pctl 脚本里嵌着一行 ORIGINAL_VERSION,也要改成新版本。这个脚本不能整体替换——它里面嵌着本机的端口、入口路径、用户名、密码等配置行,拿新版整个覆盖会把这些配置冲掉。只改版本号那一行。
服务单元文件要不要动,看情况。新版的 .service 文件如果和旧版内容相同,就不用动;不同才替换,替换后记得 daemon-reload。
验证分三层,缺一不可。先跑 1panel version,看输出的版本号是不是新版;再看两个服务是不是 active;最后用 curl 直接访问本机面板端口,确认面板能正常响应。如果面板开了 HTTPS,HTTP 请求会返回 400,提示发送了明文请求,这时要改用 https 加跳过证书校验的方式验证,不要误判为升级失败。
整批升级的顺序也有讲究。先挑一台机器做金丝雀,完整走一遍、验证三层都通过,再铺到其余机器。回滚材料提前备好:升级前把面板数据目录做一次全量备份,旧二进制单独存一份。数据目录如果太大,全量备份可以只保留数据库文件,其余按需取舍。回滚时把旧二进制换回去、数据库版本号改回去、服务重启,面板就回到升级前的状态。
复盘这次升级,最大的感受是:面板类工具的“版本号”往往不是单一事实,而是二进制、数据库、脚本三处各自存了一份。只改其中一处,系统不会报错,只会安静地表现出不一致——面板显示旧版、功能却是新版,或者反过来。升级之前先搞清楚版本信息存在哪几处,比升级动作本身更重要。
另外一个小经验:凡是“看起来像升级命令”的命令,先查它的实际行为再动手。名字会骗人,实测不会。1pctl update 这个名字,足够让人在它上面浪费一个下午。
- 点赞
- 收藏
- 关注作者
评论(0)