Download

One-Line Install (Recommended)

# Interactive (prompts for password)
wget -qO- https://gitee.com/gitdogcat/nas/raw/master/scripts/install.sh | sudo bash

# Or with password pre-set (unattended/CI)
NAS_PASS=mySecurePass123 wget -qO- https://gitee.com/gitdogcat/nas/raw/master/scripts/install.sh | sudo bash

The installer uses wget (built into Debian) and downloads from Gitee (accessible worldwide). 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. Takes ~5-10 minutes.

Manual Deploy

# 1. Clone repo
git clone https://gitee.com/gitdogcat/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.3.0	2026-08-03	Release	4-layer storage model + Design System v2.0 + rclone enhancements + firewall rewrite + Architecture v1.0
v1.2.0	2026-07-13	Release	Modular refactor + config management + backup/restore + rclone S3 + hardware definition
v1.0.0	2026-07-08	Release	Security cleanup + username generalization

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.