wsl2 挂载NAS网盘指南 + transcode music 文档

knowledgebase/WSL2 Ubuntu 中挂载 NAS 网盘完全指南.md

@@ -0,0 +1,265 @@
+#wsl #ubuntu #nas #mount 
+## 背景
+
+- **环境**: Windows 11 + WSL2 (Ubuntu 24)
+- **硬件**: Lenovo ThinkBook 16, Synology DS718 NAS
+- **目标**: 在 Ubuntu 中访问 NAS 上的 `/volume1/music` 共享文件夹
+- **Windows 路径**: `\\192.168.3.17\music`
+
+## 踩过的坑
+
+### 1. CIFS 方案失败 ❌
+
+#### 尝试方法
+
+```bash
+sudo apt install cifs-utils
+sudo mkdir -p /mnt/nas-music
+sudo mount -t cifs //192.168.3.17/music /mnt/nas-music -o username=shenwei,password=your_password
+```
+
+#### 错误信息
+
+```
+mount error(95): Operation not supported
+```
+
+#### 原因分析
+
+- 虽然内核支持 CIFS (`grep -i cifs /proc/filesystems` 有输出)
+- 但 WSL2 内核被配置为禁止旧 SMB 版本
+- dmesg 显示: `vers=2.0 mount not permitted when legacy dialects disabled`
+- Synology NAS 只支持 SMB 2.0 及更低版本，与 WSL2 不兼容
+
+#### 相关错误日志
+
+```
+CIFS: VFS: \\192.168.3.17 Dialect not supported by server
+CIFS: VFS: vers=2.0 mount not permitted when legacy dialects disabled
+```
+
+### 2. SSHFS 方案问题 ⚠️
+
+#### 尝试方法
+
+```bash
+sudo apt install sshfs
+sudo sshfs shenwei@192.168.3.17:/volume1/music /mnt/nas-music -o allow_other
+```
+
+#### 错误信息
+
+```
+read: Connection reset by peer
+```
+
+#### 原因
+
+可能是 Synology SSH 配置的限制或 sshfs 参数兼容性问题
+
+#### 建议
+
+如果 SSH 能连接但 sshfs 有问题，可尝试:
+
+- 用密钥认证而不是密码
+- 调整参数: `-o reconnect,ServerAliveInterval=15`
+- 但不如直接用 drvfs 稳定
+
+---
+
+## ✅ 最终成功方案：在 Windows 挂载后，WSL2 中访问
+
+### 第 1 步：在 Windows 中挂载 NAS（已完成）
+
+PowerShell (管理员):
+
+```powershell
+net use Z: \\192.168.3.17\music /user:shenwei your_password
+```
+
+验证:
+
+```powershell
+dir Z:\
+```
+
+### 第 2 步：在 WSL2 Ubuntu 中挂载 Windows 驱动器
+
+创建挂载点:
+
+```bash
+sudo mkdir -p /mnt/z
+```
+
+挂载 Z: 驱动器:
+
+```bash
+sudo mount -t drvfs Z: /mnt/z
+```
+
+验证:
+
+```bash
+ls /mnt/z/test
+```
+
+输出示例:
+
+```
+20260815
+@eaDir
+albums
+new
+test
+另外处理
+张国荣音乐合集1978-2007 140CD FLAC
+英文经典
+```
+
+### 第 3 步：永久自动挂载（可选）
+
+编辑 `/etc/fstab`:
+
+```bash
+sudo nano /etc/fstab
+```
+
+在末尾添加:
+
+```
+Z: /mnt/z drvfs defaults 0 0
+```
+
+保存 (Ctrl+O → Enter → Ctrl+X)
+
+测试:
+
+```bash
+sudo mount -a
+```
+
+以后每次启动 WSL2，Z: 驱动器会自动挂载到 `/mnt/z`
+
+---
+
+## 使用示例
+
+### 在 Python 中访问 NAS 文件
+
+```python
+import os
+from pathlib import Path
+
+# NAS 路径
+nas_music_path = Path("/mnt/z")
+
+# 列出所有目录
+for item in nas_music_path.iterdir():
+    print(item.name)
+
+# 处理音乐文件
+for flac_file in nas_music_path.glob("**/*.flac"):
+    print(f"处理: {flac_file}")
+```
+
+### 在 Bash 中访问 NAS 文件
+
+```bash
+# 列出文件
+ls /mnt/z/albums
+
+# 复制文件
+cp /mnt/z/albums/artist/album.flac /home/user/music/
+
+# 批量处理
+for file in /mnt/z/**/*.flac; do
+    echo "处理: $file"
+done
+```
+
+### 在 Docker 容器中使用
+
+在 `docker-compose.yml` 中挂载:
+
+```yaml
+volumes:
+  - /mnt/z:/nas-music:ro
+```
+
+容器内访问:
+
+```bash
+ls /nas-music/albums
+```
+
+---
+
+## 性能和稳定性对比
+
+|方案|稳定性|性能|易用性|备注|
+|---|---|---|---|---|
+|CIFS|❌|-|-|WSL2 不支持低版本 SMB|
+|SSHFS|⚠️|中|中|可能有兼容性问题|
+|**drvfs**|✅|快|✅|**推荐方案**|
+
+---
+
+## 故障排查
+
+### 问题 1: 挂载点不存在
+
+```bash
+# 解决
+sudo mkdir -p /mnt/z
+```
+
+### 问题 2: 权限不足
+
+```bash
+# 加 sudo
+sudo mount -t drvfs Z: /mnt/z
+```
+
+### 问题 3: Z: 驱动器在 Windows 中不可用
+
+```powershell
+# Windows PowerShell (管理员) 中重新挂载
+net use Z: \\192.168.3.17\music /user:shenwei your_password
+```
+
+### 问题 4: WSL2 中 Z: 驱动器挂载失败
+
+```bash
+# 查看 dmesg 日志
+sudo dmesg | tail -20
+
+# 尝试卸载后重新挂载
+sudo umount /mnt/z
+sudo mount -t drvfs Z: /mnt/z
+```
+
+---
+
+## 总结
+
+**最简单和最稳定的方案**:
+
+1. **Windows 中**: `net use Z: \\192.168.3.17\music`
+2. **WSL2 中**: `sudo mount -t drvfs Z: /mnt/z`
+3. **Ubuntu 中访问**: `/mnt/z/test`
+
+不需要配置复杂的 CIFS 或 SSHFS，直接利用 Windows 已有的网络共享，通过 WSL2 的 drvfs 驱动访问，**稳定、快速、可靠**。
+
+---
+
+## 相关文件路径
+
+- Windows 网络路径: `\\192.168.3.17\music`
+- Windows 驱动器: `Z:\`
+- WSL2 挂载点: `/mnt/z`
+- 音乐文件实际位置: `/mnt/z/albums/...`
+
+---
+
+**更新时间**: 2026-08-16  
+**验证环境**: WSL2 Ubuntu 24, Synology DS718