NarwhalCloud Agent — 安装指南

把你的闲置服务器变成 NAT VPS 共享主机，平摊成本，按天分成赚钱。

English | 控制台 | 官网

---

这是什么？

NarwhalCloud 是一个 C2C NAT VPS 共享平台。你把自己的服务器（独立服务器、大带宽 VPS、共置托管机器）接入平台，平台负责将服务器的资源切分成多个 NAT VPS 实例，向平台上的租户按天出售。租户付的钱平台收取 20%，你拿 80%——你什么都不用做，服务器的托管费、带宽费自然就被平摊掉了。

你的服务器 ──► NarwhalCloud Agent ──► NAT VPS 实例（租户购买）
                                         │
                    平台收取 20% 佣金 ◄──┤
                    你获得 80% 收益  ◄──┘

平摊成本的逻辑很简单： 一台月费 $50 的独立服务器，跑 30 个 NAT VPS 实例，每个以 $3/月出售，月收入 $90，净赚 $40，还附带一批自用实例。成本不但清零，还有结余。

什么是 NAT VPS？

NAT VPS 是多台虚拟机共享同一个公网 IP、通过端口转发对外暴露服务的轻量 VPS 形态。因为省去了独立 IPv4 的成本，NAT VPS 的售价通常是独立 IP VPS 的 1/5 到 1/3——而对于爬虫、代理、机器人、学习 Linux、建站（配合 Cloudflare）等大多数使用场景来说，NAT VPS 完全够用。

NarwhalCloud Agent 就是让你的服务器具备"自动切分 NAT VPS 实例 + 管理端口转发 + 流量计费 + 接入平台"这套能力的守护进程。

适合接入的机器类型

机器类型	典型场景
独立服务器 / 裸金属	核心用法，资源多、密度大，收益最高
大带宽 / 多 IP VPS	利用闲置带宽和端口对外出租
共置托管服务器	用出租收益抵消机柜租金和带宽费
家庭宽带服务器	接入平台实现轻量共享，收益覆盖电费

---

概述（技术）

NarwhalCloud Agent（narwhal-agent）是运行在宿主机（母鸡）上的后台服务，负责管理容器 / 虚拟机实例，将您的服务器接入 NarwhalCloud 平台，并提供本地 Web 管理面板。Agent 支持三种虚拟化后端（Podman、cloud-hypervisor KVM、Incus LXC），自动处理 NAT 端口转发、流量统计和 IPv6 分配，是平台侧与租户实例之间的唯一桥梁。

系统要求

项目	要求
操作系统	Debian 13 (Trixie) — 强烈推荐
架构	x86_64 (amd64) · aarch64 (arm64)
内存	≥ 1 GB RAM
磁盘	≥ 10 GB 可用空间

为什么选 Debian 13？ 安装脚本使用了 apt、podman、systemd-zram-generator 等依赖，这些在 Debian 13 上完整可用。使用其他发行版可能导致意外失败。

第一步 — 重装系统（推荐）

为确保干净一致的运行环境，建议在运行 Agent 安装脚本前，先通过 DD 重装脚本 将系统重装为 Debian 13。

警告： 此操作会清除整块硬盘的所有数据。不支持 OpenVZ 或 LXC 虚拟机。

curl -O https://raw.githubusercontent.com/bin456789/reinstall/main/reinstall.sh || wget -O reinstall.sh https://raw.githubusercontent.com/bin456789/reinstall/main/reinstall.sh
bash reinstall.sh debian 13

脚本将自动重启服务器并安装 Debian 13。重启完成后，重新以 root 身份 SSH 登入。

如需在重启生效前取消操作，执行 bash reinstall.sh reset。

第二步 — 执行安装脚本

bash <(curl -fsSL https://github.com/narwhal-cloud/runman-agent/releases/latest/download/install.sh)

安装脚本为交互式，过程中会依次询问：

1. 语言选择 — English 或 中文
2. 虚拟化类型 — 详见下方说明
3. 公网 IPv6 检测 — 是否检测并配置 IPv6
4. 数据盘大小 — 仅 Podman 模式需要，例如 20G、50G
5. 是否安装 rfw 防火墙 — 可选的 eBPF 防火墙

虚拟化类型说明

编号	类型	说明
1	Podman（推荐）	基于 Podman 的 OCI 容器，轻量，无需 KVM。使用 XFS loop 挂载数据盘。
2	cloud-hypervisor（实验性）	完整 KVM 虚拟机，需要 /dev/kvm。自动下载 Debian/Alpine 虚拟机镜像。
3	Incus (LXC)（实验性）	基于 Incus 的系统容器，比 VM 更轻量。

选项 2 和 3 目前处于实验阶段，生产环境稳定性不保证。

IPv6 支持

安装脚本会自动检测服务器的 IPv6 配置并选择合适的模式：

模式	触发条件	行为
none	无公网 IPv6	仅 IPv4
snat	单个 /128 地址，或前缀 /65–/127	容器/VM 通过 SNAT/MASQUERADE 共享宿主机 IPv6
subnet	前缀 ≤ /64（至少 /64 子网）	每个容器/VM 获得独立的公网 IPv6 地址

子网模式要求至少分配到 /64 段。 前缀 /65–/127 地址空间不足以为每个容器/VM 分配独立地址，会自动回退到 SNAT 模式。

也可通过环境变量强制指定模式及网络参数：

# 强制使用 SNAT 模式
IPV6_MODE=snat bash <(curl -fsSL https://github.com/narwhal-cloud/runman-agent/releases/latest/download/install.sh)

# 强制使用子网模式并指定 IP 和子网
IPV6_MODE=subnet IPV6_ADDR=2001:db8::1 IPV6_SUBNET=2001:db8::/64 bash <(curl -fsSL https://github.com/narwhal-cloud/runman-agent/releases/latest/download/install.sh)

安装内容

组件	路径
Agent 二进制	/opt/narwhal-agent/narwhal-agent
配置文件	/opt/narwhal-agent/config.json
Agent 数据库	/opt/narwhal-agent/agent.db
数据目录	/var/lib/narwhal-agent
Podman 数据盘	/xfs_disk.img → 挂载至 /data
Systemd 服务	narwhal-agent.service
rfw 防火墙（可选）	/opt/narwhal-agent/rfw + rfw.service

Web 管理面板：http://<服务器IP>:8792

第三步 — 绑定 Token

安装完成后，终端会显示服务器 IP 和面板地址：

[2026-01-01 00:00:00] ========================================
[2026-01-01 00:00:00] ✓ NarwhalCloud Agent 安装完成！
[2026-01-01 00:00:00] IP:           1.2.3.4
[2026-01-01 00:00:00] 面板地址:     http://1.2.3.4:8792
[2026-01-01 00:00:00] 下一步：登录面板并在设置中填入您的 Token
[2026-01-01 00:00:00] ========================================

1. 在浏览器中打开 http://<服务器IP>:8792
2. 登录管理面板
3. 进入设置页面，将 NarwhalCloud 控制台中的母鸡 Token 粘贴并保存

更新 Agent

在已安装的服务器上重新执行同一命令，脚本会自动检测到已有安装并执行就地更新（Agent + netavark + rfw 同步更新）：

bash <(curl -fsSL https://github.com/narwhal-cloud/runman-agent/releases/latest/download/install.sh)

服务管理

# 查看 Agent 状态
systemctl status narwhal-agent

# 实时查看日志
journalctl -u narwhal-agent -f

# 重启 Agent
systemctl restart narwhal-agent

# 查看 rfw 防火墙状态
systemctl status rfw

# 重置面板密码（需重启生效）
/opt/narwhal-agent/narwhal-agent -reset-password 新密码
systemctl restart narwhal-agent

关键配置字段

/opt/narwhal-agent/config.json：

字段	说明
token	母鸡 Token（安装完成后填入）
web	面板监听地址（默认 :8792）
virt_type	podman / cloudhv / incus
monitor_nic	用于流量统计的网卡名（留空自动检测）
ipv6_mode	none / snat / subnet
max_port_forward	每个容器的最大端口转发规则数（默认 20）

常见问题排查

Agent 启动失败

journalctl -u narwhal-agent --no-pager -n 50

rfw 启动失败 部分云厂商网卡不支持 eBPF。可以尝试在 rfw 服务启动参数中添加 --xdp_mode skb。

Podman 数据盘未挂载

mount -o defaults,pquota,loop,noatime /xfs_disk.img /data
systemctl restart narwhal-agent

KVM 不可用（cloud-hypervisor 模式） 在宿主机管理界面开启嵌套虚拟化，或改用 Podman 模式。

软件包安装失败 脚本会自动重试 3 次并清理 dpkg 锁。若仍失败，手动执行 apt-get update 后再试。