DevOps AI & ML GitHub Hugo & Blog

自我挑戰: 家用 KTV 雲端災備與私有儲存安全重構:pCloud 雙帳號最小權限隔離 + Rclone 自動化同步

自我挑戰: 家用 KTV 雲端災備與私有儲存安全重構:pCloud 雙帳號最小權限隔離 + Rclone 自動化同步

客廳的歌聲不能斷,但硬碟會老、主機會壞!

在上一篇《家用 KTV 系統實戰》中,我們搞定了 Karaoke Eternal 核心、Cloudflare 零信任穿透,並以 Demucs AI 去人聲 + Wav2Vec2 CTC 強制對齊 實現了雙行交替逐字變色字幕與 Option C 雙聲道原伴唱切換矩陣。

當點歌系統順暢運作、曲庫快速累積到上百首時,一個身為工程師必然會浮現的架構焦慮隨之而來:

「算力是珍貴的。每首歌都要吃 CPU/GPU 算力跑 AI 模型分離與硬字幕渲染,如果客廳這台 Linux 伺服器硬碟突然暴斃,這幾百首心血壓出來的 KTV 伴奏庫不就全毀了?」

為了徹底消滅單點故障(Single Point of Failure),我們必須做雲端異地災備(Disaster Recovery)。但事情絕非「把檔案丟上雲端」這麼簡單——如何讓無人值守的伺服器自動上傳,卻又不把個人的主要雲端金鑰暴露在內網主機上?

本文記錄我如何運用 pCloud 雙帳號共享架構(最小權限原則 Least Privilege)、Rclone WebDAV 傳輸管線,以及非同步事件驅動自動化,打造一套兼具異地災備、權限嚴格隔離、還能順便在手機線上免下載串流看 MV 的完整解決方案。


1. 系統架構演進:從「單點故障」到「混合雲災備」

在原本的架構中,所有產出的 MP4 影片全數落盤在宿主機的 /home/dan/ktv/media/library/。一旦主機毀損,所有歷史歌曲與 Karaoke Eternal 的 SQLite 資料庫(點播歷史、歌單收藏)將同步蒸發。

我們設計了以下「最小權限混合雲災備架構」:

┌──────────────── 家用 Linux 伺服器 (192.168.0.178) ───────────────┐
│                                                                  │
│  [ktv-downloader] ──▶ [ingest.sh] ──▶ ./media/library/ (*.mp4)   │
│                             │                                    │
│                             ▼ (轉檔完成後自動觸發背景非同步同步) │
│                   [sync_pcloud.sh] (Rclone WebDAV)               │
│                             │                                    │
│                             │ (使用「副帳號」專用憑證)           │
│                             │ 🔒 最小權限:僅能看見 KTV_Library  │
└─────────────────────────────┼────────────────────────────────────┘
                              ▼ (HTTPS 增量同步 / 斷點續傳)
    ┌────────────────── pCloud 雲端儲存池 ──────────────────┐
    │                                                      │
    │  【主要帳號 (付費 1TB 空間)】                          │
    │   ├── 📂 other data/                                 │
    │   └── 📁 KTV_Library/ ◀──── [Share Folder (Can edit)]│
    │            │                         ▲               │
    │            ▼                         │               │
    │    📱 手機 / 筆電 (免下載即時串流)    └── 【副帳號 (Bot)】
    └──────────────────────────────────────────────────────┘

2. 安全推演:為什麼「主帳號分享 + 副帳號 API」是神級架構?

在設計雲端自動備份時,很多人會踩進嚴重的架構反模式(Anti-pattern):

「直接在 Linux 伺服器寫入個人主要雲端帳號的 Master API Token 或帳密。」

這在資安防護上極度危險!家用 Linux 主機通常 24 小時聯網、開著各類 Docker 服務與自動化腳本。一旦這台主機遭漏洞入侵,或是備份腳本寫出邏輯 Bug(例如誤跑清理指令),主要帳號底下的其他重要資料全部都會有被看光或被洗掉的毀滅性風險。

最小權限原則(Principle of Least Privilege)

我們採用了 「主帳號建立分享資料夾 + 副帳號機器人存取」 的解法:

  1. 爆炸半徑嚴格隔離(Blast Radius Containment):
  2. 主要帳號在 pCloud 建立專屬資料夾 KTV_Library,並透過 Share folder 功能分享給專用副帳號(Bot 帳號),權限指定為 Can edit(可讀寫)。
  3. 伺服器上的自動化程式僅持有副帳號的憑證。從副帳號的視角登入,在整個 pCloud 中「只能看見並讀寫這個共享資料夾」。主要帳號的其他所有私人目錄在副帳號面前完全隱形、根本無權存取!
  4. 巧妙突破免費用戶空間上限(Quota Hack):
  5. pCloud 的共享機制非常友善:共享資料夾佔用的是資料夾「擁有者(Owner,即付費主帳號)」的儲存配額。
  6. 副帳號即使是免費的 10GB 方案,也能把主要帳號的付費儲存池當作後盾,直接上傳幾十 GB 甚至幾百 GB 的 KTV 影片,完全不會撞到副帳號的空間天花板!

3. 自動化管線落地:Rclone WebDAV 整合實戰

3.1 為什麼選擇 Rclone 搭配 WebDAV?

在無桌面環境(Headless)的 Linux 伺服器上,一般的 OAuth 授權常需要瀏覽器跳轉或本機 Callback,設定極為痛苦。

幸運的是,pCloud 原生完整支援標準 WebDAV 協定(美區機房端點為 https://webdav.pcloud.com)。搭配命令列神器 Rclone,可以做到:
- 單一靜態二進位檔安裝,零系統依賴。
- 密碼加密混淆(rclone obscure)存入設定檔。
- 原生支援 --size-only 增量檢查、多執行緒並發與斷點續傳。

遠端主機的 ~/.config/rclone/rclone.conf 設定極度精簡:

[pcloud_ktv]
type = webdav
url = https://webdav.pcloud.com
vendor = pcloud
user = your_bot_account@domain.com
pass = <obscured_password>

3.2 打造專屬同步腳本 sync_pcloud.sh

我們在 /home/dan/ktv/scripts/sync_pcloud.sh 實作了具備鎖定保護與資料庫雙備份機制的同步腳本:

#!/usr/bin/env bash
# KTV to pCloud Cloud Sync Script
set -euo pipefail

SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
KTV_ROOT="$(dirname "$SCRIPT_DIR")"

LIBRARY_DIR="${KTV_ROOT}/media/library"
BACKUP_DIR="${KTV_ROOT}/backups"
LOG_FILE="${KTV_ROOT}/pcloud_sync.log"
LOCKFILE="/tmp/ktv-pcloud-sync.lock"
RCLONE="${HOME}/.local/bin/rclone"

# 使用 flock 避免重複執行打架
exec 201>"$LOCKFILE"
flock -n 201 || { echo "[$(date '+%Y-%m-%d %H:%M:%S')] Another pCloud sync is running. Exiting."; exit 0; }

echo "[$(date '+%Y-%m-%d %H:%M:%S')] Starting KTV sync to pCloud (KTV_Library)..." | tee -a "$LOG_FILE"

# 1. 增量同步 MP4 影音庫(3 執行緒、大小比對)
if [ -d "$LIBRARY_DIR" ]; then
    "$RCLONE" copy "$LIBRARY_DIR" "pcloud_ktv:KTV_Library" \
        --include "*.mp4" \
        --transfers 3 \
        --checkers 6 \
        --size-only \
        --stats 15s \
        --stats-one-line \
        --log-file="$LOG_FILE" \
        --log-level NOTICE
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] Media sync completed." | tee -a "$LOG_FILE"
fi

# 2. 同步最新的 SQLite 點歌資料庫快照
if [ -d "$BACKUP_DIR" ]; then
    LATEST_BACKUP=$(ls -t "${BACKUP_DIR}"/ktv_backup_*.tar.gz 2>/dev/null | head -n 1 || true)
    if [ -n "$LATEST_BACKUP" ]; then
        "$RCLONE" copy "$LATEST_BACKUP" "pcloud_ktv:KTV_Library/_backups/" \
            --size-only \
            --log-file="$LOG_FILE" \
            --log-level NOTICE
        echo "[$(date '+%Y-%m-%d %H:%M:%S')] Database backup sync completed." | tee -a "$LOG_FILE"
    fi
fi

echo "[$(date '+%Y-%m-%d %H:%M:%S')] pCloud sync finished." | tee -a "$LOG_FILE"

3.3 自動化雙重觸發機制

有了同步腳本後,我們將其串接進整個 KTV 系統生命週期:

  1. 即時事件驅動(Event-Driven Ingest):
    修改 scripts/ingest.sh,在 Demucs 去人聲與 ffmpeg 壓制完新歌並入庫後,立即於背景啟動非同步同步:
    bash # 轉檔完成後,非同步觸發背景上雲(不卡住點歌台流程) if [ -x "${SCRIPT_DIR}/sync_pcloud.sh" ]; then "${SCRIPT_DIR}/sync_pcloud.sh" >/dev/null 2>&1 & fi
  2. 夜間定時增量巡檢(Nightly Cron):
    在 Linux 伺服器設定定時任務,每晚凌晨 04:30 自動巡檢一次,補齊任何因重開機或網路斷線而遺漏的檔案:
    bash 30 4 * * * /home/dan/ktv/scripts/sync_pcloud.sh >/dev/null 2>&1

4. 意外收穫:自建行動影音庫,出門在外直接「線上串流」

原本這套機制純粹是為了「災難復原(DR)」而做,但在建好後發現了一個巨大的額外福利:

  • 原生 HTTP 串流支援:
    pCloud 的網頁版(my.pcloud.com)和手機 App(iOS / Android)都內建了極為流暢的視訊播放器,支援 HTTP Range Request 流式傳輸。
  • 行動私人點歌台:
    在外面搭捷運或出差時,只要打開手機 pCloud App 點進 KTV_Library,所有已壓制逐字變色字幕的經典 MV 免下載、點開一秒即時串流播放!隨時隨地都能聽歌、練唱、看 MV,直接把雲端硬碟變成了私人行動影音串流平台。

5. 災難復原演練(Disaster Recovery Verification)

架構好不好,跑一次恢復演練就知道。

假設今天客廳伺服器整台硬碟故障,重新灌好 Ubuntu 並 Clone 專案後,我們只需要一行指令:

# 一鍵從 pCloud 雲端把整個曲庫抓回本機
~/.local/bin/rclone copy pcloud_ktv:KTV_Library /home/dan/ktv/media/library --include "*.mp4" -P

短短十幾分鐘內,數百首經過 AI 精心分離與字幕對齊的高清伴奏影片全部毫髮無損地復原就緒,連資料庫快照也能一併從 _backups/ 解開,點播記錄完全不丟失!


6. 結語與架構心法

從最初的「客廳自架點歌台」,到今天的「跨帳號雲端災備管線」,這段實踐過程帶給我深刻的架構體會:

  1. 自動化不能以犧牲安全為代價: 永遠不要貪圖方便將高權限 Master 金鑰賦予邊緣常駐機器。善用「共享目錄 + 副帳號」的權限降級,能在享受自動化的同時,將安全邊界(Security Boundary)死死守住。
  2. 算力成果必須備份: 生成式 AI 與深度學習分離模型消耗的是寶貴的時間與電費,將高算力成果持久化備份,是每個自架系統設計者必須具備的工程素養。
  3. 優雅的管線設計帶來副產品: 當你把檔案結構與傳輸標準化之後,備份庫很自然就能轉化為行動串流媒體庫,創造出原本預期之外的使用價值。

客廳的好樂迪,現在不僅歌單豐富、不怕主機壞掉,還能帶著走!

Comments

Loading comments…

Leave a Comment

↑