进阶 tableplus.com 2026-11-16 08:30:30 · 6 阅读
第55章 通过 MDM 部署 TablePlus 企业授权
工具
授权
通过 MDM 部署
如果你使用 Jamf Pro、Kandji 或 Microsoft Intune 等设备管理(MDM)工具来管理 Mac 或 Windows PC,可以通过 license key 文件在这些设备上激活 TablePlus。TablePlus 启动时会读取该文件并自动激活密钥。你也可以强制使用组织的密钥,让 TablePlus 在没有它的情况下无法使用。
License key 文件适用于最新版 TablePlus for macOS 和 TablePlus for Windows。Setapp 版本不支持读取该文件。
创建密钥文件
密钥文件是一个名为 .tplicensekey 的纯文本文件。将你的 license key 放在第一行:
TP-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
require: true
require 行是可选的:
require: true:密钥未激活前无法使用 TablePlus,且用户不能激活其他密钥。
require: false,或省略 require 行:会激活你的密钥,但在密钥无法激活时,用户仍可保留或激活自己的 license。
一些细节:
密钥必须放在第一行。也可以写成 key: TP-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX。
require 还接受 yes 和 no、1 和 0、on 和 off,也支持 require = true 的写法。其他任何值都视为 true。
以 # 开头的行是注释。
在 Mac 上安装密钥文件
将文件安装到 /Users/Shared/.tplicensekey,属主为 root,且仅 root 可写(owner root:wheel,mode 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 会把激活后的 license 保存到密钥文件旁边,即 /Users/Shared/.licensemac。如果你提前创建了这个文件,请让所有用户都可写(mode 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 会把激活后的 license 保存到密钥文件旁边,即 C:\ProgramData\TablePlus\.licensewindows,并允许该 PC 的所有用户修改。用户需要能在 C:\ProgramData\TablePlus 中创建文件,默认权限已允许。密钥文件存在后,所有用户的 TablePlus 使用相同的 device ID,因此无论有多少用户,该 PC 都只占用一个席位。
你也可以为单个用户安装密钥文件,路径为 %LOCALAPPDATA%\com.tinyapp.TablePlus\.tplicensekey。用户可以删除自己文件夹中的文件,因此在该位置 TablePlus 会忽略 require。
用户看到的内容
使用 require: true 时:
在密钥激活之前,TablePlus 会在打开任何窗口或连接前显示 "Activating license key"。如果激活失败,会说明原因,并提供选项:席位用完或更新期结束时提供 Try Again 和 Email License Owner,版本对 license 来说过新时提供 Download the Old Build,构建被撤回时提供 Download TablePlus,以及 Quit。它也会自动重试:无法连接 license 服务器时每分钟重试,其他情况每 15 分钟重试。
用户无法激活其他密钥。License 窗口(Mac 上为 TablePlus > Register license...,Windows 上为 Preferences > License)要求输入密钥时,会显示你的密钥(已遮蔽),且只激活这一个。
TablePlus 不会在会话中途停止工作。如果 TablePlus 打开期间 Mac 或 PC 失去了 license,TablePlus 会尝试重新激活你的密钥,失败时显示通知,并在下次启动时被阻止。
首次启动需要能访问 tableplus.com。
使用 require: false 时,如果你的密钥无法激活,用户可以保留自己的 license 或重新激活,TablePlus 会在下次启动时重试你的密钥。
限制功能和更新
在 License Manager 中,license key 的 TablePlus policy 部分适用于所有用该密钥激活的 Mac 和 Windows PC:
Disable MCP Server、Disable AI Chat 和 Disable crash reports 会关闭对应功能,用户会看到 "Disabled by the license owner"。
Disable query history 会阻止 TablePlus 记录查询历史。History 标签页显示 "Disabled by the license owner",MCP 客户端也无法读取历史。之前记录的历史仍保留在 Mac 上。
Updates - macOS 让 Mac 保持在你选择的版本,Updates - Windows 控制 Windows PC。它们会自动更新到 license 允许的最新版本。
TablePlus 会在启动时以及每 6 小时获取一次策略变更。失去 license 的 Mac 或 PC 在密钥文件仍安装的情况下,会保留最后一次的策略。如果你看不到 policy 部分,请联系我们为你的 license key 开启。
License Manager: https://tableplus.com/license-manager/access-link
如果你的 MDM 工具自行安装 TablePlus 更新,请只安装 license 覆盖的版本,或你在 Updates - macOS 或 Updates - Windows 中选择的版本。license 更新期结束后发布的版本无法激活,且在 require: true 下,TablePlus 会被阻止使用,直到安装回旧版构建。
更改或移除密钥
更改密钥:替换文件即可。下次启动时或 6 小时内,TablePlus 会激活新密钥。新密钥激活前,旧 license 仍然有效。
在 License Manager 中轮换密钥:同时用新密钥更新密钥文件。已激活的 Mac 和 PC 不受影响,但需要激活的设备无法使用旧密钥,在 require: true 下会被阻止使用。
释放 Mac 或 PC:删除密钥文件或将其清空。下次启动或检查时,TablePlus 会注销该设备,释放席位并解除限制。
故障排查
本地管理员仍可以删除密钥文件。要让所有 Mac 和 PC 都保持在使用支持密钥文件的版本上,请用你的 MDM 工具管理 TablePlus 的更新。
| 在 Mac 或 PC 上 | TablePlus 启动时的行为 |
|---|---|
| 没有 license | 直接激活你的密钥。 |
| 用户自己输入的 license | 告知用户此 Mac(或 PC)上的 TablePlus 由你的组织管理,然后用你的密钥替换他们的 license。他们的席位会被释放给其他设备。 |
| 已用你的密钥激活 | 什么都不做。License 窗口中会隐藏 Unlink This Mac(Windows 上为 Unlink This Device)。 |
| 提示信息 | 处理方法 |
|---|---|
| All seats on this license are in use. | 在 License Manager 中移除不再使用的设备,或增加席位。 |
| This license key isn't valid. | 检查文件中的密钥,尤其是在轮换密钥之后。 |
| This version of TablePlus was released after the license's updates ended. | 安装旧版构建,或续订 license。 |
| 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 文件。 |