1. 为什么我要写这份麒麟系统实战手册第一次接触银河麒麟桌面操作系统V10 SP1是在一个国产化替代项目上甲方要求所有办公终端在两周内完成系统切换。当时团队里大部分人连“开始菜单”在哪都要找半天更别提排查驱动、配置外设、处理兼容性问题了。那段时间踩过的坑比过去三年加起来都多。后来项目交付了我把这些经验整理成了一份内部手册也就是你现在看到的这篇东西。Kylin-Desktop-V10-SP1也就是银河麒麟桌面操作系统V10 SP1版本是目前国产桌面操作系统里装机量比较大、生态相对成熟的一个版本。它基于Linux内核搭载了自研的UKUI桌面环境预装了WPS Office、永中Office、Firefox等常用软件支持x86、ARM、LoongArch等多种CPU架构。说白了它就是一个面向政企办公场景的国产Linux发行版。这篇文章适合谁看如果你是刚接触麒麟系统的运维人员、技术支持工程师、或者正在做国产化适配的开发者那这篇内容基本覆盖了你前三个月会遇到的绝大多数问题。如果你只是普通办公用户想了解这个系统怎么用得更顺手里面关于外设、字体、软件安装的部分同样对你有用。我打算围绕六个最常被问到的场景来展开系统安装与初始化、桌面环境与核心组件、软件生态与安装方式、外设与驱动适配、系统维护与故障排查、以及安全加固与权限管理。每个场景我都会给出具体的操作步骤、参数说明和我自己踩过的坑。不废话直接上干货。2. 系统安装与初始化从下载到第一次开机2.1 镜像获取与启动盘制作的关键细节麒麟系统的镜像获取渠道主要有两个一是通过官方渠道申请试用版或正式版镜像二是通过已授权的设备厂商获取预装镜像。这里要注意网上流传的很多“精简版”“优化版”镜像来源不明可能被植入后门或删减了核心组件生产环境绝对不要用。下载完ISO文件后第一步是校验完整性。官方通常会提供MD5或SHA256校验值在Linux下用sha256sum命令比对在Windows下可以用CertUtil工具。这一步很多人会跳过但我遇到过不止一次因为下载中断导致镜像损坏、安装到一半报错的情况。# 在Linux终端校验镜像完整性 sha256sum Kylin-Desktop-V10-SP1-Release-20230714-x86_64.iso # 在Windows PowerShell中校验 CertUtil -hashfile Kylin-Desktop-V10-SP1-Release-20230714-x86_64.iso SHA256启动盘制作推荐用RufusWindows或dd命令Linux。Rufus在写入时选择“DD模式”而不是“ISO模式”兼容性更好。用dd命令的话先确认U盘设备名千万别写错否则可能把硬盘数据覆盖掉。# 确认U盘设备名通常是/dev/sdb或/dev/sdc lsblk # 写入镜像of参数一定要确认是U盘设备 sudo dd ifKylin-Desktop-V10-SP1.iso of/dev/sdb bs4M statusprogress sync注意dd命令没有确认提示of参数写错就是灾难。执行前务必用lsblk确认设备名拔掉其他不必要的USB存储设备。2.2 安装过程中的分区策略与引导配置麒麟系统的安装器提供了图形化分区界面对新手比较友好。但如果你要装双系统或者做自定义分区有几个点需要特别注意。首先是分区方案。对于办公场景我通常建议这样分/boot给2GB存放内核和引导文件/给50-100GB根分区放系统和软件/home给剩余空间用户数据swap给内存的1-2倍休眠和内存不足时用。如果是UEFI引导还需要一个/boot/efi分区给512MB格式选FAT32。其次是引导器安装位置。双系统环境下GRUB引导器默认会覆盖Windows的引导记录。如果你希望保留Windows引导需要在安装时选择“自定义”引导器安装位置或者安装后用os-prober和update-grub重新生成引导菜单。# 安装后更新GRUB引导菜单识别其他系统 sudo os-prober sudo update-grub安装完成后第一次重启可能会遇到黑屏或卡在登录界面的情况。这通常和显卡驱动有关。如果是NVIDIA显卡可以在GRUB启动参数里加nomodeset临时进入系统然后安装官方驱动。如果是AMD或Intel核显一般不会有这个问题。2.3 首次开机后的必做配置清单系统装好了别急着装软件。先做这几件事能帮你省掉后面很多麻烦。第一更新系统源和已安装的软件包。麒麟系统的软件源配置文件在/etc/apt/sources.list默认指向官方源。如果在内网环境可能需要替换为本地镜像源。# 更新软件包列表 sudo apt update # 升级已安装的软件包 sudo apt upgrade -y # 清理不再需要的依赖 sudo apt autoremove -y第二配置网络和代理。如果是办公环境可能需要配置静态IP或加入域。麒麟系统的网络管理用的是NetworkManager图形界面在“控制面板-网络”里命令行可以用nmcli。# 查看网络连接 nmcli connection show # 配置静态IP nmcli connection modify 有线连接 1 ipv4.addresses 192.168.1.100/24 ipv4.gateway 192.168.1.1 ipv4.dns 223.5.5.5 ipv4.method manual nmcli connection up 有线连接 1第三创建普通用户并配置sudo权限。麒麟系统默认的root账户是锁定的日常操作应该用普通用户加sudo。如果安装时没有创建普通用户可以用useradd命令补上。# 创建新用户并设置密码 sudo useradd -m -s /bin/bash zhangsan sudo passwd zhangsan # 将用户加入sudo组 sudo usermod -aG sudo zhangsan第四检查系统时间和时区。时间不对会导致软件源证书验证失败、日志时间错乱等问题。# 查看当前时间和时区 timedatectl # 设置时区为上海 sudo timedatectl set-timezone Asia/Shanghai # 启用NTP同步 sudo timedatectl set-ntp true3. 桌面环境与核心组件拆解3.1 UKUI桌面环境的架构与进程模型麒麟系统默认的桌面环境叫UKUI是基于Qt和GTK混合开发的。它的核心进程包括ukui-panel任务栏、ukui-menu开始菜单、peony文件管理器、ukui-settings-daemon设置守护进程等。这些进程之间通过D-Bus通信任何一个崩溃都可能影响桌面整体稳定性。我遇到过几次桌面卡死的情况排查下来多半是ukui-panel或peony占用内存过高导致的。这时候不用重启系统直接杀掉对应进程桌面会自动重新拉起。# 查看桌面相关进程的资源占用 ps aux | grep -E ukui|peony | grep -v grep # 重启任务栏 killall ukui-panel # 重启文件管理器 killall peonyUKUI的配置文件主要存放在~/.config和~/.local/share目录下。如果桌面出现异常可以尝试重命名配置目录来恢复默认设置但这样会丢失个性化配置操作前记得备份。# 备份UKUI配置 mv ~/.config/ukui ~/.config/ukui.bak mv ~/.config/peony ~/.config/peony.bak # 重启桌面会话 ukui-session-quit --logout3.2 核心系统服务与开机启动项管理麒麟系统基于systemd管理服务和大多数现代Linux发行版一样。但有几个麒麟特有的服务需要了解。kylin-system-updater是系统更新服务负责检查和应用系统补丁。kylin-software-center是软件中心的后台服务。kylin-activation是激活服务用于验证系统授权状态。这些服务如果异常会导致更新失败、软件中心打不开、系统提示未激活等问题。# 查看麒麟相关服务状态 systemctl status kylin-system-updater systemctl status kylin-software-center systemctl status kylin-activation # 重启某个服务 sudo systemctl restart kylin-software-center开机启动项的管理可以用systemctl管理服务用“控制面板-开机启动”管理用户级自启动程序。我建议把不必要的自启动项关掉尤其是那些后台常驻的聊天软件、云盘客户端能明显提升开机速度。# 列出所有已启用的系统服务 systemctl list-unit-files --typeservice --stateenabled # 禁用某个服务 sudo systemctl disable bluetooth.service # 查看用户级自启动项 ls ~/.config/autostart/3.3 文件管理器与搜索功能的深度使用Peony是麒麟的文件管理器功能上类似Windows资源管理器但有一些Linux特有的设计。比如它支持多标签页、分栏视图、以及基于tracker的文件内容搜索。文件搜索慢是很多人反馈的问题。默认情况下Peony只搜索文件名不搜索文件内容。如果要启用全文搜索需要安装并配置tracker。# 安装tracker sudo apt install tracker tracker-miners # 启动tracker索引 tracker daemon start # 查看索引状态 tracker status但要注意tracker索引会占用一定的CPU和磁盘IO在老机器上可能影响性能。如果不需要全文搜索可以关掉它。# 禁用tracker索引 tracker daemon stop systemctl --user mask tracker-store.service tracker-miner-fs.service另外Peony支持自定义右键菜单和脚本扩展。你可以把常用操作写成脚本放到~/.local/share/peony/scripts/目录下就能在右键菜单里直接调用。# 创建一个批量重命名的右键脚本 mkdir -p ~/.local/share/peony/scripts/ cat ~/.local/share/peony/scripts/batch-rename.sh EOF #!/bin/bash # 批量将文件名中的空格替换为下划线 for file in $; do newname$(echo $file | tr _) mv $file $newname done EOF chmod x ~/.local/share/peony/scripts/batch-rename.sh4. 软件生态与安装方式全解析4.1 软件源配置与apt命令实战麒麟系统的软件包管理基于Debian的apt体系但软件源里包含的是麒麟官方和第三方适配的软件。默认源里软件数量有限很多常用软件需要手动添加源或下载deb包安装。软件源配置文件在/etc/apt/sources.list和/etc/apt/sources.list.d/目录下。修改前先备份。# 备份当前源配置 sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak # 查看当前源 cat /etc/apt/sources.list如果在内网环境通常会有本地镜像源。把源地址替换为内网镜像地址后执行sudo apt update更新缓存。如果遇到GPG密钥错误需要导入对应的公钥。# 导入GPG密钥 sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys KEY_ID # 或者将密钥文件直接导入 sudo apt-key add public.keyapt常用命令我整理了一个速查表操作命令更新软件包列表sudo apt update升级已安装软件sudo apt upgrade安装软件sudo apt install 包名卸载软件sudo apt remove 包名卸载并删除配置sudo apt purge 包名搜索软件apt search 关键词查看软件信息apt show 包名清理缓存sudo apt clean修复依赖sudo apt install -f提示麒麟系统的apt源里软件包名称可能和Ubuntu/Debian略有不同。比如火狐浏览器在麒麟源里叫firefox但有些版本叫firefox-esr。找不到包时先用apt search搜一下。4.2 deb包、AppImage与容器化安装方案除了apt源麒麟系统还支持多种软件安装方式。deb包是最常见的。下载后可以用dpkg命令安装但dpkg不会自动处理依赖所以更推荐用apt install ./package.deb的方式让apt自动解决依赖。# 用dpkg安装deb包 sudo dpkg -i package.deb # 如果报依赖错误修复依赖 sudo apt install -f # 更推荐的方式用apt安装本地deb包 sudo apt install ./package.debAppImage是一种免安装的软件格式下载后赋予执行权限就能直接运行。适合那些没有deb包、又不想折腾依赖的软件。# 下载AppImage文件 wget https://example.com/software.AppImage # 赋予执行权限 chmod x software.AppImage # 直接运行 ./software.AppImage但AppImage在麒麟系统上可能会遇到FUSE相关的问题。如果运行时报fuse: device not found需要安装libfuse2。sudo apt install libfuse2对于开发环境Docker容器化方案在麒麟系统上也能用。但要注意麒麟系统的内核版本可能和Docker官方要求的有差异建议用麒麟源里的docker版本或者用Podman作为替代。# 安装docker sudo apt install docker.io # 启动docker服务 sudo systemctl enable --now docker # 将当前用户加入docker组避免每次都要sudo sudo usermod -aG docker $USER4.3 国产软件适配现状与替代方案麒麟系统的软件生态是国产化替代项目里最让人头疼的部分。很多Windows下的专业软件没有Linux版本只能找替代品或者用Wine兼容层。办公软件方面WPS Office有原生Linux版永中Office也有麒麟适配版。日常文档处理基本够用。但如果你重度依赖Microsoft Office的宏和高级功能可能会遇到兼容性问题。浏览器方面Firefox有原生版本Chromium也可以用。但有些网银、政务系统只支持IE内核这时候可能需要用ukylin-wine或者crossOver来运行Windows版浏览器。# 安装Wine兼容层 sudo apt install wine # 配置Wine环境 winecfg开发工具方面VS Code有Linux版JetBrains全家桶也有Linux版。但要注意麒麟系统的glibc版本可能比较旧某些新版本IDE可能跑不起来。建议下载对应架构的旧版本或者用Snap/Flatpak安装。# 安装Flatpak sudo apt install flatpak # 添加Flathub源 flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo # 安装软件 flatpak install flathub com.visualstudio.code5. 外设与驱动适配实战5.1 打印机、扫描仪与高拍仪的驱动安装外设适配是麒麟系统落地时最大的痛点之一。尤其是打印机很多型号在Linux下没有官方驱动。麒麟系统内置了CUPS打印系统支持大部分HP、Canon、Epson的打印机。如果系统自带的驱动库里有对应型号插上USB后会自动识别。如果没有可以尝试用通用驱动或者从厂商官网下载Linux驱动。# 查看已识别的打印机 lpstat -p -d # 添加打印机 sudo systemsetup -a # 或者用CUPS网页界面管理 # 浏览器访问 http://localhost:631对于高拍仪、手写板这类设备通常需要厂商提供Linux驱动。如果厂商只提供Windows驱动可以尝试用libusb和sane项目做适配但工作量比较大。我建议在采购阶段就确认设备是否有Linux驱动支持避免后期被动。注意麒麟系统的CUPS版本可能比较旧某些新打印机的PPD文件可能不兼容。如果安装驱动后打印乱码可以尝试用foomatic通用驱动替代。5.2 显卡驱动与多屏显示的配置要点显卡驱动直接影响桌面流畅度和多屏显示功能。麒麟系统默认使用开源驱动Intel/AMD用mesaNVIDIA用nouveau日常办公够用但如果你需要3D加速或视频硬解就需要装官方驱动。NVIDIA官方驱动的安装稍微麻烦一点。先从NVIDIA官网下载对应型号的.run文件然后关闭图形界面在命令行下安装。# 切换到命令行模式 sudo systemctl isolate multi-user.target # 给驱动文件加执行权限 chmod x NVIDIA-Linux-x86_64-*.run # 安装驱动 sudo ./NVIDIA-Linux-x86_64-*.run # 安装完成后重启图形界面 sudo systemctl isolate graphical.target多屏显示配置可以用xrandr命令。先查看当前显示输出然后设置分辨率和位置。# 查看显示输出 xrandr # 设置双屏扩展模式 xrandr --output HDMI-1 --auto --right-of eDP-1 # 设置主屏 xrandr --output eDP-1 --primary如果用的是Wayland会话xrandr可能不生效需要用wlr-randr或者桌面环境自带的显示设置。5.3 大容量U盘与移动硬盘的识别问题“大容量U盘在麒麟系统里打不开”是热搜里经常出现的问题。这通常和文件系统格式有关。麒麟系统默认支持ext4、NTFS、FAT32、exFAT等格式但有些U盘出厂时格式化为exFAT而系统没有预装exFAT驱动。# 安装exFAT支持 sudo apt install exfat-fuse exfat-utils # 安装NTFS支持通常已预装 sudo apt install ntfs-3g如果U盘插上后没有自动挂载可以用lsblk查看设备是否被识别然后手动挂载。# 查看块设备 lsblk # 手动挂载U盘 sudo mkdir -p /mnt/usb sudo mount /dev/sdb1 /mnt/usb # 卸载 sudo umount /mnt/usb还有一种情况是U盘分区表是GPT格式而麒麟系统的某些版本对GPT支持不完善。这时候可以用gdisk或parted转换分区表为MBR但会丢失数据操作前记得备份。# 查看分区表类型 sudo parted /dev/sdb print # 转换分区表危险操作会清空数据 sudo parted /dev/sdb mklabel msdos6. 系统维护与故障排查实录6.1 开机黑屏与登录失败的排查路径“麒麟系统开机后黑屏”是高频问题。黑屏的原因有很多种排查思路是从硬件到软件、从引导到桌面逐层定位。第一步看是不是显卡驱动问题。在GRUB菜单里按e编辑启动参数在linux行末尾加nomodeset然后按F10启动。如果能进系统说明是显卡驱动问题需要安装正确的驱动。第二步看是不是磁盘满了。根分区满了会导致系统无法正常启动。用Live USB启动挂载根分区清理日志和缓存。# 查看磁盘使用情况 df -h # 清理apt缓存 sudo apt clean # 清理日志 sudo journalctl --vacuum-size100M第三步看是不是Xorg配置问题。如果/etc/X11/xorg.conf配置错误会导致Xorg启动失败。可以尝试重命名这个文件让系统使用默认配置。# 备份并移除xorg配置 sudo mv /etc/X11/xorg.conf /etc/X11/xorg.conf.bak # 重启显示管理器 sudo systemctl restart lightdm第四步看是不是用户配置文件损坏。如果某个用户的桌面配置损坏会导致该用户登录后黑屏。可以尝试用另一个用户登录或者删除损坏的配置文件。# 重命名用户配置目录 mv ~/.config ~/.config.bak mv ~/.local ~/.local.bak # 重启会话 ukui-session-quit --logout6.2 系统修复助手与root密码重置方法麒麟系统自带了一个“系统修复助手”工具可以在系统无法正常启动时进行修复。它通常集成在Live USB里或者通过GRUB菜单的恢复模式进入。如果忘记了root密码可以通过GRUB进入单用户模式重置。步骤如下开机时按Shift或Esc进入GRUB菜单。选择要启动的内核按e编辑。找到linux行在末尾加init/bin/bash或rw single init/bin/bash。按F10启动进入bash shell。用passwd命令重置root密码。重启系统。# 在单用户模式下重置root密码 passwd root # 如果文件系统是只读的先重新挂载为读写 mount -o remount,rw / # 重置完成后重启 exec /sbin/init注意单用户模式下的操作权限最高误操作可能导致系统无法启动。重置密码后建议立即重启不要做其他修改。6.3 常见故障速查表与日志分析技巧麒麟系统的日志主要集中在/var/log/目录下。syslog和messages记录系统级日志Xorg.0.log记录图形界面日志auth.log记录认证日志dpkg.log记录软件包操作日志。# 查看系统日志 sudo tail -f /var/log/syslog # 查看Xorg日志 cat /var/log/Xorg.0.log | grep -i error # 查看认证日志 sudo tail -f /var/log/auth.log # 用journalctl查看systemd日志 sudo journalctl -xe sudo journalctl -u kylin-software-center --since 1 hour ago我整理了一个常见故障速查表故障现象可能原因排查命令解决方案开机黑屏显卡驱动问题dmesg | grep -i nvidia加nomodeset启动安装官方驱动无法登录根分区满df -h清理日志和缓存桌面卡死UKUI进程异常ps aux | grep ukui杀掉异常进程重启桌面软件中心打不开服务未启动systemctl status kylin-software-center重启服务网络不通NetworkManager配置错误nmcli connection show重新配置网络打印机不工作驱动缺失lpstat -p安装对应PPD驱动U盘不识别文件系统不支持lsblk安装exFAT/NTFS驱动系统更新失败源配置错误apt update检查sources.list7. 安全加固与权限管理7.1 用户权限体系与sudo配置最佳实践麒麟系统的权限体系和标准Linux一致root是超级用户普通用户通过sudo提权。但麒麟系统默认锁定了root账户的直接登录这是出于安全考虑。sudo的配置文件在/etc/sudoers但不要直接编辑这个文件应该用visudo命令它会做语法检查避免配置错误导致无法提权。# 用visudo编辑sudo配置 sudo visudo # 添加一行让zhangsan用户无需密码执行所有命令 zhangsan ALL(ALL) NOPASSWD: ALL # 更安全的做法只允许特定命令免密 zhangsan ALL(ALL) NOPASSWD: /usr/bin/apt update, /usr/bin/apt upgrade我建议遵循最小权限原则普通用户只给必要的sudo权限不要图省事给NOPASSWD: ALL。尤其是多人共用的机器权限管理不当会导致误操作或安全漏洞。# 查看当前用户的sudo权限 sudo -l # 查看用户所属组 groups zhangsan # 将用户从sudo组移除 sudo deluser zhangsan sudo7.2 防火墙配置与端口管理麒麟系统默认安装了ufwUncomplicated Firewall作为防火墙管理工具。默认情况下ufw可能是关闭的。在生产环境建议开启并配置规则。# 查看防火墙状态 sudo ufw status # 启用防火墙 sudo ufw enable # 允许SSH sudo ufw allow 22/tcp # 允许特定IP访问特定端口 sudo ufw allow from 192.168.1.0/24 to any port 80 # 拒绝某个端口 sudo ufw deny 137,139/tcp # 查看规则编号 sudo ufw status numbered # 删除规则 sudo ufw delete 规则编号热搜里提到的“麒麟系统关闭137139端口”其实就是关闭SMB服务的NetBIOS相关端口。这两个端口如果暴露在公网容易被利用进行信息收集。关闭方法除了用ufw还可以直接停用SMB服务。# 停止并禁用SMB服务 sudo systemctl stop smbd sudo systemctl disable smbd # 或者只关闭NetBIOS端口 sudo ufw deny 137/udp sudo ufw deny 139/tcp7.3 系统更新策略与补丁管理麒麟系统的更新分为安全更新、功能更新和内核更新。安全更新建议及时安装功能更新可以根据业务需求选择性安装内核更新要谨慎因为可能影响驱动兼容性。# 查看可用的更新 sudo apt list --upgradable # 只安装安全更新 sudo apt install unattended-upgrades sudo dpkg-reconfigure unattended-upgrades # 查看更新历史 cat /var/log/apt/history.log对于生产环境我建议先在测试机上验证更新确认没问题后再批量推送。麒麟系统自带的kylin-system-updater支持批量更新管理可以在控制面板里配置更新策略。# 查看系统更新服务状态 systemctl status kylin-system-updater # 手动触发更新检查 sudo kylin-system-updater --check # 查看更新日志 cat /var/log/kylin-system-updater.log提示内核更新后如果出现驱动不兼容可以在GRUB菜单里选择旧内核启动然后卸载新内核或重新安装驱动。8. 我在这六个场景里踩过的坑和总结的技巧写到这里六个核心场景基本覆盖完了。最后分享几个我在实际项目中踩过的坑以及一些能帮你省时间的技巧。第一个坑是字体问题。麒麟系统默认字体是“方正字体”但很多文档用的是“宋体”“黑体”“Times New Roman”。如果系统里没有这些字体打开文档会显示为方块或乱码。解决办法是安装Windows字体包或者从其他系统拷贝字体文件到/usr/share/fonts/目录下。# 创建字体目录 sudo mkdir -p /usr/share/fonts/windows # 拷贝字体文件 sudo cp *.ttf /usr/share/fonts/windows/ # 更新字体缓存 sudo fc-cache -fv # 查看已安装字体 fc-list | grep -i simsun第二个坑是永中Office新建文档没有模板。这是因为模板目录权限不对或者模板文件丢失。解决办法是重新安装永中Office或者手动创建模板目录。# 查看永中Office模板目录 ls ~/.local/share/永中Office/template/ # 如果目录不存在手动创建 mkdir -p ~/.local/share/永中Office/template/第三个坑是屏幕截图无法捕获。麒麟系统自带的截图工具在某些显卡驱动下会失效。替代方案是用gnome-screenshot或scrot。# 安装scrot sudo apt install scrot # 截取全屏 scrot screenshot.png # 截取选定区域 scrot -s area.png # 延时截图 scrot -d 5 delayed.png第四个坑是VSCode在麒麟系统上跑不起来。这通常是因为glibc版本太旧。解决办法是下载旧版本的VSCode或者用Flatpak安装。# 查看glibc版本 ldd --version # 用Flatpak安装VSCode flatpak install flathub com.visualstudio.code最后一个技巧是关于系统备份的。麒麟系统没有内置的备份工具我建议用rsync做定期备份或者用timeshift做系统快照。# 用rsync备份home目录 rsync -avz --delete ~/ /backup/home/ # 安装timeshift sudo apt install timeshift # 创建系统快照 sudo timeshift --create --comments before update这些经验都是我在实际项目中一点点积累的希望能帮你少走弯路。麒麟系统的生态还在不断完善遇到问题多查官方文档和社区论坛大部分问题都有解决方案。