Quip Node Manager Docker 模式与 Native 模式怎么选?完整对比与场景指南
Quip Node Manager Docker 模式与 Native 模式怎么选?完整对比与场景指南
Quip Node Manager 是一款用于运行和监控 Quip 网络节点的桌面客户端,支持 macOS、Linux 和 Windows。它内置了两种运行模式:Docker 模式(默认)和 Native 模式(仅限 Apple Silicon Mac)。选错模式可能导致你的 GPU 挖矿性能白白浪费,或者启动失败。本文用一张对比表加三个真实场景,帮你在 2 分钟内做出正确选择。
两种模式分别是什么?
Quip 节点并不是单一进程,而是一整套服务栈:矿工(Miner)、验证者(Validator)、仪表盘(Dashboard)、Postgres 数据库和 Caddy 反向代理。两种模式的区别,本质上是矿工以什么方式运行:
Docker 模式:全容器化一键运行
Docker 模式通过 Docker Compose 启动完整服务栈,矿工也运行在容器里。应用会自动根据你的 GPU 选择 CPU 或 CUDA 镜像(启用 NVIDIA 设备时自动切换到 CUDA 镜像),并拉取最新的节点与仪表盘镜像。
- 前置条件:Docker + Compose v2(Windows 还需 WSL)
- 优点:隔离性好、可移植性强、自动管理依赖
- 这是 Windows 和 Linux 的唯一模式
Native 模式:矿工直接跑在宿主机上
Native 模式下,应用会下载原生的 quip-coordinator 二进制文件(安装到 ~/quip-data/bin/),让矿工以宿主机进程的方式运行,而验证者、仪表盘、Postgres、Caddy 依然跑在 Docker 容器里,通过 host.docker.internal 与宿主机矿工通信。
这个模式存在的唯一理由,写在 native.rs 的注释里:
只有 Native 模式才能让 Metal 挖矿真正访问 Apple Silicon 的 GPU——容器做不到这一点。
Native 模式目前仅支持 Apple Silicon(M 系列芯片)Mac,在其它平台上选择它会直接提示使用 Docker 模式。
Docker 模式 vs Native 模式:完整对比表
| 对比维度 | Docker 模式 | Native 模式 |
|---|---|---|
| 支持平台 | macOS / Windows / Linux | 仅 Apple Silicon Mac |
| 矿工运行位置 | 容器内(quip-cpu 或 quip-cuda) |
宿主机进程 |
| GPU 挖矿 | NVIDIA(CUDA 镜像) | Apple 芯片(Metal) |
| D-Wave QPU 挖矿 | ✅ 支持(走 CPU 镜像 + 配置段) | ❌ 不支持 |
| 前置依赖 | Docker + Compose v2 | Docker + 自动下载原生二进制 |
| 矿工更新方式 | 拉取新镜像 | 下载新二进制包 |
| 验证者 RPC 端口 | 容器网络内部(ws://quip-validator:9944) |
发布到宿主机 127.0.0.1:9944 |
| 默认状态 | Windows / Linux 默认 | macOS 默认 |
💡 值得注意:在 macOS 上,运行模式其实由 Metal GPU 开关自动决定——打开 Metal 开关就走 Native 模式,关闭则回落到 Docker 模式的 CPU 挖矿(见 settings.rs 中的默认值逻辑)。Windows 和 Linux 用户则永远只有 Docker 模式可选。
三个典型场景,对号入座
场景一:M 系列芯片的 Mac 想挖矿
👉 选 Native 模式(打开 Metal 开关)。
这是 Native 模式的唯一"独家能力"。v0.3 的 Docker 镜像虽然自带 CPU、D-Wave、CUDA 三种矿工,但 Metal 挖矿只有原生二进制能用到 Apple Silicon GPU。应用会检查并自动下载 quip-miner-darwin-arm64 二进制包,你只需要在设置里开启 Metal 设备并调节利用率滑块。
场景二:Windows / Linux 机器,带 NVIDIA 显卡
👉 Docker 模式(自动启用 CUDA 镜像)。
在 GUI 的 GPU 设置中启用 NVIDIA 设备后,应用会自动把矿工镜像切换为 CUDA 版本(quip-miner-cuda)。D-Wave QPU 量子挖矿也走这条路径——它不需要单独的镜像,只需在配置中填写 D-Wave 的 API 信息即可。
场景三:纯 CPU 挖矿,或第一次部署节点
👉 Docker 模式,最省心。
无论 macOS、Windows 还是 Linux,Docker 模式都能覆盖 CPU 挖矿。应用内置了预检清单(checklist.rs):启动前会自动验证 Docker 是否可用、节点密钥是否就绪、公网 IP 与端口是否可达,避免"点了 Start 才知道缺东西"的尴尬。
切换模式前,了解 3 个关键差异
1️⃣ 端口与网络
Native 模式需要把验证者 RPC 发布到宿主机端口(默认 9944,默认仅监听本机),矿工的 REST 接口则绑定在 0.0.0.0:20100,这样 Caddy 容器才能通过 Docker 宿主网关访问到它。Docker 模式下这些通信全部发生在容器网络内部,默认不对外暴露。端口开关和端口号都可以在高级设置中按服务分组调整。
2️⃣ 更新机制不同
- Docker 模式:后台每 30 分钟检查一次各镜像的摘要(digest),有新版本会提示重启拉取
- Native 模式:检查 GitLab Release 中最新的 macOS 二进制包,通过 download_native_binary 下载并替换本地二进制,还会清理旧版本的遗留文件
两种模式的应用自身更新、日志流、健康面板功能完全一致。
3️⃣ 数据与配置统一存放
不管哪种模式,所有数据都在 ~/quip-data/ 目录:config.toml 每次启动重新生成,Docker 模式下挂载进容器;Native 模式下由宿主机进程直接读取。切换模式不会丢失你的链数据和节点密钥。
常见问题 🤔
Q1:Windows 或 Linux 上为什么看不到 Native 选项? 因为当前只有 Apple Silicon 平台提供原生二进制包。这些平台上的所有挖矿能力(CPU / CUDA / D-Wave)都已包含在 Docker 镜像中,无需 Native 模式。
Q2:在 Mac 上关掉 Metal 开关会发生什么? 应用会回落到 Docker 模式的 CPU 镜像挖矿,节点数据不受影响,随时可以重新开启 Metal 切回 Native 模式。
Q3:没有 Docker 能用 Native 模式吗? 不能。Native 模式只把矿工移出容器,验证者、仪表盘、Postgres、Caddy 依然依赖 Docker。
Q4:可以在服务器上无界面运行吗?
可以。应用提供终端 UI 模式(--cli,或 SSH 无显示环境自动启用),能启动/停止节点栈、跑预检清单、看日志、改配置(参见 tui_app.rs),适合纯 Docker 模式的服务器部署。
一句话总结
| 你的情况 | 推荐模式 |
|---|---|
| Apple Silicon Mac + 想用 GPU | Native 模式(唯一选择) |
| Windows / Linux + NVIDIA 显卡 | Docker 模式(自动 CUDA) |
| 纯 CPU 挖矿 / 首次部署 / 服务器 | Docker 模式 |
| D-Wave 量子挖矿 | Docker 模式 |
记住核心结论:"Metal 选 Native,其它全 Docker"。更多架构细节可参阅 AGENTS.md 与 README.md,Docker 编排逻辑在 compose.rs,Native 二进制生命周期管理在 native.rs。