# MarkBase 優化建議 (借鏡 Proxmox VE / Unraid / OpenNAS)

## 優化優先級排序

根據三個平台的比較分析，以下是 MarkBase 可以借鏡的功能，按影響力和實施難度排序：

---

## P0：立即實施（高影響 + 低難度）

### 1. NFS Support ⭐⭐⭐⭐⭐

**借鏡來源**：OpenNAS, Unraid

**當前問題**：
- MarkBase 缺少 NFS 支持
- Linux/Unix 客戶端依賴 SMB 或 SFTP

**實施方案**：
```rust
// NFSv4 Server Implementation
pub struct NfsServer {
    backend: Box<dyn VfsBackend>,
    exports: Vec<NfsExport>,
}

pub struct NfsExport {
    path: PathBuf,
    clients: Vec<String>,  // IP ranges
    options: NfsOptions,
}

impl NfsServer {
    pub async fn handle_nfs_request(&self, req: NfsRequest) -> Result<NfsResponse>;
}
```

**預估工作量**：~500 行（nfs_server.rs）
**預估時間**：2-3 天
**影響**：⭐⭐⭐⭐⭐（補足 Linux 客戶端需求）

---

### 2. Web UI User/Group 管理 ⭐⭐⭐⭐⭐

**借鏡來源**：OpenNAS, Unraid

**當前問題**：
- MarkBase 需要 CLI 或 SQLite 操作用戶
- 無 GUI 用戶管理界面

**實施方案**：
```vue
<!-- Users.vue -->
<template>
  <el-card>
    <template #header>
      <span>User Management</span>
      <el-button @click="showCreateDialog">Create User</el-button>
    </template>
    <el-table :data="users">
      <el-table-column prop="username" label="Username" />
      <el-table-column prop="home_dir" label="Home Directory" />
      <el-table-column label="Actions">
        <el-button @click="editUser">Edit</el-button>
        <el-button @click="deleteUser">Delete</el-button>
      </el-table-column>
    </el-table>
  </el-card>
</template>
```

**REST API**：
```
GET    /api/v2/users          - List users
POST   /api/v2/users          - Create user
PUT    /api/v2/users/:name    - Update user
DELETE /api/v2/users/:name    - Delete user
```

**預估工作量**：~300 行（Users.vue + REST API）
**預估時間**：1-2 天
**影響**：⭐⭐⭐⭐⭐（大幅提升易用性）

---

### 3. Web UI Share 管理 ⭐⭐⭐⭐

**借鏡來源**：Unraid, OpenNAS

**當前問題**：
- SMB shares 需要 CLI 配置
- 無 GUI share 管理界面

**實施方案**：
```vue
<!-- Shares.vue -->
<template>
  <el-card>
    <template #header>
      <span>Share Management</span>
      <el-button @click="showCreateDialog">Create Share</el-button>
    </template>
    <el-table :data="shares">
      <el-table-column prop="name" label="Share Name" />
      <el-table-column prop="path" label="Path" />
      <el-table-column prop="protocol" label="Protocol" />
      <el-table-column label="Actions">
        <el-button @click="editShare">Edit</el-button>
        <el-button @click="deleteShare">Delete</el-button>
      </el-table-column>
    </el-table>
  </el-card>
</template>
```

**預估工作量**：~400 行（Shares.vue + REST API）
**預估時間**：1-2 天
**影響**：⭐⭐⭐⭐⭐（補足 Web UI 完整性）

---

## P1：短期實施（高影響 + 中難度）

### 4. Dashboard 完整化 ⭐⭐⭐⭐⭐

**借鏡來源**：Proxmox VE Dashboard, Unraid Main page

**當前問題**：
- Backup.vue Dashboard 功能有限
- 缺少系統概覽（CPU/RAM/Disk）

**實施方案**：
```vue
<!-- Dashboard.vue -->
<template>
  <el-row :gutter="20">
    <el-col :span="6">
      <el-card>
        <el-statistic title="CPU Usage" :value="cpuUsage" suffix="%" />
        <el-progress :percentage="cpuUsage" />
      </el-card>
    </el-col>
    <el-col :span="6">
      <el-card>
        <el-statistic title="Memory Usage" :value="memUsage" suffix="%" />
        <el-progress :percentage="memUsage" />
      </el-card>
    </el-col>
    <el-col :span="6">
      <el-card>
        <el-statistic title="Storage Used" :value="storageUsed" suffix="%" />
        <el-progress :percentage="storageUsed" />
      </el-card>
    </el-col>
    <el-col :span="6">
      <el-card>
        <el-statistic title="Active Users" :value="activeUsers" />
      </el-card>
    </el-col>
  </el-row>
  
  <el-row :gutter="20" style="margin-top: 20px;">
    <el-col :span="12">
      <el-card>
        <template #header>Storage Pools</template>
        <el-table :data="storagePools">
          <el-table-column prop="name" label="Pool" />
          <el-table-column prop="type" label="Type" />
          <el-table-column prop="size" label="Size" />
          <el-table-column prop="used" label="Used" />
          <el-table-column prop="health" label="Health">
            <template #default="{ row }">
              <el-tag :type="row.health === 'healthy' ? 'success' : 'danger'">
                {{ row.health }}
              </el-tag>
            </template>
          </el-table-column>
        </el-table>
      </el-card>
    </el-col>
    <el-col :span="12">
      <el-card>
        <template #header>Recent Backups</template>
        <el-timeline>
          <el-timeline-item v-for="backup in recentBackups">
            {{ backup.name }} - {{ backup.time }}
          </el-timeline-item>
        </el-timeline>
      </el-card>
    </el-col>
  </el-row>
</template>
```

**REST API**：
```
GET /api/v2/dashboard/stats     - CPU/RAM/Disk usage
GET /api/v2/dashboard/pools     - Storage pools status
GET /api/v2/dashboard/backups   - Recent backups
GET /api/v2/dashboard/users     - Active users count
```

**預估工作量**：~500 行（Dashboard.vue + REST API）
**預估時間**：2-3 天
**影響**：⭐⭐⭐⭐⭐（專業 Dashboard 體驗）

---

### 5. SMART 硬盤監控 ⭐⭐⭐⭐

**借鏡來源**：Unraid, OpenNAS

**當前問題**：
- MarkBase 缺少硬盤健康監控
- 硬盤故障無預警

**實施方案**：
```rust
// smart_monitor.rs
pub struct SmartMonitor {
    disks: Vec<PathBuf>,
}

pub struct SmartStats {
    disk: String,
    temperature: u32,
    health_percent: u32,
    power_on_hours: u64,
    read_errors: u64,
    write_errors: u64,
}

impl SmartMonitor {
    pub fn check_disk(&self, disk: &Path) -> Result<SmartStats>;
    pub fn get_all_stats(&self) -> Result<Vec<SmartStats>>;
    pub fn is_healthy(&self, stats: &SmartStats) -> bool;
}
```

**Web UI**：
```vue
<!-- Disks.vue -->
<el-table :data="diskStats">
  <el-table-column prop="disk" label="Disk" />
  <el-table-column prop="temperature" label="Temperature" suffix="°C" />
  <el-table-column prop="health_percent" label="Health">
    <template #default="{ row }">
      <el-progress :percentage="row.health_percent" 
                   :color="row.health_percent > 80 ? '#67c23a' : '#f56c6c'" />
    </template>
  </el-table-column>
  <el-table-column prop="power_on_hours" label="Power On" suffix=" hours" />
</el-table>
```

**預估工作量**：~400 行（smart_monitor.rs + Disks.vue）
**預估時間**：2-3 天
**影響**：⭐⭐⭐⭐（硬盤健康預警）

---

### 6. Plugin/Template 系統 ⭐⭐⭐⭐⭐

**借鏡來源**：Unraid Community Applications

**當前問題**：
- MarkBase 功能需 cargo build
- 無插件扩展機制

**實施方案**：
```rust
// plugin_manager.rs
pub struct PluginManager {
    plugins: Vec<Plugin>,
}

pub struct Plugin {
    name: String,
    version: String,
    author: String,
    description: String,
    install_path: PathBuf,
    config: PluginConfig,
}

impl PluginManager {
    pub fn list_plugins(&self) -> Vec<Plugin>;
    pub fn install_plugin(&mut self, url: &str) -> Result<()>;
    pub fn uninstall_plugin(&mut self, name: &str) -> Result<()>;
    pub fn update_plugin(&mut self, name: &str) -> Result<()>;
    pub fn enable_plugin(&mut self, name: &str) -> Result<()>;
    pub fn disable_plugin(&mut self, name: &str) -> Result<()>;
}
```

**Plugin Format**：
```json
{
  "name": "markbase-nextcloud",
  "version": "1.0.0",
  "author": "community",
  "description": "Nextcloud integration",
  "install_script": "install.sh",
  "config_template": "config.toml",
  "web_ui": "nextcloud.vue"
}
```

**預估工作量**：~800 行（plugin_manager.rs + Plugin UI）
**預估時間**：5-7 天
**影響**：⭐⭐⭐⭐⭐（插件生态）

---

## P2：中期實施（中影響 + 中難度）

### 7. ZFS Native Integration ⭐⭐⭐⭐

**借鏡來源**：OpenNAS ZFS

**當前問題**：
- MarkBase VFS 層實現 ZFS-style 功能
- 不利用 Linux ZFS native 性能

**實施方案**：
```rust
// zfs_backend.rs (optional)
pub struct ZfsBackend {
    pool: String,
    dataset: String,
}

impl VfsBackend for ZfsBackend {
    fn create_snapshot(&self, path: &Path, name: &str) -> Result<()> {
        // Use native zfs snapshot command
        Command::new("zfs")
            .arg("snapshot")
            .arg(format!("{}@{}", self.dataset, name))
            .output()?;
    }
    
    fn list_snapshots(&self, path: &Path) -> Result<Vec<String>> {
        // Use native zfs list -t snapshot
        let output = Command::new("zfs")
            .arg("list")
            .arg("-t")
            .arg("snapshot")
            .arg("-o")
            .arg("name")
            .output()?;
        // Parse output
    }
}
```

**預估工作量**：~600 行（zfs_backend.rs）
**預估時間**：3-5 天
**影響**：⭐⭐⭐⭐⭐（ZFS native 性能）

---

### 8. JBOD-like Storage ⭐⭐⭐⭐

**借鏡來源**：Unraid JBOD + Parity

**當前問題**：
- MarkBase RAID-Z 要求硬盤同容量
- 硬盤故障影響全部數據

**實施方案**：
```rust
// jbod_backend.rs
pub struct JbodBackend {
    disks: Vec<PathBuf>,
    parity_disks: Vec<PathBuf>,
}

impl JbodBackend {
    pub fn add_disk(&mut self, disk: PathBuf) -> Result<()> {
        // Add disk without re-striping
        self.disks.push(disk);
    }
    
    pub fn calculate_parity(&self) -> Result<()> {
        // Reed-Solomon parity calculation
    }
    
    pub fn recover_disk(&self, failed_disk: usize) -> Result<()> {
        // Recover from parity
    }
}
```

**預估工作量**：~800 行（jbod_backend.rs）
**預估時間**：5-7 天
**影響**：⭐⭐⭐⭐⭐（異容量硬盤池）

---

### 9. GPU Passthrough Support ⭐⭐⭐

**借鏡來源**：Unraid GPU Passthrough

**當前問題**：
- MarkBase 不支持 VM
- 不需要 GPU Passthrough（定位不同）

**建議**：❌ **不實施**（定位：文件服務器，非虛擬化平台）

---

## P3：長期實施（低影響 + 高難度）

### 10. Distributed Storage (Ceph-like) ⭐⭐⭐

**借鏡來源**：Proxmox VE Ceph

**當前問題**：
- MarkBase 单節點存儲
- 無分布式冗余

**實施方案**：
```rust
// distributed_backend.rs
pub struct DistributedBackend {
    nodes: Vec<StorageNode>,
    replication_factor: u32,
}

pub struct StorageNode {
    addr: SocketAddr,
    backend: Box<dyn VfsBackend>,
    sync_status: SyncStatus,
}

impl DistributedBackend {
    pub fn replicate(&self, path: &Path, data: &[u8]) -> Result<()> {
        // Replicate to N nodes
    }
    
    pub fn recover(&self, path: &Path) -> Result<Vec<u8>> {
        // Recover from available nodes
    }
}
```

**預估工作量**：~2000 行（distributed_backend.rs + Network layer）
**預估時間**：10-15 天
**影響**：⭐⭐⭐⭐⭐（分布式存儲）

---

### 11. Docker Integration ⭐⭐⭐

**借鏡來源**：Unraid Docker Templates

**當前問題**：
- MarkBase 不支持 Docker 管理
- 定位：文件服務器，非容器平台

**建議**：✅ **部分實施**（作為 Docker volume backend）

**實施方案**：
```
# Docker volume driver for MarkBase
docker volume create --driver markbase myvolume
docker run -v myvolume:/data mycontainer

# MarkBase provides:
- SMB volume driver
- S3 volume driver
- WebDAV volume driver
```

**預估工作量**：~500 行（volume driver）
**預估時間**：3-5 天
**影響**：⭐⭐⭐⭐（Docker ecosystem）

---

### 12. HA Cluster ⭐⭐⭐

**借鏡來源**：Proxmox VE HA (Corosync + Pacemaker)

**當前問題**：
- MarkBase 单節點
- 無故障自動轉移

**建議**：❌ **不實施**（定位：小型團隊，单節點足夠）

---

## 優化 Roadmap

### Phase 11（立即實施）- 1-2 周

| 功能 | 工作量 | 時間 | 影響 |
|------|--------|------|------|
| NFS Support | 500 行 | 2-3 天 | ⭐⭐⭐⭐⭐ |
| Web UI User/Group | 300 行 | 1-2 天 | ⭐⭐⭐⭐⭐ |
| Web UI Share 管理 | 400 行 | 1-2 天 | ⭐⭐⭐⭐⭐ |
| Dashboard 完整化 | 500 行 | 2-3 天 | ⭐⭐⭐⭐⭐ |

**總計**：1700 行，7-10 天

### Phase 12（短期實施）- 2-3 周

| 功能 | 工作量 | 時間 | 影響 |
|------|--------|------|------|
| SMART 監控 | 400 行 | 2-3 天 | ⭐⭐⭐⭐ |
| Plugin 系統 | 800 行 | 5-7 天 | ⭐⭐⭐⭐⭐ |

**總計**：1200 行，7-10 天

### Phase 13（中期實施）- 3-4 周

| 功能 | 工作量 | 時間 | 影響 |
|------|--------|------|------|
| ZFS Native Integration | 600 行 | 3-5 天 | ⭐⭐⭐⭐⭐ |
| JBOD-like Storage | 800 行 | 5-7 天 | ⭐⭐⭐⭐⭐ |

**總計**：1400 行，8-12 天

### Phase 14（長期實施）- 4-6 周

| 功能 | 工作量 | 時間 | 影響 |
|------|--------|------|------|
| Distributed Storage | 2000 行 | 10-15 天 | ⭐⭐⭐⭐⭐ |
| Docker Volume Driver | 500 行 | 3-5 天 | ⭐⭐⭐⭐ |

**總計**：2500 行，13-20 天

---

## 總工作量

| Phase | 工作量 | 時間 | 功能數 |
|-------|--------|------|--------|
| **Phase 11** | 1700 行 | 7-10 天 | 4 功能 |
| **Phase 12** | 1200 行 | 7-10 天 | 2 功能 |
| **Phase 13** | 1400 行 | 8-12 天 | 2 功能 |
| **Phase 14** | 2500 行 | 13-20 天 | 2 功能 |
| **總計** | **6800 行** | **35-52 天** | **10 功能** |

---

## 優化後功能覆蓋率

### 對比 Proxmox VE

| 類別 | 現在 | Phase 11-14 | 提升 |
|------|------|-------------|------|
| **存儲管理** | 60% | 80% | +20% |
| **文件服務** | 250% | 300% | +50% (NFS) |
| **備份** | 80% | 90% | +10% |
| **Web UI** | 62% | 90% | +28% |
| **系統管理** | 20% | 60% | +40% (SMART) |

### 對比 Unraid

| 類別 | 現在 | Phase 11-14 | 提升 |
|------|------|-------------|------|
| **存儲管理** | 60% | 85% | +25% (JBOD) |
| **文件服務** | 250% | 300% | +50% (NFS) |
| **Web UI** | 50% | 85% | +35% |
| **插件** | 0% | 50% | +50% |
| **硬盤監控** | 0% | 80% | +80% |

### 對比 OpenNAS

| 類別 | 現在 | Phase 11-14 | 提升 |
|------|------|-------------|------|
| **ZFS** | 60% | 90% | +30% (Native) |
| **文件服務** | 167% | 200% | +33% (NFS) |
| **Web UI** | 50% | 85% | +35% |
| **系統管理** | 20% | 70% | +50% |

---

## 建議實施順序

### 立即開始（本周）

1. **Web UI User/Group 管理** ⭐⭐⭐⭐⭐
   - 工作量最小
   - 影響最大（易用性）

2. **Web UI Share 管理** ⭐⭐⭐⭐⭐
   - 工作量最小
   - 影響最大（易用性）

### 短期開始（下周）

3. **NFS Support** ⭐⭐⭐⭐⭐
   - 工作量中等
   - 影響最大（補足 Linux 客戶端）

4. **Dashboard 完整化** ⭐⭐⭐⭐⭐
   - 工作量中等
   - 影響最大（專業體驗）

### 中期開始（2周後）

5. **SMART 監控** ⭐⭐⭐⭐
   - 工作量中等
   - 影響中等（硬盤健康）

6. **Plugin 系統** ⭐⭐⭐⭐⭐
   - 工作量最大
   - 影響最大（插件生态）

---

## 不建議實施

| 功能 | 原因 |
|------|------|
| **VM 管理** | 定位不符（文件服務器 vs 虛擬化平台） |
| **Docker 容器管理** | 定位不符（可作為 volume backend） |
| **HA Cluster** | 定位不符（小型團隊，单節點足夠） |
| **GPU Passthrough** | 定位不符（VM 功能） |

---

## 總結

### 優化後 MarkBase 定位

**Lightweight Enterprise File Server + Backup Server**

| 功能 | Proxmox VE | Unraid | OpenNAS | MarkBase (優化後) |
|------|------------|--------|---------|-------------------|
| **存儲管理** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| **文件服務** | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| **備份** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| **Web UI** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| **部署輕量** | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |

**MarkBase 獨特優勢**：
- ✅ 輕量部署（macOS/Linux 應用）
- ✅ 多協議支持（SMB + SFTP + WebDAV + S3 + NFS）
- ✅ SSH 高性能（140 MB/s）
- ✅ macOS Time Machine 完整支持
- ✅ 內置 BackupScheduler
- ✅ cargo build 快速升級

---

**最後更新**：2026-06-24
**版本**：1.53（優化建議 Roadmap 完成）