# sanguo_vnpy NAS 部署 - 前期准备清单

## ✅ 部署前检查清单

请确保以下项目都已准备就绪，才能实现真正的"零干预"部署！

---

## 🖥️ NAS 端准备

### 1. Container Manager (Docker) 已安装

- [ ] 打开群晖 DSM → 套件中心
- [ ] 搜索「Container Manager」或「Docker」
- [ ] 确认已**安装并启动**
- [ ] 打开 Container Manager，确认界面正常

**如果未安装**：在套件中心点击「安装」，等待安装完成后启动。

---

### 2. 存储空间充足

- [ ] 打开 File Station
- [ ] 查看 `volume1` 可用空间
- [ ] 确认可用空间 ≥ **50GB**（推荐 100GB+）
- [ ] stock 共享文件夹已存在（位于 `/volume1/stock`）

**如果空间不足**：
- 清理不必要的文件
- 或考虑添加/扩容硬盘

---

### 3. 内存配置足够

- [ ] 打开 DSM → 控制面板 → 信息中心 → 硬件
- [ ] 确认 NAS 内存 ≥ **4GB**（推荐 8GB+）
- [ ] 如果内存 < 8GB，建议先升级内存

**内存不足的影响**：Docker 容器运行会变慢，甚至可能被系统终止。

---

### 4. SSH 访问已启用

- [ ] 打开 DSM → 控制面板 → 终端机和 SNMP
- [ ] 勾选「启用 SSH 功能」
- [ ] 端口保持默认 `22`
- [ ] 点击「应用」

---

### 5. 网络配置正常

- [ ] NAS IP 地址：`192.168.2.154`（固定 IP，不要用 DHCP）
- [ ] Mac mini 和 NAS 在**同一局域网**
- [ ] 从 Mac mini 能 ping 通 NAS：
  ```bash
  ping -c 3 192.168.2.154
  ```

---

## 💻 Mac mini 端准备

### 1. NAS 挂载信息正确

确认以下信息无误：
- [ ] NAS IP：`192.168.2.154`
- [ ] 用户名：`cfdaily`
- [ ] 密码：`Ccf7561523`
- [ ] 共享文件夹：`stock`

**如果信息有变化**，请更新脚本顶部的配置。

---

### 2. 本地策略文件已准备（可选但推荐）

如果您有本地策略文件：
- [ ] 策略文件位于 `~/strategies/` 目录
- [ ] 或 `~/vnpy_project/` 目录
- [ ] 文件权限正常可读

脚本会自动复制这些文件到 NAS。

---

## 🔐 账号密码准备

### NAS SSH 登录账号

请确认您有 NAS 的管理员账号：
- [ ] 管理员用户名（通常是 `admin`）
- [ ] 管理员密码

**如果忘记密码**：在 NAS 登录页面点击「忘记密码」重置。

---

## 📋 快速验证命令

在开始部署前，在 Mac mini 终端运行以下命令验证：

```bash
# 1. 验证网络连通
ping -c 3 192.168.2.154

# 2. 验证 NAS 共享可访问
smbutil view //cfdaily:Ccf7561523@192.168.2.154

# 3. 验证 SSH 可登录（尝试连接一下）
ssh admin@192.168.2.154 echo "SSH连接成功"
```

如果以上都成功，说明准备就绪！🎉

---

## ⚠️ 常见问题提前排查

### Q: Container Manager 启动失败怎么办？
A: 
1. 重启 NAS
2. 卸载并重新安装 Container Manager
3. 确认 DSM 版本 ≥ 7.0

### Q: NAS 存储空间不够怎么办？
A:
1. 清理旧文件和快照
2. 添加新硬盘扩容
3. 使用外接存储设备

### Q: SSH 连接被拒绝怎么办？
A:
1. 确认 SSH 已在 DSM 启用
2. 检查群晖防火墙是否阻止
3. 确认用户名密码正确

---

## ✅ 最终确认

部署前最后确认：

- [ ] NAS Container Manager 已安装并运行
- [ ] NAS 可用空间 ≥ 50GB
- [ ] NAS 内存 ≥ 4GB
- [ ] SSH 已启用
- [ ] Mac mini 能 ping 通 NAS
- [ ] 有 NAS 管理员账号密码
- [ ] 已阅读本文档并理解各项要求

**如果全部打勾，恭喜！可以开始零干预部署了！** 🚀

---

**准备清单版本**: 1.0  
**最后更新**: 2026年3月27日
