进阶 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。 用户看到的内容
在 Mac 或 PC 上TablePlus 启动时的行为
没有 license直接激活你的密钥。
用户自己输入的 license告知用户此 Mac(或 PC)上的 TablePlus 由你的组织管理,然后用你的密钥替换他们的 license。他们的席位会被释放给其他设备。
已用你的密钥激活什么都不做。License 窗口中会隐藏 Unlink This Mac(Windows 上为 Unlink This Device)。
使用 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 会注销该设备,释放席位并解除限制。 故障排查
提示信息处理方法
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 文件。
本地管理员仍可以删除密钥文件。要让所有 Mac 和 PC 都保持在使用支持密钥文件的版本上,请用你的 MDM 工具管理 TablePlus 的更新。

评论 (0)