Download

One-Line Install (Recommended)

# Default install (factory password when NAS_PASS is unset; forced change on first panel login)
curl -fsSL https://get.z1.sale/install.sh | sudo bash

# Or with custom password (unattended/CI)
# NOTE: sudo clears env vars, so NAS_PASS must be passed via `sudo env`
curl -fsSL https://get.z1.sale/install.sh | sudo env NAS_PASS=mySecurePass123 bash

The installer downloads from the nearest mirror (Gitee for China, GitHub for international). It auto-detects your system, switches to a fast apt mirror if needed, and deploys all 9 services with progress tracking. After installation, it runs a 46-item system registry check to verify everything is working, then prints the login URL, username and password on screen. Takes ~5-10 minutes.

Manual Deploy

# 1. Clone repo (Gitee, or GitHub mirror below)
git clone https://gitee.com/gitdogcat/nas.git ~/soft/nas
# GitHub: git clone https://github.com/jackeyPeng/nas.git ~/soft/nas

# 2. Configure password
cp ~/soft/nas/.env.example ~/soft/nas/.env
# Edit .env, set password (min 12 chars)

# 3. Deploy
sudo bash ~/soft/nas/scripts/setup.sh

setup.sh auto-downloads the nas-panel binary. If network is unavailable, compile manually (see below).

Deployment takes ~5-10 minutes. Access at http://<NAS IP>:8090.

System Requirements

Requirement	Minimum	Recommended
OS	Debian 12+	Debian 13 (trixie)
CPU	2 cores	4 cores+
RAM	2GB	4GB+
Disk	20GB	Separate data disk
Network	Gigabit	2.5GbE
Arch	x86_64	x86_64 / ARM64

Also supports Raspberry Pi 4/5, VMs, Mini PCs — same install path.

nas-panel Binary

Auto-downloaded from:

File	URL	Description
nas-panel.latest	https://get.z1.sale/control/nas-panel.latest	Latest binary (amd64)

Place at /usr/local/bin/nas-panel.

Compile from Source

cd ~/soft/nas/web
export GOPROXY=https://goproxy.cn,direct
go build -o nas-panel .
strip nas-panel   # 11MB → 6.2MB

GOPROXY is required in China (default proxy is blocked). Frontend is embedded — no Node.js needed.

Version History

Version	Date	Download	Highlights
v1.4.0-beta.19	2026-10-13	Release	Built-in file manager M1-M3 complete (replaces FileBrowser) — browse / zip download / preview / streaming upload with progress bar, mkdir/rename/move/copy/delete-to-recycle-bin (default-config deletions restorable from the Recycle Bin page), full permission management: properties dialog (octal input + live symbolic preview + presets), batch chmod with serial progress, one-click fix-home-perms on Users page; symlink-safe recursion, mode whitelist rejects setuid/setgid/sticky, type-to-confirm for dangerous ops; new installs no longer ship FileBrowser (--with-filebrowser kept for one cycle)
v1.4.0-beta.15	2026-09-24	Release	Home-usability first — NFS exports default to no_root_squash,insecure (mount-and-write, NAT'd clients no longer rejected), public share guest ok (account-free LAN access), relaxed fail2ban (10-min ban / 10 retries), S3 access key fix for short usernames, full audit-log coverage, real-time rclone sync progress
v1.4.0-beta.14	2026-09-19	Release	Online upgrade hardening — atomic binary replacement, signature verification (SHA256 + ed25519) for CLI upgrades, idempotent config migration after upgrade (setup.sh --config-only), single source of truth for FileBrowser version
v1.4.0-beta.13	2026-09-19	Release	NFS exports now open to all networks (* instead of local-subnet detection) — cross-subnet / multi-NIC clients are no longer rejected by mountd as unmatched host
v1.4.0-beta.12	2026-09-18	Release	Storage creation wizard now previews usable capacity per selected disks (goal-step preview panel with capacity/safety/notes per plan) + login page brand slogan
v1.4.0-beta.11	2026-09-18	Release	Active Connections card on Monitor page (SMB sessions via smbstatus + per-protocol port mapping) + per-share recycle bin (.recycle/<user>/, delete=rename zero-copy, restore keeps directory tree, legacy #recycle compatible) + storage tab-switch layout jump fix

Upgrade

# Method 1: Pull + compile
cd ~/soft/nas && git pull
cd web && export GOPROXY=https://goproxy.cn,direct && go build -o nas-panel .
sudo cp nas-panel /usr/local/bin/ && sudo systemctl restart nas-panel

# Method 2: Download pre-built binary
sudo wget -O /usr/local/bin/nas-panel https://get.z1.sale/control/nas-panel.latest
sudo systemctl restart nas-panel

Config is auto-backed up before upgrade. Panel upgrade doesn't affect storage data or running services.

Verify Installation

# Panel service
sudo systemctl status nas-panel

# File sharing
sudo systemctl status smbd nfs-server vsftpd

# Firewall
sudo ufw status

# All services
sudo systemctl list-units --type=service | grep -E "smbd|nfs|vsftpd|nas|fail2ban|filebrowser|monitor"

Browser: http://<NAS IP>:8090, login with credentials from .env.