本文提供 macOS 设备在安装飞连客户端失败时的常见排查思路与深度清理方案。当遇到安装卡住、提示权限不足或安装器报错时，可参考以下步骤进行排障。

一、基础排查与信息收集 #

在进行深度排障前，建议先收集以下基础信息，以便快速定位问题：

1. 确认系统版本与芯片架构 #

飞连 macOS 客户端分为 Intel 芯片版和 Apple 芯片版（M1/M2/M3等），安装包选错会导致无法安装。因此在排障前，请首先确认已下载正确的版本。

1. 点击屏幕左上角苹果图标  → 关于本机。
2. 查看“macOS 版本号”以及“芯片/处理器”类型。
   • 若显示为 Apple M1/M2/M3 等：请确保下载并安装 Apple 芯片版。
   • 若显示为 Intel Core 等：请确保下载并安装 Intel 芯片版。
     

2. 核对安装包完整性（MD5 校验） #

安装包在下载过程中可能发生损坏，可以通过以下方式校验完整性：

1. 打开系统终端（Terminal）。
2. 输入 md5 （注意 md5 后面需保留一个空格）。
3. 将下载的飞连安装包（.pkg 文件）拖拽至终端窗口中，按下回车键。
4. 对比终端输出的 MD5 值是否与下载页面提供的 MD5 值一致。如果不一致，请重新下载安装包。

二、常见报错与解决方案 #

1. 提示“安装器权限不足”（macOS 13 及以上常见） #

在 macOS 13 (Ventura) 及更高版本中，系统对安装器的磁盘权限管控更为严格。

• 解决方法 A：进入系统设置 → 隐私与安全性 → 完全磁盘访问权限，在列表中找到并勾选“安装器 (Installer)”，随后重新运行安装包。
• 解决方法 B：将下载好的 .pkg 安装包移动到系统的 /Applications（应用程序）目录或 ~/Desktop（桌面）目录下，双击再次尝试安装。

2. 终端安全软件拦截 #

• 排查方法：请确认目标设备上是否运行了其他企业级终端安全软件（如 EDR、防病毒软件等）。
• 解决方案：暂时退出或在安全软件中将飞连安装包添加至白名单后，重新尝试安装。

3. 尝试使用命令行强制安装 #

如果图形界面安装器持续报错，可以尝试通过终端命令行进行静默安装，这通常能绕过部分界面权限问题并显示具体的报错原因：

1. 打开终端（Terminal）。
2. 执行以下命令（执行后需输入设备的开机密码）：

   sudo installer -pkg /此处替换为安装包的实际路径/文件.pkg -target /
   

三、深度清理与重新安装 #

如果设备此前安装过飞连（CorpLink 或 SealSuite），但卸载不彻底，残留的系统保护文件会导致重新安装失败。请严格按照以下步骤进行深度清理：

步骤 1：移除系统保护标志 #

部分残留文件可能带有系统级不可更改标志（schg），这类标志通常由安全软件或内核添加，必须先使用 noschg 参数解锁才能删除：

# 如果之前安装的是 CorpLink 版本，执行：
sudo chflags -R noschg /Applications/CorpLink*

# 如果之前安装的是 SealSuite 版本，执行：
sudo chflags -R noschg /Applications/SealSuite*

步骤 2：删除客户端应用 #

在启动台（Launchpad）​或应用程序目录中，将飞连应用图标拖移至废纸篓进行基础卸载。

步骤 3：执行官方卸载脚本 #

清理后台残留的服务进程：

sudo chflags noschg /usr/local/corplink/corplink-service
sudo /usr/local/corplink/uninstall.sh

步骤 4：手动清理残留目录 #

打开访达（Finder），使用快捷键 Shift + Command + G 依次前往以下路径。如果发现仍有 CorpLink、SealSuite 或 feilian 相关的文件夹，请将其移至废纸篓。
残留文件有时会带有用户级锁定标志。若遇到带小锁的图标，可右键点击“显示简介”取消勾选“已锁定”后再删除；若需要通过命令行批量解锁，可在终端执行 sudo chflags -R nouchg /目标路径。

步骤 5：重新安装 #

完成上述清理后，清空废纸篓，重启设备。随后再使用最新版的安装包重新进行安装。

仍未解决？ #

如果您尝试了本文提供的所有步骤后，依然无法成功安装飞连客户端，请收集以下两类日志，并联系飞连技术支持团队获取进一步帮助：

• 安装器日志：在安装失败时，不要立即关闭图形界面安装器，点击顶部菜单栏的窗口 → 安装器日志，将其中的报错信息截图或导出。
• 系统安装日志：打开访达（Finder），按下快捷键 Shift + Command + G，输入 /var/log/ 并回车。在打开的文件夹中找到 install.log 文件，将其复制并发送给技术支持。