# nas_ext

**Repository Path**: my_module/nas_ext

## Basic Information

- **Project Name**: nas_ext
- **Description**: window下nas辅助程序包
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-03
- **Last Updated**: 2026-05-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# nas_ext - NAS 模块外部依赖二进制仓库

存放 nas 模块在 **Windows 平台**所需的第三方二进制（不便走包管理器分发的部分），供项目根的安装脚本 `nas/scripts/install-deps.ps1` 直接取用。

> Linux 平台所有依赖均通过 apt/dnf/yum 在线安装，本仓库**仅服务 Windows**。

## 目录结构

```
nas_ext/
├── README.md
├── manifest.json                       # 各工具版本、来源、校验信息
└── windows/
    ├── rclone/
    │   └── rclone.exe                  # 来自官方 rclone-vX.YY.Z-windows-amd64.zip
    ├── winfsp/
    │   └── winfsp-X.Y.Z.msi            # WinFsp 安装包（必须 .msi）
    ├── par2/
    │   └── par2.exe                    # par2cmdline-turbo 编译产物
    └── smartctl/
        └── smartctl.exe                # smartmontools Windows 版
```

## 工具来源

| 工具 | 官方下载 | 用途 |
|------|---------|------|
| rclone | https://rclone.org/downloads/ | 网盘/网络磁盘挂载 |
| WinFsp | https://winfsp.dev/rel/ | rclone mount 的 Windows FUSE 实现 |
| par2cmdline-turbo | https://github.com/animetosho/par2cmdline-turbo/releases | 虚拟磁盘 PARITY 校验 |
| smartmontools | https://www.smartmontools.org/wiki/Download | SMART 健康监测 |

具体版本以 `manifest.json` 为准。

## 使用方式

`install-deps.ps1` 默认在项目根的同级目录寻找 `nas_ext/`：

```
项目父目录/
├── myAdmin/    # 你的 myAdmin / myBase 项目
└── nas_ext/    # 本仓库（与项目并列）
```

如未克隆，安装脚本会尝试 `git clone https://gitee.com/my_module/nas_ext.git ../nas_ext` 自动获取（可通过 `NAS_EXT_REPO` 环境变量覆盖默认地址）。

## 维护说明

- 二进制文件较大，建议使用 git LFS 管理；或仓库托管在国内镜像加速访问
- 升级版本时同步更新 `manifest.json` 的版本号与下载来源
- WinFsp 必须用官方 `.msi` 安装包（脚本通过 msiexec 安装），不能直接放 dll
- 如需新增工具，在 `windows/<tool>/` 下放置二进制，然后在 `manifest.json` 与 `install-deps.ps1` 中登记

## 二进制下载与放置（首次构建仓库时）

1. **rclone**：从官网下 `rclone-vX.YY.Z-windows-amd64.zip`，解压后将 `rclone.exe` 放到 `windows/rclone/`
2. **WinFsp**：从 https://winfsp.dev/rel/ 下最新 `.msi`，原样放到 `windows/winfsp/`
3. **par2cmdline-turbo**：从 GitHub Releases 下 `par2cmdline-turbo-vX.Y.Z-win-x64.zip`，解压后将 `par2.exe` 放到 `windows/par2/`
4. **smartctl**：从官网下 Windows 安装包并提取（或装一次后从 `C:\Program Files\smartmontools\bin\smartctl.exe` 拷出），放到 `windows/smartctl/`

完成后 `git add . && git commit -m "init: windows binaries" && git push`。