安装失败、服务起不来、客户端崩溃怎么处理？

Linux 上最常见的是依赖装不上，官方有专门文档《向日葵Linux因安装依赖问题无法安装成功的解决办法》，企业版另有一篇《Linux企业主被控重要依赖安装指引》。CentOS 8 或 Ubuntu 17.10 以上无法被远控也有单独方案。要说明的是，客户端日志文件的具体路径官方没有公开，排查到需要日志时建议直接提工单让技术支持指路。

图：安装与服务故障按平台分流

安装失败：先分平台

平台	最常见的安装问题
Linux	依赖缺失、架构或包格式选错
Windows	安全软件拦截、旧版本残留、权限不足
macOS	芯片架构装错、权限没授予（严格说不算装失败，是装了用不了）

Linux：依赖是头号原因

Linux 客户端装不上，八成是依赖问题，而不是系统不支持。官方专门写了文档处理这个：

《向日葵Linux因安装依赖问题无法安装成功的解决办法》——个人版依赖问题主文档
《Linux企业主被控重要依赖安装指引》——企业版的依赖安装指引

装之前先确认两件事，能避开大部分坑：

架构选对

企业版 Linux 要选 x86_64 或 aarch64。选错架构装不上。

包格式选对

官方标注 deb「适用于 Deepin、Ubuntu、Uos、麒麟等」，rpm「适用于 CentOS、Fedora 等」。给 Ubuntu 装 rpm 自然不行。

发行版在官方列表内

官方个人版写明支持 Ubuntu、Deepin、CentOS、信创 UOS、麒麟、中科方德等。不在列表里的发行版没有承诺。

用包管理器装能自动解依赖deb/rpm 包如果直接双击装容易卡在依赖上，改用命令行包管理器（apt、dnf/yum 等）安装，通常能自动拉取缺失的依赖，比手动一个个补快得多。具体命令以官方依赖文档为准。

Linux：装上了但无法被远控

安装成功不等于能被远控。官方有一篇针对性文档：《CentOS8或Ubuntu17.10以上系统无法被远控解决方案》。这两个及更高版本改了显示架构（涉及 Wayland 等），需要按官方方案调整才能被正常抓屏。相关的黑屏排查见远控画面黑屏或白屏怎么办。

Windows：装不上或装完起不来

先看安全软件有没有拦

安装被杀软拦截时会中途失败。确认安装包确实来自官方下载页后，临时放行再装。别为了装软件长期关闭防护。

清干净旧版本再装

之前装过旧版或装坏过，残留会导致新版装不上或服务起不来。用系统「应用和功能」里的卸载程序先彻底卸掉，再从官网重新下载安装。

用管理员身份运行安装程序

权限不足会导致服务注册失败。右键「以管理员身份运行」。

架构对上

下载页有 32 位、64 位、Arm 三种，别装错，见在哪下载？支持哪些平台。

服务启动不了 / 开机不自启

向日葵被控端很依赖后台服务和开机自启。起不来或重启后掉线，查这些：

被桌面管理工具拦了自启：官方无人值守文档明确提到要检查向日葵是否被桌面管理工具拦截了开机启动，路径【设置 → 常规 → 无人值守】里的「开机启动」。公司电脑尤其常见。
自动登录没勾：同一路径下确认「自动登录」勾选，否则服务起来了也没登录，见无人值守设置。
系统睡眠/休眠：机器睡了服务也就停了，调电源计划。

客户端崩溃

升级到最新版

崩溃类问题很多在新版修掉了。官方有《如何远程更新向日葵客户端》。

卸载重装

配置损坏时，彻底卸载再重装是最快的办法。

记录崩溃的触发动作

是一打开就崩，还是点某个功能才崩。这个信息对客服定位很关键。

关于日志文件查证后确认：客户端日志文件的具体存放路径，官方帮助文档里没有公开。所以本文不给一个「日志在 X 目录」的确切说法。需要用到日志排查时，最稳妥的是直接提工单，让技术支持告诉你这个版本的日志位置和收集方式。
官方客服中心是工单形式，把系统版本、客户端版本号、崩溃触发动作写清楚，见官方支持渠道有哪些。