2026-06-14 12:08:38 +08:00
|
|
|
|
# GPU Stack Bootstrap
|
2026-06-14 12:06:06 +08:00
|
|
|
|
|
2026-06-14 12:08:38 +08:00
|
|
|
|
> Windows 11 + WSL2 Ubuntu 24.04 + RTX 5060 Ti (Blackwell) 全栈装机指南
|
|
|
|
|
|
>
|
|
|
|
|
|
> 目标读者：能看懂命令但没装过 NVIDIA 显卡+WSL2+CUDA 的新人
|
|
|
|
|
|
|
|
|
|
|
|
## 一句话 TL;DR
|
|
|
|
|
|
|
|
|
|
|
|
装 NVIDIA Studio 驱动（Windows）→ 装 CUDA Toolkit 12.8（WSL2）→ 装 PyTorch / Ollama / ComfyUI
|
|
|
|
|
|
→ 验证 `nvidia-smi` 看到 5060 Ti → 完事。
|
|
|
|
|
|
|
|
|
|
|
|
## 当前进度
|
|
|
|
|
|
|
|
|
|
|
|
| 章节 | 状态 | 验证方式 |
|
|
|
|
|
|
|------|------|------|
|
|
|
|
|
|
| [01 硬件与基础检查](./01-hardware-check.md) | ✅ 已跑通 | 装好显卡，nvidia-smi 能看到 |
|
|
|
|
|
|
| [02 Windows 装 Studio 驱动](./02-windows-driver.md) | ✅ 已跑通 | nvidia-smi 看到 5060 Ti + 610.47 |
|
|
|
|
|
|
| [03 WSL2 + CUDA 12.8](./03-wsl2-ubuntu.md) | ✅ 已跑通 | nvcc --version 显示 12.8 |
|
|
|
|
|
|
| [04 Ollama 装 LLM](./04-ollama-llm.md) | ✅ 已跑通 | qwen2.5:7b 聊天正常 |
|
2026-06-14 12:12:20 +08:00
|
|
|
|
| [05 PyTorch 验证](./05-pytorch-verify.md) | ✅ 已跑通 | 看到 `CUDA: True \| 5060 Ti`（torch 2.12.0）|
|
2026-06-14 13:41:40 +08:00
|
|
|
|
| [06 ComfyUI 装出图](./06-comfyui-image.md) | ✅ 已跑通 | 浏览器开 8188 出图（SDXL 6.94G）|
|
2026-06-14 12:08:38 +08:00
|
|
|
|
| [90 排错手册](./90-troubleshoot.md) | ✅ 已有 | 镜像源 / 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.94**（Blackwell 必需，5060 Ti 在 560.94 之前根本点不亮）
|
|
|
|
|
|
2. **WSL2 Ubuntu 内不能装 NVIDIA 驱动**（会和 Windows 驱动打架黑屏）—— 只装 CUDA Toolkit
|
|
|
|
|
|
3. **CUDA Toolkit 必须 ≥ 12.6**（Blackwell 必需，13.x 主流 wheel 还没出）
|
|
|
|
|
|
4. **PyTorch wheel 必须 `+cu128`**（不是 cu118/cu121/cu124，老版本不支持 Blackwell）
|
|
|
|
|
|
5. **模型放 D 盘**（`/mnt/d/`），系统盘别占满
|
|
|
|
|
|
|
|
|
|
|
|
## 推荐阅读顺序
|
|
|
|
|
|
|
|
|
|
|
|
1. 先看 [01 硬件与基础检查](./01-hardware-check.md) —— 确认你电脑符合
|
|
|
|
|
|
2. 严格按 02 → 03 → 04 跑，每步都看验证输出
|
|
|
|
|
|
3. 卡住先查 [90 排错手册](./90-troubleshoot.md)
|
|
|
|
|
|
4. 跑通后看 05 / 06 装实际工作负载
|
|
|
|
|
|
|
|
|
|
|
|
## 备份仓库
|
|
|
|
|
|
|
|
|
|
|
|
- **Gitea (主)**: https://git.errlens.top/hwd32/gpu-stack-bootstrap
|
|
|
|
|
|
- **GitCode (异地备份)**: https://gitcode.com/tupingr/gpu-stack-bootstrap
|
|
|
|
|
|
|
|
|
|
|
|
## 贡献
|
|
|
|
|
|
|
|
|
|
|
|
踩坑了补 [90 排错手册](./90-troubleshoot.md) 或直接提 PR。
|
