NOVABERDocs

正在准备搜索…

    文档目录

    开始使用

    在 Windows 上安装并开始使用 Novaber

    1.0.3

    Novaber · 内容核对

    本页目录

    第一次使用?按下面 5 步准备好环境,再安装你的第一个本地 AI 应用。驱动、WSL2 和 Docker 通常只需配置一次;已装好的项目,检查通过后即可跳过。

    本指南上次核对:2026-11-17。图片可点击放大;界面与系统要求可能随软件更新,请以所链接的官方文档和当前应用要求为准。

    下载 Novaber Windows 版

    如需 AI 协助安装,请把本版本安装技能入口交给助手,并按AI 安装流程继续。安装技能、参考和检测脚本必须来自同一版本。

    命令可使用代码块右上角的复制按钮。若无法自动复制,直接选中完整命令后手动复制即可。

    开始前的准备

    本指南适用于 Windows x64 电脑。NVIDIA 驱动让电脑识别显卡,WSL2 提供 Linux 运行基础,Docker 为应用准备独立环境。先检查以下几项,后面就不容易走弯路。

    • Windows:建议使用仍受支持的 Windows 11。Windows 10 / 11 的具体版本与系统要求,以当前 Docker Desktop 官方说明为准。
    • 内存:Docker Desktop 至少需要 8 GB 系统内存;运行 AI 应用可能需要更多,以应用详情为准。
    • 虚拟化:右键开始菜单 → 任务管理器 → 性能 → CPU,确认“虚拟化”为“已启用”。若未启用,按电脑厂商说明在 BIOS / UEFI 中开启 Intel VT-x 或 AMD-V。
    • 显卡:GPU 应用需要兼容的 NVIDIA 显卡。显存与镜像体积请查看对应应用详情,不同应用要求不同。
    • 存储与网络:为镜像解压、模型和任务输出预留空间;安装应用与登录账户需要网络连接。

    查看 Docker Desktop 系统要求

    01 / 安装 NVIDIA 驱动

    Novaber 的 NVIDIA GPU 工作流要求驱动主版本 ≥ 575。针对本项目的 CUDA 12.9.1 基线,Windows 驱动还应达到 576.57 或更新版本。读取完整版本并按数字比较,不能只看 nvidia-smi 是否成功。

    nvidia-smi --query-gpu=name,driver_version,memory.total --format=csv,noheader,nounits
    

    例如:574.99 不满足主版本门槛,575.90 和 576.02 未达到本项目的 Windows 基线,576.57、610.47 满足这项驱动条件。版本读不到或格式不明时标为未知;权限被拒绝时标为受限,两者都不得判定通过。保留符合要求的新驱动;通过后仍需验证容器 GPU 和所选应用。

    这是 Novaber 的项目基线,不代表所有 CUDA 12.x 程序都必须使用 575 分支。NVIDIA 对 CUDA 12.9 Update 1 列出的对应驱动为 Linux 575.57.08、Windows 576.57;部分旧驱动的小版本兼容有功能限制,不能直接替代本项目的要求。CUDA 12.9.1 官方说明。无需为此额外安装完整 Windows CUDA Toolkit。

    使用 GPU 应用时,先为显卡安装合适的 Windows 驱动。仅使用明确支持 CPU 的应用,可以跳过 GPU 相关步骤。

    先认清型号,再下载

    1. 右键开始菜单 → 任务管理器 → 性能 → GPU,记下完整的 NVIDIA 显卡型号。笔记本可能同时有集成显卡和 NVIDIA 独立显卡,请看 NVIDIA 那一项。
    2. 打开下方 NVIDIA 官网链接,在 Manual Driver Search(手动搜索驱动)中依次选择显卡类别、系列、具体型号和 Windows 版本,然后点击 Find(查找)。
    3. 在结果中下载与你的设备匹配的最新 Game Ready 或 Studio 驱动。不要照抄别人的显卡型号或截图里的驱动版本号。
    NVIDIA 官网手动驱动搜索:类别、系列、型号、系统、语言和 Find 按钮

    图 1 · 从上到下:显卡类别 → 显卡系列 → 具体型号 → 操作系统 → 语言。Windows 版本可在“设置 → 系统 → 系统信息”查看。

    查看大图 · 官方来源

    下载 NVIDIA 驱动

    运行安装程序,然后重启

    打开下载的安装程序,按提示解压并继续。界面中 NVIDIA Graphics Driver 表示显卡驱动,带 NVIDIA App 的选项还会安装驱动管理应用。阅读并同意许可后继续安装,完成后重启电脑。

    NVIDIA 官方驱动安装器,提供显卡驱动与 NVIDIA App 安装选项,下方为同意并继续按钮

    图 2 · NVIDIA 官方安装界面示例。这里只需认清驱动选项与右下角继续按钮;图中版本号不是 Novaber 的指定版本。

    查看大图 · 官方来源

    重启后,在开始菜单搜索 PowerShell 并打开,粘贴下面的命令,按 Enter 执行。

    nvidia-smi
    

    检查通过 确认 GPU 型号、驱动主版本 ≥ 575,且完整 Windows 驱动版本 ≥ 576.57 后,再继续。如果命令报错或没有 NVIDIA 显卡信息,先检查是否装对驱动。表格中的 CUDA Version 表示驱动支持的 CUDA 能力,不代表你需要另装同版本 CUDA。

    按所选应用镜像的 CUDA 版本检查 Windows 驱动兼容性;不要直接套用 Linux 驱动版本号,也不要仅凭 nvidia-smi 的 CUDA Version 判断所有镜像均可运行。

    驱动门槛、版本比较和 CUDA 兼容范围统一见系统要求中的驱动基线。把完整版本和核对结果记录到安装诊断报告,再继续容器 GPU 检查。

    02 / 安装并检查 WSL2

    右键 Windows 开始菜单,选择“终端(管理员)”或“Windows PowerShell(管理员)”,确认系统授权提示。首次安装时,复制下面一行并按 Enter;它会安装 WSL 和默认的 Ubuntu 发行版。

    wsl --install
    

    按提示重启电脑。如果 Ubuntu 首次启动要求创建用户名和密码,按提示完成即可;输入密码时屏幕不显示字符是正常现象。后续命令请回到 Windows PowerShell 执行。已有 WSL 的电脑从下面的更新和检查开始。

    更新 WSL 到最新版本。完成后按提示重启,再分别执行后面的检查命令。

    wsl --update
    

    先看 WSL 程序版本,再看发行版是否使用 WSL2(这两个版本号不是同一回事):

    wsl --version
    wsl --list --verbose
    

    检查通过 wsl --version 中 WSL 版本至少为 2.1.5;发行版列表中 Ubuntu 等项目的 VERSION 为 2。若没有安装 Ubuntu,也可以在 Windows 中使用 Docker,无需专门补装发行版。 仅当已有发行版的 VERSION 为 1 时,才执行下面这行。把 Ubuntu 换成列表中的实际名称;转换完成后再次检查。

    wsl --set-version Ubuntu 2
    

    查看 Microsoft WSL 安装说明

    03 / 准备 Docker Desktop

    打开 Docker 官网,下载 Windows - x86_64 版安装器。Intel 和 AMD 的常见 Windows x64 电脑都选这个版本;本指南不适用于 Arm 设备。

    Docker 官方下载页面的三个按钮:Windows x86_64 安装器、Microsoft Store 版和 Arm 版

    图 3 · 点击第一个 Windows - x86_64 按钮下载安装器。下面的 Microsoft Store 和 Arm 是其他下载入口。

    查看大图 · 官方来源

    下载与安装 Docker Desktop

    安装并启动 Docker

    1. 双击 Docker Desktop Installer.exe,按安装向导继续。如果出现安装范围选项,个人电脑可保留默认的 Per-user(当前用户)。
    2. 如果出现后端选项,选择 Use WSL 2 instead of Hyper-V。部分系统会自动选择 WSL2,不会出现这个选项。
    3. 安装完成后按提示重启。从开始菜单打开 Docker Desktop,阅读首次启动的服务条款并自行确认后,等待引擎启动。仅安装完成,不代表 Docker 已经在运行。

    确认运行方式

    1. 在 Docker Desktop 中点击设置图标 → General(常规),选择 Use WSL 2 based engine(使用 WSL2 引擎)。若此项未显示,可能是系统已默认启用 WSL2,可继续做下方检查。
    2. 使用 Linux 容器模式。如果右下角托盘的 Docker 菜单出现 Switch to Linux containers,点击切换;如果显示 Switch to Windows containers,说明当前已是 Linux 模式,不用切换。
    3. 仅当你还想从 Ubuntu 终端运行 Docker 命令时,才需要到 Resources → WSL Integration 开启对应发行版。在 Windows 使用 Novaber,不必专门开启这个选项。
    4. 如果修改了设置,点击 Apply 或 Apply & restart,等待引擎重新就绪。回到 Windows PowerShell,执行下面的检查。
    docker version
    docker info --format '{{.OSType}}'
    

    检查通过 docker version 同时显示 Client 和 Server;第二条命令输出 linux。若只有 Client 或提示无法连接 daemon,先打开 Docker Desktop 并等待启动,暂时不要继续安装应用。 对照 Docker 官方 WSL2 设置说明

    配置 Docker 登录启动

    安装并首次打开后,在 Settings → General 中启用 Start Docker Desktop when you sign in to your computer;如果你选择手动启动,可以保留关闭。按当前版本提供的方式保存或应用,再次打开设置确认已保存。受组织管理的设置可能需要管理员处理。参见 Docker 常规设置。

    这项设置在 Windows 用户登录后启动 Docker Desktop,不等于已实测下一次登录,也不表示所有业务容器都会自动启动。不用服务启动类型或自定义脚本替代该选项;应用设置时注意现有工作,避免中断运行中的任务。

    04 / 验证容器 GPU

    需要 GPU 的应用先做这项检查。在 Windows PowerShell 中复制并执行完整命令。首次运行会下载测试镜像,下载期间请等待;镜像下载报错不等于显卡损坏。

    docker run --rm -it --gpus=all nvcr.io/nvidia/k8s/cuda-sample:nbody nbody -gpu -benchmark
    

    检查通过 命令成功结束,输出中出现 GPU 设备信息以及计算性能结果(例如 GFLOP/s)。这说明该测试容器能调用显卡;具体应用仍需满足显存和驱动要求。此示例用于功能验证,不能作为应用性能或模型效果的测量依据。

    这条 Windows + Docker Desktop 路线使用 Windows 显卡驱动,不要在 WSL 中另装 Linux NVIDIA 显示驱动。本流程也不要求在 Windows 手动安装 CUDA Toolkit;应用镜像会提供自己的 CUDA 运行环境。 查看 NVIDIA 对 WSL 驱动的说明 · 查看 Docker GPU 验证说明

    05 / 安装第一个应用

    环境就绪后,回到 Novaber 完成应用安装。

    1. 下载并安装 Windows 版 Novaber,按应用提示完成账户登录。
    2. 在应用目录选择工具,对照应用要求检查 GPU、显存与存储空间。
    3. 点击“安装到本地”,等待镜像下载与容器准备完成。首次安装耗时取决于镜像大小和网络。
    4. 状态就绪后点击“打开工作区”,进入本机应用界面。继续按 使用流程 完成小任务和导出检查。

    检查通过 应用工作区能够打开并完成一个小任务,就完成了首次安装。以后使用前先确认 Docker Desktop 在运行,再打开 Novaber。 浏览已发布应用 · 批量抠图教程

    安装遇到问题?

    Docker Desktop 无法启动

    检查 BIOS / UEFI 虚拟化状态,运行 wsl --update,并按提示重启。再对照 Docker Desktop 的系统要求检查 Windows 与 WSL 版本。

    容器提示找不到 GPU

    先确认 Windows 中的 nvidia-smi 正常,再检查 Docker 是否使用 WSL2 后端和 Linux 容器模式。更新 Windows NVIDIA 驱动后,重新运行本页 GPU 验证命令。

    WSL 中找不到 nvidia-smi 命令

    可以尝试 /usr/lib/wsl/lib/nvidia-smi。不要因此在 WSL 中安装 Linux 显卡驱动;同时检查 Windows 主机驱动与 WSL 更新状态。

    GPU 验证成功,应用仍提示 CUDA 不可用

    检查应用镜像的 CUDA 与主机驱动是否兼容,以及应用是否使用 GPU 版运行环境。基础 GPU 验证通过,并不表示所有应用的依赖和显存条件都已满足。

    应用下载或安装失败

    确认 Docker 正常运行、网络可以访问镜像源且磁盘空间充足。保留报错信息,再查看下方日志目录;不要为重试安装而直接清空 Docker 数据或应用目录。

    日志与问题反馈

    在文件资源管理器的地址栏输入以下默认目录,查找主程序记录的相关日志。实际位置和可用日志以安装版本为准;子应用日志也可能由自己的任务界面提供:

    %APPDATA%\novaber\logs
    

    反馈时附上 Windows 版本、显卡型号、应用名称、操作步骤和相关报错。分享前请移除日志中的邮箱、令牌及个人文件路径等信息。

    前往 Gitee 提交 Issue · 官网意见反馈

    报告状态、自定义安装目录、受限命令及运行文件的判断方法,统一见安装诊断与启动验证。

    系统支持、下载准备、联网、任务与导出等疑问可按Novaber 常见问题继续查找。

    资料来源