MyWebDrive 使用指南

認識 MyWebDrive 的架構與能力邊界，找到適合你的閱讀起點。

這套指南覆蓋什麼

MyWebDrive 是一個檔案存儲與分發平台。整套系統目前以 Core 為中心：Core 負責身份驗證、檔案元資料、上傳意圖、配額、分享和發佈；Storage 處理對象傳輸與後台作業；Next.js 頁面則透過同源 Nginx 存取 API。早期拆分式的 Auth、User、Metadata、Sharing、Gateway 已經軟退役，舊文件裡的啟動和遷移命令不再適用於當前主線。

這份說明在 2026-09-07 對照公開主分支原始碼、公共 OpenAPI、元件和測試編寫而成。源專案採用 MIT 授權。倉庫中仍有未完成的歷史敏感材料處理，因此這裡提供的是經過檢查的使用說明，暫時不提供原始碼取得方式和倉庫 Issue 連結——這不代表原始碼已通過安全審計。如果你手邊有經維護者確認的原始碼副本，可以前往本地開發了解更多。

按使用目的閱讀

目的	指南
第一次登入並上傳一個檔案	快速開始、登入與會話
查看檔案、版本和下載	檔案與版本
理解進度、失敗重試和空間佔用	上傳、配額
向指定接收者或公眾分發檔案	分享、公開發佈
管理使用者、指標和通知	使用者管理、儀錶盤、通知
開發接口或運維自己的實例	API、本地開發、部署與恢復
操作失敗	排錯

頁面入口與能力邊界

以下路徑屬於你正在使用的 MyWebDrive 實例，而不是這個說明站：/signin 登入、/account 個人中心、/download 公開目錄、/admin/overview 管理概覽、/admin/users 使用者管理、/admin/publish 發佈、/admin/notifications 通知。

有些 API 已經可以使用，但目前不一定有對應的介面按鈕。個人中心提供上傳、檔案列表、版本查看和下載功能；不過目前還沒有通用的重新命名、移動、刪除、資源回收筒或建立資料夾的介面。分享管理與替換上傳需要直接呼叫 API，版本列表也不代表有「還原舊版」按鈕。請不要根據舊截圖或資料夾類型欄位推測某項操作已經可用。

驗證範圍

這份指南的功能說明來自固定原始碼的靜態核對。網站文件、搜尋和 AI 的測試與 MyWebDrive 實例的運行驗收是分開記錄的。實例能打開首頁，並不代表郵箱投遞、真實上傳、後台完成處理和下載都已經通過驗證。第一次使用時，建議按照快速開始的步驟，親自用一個不含敏感內容的小檔案完成一趟往返測試。