Files
gpu-stack-bootstrap/README.md
T
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

54 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 硬件与基础检查](./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 聊天正常 |
| [05 PyTorch 验证](./05-pytorch-verify.md) | ⏳ 待补 | 看到 `CUDA: True \| 5060 Ti` |
| [06 ComfyUI 装出图](./06-comfyui-image.md) | ⏳ 待补 | 浏览器开 8188 出图 |
| [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。