关键词：银河麒麟 Kylin V10、海光 CPU、信创服务器、Qwen2.5-14B、Git LFS、大模型下载、国产化适配

一、背景说明

随着国产化替代加速推进，越来越多 AI 应用需要部署在 信创环境（如银河麒麟操作系统 + 海光/鲲鹏/飞腾 CPU）中。近期，我在一台 银河麒麟 Linux Advanced Server V10（Halberd） + 海光 CPU 的服务器上尝试下载 Qwen2.5-14B-Instruct 开源大模型，过程中踩了不少“看似简单实则深坑”的问题，特此记录，供同行参考。

目标：将模型完整克隆至 SSD 根目录 /models/Qwen2.5-14B-Instruct，用于后续推理部署。

---

二、关键挑战与误区

❌ 误区1：直接 git clone 就能拿到完整模型？

现象：
执行 git clone 后，发现 .safetensors 文件只有 1KB，但实际应为 3.6GB+。

原因：
Hugging Face 等平台的大模型文件通常通过 Git LFS（Large File Storage） 管理。普通 git clone 只会下载一个 指针文件（placeholder），而非真实数据。

⚠️ 这是最常见也最容易被忽略的坑！尤其在信创环境下，若未预装 Git LFS，极易误判“下载失败”或“仓库损坏”。

---

❌ 误区2：在任意目录运行 git lfs install 报错就以为失败？

现象：

$ git lfs install
Error: failed to call git rev-parse --git-dir...
fatal: 不是 git 仓库...
Git LFS initialized.

真相：
虽然报错，但只要看到 Git LFS initialized.，就说明 全局配置已成功！
该命令只需在用户目录下运行一次，用于启用 LFS 支持，无需在 Git 仓库内执行。

✅ 正确做法：忽略前面的 warning，继续进入模型目录执行 git lfs pull。

---

❌ 误区3：根目录 /models 权限不足导致写入失败

现象：
克隆到 /models 时提示 Permission denied。

解决：

sudo mkdir -p /models
sudo chown -R $USER:$USER /models  # 赋予当前用户所有权

避免全程使用 sudo git（可能引发 SSH/Git 配置错乱）。

---

三、完整操作流程（Kylin V10 + 海光 CPU）

Step 1：安装 Git 和 Git LFS

# 安装 Git（若未安装）
sudo yum install -y git

# 安装 Git LFS（关键！）
sudo yum install -y git-lfs

# 初始化 LFS（全局生效，可在家目录执行）
git lfs install
# 忽略 "not a git repo" 警告，只要看到 "initialized" 即可

💡 注：部分麒麟系统源可能缺少 git-lfs，可手动添加官方源或从 https://packagecloud.io/git-lfs/git-lfs 下载 RPM 包安装。

---

Step 2：创建模型目录并授权

sudo mkdir -p /models
sudo chown -R yb:yb /models  # 替换为你的用户名

---

Step 3：克隆仓库 + 拉取 LFS 大文件

# 克隆（使用镜像站加速，如 atomgit.com）
git clone https://atomgit.com/hf_mirrors/ai-gitcode/Qwen2.5-14B-Instruct.git /models/Qwen2.5-14B-Instruct

# 进入目录，拉取真实模型文件
cd /models/Qwen2.5-14B-Instruct
git lfs pull

🕒 等待时间取决于网络带宽（14B 模型约 27GB），建议使用 screen 或 tmux 防止 SSH 断连。

---

Step 4：验证模型完整性

ls -lh *.safetensors
# 应显示每个分片为 3~4GB，而非 1KB
du -sh .  # 总大小应在 27GB 左右

---

四、避坑总结（重点！）

坑点	现象	解决方案
未启用 Git LFS	.safetensors 文件仅 1KB	安装 git-lfs 并执行 git lfs pull
LFS 初始化报错	not a git repo 警告	忽略警告，只要看到 initialized 即成功
根目录权限不足	Permission denied	用 chown 赋权，避免全程 sudo
网络中断	下载卡住或失败	git lfs pull 支持断点续传，可重复执行
误判仓库为空	文件少、体积小	检查是否含 .gitattributes（LFS 配置文件）

✅ 欢迎点赞、收藏、转发！如有疑问，欢迎评论区交流。