客户端常见问题--飞连-火山引擎

文档中心

立即注册

导航

客户端常见问题

最近更新时间：2025.11.14 16:29:28首次发布时间：2024.11.05 17:16:22

安装相关

安装时提示服务被拦截

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

问题原因

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

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

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

#查询 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中是否配置了代理。

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

删除代理，或者配置浏览器代理，不要配置全局代理。
说明
您也可以重新安装新版本飞连客户端，安装时以管理员的身份运行，安装后重启电脑。

客户端安装失败

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

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目录被其他文件占用。
问题解决

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

客户端升级时提示要管理员权限

问题现象
通过域控安装方式升级飞连客户端时，升级失败，提示需要管理员权限。

问题原因
通过域控安装飞连时，飞连的安装进程在后台静默安装，此时需要管理员权限。
问题解决
您可以通过软件分发的方式升级员工的客户端，具体请参见分发软件至员工设备。

登录相关

启动飞连时提示 Failed to get 'userData' path

问题现象
启动飞连时出现如下异常对话框，错误信息中提示Error: Failed to get 'userData' path，如下图所示。

问题原因
用户迁移数据或者升级系统后，~/Library/Logs 日志目录权限变成了 root，导致飞连桌面端在访问的时候因权限问题无法启动。
问题解决
将 ~/Library/Logs 的目录权限修改为当前安装飞连客户端的用户。类似如下图所示。

启动飞连时提示 NodeguardError: integrity of .node size

问题现象
启动飞连时出现如下异常对话框，错误信息中提示Error: NodeguardError: integrity of .node size，如下图所示。

问题原因
有其他软件破坏了客户端，导致缺少文件或者文件权限不对，macOS 可以使用codesign -vvv -strict --deep /Application/CorpLink.app判断文件是否被破坏。
问题解决
重新安装飞连客户端，并确认文件的完整性。

客户端启动后白屏

问题现象
打开飞连客户端后，界面显示全部空白。
问题原因

用户设备开启了系统网络代理，导致 127.0.0.1 请求被转发，主进程出现错误，阻断了后续代码的执行，从而引起白屏。
用户设备网络连接异常，导致渲染进程请求发送失败。
如果是 Linux 客户端，可能是使用了 root 权限安装飞连客户端。

问题解决（针对原因 1）
关闭网络代理后重启飞连。

MAC：在网络偏好设置 > 高级 > 代理中检查是否开启了代理，下图是 MAC 电脑未开启任何代理的正常状态，供参考。
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
```
```
以上命令结果显示该电脑配置了代理。
```
1. 检查网络和 Internet中是否配置了代理。
  1. 选择控制面板 > 网络和 Internet > Internet 选项，在 Internet 属性页面，选择连接页签，单击局域网设置。
  2. 取消选择为LAN 使用代理服务器。
2. 检查环境变量中是否配置了代理。
  按 Win + r 打开运行对话框，输入 rundll32.exe sysdm.cpl,EditEnvironmentVariables 后回车打开环境变量。
3. 删除代理，或者配置浏览器代理，不要配置全局代理。

问题解决（针对原因 2）

请通过其他方式连接网络后，重新启动飞连。
如果是 DNS 被劫持，导致网络异常，您也可以在飞连客户端选择实验室，单击 DNS 重置。

问题解决（针对原因 3）
查看飞连安装目录对应的用户和权限信息，重新使用用户账户安装飞连客户端，不要使用 root 用户安装飞连客户端。

客户端加载失败

问题现象
打开飞连客户端，界面一直显示初始化加载中，如下图所示。

问题原因
内网环境，内置的企业信息（企业识别码、域名、证书等信息）不正确，因内网环境无法调用火山引擎通用查询服务，导致无法获取详细的企业信息，无法获取对应的企业域名、证书等信息，无法继续加载。
问题解决
建议加白火山引擎的服务后，重启客户端。

无法访问飞连门户网站

问题现象
无法访问飞连门户网站。

问题原因

飞连客户端连接了错误的 Wi-Fi、有线网络，导致飞连门户域名访问不通。
连接了 VPN，VPN 节点异常，网络不稳定。

问题解决

在访问错误提示页中找到门户域名，然后在浏览器中验证门户域名是否可以访问。
通过其他方式连接网络，例如有线网络或访客 Wi-Fi 等。
在飞连客户端的网络页面，尝试重新连接网络，并检查是否已连接正确的网络。
在飞连客户端的网络页面，单击 VPN 页签，单击当前服务器右侧的下拉列表，切换其他可用 VPN 节点。

客户端登录界面显示异常

问题现象
飞连客户端登录界面没有显示正常的账号密码输入框，出现类似下图所示界面。

问题解决
请重新启动飞连客户端，重新输入企业识别码，触发重新请求，以便获取正确的配置。

账号退出后无法登录，登录日志提示104018

问题现象
飞连客户端退出登录后，无法重新登录，管理后台登录日志显示“104018(飞连登录账号与上次登录账号不一致)”

问题原因
开启了防退出功能。
问题解决
在飞连管理后台关闭防退出功能，具体请参见配置防退出防卸载策略。

开机后飞连自动启动，但是用户没有配置“开机启动飞连”

问题现象
用户在飞连客户端的设置页面，没有选择开机启动飞连，但是电脑开机后却自动启动了飞连客户端。
问题原因
在飞连管理后台开启了开机自启动。若您配置了自动打开客户端前端界面，且不允许员工修改，则员工无法修改开机自启动飞连的配置，在飞连客户端的设置页面不展示相应的配置项。
问题解决

您可以通过 corplink.log 日志搜索 auto_start 字段，如果为 true 表示开启了开机自启动。
您可以通过飞连管理后台查看客户端启动配置，具体请参见配置客户端启动配置。

飞连与终端安全管理软件冲突导致浏览器崩溃

问题现象
在已安装第三方终端安全管理软件（如联软、IP-guard）的 Windows 设备上，启动或运行飞连客户端后，导致浏览器频繁崩溃或闪退。
问题原因
此问题通常由软件兼容性冲突导致。飞连客户端与第三方终端安全软件，在同时对浏览器等应用进行底层监控时，可能会产生冲突，从而引发被监控应用的进程异常。
问题解决
停止或退出设备上的其他安全管理软件的客户端服务，仅保留飞连运行。

其他

如何获取客户端日志？

飞连 Windows 客户端的日志路径如下表所示。

日志类型	日志路径
飞连日志	`%programfiles%\CorpLink\current\logs` 说明若客户端版本为 2.2.14 之前版本，日志路径为：`%localappdata%\corplink-ow\logs`
安装日志	如果是通过 .exe 安装包安装飞连客户端，安装日志的路径为：`%AppData%\CorpLink\corplink-installer.log`。如果是通过 .msi 安装包安装飞连客户端，安装日志的路径为：`%programfiles%\CorpLink\current\logs\installnsis.log`。
飞连前端日志	`%AppData%\CorpLink\logs`

飞连 MAC 客户端的日志路径如下表所示。

日志类型	日志路径
飞连日志	/usr/local/corplink/logs
飞连前端日志	~/Library/Logs/CorpLink/fe

飞连 Linux 客户端的日志路径如下表所示。

日志类型	日志路径
飞连前端日志	$HOME/.config/CorpLink/logs/fe
Service 日志	/opt/Corplink/logs/

飞连是否支持 Linux 客户端？

支持。企业管理员可通过飞连管理后台上线 Linux 客户端的下载链接，具体请参见版本发布。

客户端防卸载和防退出功能如何开启？以及如何获取对应密码？

具体操作，请参见客户端配置。

开启防退出后，切换电脑的登录账号，无法切换飞连账号

该现象为正常现象。开启防退出功能后，用户是无法切换飞连账号，仍保持原用户的飞连账号，如果需要切换飞连账号，请联系管理员获取退出/卸载通用密码。

失效设备和休眠设备是否能被静默升级？

失效设备和休眠设备不能被静默升级。

若用户被授权三种升级方式，用户最终采用哪种升级方式？

若某用户被授权了多个升级策略，则生效的优先级为：静默升级 > 弹窗提示，员工不可关闭 > 弹窗提示，员工可关闭。

飞连软件库下载软件提示证书错误

问题现象
在飞连客户端的软件库中，下载软件提示证书错误。
问题原因
使用了自签证书，证书校验遇到问题。
问题解决
检查证书的配置，或重新生成证书后重试，具体请参见管理企业自签根证书。

客户端的网络页面不展示 VPN 或员工 Wi-Fi 页签

问题现象
在飞连客户端的网络页面，不展示 VPN 或员工 Wi-Fi 页签，类似如下图所示。

问题原因
该用户不具备相应权限或被降级使用网络权限。
问题解决

进入飞连管理后台，选择 Wi-Fi 管理 > 员工入网 > 权限配置，查看用户所属的策略的接入方式是否包含员工 Wi-Fi。
选择 Wi-Fi 管理 > 员工入网 > 入网详情，查看该用户是否被停用 Wi-Fi 入网。
选择 Wi-Fi 管理 > 使用配置 > 网络设备，查看各类型网络设备是否都已开启员工 Wi-Fi。
选择动态控制 > 处置记录，查看用户是否有被降级使用 VPN 或降级使用 Wi-Fi 的记录。

客户端显示联网状态不正确

问题现象
飞连客户端提示未连接任何可用的网络。电脑右下角的网络连接图标显示未连接网络。

问题原因
内网未对相关域名放行。Windows在检查网络连接状态时，会检测特定域名是否连通。若内网对相应域名未放行，就会显示网络未连接，且 VPN 相关功能也无法使用。
问题解决
对如下网络域名和相应的端口（80 和 443 端口）进行放行：

http://www.msftncsi.com/ncsi.txt （适用于 Windows Vista、Windows 7、Windows 8、Windows 8.1）
http://www.msftconnecttest.com/connecttest.txt （适用于 Windows 10、Windows 11）

客户端未展示安全模块

问题现象
飞连客户端左侧导航栏中没有安全的入口。
问题原因

没有配置终端基线或终端防病毒策略等安全相关策略，所以不展示安全模块的入口。
终端基线或终端防病毒策略未成功下发。

问题解决

在飞连管理后台检查已配置终端基线或终端防病毒策略，具体请参见配置终端管理策略和防病毒策略配置。
搜索日志 fe-renderer.log，查看配置是否下发成功，日志的获取方法请参见如何获取客户端日志？。
1. 日志中搜索 getSecurityModuleInfo, 其中 enableProcess、enableSecurity、enableSoftware 至少有一个为 true，代表基线安全模块开启。
2. 日志中搜索 GetModuleStatus,，其中 av_module_enabled 需要为 true，代表防病毒模块开启。
如果日志中提示有异常（不是 true/false，而是 xxxx Error），可能是飞连桌面端服务和前端连接出错，请重启飞连客户端。

客户端提示配置了网络代理

问题现象
在飞连客户端的实验室诊断中提示配置了个人网络代理，但是在网络和 Internet > 代理中显示并未配置代理。

问题原因
请排查以下页面是否配置了代理：

Windows：在电脑右下角右键单击网络图标，选择网络和 Internet > 代理，检查是否开启了使用设置脚本，在脚本中设置了代理地址。
MAC：在网络偏好设置 > 高级 > 代理中检查是否开启了代理，下图是 MAC 电脑未开启任何代理的正常状态，供参考。

macOS 15.0 如何开启网络扩展？

macOS 15.0 及以上版本，请通过如下方法开启网络扩展：
选择设置 > 通用 > 登录项与扩展，在扩展区域，开启网络扩展。