必须先执行三道命令验证硬性前提：uname -m输出aarch64或x86_64、cat /etc/kylin-release确认V10/V11、sudo -v验证root权限；缺一则后续操作中断。
在无外网环境的物理隔离网络中，银河麒麟系统必须靠本地资源构建可编译、可打包、可容器化、可远程调试的完整软件开发与部署链路，不能依赖任何在线源或云端服务。
确认系统基础与离线资源就位
先执行三道命令验证硬性前提：【uname -m 输出必须为 aarch64 或 x86_64】；cat /etc/kylin-release 确认是 V10 或 V11；sudo -v 验证当前用户具备 root 权限。缺一不可，否则后续所有操作将中断在第一步。
把已下载的 ISO 镜像（如 Kylin-Desktop-V10-SP3-2503.iso 或 Kylin-Server-V10-SP3-2403.iso）拷贝到目标机 /opt/iso/ 目录下，文件名不得含中文空格或特殊符号，否则挂载时会报 invalid argument。
搭建本地 APT/YUM 源——开发环境的基石
先判断你的系统类型：运行 which apt && echo desktop || (which yum && echo server)。桌面版走 APT，服务器版走 YUM，混用会导致包冲突和元数据损坏。
方法一：桌面版（APT）本地源搭建
创建挂载点并挂载 ISO：sudo mkdir -p /mnt/kylin-iso && sudo mount -o loop,ro /opt/iso/Kylin-Desktop-V10-SP3-2503.iso /mnt/kylin-iso。
编辑源列表：echo "deb [trusted=yes] file:///mnt/kylin-iso/ v103 main restricted universe multiverse" | sudo tee /etc/apt/sources.list。
执行 sudo apt update，若输出中出现 Get:1 file:///mnt/kylin-iso ... 且无 Err 行，说明源已生效。
方法二：服务器版（YUM）本地源搭建
挂载 ISO 后，在 /etc/yum.repos.d/kylin-local.repo 中写入：[kylin-local]name=Kylin Local Basebaseurl=file:///mnt/kylin-iso/BaseOSenabled=1gpgcheck=0。
【必须删除 /etc/yum.repos.d/ 下所有以 .repo 结尾的其他文件，否则优先级混乱会导致安装失败】
离线安装 Qt 5.12.8 开发套件（ARM64 专用）
第一步：解压离线包
进入存放 银河麒麟V10-arm64-qt5.12.8离线安装包.tar.gz 的目录，执行：tar -xzvf 银河麒麟V10-arm64-qt5.12.8离线安装包.tar.gz → cd 银河麒麟V10-arm64-qt5.12.8离线安装包。
第二步：执行安装脚本sudo ./install-qt5128.sh。该脚本会自动安装全部 87 个 .deb 包，不依赖 apt install，也不修改系统默认源配置。
第三步：验证安装结果
运行 qmake -v，输出应包含 Using Qt version 5.12.8；再运行 which qmake，路径应为 /opt/Qt5.12.8/5.12.8/gcc_64/bin/qmake。若提示 command not found，请手动执行 export PATH="/opt/Qt5.12.8/5.12.8/gcc_64/bin:$PATH" 并写入 ~/.bashrc。
静态部署 Docker 20.10（ARM64 兼容版）
① 下载并解压官方 ARM64 静态包：wget https://download.docker.com/linux/static/stable/aarch64/docker-20.10.18.tgz → tar -xzf docker-20.10.18.tgz → sudo cp docker/* /usr/bin/。
② 加载内核模块：sudo modprobe overlay br_netfilter；写入持久化配置：echo -e "overlay\nbr_netfilter" | sudo tee /etc/modules-load.d/docker.conf。
③ 创建 systemd 服务文件：sudo tee /etc/systemd/system/docker.service，内容为标准 Docker 官方 unit 文件（含 ExecStart=/usr/bin/dockerd --data-root=/var/lib/docker）。
④ 启动服务：sudo systemctl daemon-reload → sudo systemctl start docker → sudo docker run --rm hello-world。成功则输出 “Hello from Docker!”。
配置离线 VNC 远程桌面（用于 GUI 调试）
从挂载的 ISO 中提取 TigerVNC：sudo apt install -y /mnt/kylin-iso/pool/main/t/tigervnc-standalone-server/*.deb（桌面版）或 sudo yum localinstall -y /mnt/kylin-iso/BaseOS/Packages/tigervnc-server-*.rpm（服务器版）。
生成初始配置：vncserver :1，按提示设置密码；然后 kill 掉临时进程：vncserver -kill :1。
编辑 ~/.vnc/xstartup，末尾添加一行：exec gnome-session &（桌面版）或 exec startxfce4 &（轻量需求）。保存后 chmod +x ~/.vnc/xstartup。
启动服务：vncserver :1 -geometry 1920x1080 -depth 24。此时可在另一台内网机器用 VNC Viewer 连接 192.10.10.5:5901（替换为实际 IP）。
