安装时提示服务被拦截

问题现象
首次安装飞连客户端或者更新飞连客户端版本时，提示“飞连服务被拦截，客户端无法正常运行，飞连正尝试修复，需要您授权”，类似如下图所示。

问题原因

• 设备本地的安全软件或者防病毒软件阻止了飞连的安装。
• 配置了本地系统的全局代理，导致飞连客户端服务运行异常。

问题解决（针对原因 1）
问题原因 1 的解决方法：退出安全软件和防病毒软件后，重新安装飞连客户端。
问题解决（针对原因 2）
问题原因 2 Windows 客户端的解决方法如下：

1. 按win + r，输入 cmd 打开命令行。
2. 分别执行如下两条命令检查是否设置了代理。

#查询 IP 地址相关信息，若电脑设置了代理，以下请求会通过代理服务器发送给ipinfo.io
C:\Users\bytedance>curl https://ipinfo.io
curl: (28) Failed to connect to proxy.test.com port 8888 after 21154 ms: Couldn't connect to server

# 执行查看是否有代理
netsh winhttp show proxy

以上命令结果显示该电脑配置了代理。
3. 检查网络和 Internet中是否配置了代理。

1. 选择控制面板 > 网络和 Internet > Internet 选项，在 Internet 属性页面，选择连接页签，单击局域网设置。
2. 取消选择为LAN 使用代理服务器。
   
3. 检查环境变量中是否配置了代理。
   按 Win + R 打开运行对话框，执行 rundll32.exe sysdm.cpl,EditEnvironmentVariables 后回车打开环境变量。

5. 删除代理，或者配置浏览器代理，不要配置全局代理。

   说明

   您也可以重新安装新版本飞连客户端，安装时以管理员的身份运行，安装后重启电脑。

客户端安装失败

问题现象
客户端安装失败，查看安装日志，显示如下：

INFO    2024/09/06 10:12:17.144 Export.cpp:122 17272:09244 : DropFile : CorpLink-MDM.exe
INFO    2024/09/06 10:12:17.256 Export.cpp:122 17272:09244 : We are running on a 64-bit system.
INFO    2024/09/06 10:12:17.256 Export.cpp:122 17272:09244 : DropFile : driver\x64\*
INFO    2024/09/06 10:12:17.276 Export.cpp:122 17272:09244 : DropFile : x86\module\*
ERROR   2024/09/06 10:12:19.334 Export.cpp:122 17272:09244 : Failed

问题分析
通过日志可以发现安装失败的原因是x86\module目录被其他文件占用。
问题解决

1. 检查哪个进程占用了x86\module文件。
2. 直接重启电脑后再次尝试安装飞连客户端。

Windows7 系统无法安装飞连，点击安装，弹出飞连安装程序已停止运行，如何解决？

问题原因
飞连仅支持安装了 Service Pack 1(SP1) 补丁的 Windows 7 系统，如果您的电脑上没有安装 SP1 的补丁，则无法安装飞连。
解决方案
将电脑系统升级到 Windows 10 及以上版本或者到微软官网，选择下载 SP1 补丁包，并且将补丁包安装到本地电脑。

Windows 端内覆盖安装飞连客户端失败是什么原因？

• 问题原因：卸载旧客户端时仍有残留导致覆盖安装失败。
• 解决方案：
  • 方案一：手动执行飞连卸载程序（程序示例路径：C:\Program Files\CorpLink\uninstall.exe），再尝试覆盖安装飞连客户端。
  • 方案二：打开任务管理器查看 corplink-service 进程是否还在运行。如果在运行，请结束进程后，再尝试覆盖安装飞连客户端。
  • 方案三：覆盖安装时服务发现有残留的注册表导致安装失败，可使用以下注册表脚本清除残留注册表，再尝试覆盖安装飞连客户端。
    
    

    patch.reg

    未知大小

    

Windows Server 启动飞连提示“服务被拦截”，如何解决？

问题原因
Windows Server 系统默认未安装无线 LAN 服务。飞连客户端依赖该组件进行网络管理，缺失该组件会导致底层依赖检测失败，从而误报为“服务被拦截”。
解决方案

1. 安装功能组件
   打开服务器管理器，进入添加角色和功能向导。在“功能”选择步骤中，勾选无线 LAN 服务 并完成安装（安装后可能需要重启服务器）。
2. 重装客户端
   组件安装成功后，请运行飞连安装程序重新安装客户端以修复服务。

macOS 安装飞连报错“版本不能与此版本的 macOS 配合使用”，如何解决？

问题原因
安装包架构不匹配。飞连 Mac 客户端提供两个版本：Intel 芯片版（x64）和 Apple 芯片版（M1/M2/M3 等 ARM 架构）。若在 Apple 芯片的 Mac 上安装了 Intel 版（或反之），可能会触发此兼容性报错。
解决方案

1. 点击屏幕左上角苹果图标 > 关于本机，查看“处理器”或“芯片”信息。
2. 访问飞连客户端下载页面，选择与芯片架构对应的版本进行下载安装。

macOS 13 (Ventura) 提示“飞连服务被拦截”，如何解决？

问题原因
macOS 13 引入了新的后台任务管理机制。若在系统设置中禁用了飞连的后台允许项，会导致飞连核心服务无法启动，从而触发拦截报错。
排查与解决

1. 确认系统版本
   点击屏幕左上角苹果图标 > 关于本机 (About This Mac)，确认当前系统版本为 macOS 13 (Ventura) 或更高。
2. 启用后台登录项
   • 打开系统设置 (System Settings) > 通用 (General) > 登录项 (Login Items)。
   • 在允许在后台 (Allow in the Background) 列表中，找到飞连相关项目。
   • 确保其开关处于 开启 (ON) 状态。
     
3. 重启客户端
   配置完成后，请重启飞连客户端以恢复服务。

飞连客户端是否支持 Linux 操作系统？有哪些版本和环境要求？

是的，飞连客户端支持在主流的 Linux 发行版上安装和运行，但需满足以下两个核心要求：

1. 支持的发行版与版本
   请确保您的操作系统及版本符合下表中的最低要求：

   Ubuntu	Debian	CentOS	Deepin	Kylin	UOS
   18.04 及以上	10 及以上	8 及以上	20.2.1 及以上	V10 SP1	20

2. 必须具备图形桌面环境

飞连客户端是一款图形界面（GUI）应用，因此不支持在纯命令行模式的服务器系统上安装。请确保系统已安装并运行桌面环境。
安装包说明
飞连官方下载页面会提供 .deb 和 .rpm 两种格式的安装包。请根据您所使用发行版的包管理系统进行选择：

• .deb：适用于 Debian, Ubuntu, Deepin 等使用 apt 命令的系统。
• .rpm：适用于 CentOS, UOS, Kylin 等使用 yum 或 dnf 命令的系统。

如何在 Linux 系统上安装飞连客户端？

在 Linux 系统上安装飞连客户端，您需要根据所使用发行版的包管理系统（DEB 或 RPM）来选择对应的安装包和命令。

前提条件

1. 确认系统兼容性：请确保您的 Linux 发行版及版本符合要求，并且已安装图形桌面环境。
2. 下载正确的安装包：从飞连官方下载页面，根据您的系统类型下载对应的安装包：
   • .deb 包：适用于 Debian、Ubuntu、Deepin 等系统。
   • .rpm 包：适用于 CentOS、UOS、Kylin、Fedora 等系统。
3. 获取管理员权限：所有安装和卸载操作都需要 sudo 权限。

安装/升级/卸载

对于 .deb 包

• 首次安装

  sudo apt install -y ./FeiLian_Linux_xxx.deb
  

• 升级或覆盖安装

  sudo dpkg -i FeiLian_Linux_xxx.deb
  

• 卸载

  sudo apt autoremove -y com.volcengine.feilian
  

对于 .rpm 包

• 首次安装

  sudo rpm -ivh --nodeps --force FeiLian_Linux_xxx.rpm
  

• 升级或覆盖安装

  sudo rpm -ivh --replacepkgs --nodeps --force FeiLian_Linux_xxx.rpm
  

• 卸载

  sudo rpm -e --nodpes com.volcengine.feilian
  

关键文件路径

在排查问题时，您可能会需要访问以下路径：

Linux 运行 dpkg -i 安装客户端提示缺少依赖，如何解决？

问题原因
dpkg 命令仅用于解包和安装本地 .deb 文件，不具备自动解析和下载依赖包的能力。若系统缺失飞连所需的运行库，安装过程将报错中止。
解决方案
推荐使用 apt 命令进行安装，可自动处理本地包的依赖关系。
请在终端执行以下命令：

sudo apt update                                          # 1. 更新软件源索引
sudo apt install /path/FeiLian_Linux_{packagename}.deb   # 2. 安装飞连包并自动补全依赖

注意：请将 /path/FeiLian_Linux_{packagename}.deb 替换为实际的文件路径和文件名

Linux 无法在线安装依赖（apt 源不可用/离线环境），如何解决？

问题原因
目标 Linux 终端未连接互联网或 apt 软件源配置失效，导致 apt install 无法从仓库拉取所需的依赖包。
解决方案
请通过离线方式手动安装依赖。

1. 安装离线依赖包

   • 下载离线依赖包（目前仅支持 Ubuntu 16.04+ / Debian 9-11 等主流版本）。

   • 解压包文件，进入目录并在终端执行安装脚本：

     sudo ./install.sh
     

注：对于非标系统，需自行下载对应架构的 rpm/deb 包进行安装，依赖清单参考“关键依赖清单”部分。

2. 安装飞连客户端
   依赖就绪后，再次执行安装命令：

   sudo dpkg -i /path/FeiLian_Linux_{packagename}.deb
   

关键依赖清单

• Debian 系 (Ubuntu/Deepin)：network-manager, dnsmasq-base, libnss3-tools, auditd
• RedHat 系 (CentOS/Fedora)：NetworkManager, dnsmasq, nss-tools, audit

Fedora 36 安装飞连 rpm 包提示缺少 libcurl.so.4（已安装库仍报错），如何解决？

问题原因
依赖版本或路径映射问题。即便系统中已安装 libcurl，rpm 包管理器可能因版本号不严格匹配或未能正确索引到库文件路径，导致依赖检查失败。
解决方案
在确认系统已安装 libcurl（通常通过 sudo dnf install libcurl）的前提下，安装飞连时跳过 rpm 的强依赖检查。
请执行以下命令安装：

sudo rpm -ivh --nodeps <FeiLian_Package_Name>.rpm

注：--nodeps 参数强制忽略依赖关系直接安装，请确保后续运行飞连时功能正常。

飞连客户端是否支持安装在 Windows Server 操作系统上？

支持，但前提条件是必须手动为服务器启用“无线 LAN 服务”功能。
默认情况下，Windows Server 操作系统为了追求稳定性和最小化攻击面，并不会安装桌面环境中的所有组件。飞连客户端依赖于部分与无线网络相关的系统模块（即使在有线环境中使用），如果未安装此功能，飞连客户端在安装或运行时可能会出错。

步骤一：安装“无线 LAN 服务”

• 方法一：通过服务器管理器
  1. 打开服务器管理器。
  2. 点击管理 > 添加角色和功能。
  3. 在弹出的向导中，一直点击 下一步，直到您到达功能页面。
  4. 在功能列表中，找到并勾选无线 LAN 服务。
  5. 点击下一步，然后点击安装，完成功能的添加。
• 方法二：通过 PowerShell
  1. 以管理员权限打开 Windows PowerShell。
  2. 根据您的服务器版本，执行对应的命令：

     • 对于 Windows Server 2012 R2 及更新版本（如 2016、2019、2022）：

       Install-WindowsFeature Wireless-Networking
       

     • 对于 Windows Server 2008 R2:

       Import-Module ServerManager
       Add-WindowsFeature Wireless-Networking
       

步骤二：重启服务器

安装完“无线 LAN 服务”后，必须重启服务器，以确保新安装的系统功能被完全加载和初始化。

步骤三：安装或重装飞连客户端

服务器重启后，正常安装飞连客户端即可。

重要提示：如果执行步骤一之前已经尝试安装过飞连客户端，必须先将其卸载，然后再重新进行安装。这是为了确保飞连的安装程序能够正确地识别并集成新添加的系统功能。