服务支持
部署文档
快速部署（10 步）
bash
# 1. 安装 Debian 13（最小安装即可）
# 2. 获取项目
git clone https://gitee.com/gitdogcat/nas.git ~/soft/nas
# 3. 配置密码
cp ~/soft/nas/.env.example ~/soft/nas/.env
# 编辑 .env 填入密码（至少12位）
# 4. 执行部署
sudo bash ~/soft/nas/scripts/setup.sh
# 5. 访问面板
# 浏览器打开 http://<NAS IP>:8090setup.sh 会自动完成：
- 系统更新 + 工具安装
- Samba/NFS/FTP/WebDAV 服务配置
- 防火墙规则 + Fail2ban
- nas-panel 二进制下载 + systemd 服务
- FileBrowser 安装
- rclone 下载
- 监控脚本 + cron
- 备份脚本 + cron
- 配置自检
手动编译面板
bash
cd ~/soft/nas/web
export GOPROXY=https://goproxy.cn,direct
go build -o nas-panel .
# 产物约 11MB，放到 /usr/local/bin/nas-panel部署到已运行的 NAS
已有数据的机器无需重装，直接部署 Z1 面板：
bash
git clone https://gitee.com/gitdogcat/nas.git ~/soft/nas
cp ~/soft/nas/.env.example ~/soft/nas/.env
# 编辑 .env
# 只部署面板（不影响现有服务）
cd ~/soft/nas/web
export GOPROXY=https://goproxy.cn,direct
go build -o nas-panel .
sudo cp nas-panel /usr/local/bin/
sudo systemctl enable nas-panel常见问题
面板打不开
- 检查服务：
sudo systemctl status nas-panel - 检查端口：
sudo ss -tlnp | grep 8090 - 检查防火墙：
sudo ufw status（需要放行 8090） - 查看日志：
sudo journalctl -u nas-panel -f
Samba 连接失败
- 确认服务运行：
sudo systemctl status smbd - 确认用户存在：
sudo smbpasswd -L -v <username> - 确认防火墙放行 139/445 端口
- Windows:
\\NAS_IP\共享名，Mac:smb://NAS_IP
忘记面板密码
bash
# 查看当前密码
grep NAS_PASS ~/soft/nas/.env
# 修改密码
sudo nano ~/soft/nas/.env
# 改 NAS_PASS 行
sudo systemctl restart nas-panel磁盘未显示
- 确认系统识别：
lsblk - 确认 SMART 可读：
sudo smartctl -a /dev/sdX - 面板刷新：存储管理页 → 刷新按钮
- LVM 成员盘不显示：确认
sudo pvs输出正常
RAID 同步进度
bash
# 查看同步状态
cat /proc/mdstat
# 或通过面板
# 存储管理 → 存储池 → RAID 状态会显示同步百分比技术支持
| 渠道 | 地址 | 适用场景 |
|---|---|---|
| Gitee Issues | https://gitee.com/gitdogcat/nas/issues | Bug 报告、功能建议 |
| 邮件 | - | 商务合作 |
| 社区文档 | 见下方链接 | 自助排查 |
开发者文档
| 文档 | 内容 |
|---|---|
| Architecture v1.0 | 架构宪法，二十条建议评审结论 |
| 产品手册 | 完整部署/使用文档 |
| CHANGELOG | 版本变更日志 |
| TODO | 优化路线图 |
| CONTRIBUTING.md | 贡献者指南 |
| DEVELOPMENT.md | 团队开发手册 |
| HARDWARE_SPEC.md | 硬件规格定义 |
| PURCHASE_LIST.md | 采购清单 |
服务端口一览
| 端口 | 服务 | 说明 |
|---|---|---|
| 22 | SSH | 远程管理 |
| 21 | FTP | vsftpd |
| 80 | HTTP | 可选，反向代理 |
| 139, 445 | Samba | 文件共享 |
| 137-138 | NetBIOS | 名称服务 |
| 2049 | NFS | Linux 文件共享 |
| 8080 | WebDAV | rclone serve webdav |
| 8081 | FileBrowser | Web 文件管理 |
| 9000 | S3 | rclone serve s3 |
| 8090 | Z1 Panel | 管理面板 |