软件下载
一行命令安装（推荐）
bash
# 默认安装（未设置 NAS_PASS 时使用出厂默认密码，首次登录面板强制修改）
curl -fsSL https://get.z1.sale/install.sh | sudo bash
# 或自定义密码（无人值守/CI）
# 注意：sudo 会清空环境变量，需用 `sudo env` 透传
curl -fsSL https://get.z1.sale/install.sh | sudo env NAS_PASS=mySecurePass123 bash安装脚本自动检测网络（国外 GitHub / 国内 Gitee），克隆仓库，设置密码，执行完整部署。约 5-10 分钟。安装完成后会打印登录地址、用户名和密码。
手动部署
bash
# 1. 克隆仓库（Gitee，或用下方 GitHub 镜像）
git clone https://gitee.com/gitdogcat/nas.git ~/soft/nas
# GitHub: git clone https://github.com/jackeyPeng/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.4.0-beta.19 | 2026-10-13 | Gitee Release | 面板内置文件管理器 M1-M3 全量落地（取代 FileBrowser）——浏览/zip 打包下载/预览/流式上传带进度条、新建/重命名/移动/复制/删除进回收站（默认配置删除也可在回收站页恢复），权限管理全套：属性对话框（八进制输入+符号位实时预览+预设）、批量改权限（串行进度+汇总）、用户页一键修复 home 权限；递归操作符号链接安全语义、mode 白名单拒 setuid/setgid/sticky、危险操作 type-to-confirm；新装默认不再安装 FileBrowser（--with-filebrowser 保留一版） |
| v1.4.0-beta.15 | 2026-09-24 | Gitee Release | 家用可用性优先——NFS 导出默认 no_root_squash,insecure（挂载即可写、NAT 后客户端可挂）、public 共享 guest ok（局域网免账号访问）、fail2ban 放宽（ban 10 分钟/10 次尝试）、S3 短用户名 access key 修复、审计日志全覆盖、rclone 同步实时进度 |
| v1.4.0-beta.14 | 2026-09-19 | Gitee Release | 在线升级加固——二进制原子替换、CLI 升级验签（SHA256 + ed25519）、升级后配置幂等迁移（setup.sh --config-only）、FileBrowser 版本单一事实源 |
| v1.4.0-beta.13 | 2026-09-19 | Gitee Release | NFS 导出对所有网段开放（* 替代本机网段检测）——跨网段/多网卡客户端不再被 mountd 拒绝 unmatched host |
| v1.4.0-beta.12 | 2026-09-18 | Gitee Release | 创建向导按已选磁盘实时预估容量（选目标后预览面板：各方案可用容量/安全性/注意事项）+ 登录页品牌 slogan |
| v1.4.0-beta.11 | 2026-09-18 | Gitee Release | 监控页「当前连接」卡片（SMB 会话 + 各协议端口归类）+ 回收站改 per-share .recycle/（删除=rename 零拷贝、恢复保留目录树、旧 #recycle 兼容）+ 存储页 tab 切换跳动修复 |
升级
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 中配置的用户名密码登录。