Mac Mini 上NAS挂载配置指南
This commit is contained in:
@@ -92,6 +92,13 @@ python3 transcode_music.py /mnt/d/music/ /mnt/x/music/20260823
|
|||||||
python3 transcode_music.py /mnt/z/我的音乐 /mnt/x/mp3输出
|
python3 transcode_music.py /mnt/z/我的音乐 /mnt/x/mp3输出
|
||||||
```
|
```
|
||||||
|
|
||||||
|
``` shell
|
||||||
|
# 4. Macmini上的命令路径(NAS上 /volume2/navidrome已经成功mount)：
|
||||||
|
python3 transcode_music.py ~/MyMusic ~/mnt/volume2/navidrome/music/20260823
|
||||||
|
|
||||||
|
```
|
||||||
|
[[Mac Mini NAS 挂载配置指南]]
|
||||||
|
|
||||||
就这么简单。下面是完整的参数说明和更多用法。
|
就这么简单。下面是完整的参数说明和更多用法。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|||||||
341
knowledgebase/Mac Mini NAS 挂载配置指南.md
Normal file
341
knowledgebase/Mac Mini NAS 挂载配置指南.md
Normal file
@@ -0,0 +1,341 @@
|
|||||||
|
#mac-min #nas #mount #Configuration
|
||||||
|
|
||||||
|
## 快速概览
|
||||||
|
|
||||||
|
- **NAS IP**: `192.168.3.17`
|
||||||
|
- **用户**: `shenwei`
|
||||||
|
- **NAS 路径**：
|
||||||
|
- Volume1: `//shenwei@192.168.3.17/[share_name]`
|
||||||
|
- Volume2: `//shenwei@192.168.3.17/[share_name]`
|
||||||
|
- **本地挂载基路径**: `~/mnt/volume1/` 和 `~/mnt/volume2/`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 一、脚本位置和自启动配置
|
||||||
|
|
||||||
|
### 关键文件位置
|
||||||
|
|
||||||
|
|文件|路径|说明|
|
||||||
|
|---|---|---|
|
||||||
|
|挂载脚本|`~/Library/LaunchAgents/nas-mounts.sh`|执行具体挂载命令的 Shell 脚本|
|
||||||
|
|LaunchAgent 配置|`~/Library/LaunchAgents/com.nas-mounts.plist`|系统自启动配置|
|
||||||
|
|挂载日志|`~/.nas-mounts.log`|挂载执行日志，用于问题诊断|
|
||||||
|
|
||||||
|
### 查看当前挂载状态
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 查看所有 NAS 挂载
|
||||||
|
mount | grep mnt/volume
|
||||||
|
|
||||||
|
# 或用 df 查看更清晰的统计
|
||||||
|
df -h | grep volume
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 二、nas-mounts.sh 脚本内容
|
||||||
|
|
||||||
|
### 脚本位置
|
||||||
|
|
||||||
|
```
|
||||||
|
~/Library/LaunchAgents/nas-mounts.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
### 完整脚本内容
|
||||||
|
|
||||||
|
```bash
|
||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
NAS_USER="shenwei"
|
||||||
|
NAS_PASS="zmkm99zmkm00"
|
||||||
|
NAS_HOST="192.168.3.17"
|
||||||
|
|
||||||
|
# 日志文件
|
||||||
|
LOG_FILE="$HOME/.nas-mounts.log"
|
||||||
|
echo "=== NAS Mount Start $(date) ===" >> "$LOG_FILE"
|
||||||
|
|
||||||
|
# 函数：安全挂载
|
||||||
|
mount_share() {
|
||||||
|
local share=$1
|
||||||
|
local mount_point=$2
|
||||||
|
|
||||||
|
# 创建挂载点
|
||||||
|
mkdir -p "$mount_point"
|
||||||
|
|
||||||
|
# 检查是否已经挂载
|
||||||
|
if mount | grep -q "$mount_point"; then
|
||||||
|
echo "✓ Already mounted: $share" | tee -a "$LOG_FILE"
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
|
||||||
|
# 如果目录非空，尝试卸载再删除
|
||||||
|
if [ -n "$(ls -A "$mount_point" 2>/dev/null)" ]; then
|
||||||
|
echo "Cleaning up $mount_point..." >> "$LOG_FILE"
|
||||||
|
umount -f "$mount_point" 2>/dev/null
|
||||||
|
rm -rf "$mount_point"
|
||||||
|
mkdir -p "$mount_point"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# 尝试挂载
|
||||||
|
echo "Mounting $share to $mount_point..." >> "$LOG_FILE"
|
||||||
|
if mount_smbfs -o nosuid,nodev "//${NAS_USER}:${NAS_PASS}@${NAS_HOST}/$share" "$mount_point" 2>> "$LOG_FILE"; then
|
||||||
|
echo "✓ Successfully mounted: $share" | tee -a "$LOG_FILE"
|
||||||
|
else
|
||||||
|
echo "✗ FAILED to mount: $share" | tee -a "$LOG_FILE"
|
||||||
|
return 1
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# Volume1 mounts
|
||||||
|
mount_share "photo" "$HOME/mnt/volume1/photo"
|
||||||
|
mount_share "video" "$HOME/mnt/volume1/video"
|
||||||
|
mount_share "openclaw" "$HOME/mnt/volume1/openclaw"
|
||||||
|
mount_share "obsidian" "$HOME/mnt/volume1/obsidian"
|
||||||
|
mount_share "download" "$HOME/mnt/volume1/download"
|
||||||
|
mount_share "software" "$HOME/mnt/volume1/software"
|
||||||
|
mount_share "music" "$HOME/mnt/volume1/music"
|
||||||
|
mount_share "Shen%20Wei" "$HOME/mnt/volume1/home"
|
||||||
|
mount_share "homes" "$HOME/mnt/volume1/homes"
|
||||||
|
mount_share "docker" "$HOME/mnt/volume1/docker"
|
||||||
|
|
||||||
|
# Volume2 mounts
|
||||||
|
mount_share "work" "$HOME/mnt/volume2/work"
|
||||||
|
mount_share "knowledgebase" "$HOME/mnt/volume2/knowledgebase"
|
||||||
|
mount_share "backup" "$HOME/mnt/volume2/backup"
|
||||||
|
mount_share "gitea-share" "$HOME/mnt/volume2/gitea-share"
|
||||||
|
mount_share "system" "$HOME/mnt/volume2/system"
|
||||||
|
mount_share "navidrome" "$HOME/mnt/volume2/navidrome"
|
||||||
|
|
||||||
|
echo "=== NAS Mount End $(date) ===" >> "$LOG_FILE"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 三、com.nas-mounts.plist 自启动配置
|
||||||
|
|
||||||
|
### 文件位置
|
||||||
|
|
||||||
|
```
|
||||||
|
~/Library/LaunchAgents/com.nas-mounts.plist
|
||||||
|
```
|
||||||
|
|
||||||
|
### 配置内容
|
||||||
|
|
||||||
|
```xml
|
||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
|
||||||
|
<plist version="1.0">
|
||||||
|
<dict>
|
||||||
|
<key>Label</key>
|
||||||
|
<string>com.nas-mounts</string>
|
||||||
|
<key>ProgramArguments</key>
|
||||||
|
<array>
|
||||||
|
<string>/Users/weishen/Library/LaunchAgents/nas-mounts.sh</string>
|
||||||
|
</array>
|
||||||
|
<key>RunAtLoad</key>
|
||||||
|
<true/>
|
||||||
|
<key>KeepAlive</key>
|
||||||
|
<false/>
|
||||||
|
</dict>
|
||||||
|
</plist>
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 四、常见操作
|
||||||
|
|
||||||
|
### 1. 手动执行挂载脚本
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 确保脚本有执行权限
|
||||||
|
chmod +x ~/Library/LaunchAgents/nas-mounts.sh
|
||||||
|
|
||||||
|
# 直接运行脚本
|
||||||
|
~/Library/LaunchAgents/nas-mounts.sh
|
||||||
|
|
||||||
|
# 查看执行结果日志
|
||||||
|
cat ~/.nas-mounts.log
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 重新加载自启动配置
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 卸载当前配置
|
||||||
|
launchctl unload ~/Library/LaunchAgents/com.nas-mounts.plist
|
||||||
|
|
||||||
|
# 重新加载配置（会立即执行挂载）
|
||||||
|
launchctl load ~/Library/LaunchAgents/com.nas-mounts.plist
|
||||||
|
|
||||||
|
# 查看状态
|
||||||
|
launchctl list | grep nas-mounts
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 卸载所有 NAS 挂载
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 卸载所有 volume1 和 volume2 的挂载
|
||||||
|
umount -f ~/mnt/volume1/* 2>/dev/null
|
||||||
|
umount -f ~/mnt/volume2/* 2>/dev/null
|
||||||
|
|
||||||
|
# 验证
|
||||||
|
mount | grep mnt/volume
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. 清理并重新挂载
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 完全清理目录
|
||||||
|
rm -rf ~/mnt/volume1 ~/mnt/volume2
|
||||||
|
|
||||||
|
# 重新创建目录（脚本会自动创建，或手动创建）
|
||||||
|
mkdir -p ~/mnt/volume1
|
||||||
|
mkdir -p ~/mnt/volume2
|
||||||
|
|
||||||
|
# 手动执行脚本
|
||||||
|
~/Library/LaunchAgents/nas-mounts.sh
|
||||||
|
|
||||||
|
# 验证
|
||||||
|
df -h | grep volume
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 五、增加新的共享目录
|
||||||
|
|
||||||
|
### 步骤 1：确认 NAS 上的共享名称
|
||||||
|
|
||||||
|
在 Synology DSM 上查看：
|
||||||
|
|
||||||
|
- 控制面板 → 共享文件夹 → 找到要共享的文件夹名称
|
||||||
|
- 例如：`new_share`
|
||||||
|
|
||||||
|
### 步骤 2：编辑 nas-mounts.sh 脚本
|
||||||
|
|
||||||
|
```bash
|
||||||
|
nano ~/Library/LaunchAgents/nas-mounts.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
### 步骤 3：添加新的 mount_share 调用
|
||||||
|
|
||||||
|
在对应的 Volume 部分添加一行。例如在 Volume2 部分添加：
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Volume2 mounts
|
||||||
|
# ... 现有的其他挂载 ...
|
||||||
|
mount_share "new_share" "$HOME/mnt/volume2/new_share" # ← 添加这一行
|
||||||
|
```
|
||||||
|
|
||||||
|
### 步骤 4：保存并测试
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 保存：Ctrl+O, Enter, Ctrl+X
|
||||||
|
|
||||||
|
# 测试执行
|
||||||
|
~/Library/LaunchAgents/nas-mounts.sh
|
||||||
|
|
||||||
|
# 查看日志确认成功
|
||||||
|
cat ~/.nas-mounts.log | grep new_share
|
||||||
|
|
||||||
|
# 验证挂载
|
||||||
|
df -h | grep new_share
|
||||||
|
```
|
||||||
|
|
||||||
|
### 步骤 5：重新加载 LaunchAgent
|
||||||
|
|
||||||
|
```bash
|
||||||
|
launchctl unload ~/Library/LaunchAgents/com.nas-mounts.plist
|
||||||
|
launchctl load ~/Library/LaunchAgents/com.nas-mounts.plist
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 六、问题诊断
|
||||||
|
|
||||||
|
### 挂载失败的常见原因
|
||||||
|
|
||||||
|
|错误|原因|解决方案|
|
||||||
|
|---|---|---|
|
||||||
|
|`No such file or directory`|NAS 上不存在该共享或权限不足|检查 NAS 的共享文件夹配置和权限|
|
||||||
|
|`File exists`|目录已挂载或目录非空|卸载旧挂载，删除目录后重试|
|
||||||
|
|`Permission denied`|用户无访问权限|在 NAS 的共享文件夹权限中添加用户访问权限|
|
||||||
|
|`Connection refused`|NAS 不响应或网络问题|检查 NAS IP 和网络连接|
|
||||||
|
|
||||||
|
### 快速诊断
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1. 查看所有 NAS 挂载
|
||||||
|
mount | grep mnt/volume
|
||||||
|
|
||||||
|
# 2. 查看挂载日志
|
||||||
|
cat ~/.nas-mounts.log
|
||||||
|
|
||||||
|
# 3. 测试 NAS 连接
|
||||||
|
ping 192.168.3.17
|
||||||
|
|
||||||
|
# 4. 列出 NAS 上所有可访问的共享
|
||||||
|
smbclient -L //192.168.3.17 -U shenwei -p zmkm99zmkm00
|
||||||
|
|
||||||
|
# 5. 手动尝试挂载单个共享
|
||||||
|
mount_smbfs "//shenwei:zmkm99zmkm00@192.168.3.17/share_name" ~/mnt/test
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 七、特殊情况处理
|
||||||
|
|
||||||
|
### 共享名称包含空格
|
||||||
|
|
||||||
|
如果共享名称是 `Shen Wei`，需要用 URL 编码 `%20`：
|
||||||
|
|
||||||
|
```bash
|
||||||
|
mount_share "Shen%20Wei" "$HOME/mnt/volume1/home"
|
||||||
|
```
|
||||||
|
|
||||||
|
### 同一共享挂载到多个位置冲突
|
||||||
|
|
||||||
|
如果发现某个共享已在 `/Volumes/` 下挂载：
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 查看已挂载位置
|
||||||
|
mount | grep share_name
|
||||||
|
|
||||||
|
# 卸载原位置
|
||||||
|
umount /Volumes/share_name
|
||||||
|
|
||||||
|
# 或创建符号链接而非重复挂载
|
||||||
|
ln -s /Volumes/share_name ~/mnt/volume2/share_name
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 八、快速参考命令
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 查看当前挂载
|
||||||
|
mount | grep mnt/volume
|
||||||
|
|
||||||
|
# 手动执行脚本
|
||||||
|
~/Library/LaunchAgents/nas-mounts.sh
|
||||||
|
|
||||||
|
# 查看日志
|
||||||
|
cat ~/.nas-mounts.log
|
||||||
|
|
||||||
|
# 卸载所有
|
||||||
|
umount -f ~/mnt/volume1/* ~/mnt/volume2/* 2>/dev/null
|
||||||
|
|
||||||
|
# 编辑脚本
|
||||||
|
nano ~/Library/LaunchAgents/nas-mounts.sh
|
||||||
|
|
||||||
|
# 编辑 LaunchAgent 配置
|
||||||
|
nano ~/Library/LaunchAgents/com.nas-mounts.plist
|
||||||
|
|
||||||
|
# 重新加载 LaunchAgent
|
||||||
|
launchctl unload ~/Library/LaunchAgents/com.nas-mounts.plist
|
||||||
|
launchctl load ~/Library/LaunchAgents/com.nas-mounts.plist
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 版本历史
|
||||||
|
|
||||||
|
- **v1.0** (2026-08-23)：完成初始配置，支持 Volume1 和 Volume2 多共享挂载，包含自启动和错误处理逻辑
|
||||||
Reference in New Issue
Block a user