1. 環境準備 #
## 1.1 確認系統
sw_vers
# ProductName: macOS
# ProductVersion: 15.1.1
# BuildVersion: 24B83
## 1.2 安裝必要工具（使用 Homebrew）
brew install kopia rclone openssl
## 1.3 手動安裝 Kopia UI（brew 版無 GUI）
curl -L https://github.com/kopia/kopia/releases/download/v0.21.1/kopia-0.21.1-macOS-arm64.tar.gz -o kopia.tar.gz
tar -xzf kopia.tar.gz
mkdir -p ~/bin /Applications
cp kopia-*/kopia ~/bin/
cp -r kopia-*/kopia-ui.app /Applications/
chmod +x ~/bin/kopia
rm -rf kopia-*
## 1.4 將 ~/bin 加入 PATH（永久生效）
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc
## 1.5 驗證安裝
kopia --version # v0.21.1
rclone version # v1.71.2
2. 123雲盤上建立相關文件夾 #
## 2.1 建立帳號與授權
# 在手機app 或網站上選擇 "第三方掛載" --> 添加應用
# 輸入應用名稱 ： 這裏用kopia2 做例子。
# 授權目錄 --> 選擇用來建立 repositoy 的文件夾，或者新建文件夾 ， 這裏用 kopia2 文件夾做例子。
# 權限： 讀寫 --> 下一步
# 記下用戶名稱，密碼和服務器地址，下面會用到。
3. 設定 rclone 連線 123雲盤 #
## 3.1 啟動設定精靈
rclone config
# 在互動式介面中選擇：
# n) New remote
# name> kopia2
# Type of storage> webdav
# URL> https://webdav.123pan.cn/webdav [您的服務器地址可能不一樣]
# Vendor> rclone
# User> [您的帳號]
# Password> [您的密碼]
## 3.2 驗證連線
rclone ls kopia2:
4. 建立備份目錄（123雲盤不支援 rclone mkdir） #
123pan 的 WebDAV 不允許 rclone mkdir，會回傳 404 Not Found。
## 4.1 替代方案：上傳虛擬檔案強制建立目錄
mkdir -p ~/temp-init && echo "init" > ~/temp-init/.init
rclone copy ~/temp-init kopia2:kopia-repo
rm -rf ~/temp-init
## 4.2 驗證目錄已建立
rclone ls kopia2:kopia-repo
# 5 .init
也可使用 123pan App 手動建立
kopia-repo資料夾，效果相同。
5. 啟動本地 WebDAV 伺服器 #
## 5.1 停止舊有的伺服器
pkill -f "rclone serve webdav" 2>/dev/null
## 5.2 啟動 WebDAV（背景執行）
rclone serve webdav kopia2:kopia-repo \
--addr 127.0.0.1:8080 \
--read-only false \
--vfs-cache-mode writes \
--log-level INFO &
## 5.3 等待啟動並測試
sleep 2
curl -s http://127.0.0.1:8080/.init
# init
注意：勿使用
\換行貼上，會導致隱藏字元問題。建議手動輸入或整行貼上。
6. 建立 Kopia 儲存庫（CLI 或 GUI 任選其一） #
6.1 產生強密碼（建議使用） #
## 6.1.1 產生強密碼（44 字元 base64）
REPO_PASS=$(openssl rand -base64 32)
echo "Kopia repo password: $REPO_PASS" > ~/kopia-pass.txt
chmod 600 ~/kopia-pass.txt
cat ~/kopia-pass.txt
# 輸出範例：
# Kopia repo password: a1B2c3D4e5F6g7H8i9J0k1L2m3N4o5P6q7R8s9T0u1V2w3X4Y5Z6
# 重要提醒：此密碼為 Kopia 儲存庫唯一金鑰，一旦遺失，將永久無法恢復備份資料，請立即複製至安全位置（如密碼管理器）
選項 A：使用 CLI 建立儲存庫（推薦） #
## 6.1.2 建立儲存庫（CLI）
kopia repository create webdav \
--url=http://127.0.0.1:8080/ \
--password="$REPO_PASS"
## 6.1.3 連線驗證（CLI）
kopia repository connect webdav \
--url=http://127.0.0.1:8080/ \
--password="$REPO_PASS"
選項 B：使用 Kopia UI 建立儲存庫（圖形化） #
## 6.1.4 開啟 Kopia UI
open /Applications/kopia-ui.app
# 1. 點擊 Connect to Repository
# 2. 選擇 WebDAV
# 3. URL：http://127.0.0.1:8080/
# 4. 密碼：從 ~/kopia-pass.txt 取得或手動輸入
# 5. 完成！
7. 首次快照測試 #
## 7.1 備份桌面
kopia snapshot create ~/Desktop
## 7.2 檢查雲端檔案
rclone ls kopia2:kopia-repo | head -10
# 5 .init
# 1234 k/00/...
# 5678 p/01/...
接下來… #
在系列第二部分，我們將深入探討：
- 進階壓縮策略（zstd + 選擇性壓縮）
- Pushover 即時通知設定
- 開機自動啟動 WebDAV 服務
- Keychain 密碼安全管理
敬請期待 Part 2：自動化與通知整合！