实用工具 许可管理

通过 MDM 部署

如果使用 Jamf Pro、Kandji 或 Microsoft Intune 等设备管理(MDM)工具管理 Mac 或 Windows PC,可以通过许可证密钥文件激活这些设备上的 TablePlus。TablePlus 会在启动时读取文件并自动激活密钥。你还可以要求设备必须使用组织的密钥,否则无法使用 TablePlus。

最新版的 TablePlus macOS 版和 Windows 版支持许可证密钥文件。Setapp 版不会读取这些文件。

创建密钥文件

创建名为 .tplicensekey 的纯文本文件,在第一行填入许可证密钥。

TP-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
require: true

require 行是可选项。

  • 指定 require: true 后,必须先激活密钥才能使用 TablePlus,且用户无法激活其他密钥。
  • 设置 require: false 或省略 require 行时,TablePlus 会尝试激活组织的密钥。如果激活失败,用户可以保留自己的许可证或自行激活许可证。

编写文件时请注意以下几点。

  • 请将密钥写在第一行,也可以写成 key: TP-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX。
  • require 还接受 yes 和 no、1 和 0,或 on 和 off。也可以使用 require = true 这种写法。其他值均按 true 处理。
  • 以 # 开头的行是注释。

在 Mac 上安装密钥文件

将文件安装到 /Users/Shared/.tplicensekey,由 root 拥有且仅允许 root 写入(所有者和组为 root:wheel,权限为 0644)。TablePlus 会为这台 Mac 上的所有用户激活密钥,整台 Mac 只占用一个席位。

以 root 身份运行以下脚本,例如将其作为 MDM 策略中的脚本运行。

#!/bin/sh
set -e
KEY_FILE="/Users/Shared/.tplicensekey"

# Any user can create files in /Users/Shared: remove whatever is there first
rm -rf "$KEY_FILE"
printf '%s\n' "TP-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" "require: true" > "$KEY_FILE"
chown root:wheel "$KEY_FILE"
chmod 0644 "$KEY_FILE"

请务必像脚本中那样让 root 拥有文件,并且只允许 root 写入。TablePlus 会应用 /Users/Shared 中的密钥文件,无论文件归谁所有。如果用户可以修改或删除该文件,require 限制就无法得到保障。

TablePlus 会在密钥文件旁的 /Users/Shared/.licensemac 中保存已激活的许可证。如果提前创建这个文件,请允许所有用户写入(权限为 0666)。如果文件存在但用户无法写入,激活将失败并显示“TablePlus couldn't save the license in /Users/Shared.”。

也可以将密钥文件安装到单个用户的 ~/Library/Application Support/com.tinyapp.TablePlus/.tplicensekey。由于用户可以删除自己文件夹中的文件,TablePlus 会忽略该位置文件中的 require。

在 Windows 上安装密钥文件

由管理员在 C:\ProgramData\TablePlus\.tplicensekey 创建文件,普通用户只能读取。TablePlus 会为这台 PC 的所有用户激活密钥,整台 PC 只占用一个席位。

以管理员或 SYSTEM 身份运行以下 PowerShell 脚本,例如将其作为 Intune 中的平台脚本运行。

$folder = Join-Path $env:ProgramData "TablePlus"
$file = Join-Path $folder ".tplicensekey"

New-Item -ItemType Directory -Force -Path $folder | Out-Null
# A user may have created the folder first: it becomes the administrators' again, with the default permissions
icacls $folder /setowner "*S-1-5-32-544" | Out-Null
icacls $folder /reset | Out-Null

Remove-Item -Force -ErrorAction SilentlyContinue $file
Set-Content -Path $file -Encoding ASCII -Value "TP-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", "require: true"
# Users can read the key file, but not change or remove it
icacls $file /inheritance:r /grant:r "*S-1-5-18:F" "*S-1-5-32-544:F" "*S-1-5-32-545:R" | Out-Null

请务必像脚本中那样让管理员拥有文件夹,并将用户对密钥文件的权限设为只读。TablePlus 会应用 C:\ProgramData\TablePlus 中的密钥文件,无论谁创建了它。如果用户可以修改或删除该文件,require 限制就无法得到保障。

TablePlus 将已激活的许可证保存在密钥文件旁的 C:\ProgramData\TablePlus\.licensewindows,并允许这台 PC 上的所有用户修改它。用户必须能在 C:\ProgramData\TablePlus 中创建文件,默认权限允许此操作。安装密钥文件后,所有用户的 TablePlus 都使用相同的设备 ID,因此无论有多少用户,这台 PC 都只占用一个席位。

也可以将密钥文件安装到单个用户的 %LOCALAPPDATA%\com.tinyapp.TablePlus\.tplicensekey。由于用户可以删除自己文件夹中的文件,TablePlus 会忽略该位置文件中的 require。

用户会看到什么

Mac 或 PC 上的许可证状态 TablePlus 启动时的行为
没有许可证 自动激活组织的密钥,无需询问用户。
已激活用户自己输入的许可证 提示用户这台 Mac(或 PC)上的 TablePlus 由组织管理,随后激活组织的密钥,替换用户原来的密钥。用户原先占用的席位可以用于其他设备。
已使用组织的密钥激活 不执行任何操作。许可证窗口不显示 Unlink This Mac(Windows 上为 Unlink This Device)。

设置 require: true 后,行为如下。

  • 在密钥激活前,TablePlus 会先显示“Activating license key”,此时不会打开任何窗口或连接。如果激活失败,会说明原因,并提供 Try Again 和 Quit。席位已满或更新期结束时可选 Email License Owner,版本超出许可证范围时可选 Download the Old Build,当前版本已撤回时可选 Download TablePlus。连接不上许可证服务器时,TablePlus 每分钟自动重试一次。其他情况每 15 分钟重试一次。
  • 用户无法激活其他密钥。许可证窗口(Mac 上为 TablePlus > Register license...,Windows 上为 Preferences > License)会以掩码形式显示组织的密钥,并且只允许激活该密钥。
  • TablePlus 不会中断正在进行的会话。如果 Mac 或 PC 在 TablePlus 运行时失去许可证,TablePlus 会尝试重新激活组织的密钥,失败时会通知用户。限制从下次启动时开始生效。
  • 首次启动时必须能够连接 tableplus.com。

设置 require: false 时,如果组织的密钥激活失败,用户仍可保留自己的许可证或自行激活许可证。TablePlus 会在下次启动时重试组织的密钥。

限制功能和更新

在许可证管理器中,每个密钥的 TablePlus policy 设置适用于使用该密钥激活的所有 Mac 和 Windows PC。

  • Disable MCP Server、Disable AI Chat 和 Disable crash reports 可分别关闭对应功能。原本显示这些功能的位置会显示“Disabled by the license owner”。
  • Disable query history 会停止记录查询历史。History 标签页显示“Disabled by the license owner”,MCP 客户端无法读取历史记录。之前记录的历史仍保留在 Mac 上。
  • Updates - macOS 可将 Mac 固定在所选版本,Updates - Windows 则适用于 Windows PC。选择 Auto 将更新至许可证允许的最新版本。

TablePlus 会在启动时和之后每 6 小时检查策略变更。Mac 或 PC 即使失去许可证,只要密钥文件仍在,就会保留最后收到的策略。如果看不到策略设置,请联系我们为你的密钥开启该功能。

许可证管理器: https://tableplus.com/license-manager/access-link

如果 MDM 工具负责安装 TablePlus 更新,请只安装许可证涵盖的版本,或在 Updates - macOS 或 Updates - Windows 中选定的版本。在更新期结束后发布的版本无法激活。如果设置了 require: true,TablePlus 将被阻止运行,直到安装较旧的适用版本。

更换或移除密钥

  • 更换密钥: 替换密钥文件。TablePlus 会在下次启动时或 6 小时内激活新密钥。旧许可证在新密钥激活前继续有效。
  • 在许可证管理器中轮换密钥: 同时用新密钥更新文件。已激活的 Mac 和 PC 可继续使用,但需要激活的设备不能再用旧密钥。如果设置了 require: true,这些设备将无法使用 TablePlus。
  • 解除 Mac 或 PC 的授权: 删除或清空密钥文件。TablePlus 会在下次启动或检查时注销设备,释放席位并解除限制。

故障排除

消息 解决方法
All seats on this license are in use. 在许可证管理器中移除不再使用的设备,或增加席位。
This license key isn't valid. 核对文件中的密钥,尤其是在轮换密钥之后。
This version of TablePlus was released after the license's updates ended. 安装较旧的版本,或续订许可证。
TablePlus couldn't reach the license server. 确认 Mac 或 PC 能够连接 tableplus.com。
TablePlus couldn't save the license in /Users/Shared. 删除 /Users/Shared/.licensemac,或允许所有用户写入该文件。
TablePlus couldn't save the license in C:\ProgramData\TablePlus. 确认用户能在 C:\ProgramData\TablePlus 中创建文件。如果那里存在用户不能修改的 .licensewindows 文件,请移除它。

本地管理员仍然可以删除密钥文件。请通过 MDM 工具管理 TablePlus 更新,以确保所有 Mac 和 PC 都运行支持密钥文件的版本。