快速開始
連線至儲存空間,完成第一次檔案傳輸。Bucket(儲存空間)是 OSS 存放物件的容器;物件 Key 是檔案在 Bucket 中的完整名稱,包含目錄前綴。
1. 準備連線資訊
先依照取得應用程式選擇版本或執行開發預覽版。準備 Bucket 所在區域,以及其中一種憑證:AccessKey ID 與 Secret;STS 的 ID、Secret 與臨時 Token;或相容 OSS Browser 的目錄授權碼。確認授權碼的有效期與唯讀範圍。
第一次傳輸建議使用測試 Bucket 或專用目錄。可執行的操作取決於 RAM 策略。
2. 連線至 OSS
填寫連線名稱、區域(例如 cn-hangzhou)與憑證。使用授權碼時,切換到對應分頁並貼上授權碼。無法列舉所有 Bucket 時,在進階選項指定 Bucket;目錄前綴須以 / 結尾。
按下連線後,應看到儲存空間清單或指定目錄。憑證預設僅保存在記憶體中,須主動選擇才會寫入系統憑證庫。失敗時請查看常見問題。
3. 找到檔案
開啟 Bucket 與目錄,選取檔案查看大小、儲存類型與詳細資訊。搜尋依物件 Key 前綴比對,排序僅作用於已載入的資料列。需要時載入更多結果。
4. 傳輸一個檔案
按下上傳選取小型本機檔案,或選取遠端檔案後按下下載並指定本機目錄。確認計畫與同名衝突選項;首次體驗可選擇回報衝突,避免主動取代現有檔案。
在傳輸工作頁查看進度。上傳完成後重新整理清單,下載後查看目的地。關閉或中斷連線會停止傳輸;使用相同連線設定與 AccessKey ID 重新連線後,手動重試未完成的記錄。
5. 預覽或分享
選取單一檔案開啟預覽。文字修改預設另存副本。分享功能可建立限時連結;持有有效簽署連結的人可使用其授予的權限,請妥善保護連結。
連線與瀏覽
輸入名稱、區域與 AccessKey/STS,或使用上游 OSS Browser 的 base64 JSON 授權碼。目錄授權碼會套用 Bucket/前綴、過期時間與唯讀限制,最終權限由 RAM 決定。單一檔案授權碼暫不支援為目錄連線。
進階選項提供服務、內網、CNAME 和 PrivateLink;後兩者需要 HTTPS Endpoint 與 Bucket。憑據預設留在記憶體,勾選後才儲存至系統憑證庫;可明確讀取或刪除。設定和傳輸記錄不含密鑰。
雙擊開啟 Bucket/目錄,使用歷史導覽、遠端前綴搜尋及分頁;排序針對已載入項目。路徑列按鈕切換目前目錄書籤,同設定書籤顯示於側欄。Cmd/Ctrl + K 開啟完整命令清單。
傳輸
選擇檔案/目錄上傳或選取遠端檔案/目錄下載,確認時可報告衝突、略過或取代。拒絕符號連結、特殊檔案及不安全下載路徑;保留相對目錄結構,空上傳目錄建立目錄標記。
上傳與下載任務並行數可分別設定,預設各 2 個;上傳預設 8 MiB 分段、3 個分段並行,下載預設 3 個分段並行。大型檔案會自動放大上傳分段。暫時性錯誤按上限退避重試,重用有效檢查點。下載驗證續傳資料、長度、OSS CRC64 及可用的 ETag,完成後才發布檔案。
關閉或中斷會取消佇列;以相同設定和 AccessKey ID 重新連線後可手動重試未完成工作,不會自動傳輸。記錄、檢查點及下載分段均位於設定旁 transfers/。發佈時先將驗證後的資料複製到所選目的地內的私有暫存檔,再原子重新命名或建立硬連結;請預留兩份檔案所需的空間。所選下載根目錄會持久化,並在重試和清理時限制檔案操作範圍。舊版位於目的地的分段會重新下載;若舊工作無法安全解析目的地路徑,請重新加入佇列。取消會保留遠端分段,可透過 OSS 生命週期規則或控制台清理不再需要的分段。寫入後請重新整理清單。
物件工具
單檔工具位於詳細資訊,批次操作可由命令面板進入。文字可預覽、編輯、查看 Diff 並另存新物件。中繼資料使用字串鍵值 JSON;ACL 會提示公開存取。分享可選 15 分鐘、1 小時、1 天或 7 天,受已知 STS 期限限制;連結可複製或開啟,不持久儲存。
複製/移動輸入以 / 結尾的完整前綴,重新命名輸入完整物件鍵。套用前核對清單,每項結果及重試在佇列中獨立處理。移動先複製再刪除,刪除失敗保留兩份,重試不重複複製。命令面板提供新增目錄。
目前限制
目前為開發版本。真實 OSS 帳號、Windows/Linux 原生整合、正式簽章/公證與發行仍需後續提供環境,自動化截圖和交叉編譯不能代替原生驗收。
UTF-8 文字編輯上限為 5 MiB,預覽讀取上限 8 MiB,影像解碼上限 2000 萬像素。預設另存副本;明確選擇取代原物件時會預先檢查 ETag,並保留標頭、標籤、中繼資料、ACL 及儲存類型,但檢查與寫入並非不可分割。圖片可縮放,影音使用原生 WebView,文件/FLV/不支援的編解碼器可由外部開啟或下載。中繼資料修改限 1 GiB,遞迴計畫限 10 萬個鍵。物件操作佇列僅限目前工作階段。已接入 MyGo 簽署安裝及重新啟動;正式發行需可信公鑰與更新來源,開發建置提供手動下載。
啟用或暫停版本控制的 Bucket 不執行 x-oss-forbid-overwrite 保護。上傳前會檢查現有物件,但並行建立仍可能產生新版本。刪除/移動會先檢查 ETag 再刪除,兩次請求並非原子操作,期間應避免修改來源物件。
儲存空間、權限與分享工具
Bucket 選單提供建立、ACL、刪除空儲存貯體及分段上傳清理,公開 ACL 需確認。物件工具支援遞迴目錄複製/移動/重新命名/刪除、HTTP 標頭及批次中繼資料、符號連結與封存還原。還原請求成功不代表物件已可讀取。
複製或移動後可導覽至目的目錄貼上;單檔可改名,目錄保留相對結構,同區域跨貯體使用伺服器端複製。RAM 工具支援使用者及 AccessKey 管理、對使用者/群組/角色的多物件原則授權、新使用者與 STS 臨時授權碼。
分享支援公開網址、限時簽署網址、自訂 HTTPS/加速網域、QR 碼及確認後寄信。SMTP 使用 TLS/STARTTLS,密碼僅在記憶體或系統憑證庫。設定分為傳輸、系統、SMTP、記錄及其他;並行數、分段、逾時、重試及分頁大小於重新連線後套用。縮圖、啟動檢查更新及本機診斷記錄可選擇啟用;保持登入從系統憑證庫讀取金鑰,登出會清除自動連線設定。
逐項實作與驗收狀態見 110 場景清單。