qnap-zfs-rescue

Recover data from corrupted QNAP QuTS Hero ZFS pools via read-only QEMU VM.

118|23|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/st771207/qnap-zfs-rescue --skill qnap-zfs-rescue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qnap-zfs-rescue
Source: https://github.com/st771207/qnap-zfs-rescue/tree/main
Command: npx skills add https://github.com/st771207/qnap-zfs-rescue --skill qnap-zfs-rescue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Rescue data from QNAP QuTS Hero ZFS pools when metadata is corrupted and standard OpenZFS tooling cannot read the modified QZFS structures, enabling data recovery without risking live disks.

Core Features & Use Cases

  • End-to-end rescue workflow for ZFS-8000-72 scenarios, including diagnosing QZFS, extracting native tools from a running NAS, and using QEMU to mount the pool with QNAP drivers in a read-only VM.
  • Tool extraction & VM-based recovery to access dataset metadata and transfer data to a network share.
  • Safety-first data transfer via read-only imports to prevent further damage during recovery.

Quick Start

Boot a QEMU VM with QNAP’s kernel and ZFS drivers, import the pool read-only, and copy the recovered data to your network storage.

Frequently Asked Questions about qnap-zfs-rescue

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I rescue a QNAP QuTS Hero ZFS pool that reports FAULTED with all disks ONLINE?

To rescue a QNAP QuTS Hero ZFS pool showing FAULTED with all disks ONLINE (ZFS-8000-72), you must bypass standard OpenZFS tooling and use native QNAP VM tooling to mount the modified QZFS structures in read-only mode.

Why does zpool import fail on my QNAP QuTS Hero ZFS pool?

Standard zpool import fails on QNAP QuTS Hero ZFS pools because they use modified QZFS metadata structures that standard OpenZFS tooling cannot read, requiring native QNAP kernel and ZFS drivers to diagnose and access the data.

What is the best way to recover data from a corrupted QZFS pool without risking the disks?

The best way to recover data safely from a corrupted QZFS pool is booting a QEMU VM with native QNAP drivers to import the pool read-only, then transferring the recovered data to a network share to prevent further damage.

Can I use standard OpenZFS tools to import a QNAP QuTS Hero ZFS pool?

You cannot use standard OpenZFS tools to import a QNAP QuTS Hero ZFS pool when metadata is corrupted because the modified QZFS structures are incompatible, requiring a VM with extracted native QNAP tools instead.

How do I extract native QNAP tools for ZFS pool recovery?

To extract native QNAP tools for ZFS pool recovery, you must pull the required kernel and ZFS drivers from a running NAS, then use them to boot a QEMU VM capable of reading the proprietary QZFS structures.

What are the limitations of using a VM for QNAP ZFS rescue?

The primary limitation of using a VM for QNAP ZFS rescue is that the recovery process is strictly read-only to prevent further damage, meaning you can only extract and transfer data rather than repair the corrupted pool metadata directly.