nas-master
afajohn tarafından
Self-Hosted & AutomationÖzet
A hardware-aware, hybrid (SMB + SSH) suite for ASUSTOR NAS metadata.
Açıklama
Bu Beceri Ne Yapar
A hybrid SMB and SSH scraping suite for ASUSTOR NAS devices that indexes files, captures metadata, and extracts system-level data like RAID status and Btrfs integrity. Enforces strict read-only access and CPU throttling tuned for i3-10th Gen hardware. Results are written to a MySQL database and surfaced through a PHP/AJAX dashboard via XAMPP.
Combines SMB file crawling with SSH system access in a single automated pipeline, with built-in hardware throttling and scan-resume support that generic scraping scripts lack.
Ne Zaman Kullanılır
- Building a searchable inventory of all files across NAS volumes
- Auditing Windows ACLs and Linux permissions on an ASUSTOR NAS
- Checking RAID health and Btrfs scrub status without manual SSH
- Running background NAS scans without degrading desktop performance
- Generating a local web dashboard to browse and filter scraped NAS data
Örnek İş Akışı
User asks: Scan all my NAS volumes and build a searchable file dashboard
- 1
Connects to NAS volumes via SMB using NAS_USER and NAS_PASS credentials
- 2
Recursively scans every folder with pathlib generators, capturing name, path, size, extension, and ACLs
- 3
Opens SSH session to extract RAID levels from /proc/mdstat and Btrfs scrub status
- 4
Writes all records to MySQL with INSERT IGNORE to safely resume interrupted scans
- 5
Generates a PHP/AJAX dashboard in C:\xampp\htdocs\nas_explorer\
Searchable NAS file explorer at localhost/nas_explorer with full metadata, permissions, and system health data
Gereksinimler
- ASUSTOR NAS device with ADM
- XAMPP installed (provides PHP, MySQL, and Apache for the dashboard)
- Environment variables: NAS_VOLUMES, NAS_USER, NAS_PASS, NAS_SSH_HOST, NAS_SSH_USER, NAS_SSH_PASS, DB_PASS
Kurulum
clawhub install afajohn/nas-masterCLI komutunu çalıştırın ya da istemi Claude Code, Cursor, Codex veya kullandığınız kodlama ajanına yapıştırın.