hwd32 58fdb03c30 docs: 初始装机指南
包含 6 章步骤 + 排错手册:
- 01 硬件与基础检查
- 02 Windows 装 Studio 驱动
- 03 WSL2 + CUDA 12.8
- 04 Ollama 装 LLM
- 05 PyTorch 验证(待补,依赖实机跑通)
- 06 ComfyUI 装出图(待补,依赖实机跑通)
- 90 排错手册
2026-06-14 12:08:38 +08:00
2026-06-14 12:06:06 +08:00
2026-06-14 12:08:38 +08:00
2026-06-14 12:08:38 +08:00
2026-06-14 12:08:38 +08:00
2026-06-14 12:08:38 +08:00
2026-06-14 12:08:38 +08:00
2026-06-14 12:08:38 +08:00
2026-06-14 12:08:38 +08:00
2026-06-14 12:06:06 +08:00
2026-06-14 12:08:38 +08:00

GPU Stack Bootstrap

Windows 11 + WSL2 Ubuntu 24.04 + RTX 5060 Ti (Blackwell) 全栈装机指南

目标读者:能看懂命令但没装过 NVIDIA 显卡+WSL2+CUDA 的新人

一句话 TL;DR

装 NVIDIA Studio 驱动(Windows)→ 装 CUDA Toolkit 12.8WSL2)→ 装 PyTorch / Ollama / ComfyUI → 验证 nvidia-smi 看到 5060 Ti → 完事。

当前进度

章节 状态 验证方式
01 硬件与基础检查 已跑通 装好显卡,nvidia-smi 能看到
02 Windows 装 Studio 驱动 已跑通 nvidia-smi 看到 5060 Ti + 610.47
03 WSL2 + CUDA 12.8 已跑通 nvcc --version 显示 12.8
04 Ollama 装 LLM 已跑通 qwen2.5:7b 聊天正常
05 PyTorch 验证 待补 看到 CUDA: True | 5060 Ti
06 ComfyUI 装出图 待补 浏览器开 8188 出图
90 排错手册 已有 镜像源 / zstd / WSL2 透传失败

硬件清单

  • GPU: NVIDIA GeForce RTX 5060 Ti (16 GB, Blackwell 架构, sm_120)
  • CPU: AMD Ryzen 7 8845HS (实测)
  • OS: Windows 11 + WSL2 Ubuntu 24.04 LTS
  • 内存: 32GB 起步

关键硬规则

  1. 驱动必须 ≥ 560.94Blackwell 必需,5060 Ti 在 560.94 之前根本点不亮)
  2. WSL2 Ubuntu 内不能装 NVIDIA 驱动(会和 Windows 驱动打架黑屏)—— 只装 CUDA Toolkit
  3. CUDA Toolkit 必须 ≥ 12.6Blackwell 必需,13.x 主流 wheel 还没出)
  4. PyTorch wheel 必须 +cu128(不是 cu118/cu121/cu124,老版本不支持 Blackwell
  5. 模型放 D 盘/mnt/d/),系统盘别占满

推荐阅读顺序

  1. 先看 01 硬件与基础检查 —— 确认你电脑符合
  2. 严格按 02 → 03 → 04 跑,每步都看验证输出
  3. 卡住先查 90 排错手册
  4. 跑通后看 05 / 06 装实际工作负载

备份仓库

贡献

踩坑了补 90 排错手册 或直接提 PR。

S
Description
Windows 11 + WSL2 Ubuntu 24.04 + RTX 5060 Ti Blackwell GPU 全栈装机指南(驱动/CUDA/PyTorch/Ollama/ComfyUI)
Readme MIT 48 KiB
Languages
Markdown 100%