节点接入指南
将你的 GPU 机器接入方舟智算算力网络，开始赚取收益。
硬件要求
| 项目 | 最低要求 | 推荐 |
|---|---|---|
| GPU | NVIDIA GTX 1080 / 8GB 显存 | RTX 3090 / 4090 / A100 |
| CPU | 4 核 | 8 核以上 |
| 内存 | 16 GB | 32 GB 以上 |
| 磁盘 | 100 GB SSD | 500 GB NVMe SSD |
| 网络 | 上行 50 Mbps | 上行 200 Mbps 以上 |
| 操作系统 | Ubuntu 20.04 LTS | Ubuntu 22.04 LTS |
:::caution 仅支持 NVIDIA GPU。AMD GPU 暂不支持。 :::
前提条件
1. 安装 NVIDIA 驱动
bash
# 查看推荐驱动版本
ubuntu-drivers devices
# 安装推荐驱动
sudo ubuntu-drivers autoinstall
sudo reboot
# 验证安装
nvidia-smi驱动版本 ≥ 525 可获得最佳兼容性。
2. 安装 Docker
bash
# 安装 Docker Engine
curl -fsSL https://get.docker.com | bash
# 启动并设置开机自启
sudo systemctl enable --now docker
# 将当前用户加入 docker 组（免 sudo）
sudo usermod -aG docker $USER
newgrp docker3. 安装 NVIDIA Container Toolkit
bash
# 添加 NVIDIA 源
curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | \
sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg
curl -s -L https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list | \
sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' | \
sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
sudo apt-get update && sudo apt-get install -y nvidia-container-toolkit
# 配置 Docker 使用 NVIDIA runtime
sudo nvidia-ctk runtime configure --runtime=docker
sudo systemctl restart docker
# 验证
docker run --rm --gpus all nvidia/cuda:12.0-base nvidia-smi获取 Join Token
- 访问 manage.arkcore.cloud 并登录供应商账号
- 进入 节点管理 → 添加节点
- 填写节点报价（每小时单价），点击生成
- 页面会显示一条完整的
curl命令，复制备用
生成 join token 后即可立即使用，无需等待审核。
运行 setup.sh
在目标机器上以 root 身份粘贴并执行控制台生成的命令：
bash
sudo bash <(curl -fsSL https://api.arkcore.cloud/node-setup.sh) \
--token YOUR_JOIN_TOKEN \
--api https://api.arkcore.cloud直接复制控制台生成的命令即可——Nomad Server 的
retry_join地址、接入认证、Cloudflare 隧道令牌等都已由服务端注入到脚本里，无需手填。平台编排层为 HashiCorp Nomad，节点不再使用 NATS。
参数说明：
| 参数 | 说明 |
|---|---|
--token | 控制台生成的一次性 join token |
--api | 方舟智算 API 地址 |
--server | Nomad Server retry_join 地址（通常已由服务端注入，无需手填） |
--cf-token | 交互式实例的 Cloudflare 隧道令牌（控制台生成命令时自动带上） |
脚本将自动完成：
- 生成稳定节点 ID（写入
/etc/ark/node-id），作为 Nomad clientmeta.node-id - 安装 Docker、Nomad 客户端、CNI 插件（GPU 机额外装 nvidia 设备插件、cloudflared）
- 自动检测本机 GPU 型号、显存、数量等硬件信息，上报平台
- 注册
nomadsystemd 服务，设置开机自启 - 以 client 模式 retry_join 接入平台 Nomad 集群，上线后自动建档激活
INFO
脚本通过 nvidia-smi 自动识别 GPU 信息，无需手动填写标签。
验证节点状态
bash
# 查看服务状态
sudo systemctl status nomad
# 查看实时日志
sudo journalctl -u nomad -f节点上线后，在控制台 节点管理 中可以看到连接状态变为「在线」（通常约 30 秒）。
节点上线后
- 控制台可查看实时任务数、收益统计
- 如需暂停接单（如维护机器），在控制台点击「暂停节点」
- 配置维护时间窗口：控制台 → 节点管理 → 节点详情 → 维护计划