升级和迁移指南

如何升级 GetWebP CLI 到新版本、更改您的计划层级或将您的许可证移到不同的设备。

另请参阅： 入门 | 命令参考 | 故障排除

目录#

• 升级您的计划 (Free 到 Pro)
• 升级 CLI 版本
  • 二进制下载 (所有平台)
  • 验证升级
• 迁移到新设备
  • 步骤 1 -- 停用旧设备
  • 步骤 2 -- 在新设备上安装
  • 步骤 3 -- 在新设备上激活
  • 紧急：旧设备不可用
• 配置文件兼容性
  • 配置位置
  • 机器绑定加密
  • 跨版本升级配置
• 按版本的破坏性更改
  • v1.0.0 (2025-01-01)
• 常见问题

升级您的计划 (Free 到 Pro)#

GetWebP CLI 在免费计划上立即工作。要解锁更快的处理、并行工作者和无限制的每次运行文件数，请升级到 Pro。

计划升级如何工作#

步骤#

1. 购买或升级您在 getwebp.com/pricing 的许可证。
2. 激活您设备上的新许可证密钥：

getwebp auth XXXX-XXXX-XXXX-XXXX

Verifying license...
✓ Activated! Pro plan unlocked.

3. 确认升级已生效：

getwebp status

Version    : 1.0.1
Mode       : Pro
License    : xxxx-xxxx-xxxx-A1B2
Expires    : 2027-04-01
Devices    : 1 / 3 used
WP Sites   : 0 / 3 used

提示： 您现有的许可证密钥可能可以原地升级（取决于升级的购买方式）。检查您的电子邮件或 仪表板 了解详情。

升级 CLI 版本#

二进制下载 (所有平台)#

这是所有平台的标准升级路径。

1. 下载最新的二进制文件，适用于您的平台，来自 Releases 页面。

2. 替换现有的二进制文件。

macOS / Linux：

# 下载并重命名
mv getwebp-macos-arm64 getwebp    # 根据您的平台调整
chmod +x getwebp
 
# 替换现有的二进制文件
sudo mv getwebp /usr/local/bin/

如果 macOS 阻止新的二进制文件，请移除隔离属性：

xattr -cr /usr/local/bin/getwebp

Windows：

将 getwebp.exe 在您的 PATH 上的目录（例如 C:\Tools\getwebp.exe）替换为新下载的文件。

3. 验证下载完整性（可选但推荐）：

# macOS / Linux
shasum -a 256 -c getwebp-macos-arm64.sha256

# Windows (PowerShell)
$expected = (Get-Content getwebp.exe.sha256).Split(' ')[0]
$actual   = (Get-FileHash getwebp.exe -Algorithm SHA256).Hash.ToLower()
if ($expected -eq $actual) { Write-Host "Verified OK" } else { Write-Host "MISMATCH" }

验证升级#

getwebp --version

预期输出（示例）：

getwebp/1.0.1

您的许可证激活会自动保留。版本升级后不需要重新认证 -- 配置文件和存储的令牌保持完整。

# 确认您的许可证仍然活跃
getwebp status

迁移到新设备#

GetWebP 许可证绑定到激活它们的设备。每个许可证都有设备限制（可通过 getwebp status 查看）。要将您的许可证移到新机器，您必须首先在旧机器上释放设备插槽。

步骤 1 -- 停用旧设备#

在旧设备上，运行：

getwebp logout

? Confirm unbind license from this device? This cannot be undone. (y/N) y
✓ Successfully unbound. This device is now on the Free plan.

这会联系服务器、移除设备绑定并清除本地令牌。对于脚本或 CI，使用 --force 跳过确认提示：

getwebp logout --force

重要： getwebp logout 需要网络访问。如果您无法连接，请查看下面的 紧急：旧设备不可用。

步骤 2 -- 在新设备上安装#

按照您的平台的标准安装步骤。查看 入门 -- 安装。

步骤 3 -- 在新设备上激活#

在新设备上，运行：

getwebp auth XXXX-XXXX-XXXX-XXXX

Verifying license...
✓ Activated! Pro plan unlocked.

验证：

getwebp status

紧急：旧设备不可用#

如果旧设备丢失、损坏或无法访问：

1. 转到您的 GetWebP 仪表板。
2. 在您的许可证下找到该设备并手动移除它。
3. 使用 getwebp auth 在新设备上激活。

如果您已达到设备限制且无法访问仪表板，请通过网站联系支持。

配置文件兼容性#

配置位置#

GetWebP 将其配置（许可证令牌和状态缓存）存储在特定平台的目录中：

您可以通过设置 GETWEBP_CONFIG_DIR 环境变量来覆盖配置目录：

GETWEBP_CONFIG_DIR=/custom/path getwebp status

机器绑定加密#

配置文件使用从您机器的硬件 ID（通过 node-machine-id）派生的密钥进行加密。这意味着：

• 配置文件无法在机器之间复制。 来自一台设备的配置文件将无法在不同的设备上解密。
• 不要备份配置文件以在其他机器上使用。 内部的令牌将不可读。
• 如果您的机器 ID 改变（例如主要硬件替换、更改系统 UUID 的操作系统重新安装），现有配置可能变得不可读。在这种情况下，删除配置文件并使用 getwebp auth 重新激活。

如果无法读取机器 ID（例如在某些容器化环境中），CLI 回退到从主机名和用户名派生的密钥。更改其中任一个将使存储的配置失效。

跨版本升级配置#

v1.x 各版本之间的配置架构保持稳定。在补丁或次要版本之间升级时不需要迁移。如果您的配置变得不可读（例如硬件更换后），请删除配置文件并使用 getwebp auth 重新激活。

按版本的破坏性更改#

v1.0.0 (2025-01-01)#

首次公开发布。v1.0.0 包含的主要功能：

常见问题#

在升级 CLI 版本之前需要注销吗？#

不需要。版本升级不会影响您的许可证。只需替换二进制文件，您的激活保持有效。