qnap-zfs-rescue

Community

Rescue QNAP ZFS pools using native VM tooling.

Authorst771207
Version1.0.0
Installs0

System Documentation

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.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: qnap-zfs-rescue
Download link: https://github.com/st771207/qnap-zfs-rescue/archive/main.zip#qnap-zfs-rescue

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.