应用商店版本落后？教你用 LPK 自助升级

懒猫微服商店里的应用没及时更新怎么办？

以 Calibre-Web Automated 为例：商店里是 3.0.5，而最新版已经到 3.1.4。作为不更新会死星人，自然要自己动手。

官方路径有两条：

1. 等待提供者更新（或客服联系开发者更新）
2. 自己修改 LPK 包，更换镜像版本

本文走第 2 条，几分钟搞定升级。

准备工作

需要工具：

• 懒猫应用查看器（用于导出/查看 LPK）
• lzc-cli（开发者命令行工具，需注册开发者账号）

步骤一：获取 LPK

安装并打开“懒猫应用查看器（LPK Inspector）”
导出 Calibre-Web Automated 的 LPK 文件

步骤二：解包并查看 manifest.yml

用任意解压软件打开 LPK（本质是 zip）
找到并打开 manifest.yml，原始片段类似：

lzc-sdk-version: 0.1
package: cloud.lazycat.app.calibreweb
version: 3.0.5
name: Calibre-Web Automated
description: Calibre-Web，但自动化且具有 Calibre 功能
license: https://choosealicense.com/licenses/gpl-3.0/
homepage: https://github.com/crocodilestick/Calibre-Web-Automated
author: CrocodileStick
application:
  subdomain: calibreweb
  user_app: true
  routes:
    - /=http://server.cloud.lazycat.app.calibreweb.lzcapp:8083
services:
  server:
    image: >-
      registry.lazycat.cloud/longixaoyi/crocodilestick/calibre-web-automated:bdf3dbf10be5a22c
    environment:
      - PUID=0
      - PGID=0
      - TZ=Asia/Shanghai
    binds:
      - /lzcapp/var/config:/config
      - /lzcapp/var/cwa-book-ingest:/cwa-book-ingest
      - /lzcapp/var/calibre-library:/calibre-library
      - /lzcapp/var/books:/books
      - >-
        /lzcapp/pkg/content/auto-library.py:/app/calibre-web-automated/scripts/auto-library.py

可以看到 image 使用的是 registry.lazycat.cloud 的仓库，意味着我们需要先把新版镜像同步到该仓库。

步骤三：把上游镜像同步到懒猫镜像仓库

使用 lzc-cli（需要开发者账号登录）执行（示例）：
lzc-cli appstore copy-image crocodilestick/calibre-web-automated:V3.1.4
命令执行成功后，会返回一个 registry.lazycat.cloud 上的完整镜像地址（包含命名空间与标签/摘要）。记下这个地址。

提示：

• 平台通常要求走 registry.lazycat.cloud 拉取，直接改 docker.io/ghcr.io 不一定能拉到，因此用 copy-image 最稳。
• 确认镜像是否包含你的 CPU 架构（amd64/arm64）。

步骤四：修改 manifest.yml 的镜像地址

• 将 services.server.image 改为上一步返回的 registry.lazycat.cloud 完整地址（3.1.4 对应的 tag/摘要）。（顺便把version 也改成3.1.4吧）
• 其他项一般不需要变动，但建议检查：
  • 环境变量（PUID/PGID/TZ 是否仍适用，新版是否有新增/废弃）
  • 端口（仍为 8083 即可）
  • 数据卷路径（/config、/books、/calibre-library、/cwa-book-ingest 等是否一致）
  • 兼容性脚本（auto-library.py 的挂载路径未变化）

步骤五：重新打包为 LPK

• 将修改后的文件“就地压缩”为 zip（注意把目录内容打包到根层级，而不是再套一层目录）
• 把后缀 .zip 改为 .lpk，例如 calibreweb-3.1.4.lpk

可选：若这是一个完整项目，也可用 lzc-cli 构建（开发手册示例）

lzc-cli project build -o release.lpk
lzc-cli app install release.lpk

步骤六：安装并验证

安装新包：lzc-cli app install calibreweb-3.1.4.lpk 提示安装成功后，打开 Calibre-Web Automated，检查应用内“关于/版本”或首页标注，确认已是 3.1.4。

故障排查与回滚

• 拉取失败/403：重试 copy-image，或检查是否输错上游 tag（V3.1.4 大小写要一致）。
• 架构不匹配：确认镜像支持你的设备架构。
• 启动报错：对照新版 README/Changelog，检查环境变量、卷挂载、健康检查端点是否变化。
• 快速回滚：把 image 改回旧地址，重新打包并安装；原数据卷位于 /lzcapp/var/*，不会随升级丢失（建议重要数据先备份）。

贴士

• 商店更新节奏有时会滞后，“自己改 LPK + 同步镜像”是当前最省事的临时方案。
• 想省去手工压包，亦可在熟悉 lzc-cli 后把此流程脚本化。

用到的工具

• 懒猫应用查看器（LPK Inspector）：https://lazycat.cloud/appstore/detail/top.j0k3r.lpk-inspector

参考

• https://lazycat.cloud/playground/guideline/652
• https://lazycat.cloud/playground/guideline/662
• https://lazycat.cloud/playground/guideline/753
• https://developer.lazycat.cloud/lzc-cli.html