通过 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 都运行支持密钥文件的版本。