软件下载
一行命令安装（推荐）
bash
# 交互式（提示输入密码）
curl -fsSL https://get.z1.sale/install.sh | bash
# 或通过环境变量传入密码（无人值守/CI）
NAS_PASS=mySecurePass123 curl -fsSL https://get.z1.sale/install.sh | bash安装脚本自动检测网络（国外 GitHub / 国内 Gitee），克隆仓库，设置密码，执行完整部署。约 5-10 分钟。
手动部署
bash
# 1. 克隆仓库
git clone https://gitee.com/gitdogcat/nas.git ~/soft/nas
# 2. 配置密码
cp ~/soft/nas/.env.example ~/soft/nas/.env
# 编辑 .env 填入密码（至少12位）
# 3. 执行部署
sudo bash ~/soft/nas/scripts/setup.shsetup.sh 会自动下载 nas-panel 二进制，如果网络不通可以手动编译（见下方）。
部署时间约 5-10 分钟（取决于网络速度），完成后浏览器访问
http://<NAS IP>:8090。
系统要求
| 要求 | 最低 | 推荐 |
|---|---|---|
| 操作系统 | Debian 12+ | Debian 13 (trixie) |
| CPU | 2 核 | 4 核+ |
| 内存 | 2GB | 4GB+ |
| 磁盘 | 20GB | 数据盘单独 |
| 网络 | 千兆 | 2.5GbE |
| 架构 | x86_64 | x86_64 / ARM64 |
也支持树莓派 4/5、VM、Mini PC，安装方式完全相同。
nas-panel 二进制
setup.sh 自动从以下地址下载二进制：
| 文件 | 地址 | 说明 |
|---|---|---|
| nas-panel.latest | https://get.z1.sale/control/nas-panel.latest | 最新版二进制 (amd64) |
下载后放到 /usr/local/bin/nas-panel。
从源码编译
bash
cd ~/soft/nas/web
export GOPROXY=https://goproxy.cn,direct
go build -o nas-panel .
strip nas-panel # 11MB → 6.2MB内网环境必须设置 GOPROXY，默认代理被墙。 前端已 embed 进二进制，不需要 Node.js。
rclone（S3 + WebDAV 服务）
setup.sh 自动从以下地址下载安装：
| 文件 | 地址 |
|---|---|
| rclone-v1.74.4-linux-amd64.deb | https://get.z1.sale/minio/rclone-v1.74.4-linux-amd64.deb |
版本历史
| 版本 | 日期 | 下载 | 主要内容 |
|---|---|---|---|
| v1.3.0 | 2026-08-03 | Gitee Release | 存储四层模型重构 + Design System v2.0 + rclone 增强 + 防火墙重写 + Architecture v1.0 |
| v1.2.0 | 2026-07-13 | Gitee Release | 模块化重构 + 配置管理 + 备份恢复 + rclone S3 + 硬件产品定义 |
| v1.0.0 | 2026-07-08 | Gitee Release | 安全清洗 + 用户名通用化 |
升级
bash
# 方式一：重新拉代码 + 编译
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
# 方式二：下载预编译二进制
sudo wget -O /usr/local/bin/nas-panel https://get.z1.sale/control/nas-panel.latest
sudo systemctl restart nas-panel升级前会自动备份配置（setup.sh 集成）。 面板升级不影响存储数据和服务运行，只需重启面板进程。
验证安装
部署完成后，检查各服务状态：
bash
# 面板服务
sudo systemctl status nas-panel
# 文件共享服务
sudo systemctl status smbd nfs-server vsftpd
# 防火墙
sudo ufw status
# 监控
sudo systemctl status monitor.timer
# 全部服务一览
sudo systemctl list-units --type=service | grep -E "smbd|nfs|vsftpd|nas|fail2ban|filebrowser|monitor"浏览器访问 http://<NAS IP>:8090，使用 .env 中配置的用户名密码登录。