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

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

问题现象
启动飞连时出现如下异常对话框，错误信息中提示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
  

  以上命令结果显示该电脑配置了代理。
  

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

问题解决（针对原因 2）

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

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

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

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

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

问题原因

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

问题解决

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

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


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

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

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

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

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