# GPU 节点接入指南 — Windows RTX 3060

> 最后更新: 2026-06-18 | 适用: Windows 10/11 + NVIDIA RTX 3060+

## 第1步：检查系统要求

| 要求 | 最低配置 | 推荐配置 |
|------|----------|----------|
| 操作系统 | Windows 10 (21H2+) | Windows 11 |
| GPU | NVIDIA RTX 3060 | RTX 3060 Ti+ |
| 显存 | 8 GB | 12 GB+ |
| 内存 | 16 GB | 32 GB |
| 磁盘 | 50 GB 可用 | 100 GB SSD |
| 网络 | 10 Mbps | 100 Mbps |

## 第2步：安装 NVIDIA 驱动

1. 打开 [NVIDIA 驱动下载](https://www.nvidia.com/download/index.aspx)
2. 选择你的显卡型号 → 下载 Game Ready 驱动
3. 安装后重启电脑
4. 验证：打开 PowerShell，输入 `nvidia-smi` — 应显示 GPU 型号和驱动版本

## 第3步：安装 Docker Desktop

1. 下载 [Docker Desktop for Windows](https://www.docker.com/products/docker-desktop/)
2. 安装时 **勾选 "Use WSL 2 instead of Hyper-V"**
3. 安装完成后重启
4. 打开 Docker Desktop → Settings → Resources → **启用 GPU 加速**
5. 验证：打开 PowerShell，输入 `docker run --rm hello-world`

## 第4步：安装 NVIDIA Container Toolkit

```powershell
# 方法1：Docker Desktop 自动安装（推荐）
# Docker Desktop 4.30+ 已内置 GPU 支持，无需额外安装

# 方法2：手动安装（如果方法1失败）
# 在 WSL2 终端中运行：
curl -fsSL https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list | sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
sudo apt update
sudo apt install -y nvidia-container-toolkit
```

## 第5步：验证 GPU 可用性

```powershell
# 测试 Docker GPU 访问
docker run --rm --gpus all nvidia/cuda:12.6.3-runtime-ubuntu22.04 nvidia-smi
```

预期输出：应显示你的 RTX 3060 显卡信息。

## 第6步：运行验收测试

```powershell
# 下载验收脚本
# 从 https://nysn777.com/docs/WINDOWS_NODE_GUIDE.md 下载 uat_acceptance.py

# 运行验收测试
python uat_acceptance.py
```

验收脚本会自动检测：
- ✅ 系统环境（OS、Python、Docker）
- ✅ GPU 硬件（型号、显存、驱动）
- ✅ Docker GPU 支持
- ✅ CUDA 兼容性
- ✅ PyTorch GPU 计算
- ✅ 平台连接性
- ✅ 节点注册

## 第7步：节点上线

验收全部通过后，节点会自动注册到平台。在平台后台可查看节点状态和收益。

---

## 常见问题 (FAQ)

### Q: Docker 报 "could not select device driver"
**A:** Docker Desktop GPU 加速未启用。打开 Docker Desktop → Settings → Resources → 勾选 "Enable GPU"。

### Q: nvidia-smi 显示 "NVIDIA-SMI has failed"
**A:** 驱动未正确安装。重新安装 NVIDIA Game Ready 驱动并重启。

### Q: WSL2 报 "Please enable the Virtual Machine Platform"
**A:** 管理员 PowerShell 运行：
```powershell
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
```
然后重启。

### Q: 验收脚本报 "GPU platform not reachable"
**A:** 检查防火墙是否放行 443 端口，确认能访问 https://nysn777.com

### Q: 如何查看节点收益？
**A:** 登录 https://nysn777.com → 管理后台 → 节点管理 → 查看节点详情。

### Q: 支持多张 GPU 吗？
**A:** 支持。验收脚本会自动检测所有 GPU 并分别注册。

### Q: 节点离线会怎样？
**A:** 节点每 120 秒发送心跳。超过 120 秒未心跳将标记为离线，不分配新任务。已分配任务会因超时自动重新调度。

---

## 技术支持

- 📧 邮件: support@nysn777.com
- 🌐 平台: https://nysn777.com
- 📋 验收报告: 运行 `uat_acceptance.py` 后自动生成 `uat_report_*.json`