# 策展 · X (Twitter) 🔥

> 作者：Archil (@archildata) · 平台：X (Twitter) · 日期：2026-04-27

> 原始來源：https://x.com/archildata/status/2048776910881337573

## 中文摘要

Archil 推出 S3 API，提供唯讀檔案系統存取。  
Archil S3 API 讓使用者透過 S3 相容 HTTP 介面，直接存取「Archil 磁碟」的內容，無需掛載客戶端，適用於快速下載或整合既有工具。

**S3 API 核心功能**  
Archil 將每個磁碟暴露為唯讀 S3 相容儲存桶，使用者可指向「Archil 端點」，搭配每個磁碟專屬的 SigV4 憑證，即可透過 HTTPS 讀取內容，無需安裝 Archil 客戶端或執行程式。  
- 支援 ListObjectsV2（僅接受 delimiter=/，其他值回傳 400 InvalidArgument）和 GetObject（完整支援 HTTP Range 標頭，回傳 206 Partial Content）。  
- Content-Type 依檔案副檔名或前 512 位元組推斷，HEAD 和 GET 對相同 key 一致。  
- 符號連結解析為目標檔案，目錄在 delimiter=/ 時顯示為 CommonPrefixes，與真實 S3 儲存桶行為相同。  
此 API 僅限讀取，高吞吐量串流或 POSIX 語意（如寫入、重命名、鎖定）需改用磁碟掛載。

**使用情境**  
適合不需掛載磁碟的輕量需求：  
- 僅需抓取少量檔案，避免消費者安裝客戶端。  
- 整合支援 S3 的工具，如資料倉儲、ETL 管道、訓練工作輸入或影像 CDN。  
- 伺服器無程式從中快速下載檔案，而不拉入 Archil 客戶端。  
不適合高吞吐量工作，官方明確指出 S3 API 優化便利性而非效能，持續高吞吐串流應使用 Archil 客戶端以享原生通訊協定和本地快取。

**端點與位址格式**  
S3 API 由每個區域專屬端點提供，必須匹配磁碟所在區域，使用路徑樣式位址（https://<endpoint>/<bucket>/<key>），不支援虛擬主機樣式，多數 S3 客戶端需明確旗標強制路徑樣式。

**認證機制**  
每個磁碟獨立 S3 憑證，無帳戶級金鑰：  
1. 在 Archil 主控台開啟磁碟「詳細頁面」。  
2. 于「授權使用者」區塊點擊「新增使用者」並選 S3 憑證。  
3. 主控台僅顯示一次 Access Key ID 和 Secret Access Key，需安全儲存，無法重取。  
憑證限單一磁碟，跨磁碟存取回傳 AccessDenied；輪替時新增使用者並移除舊者。使用標準 AWS Signature Version 4，任何 S3 SDK 均即插即用。S3 憑證獨立於磁碟 token（用於掛載）和控制平面 API 金鑰（帳戶級管理磁碟）。

**儲存桶名稱與暴露內容**  
儲存桶名稱即主控台顯示的磁碟 ID（dsk-…）。API 暴露磁碟當前檔案系統狀態，所有透過 FUSE 掛載、disk.exec 或主控台檔案瀏覽器寫入的檔案，即以 POSIX 路徑為 key 呈現為物件。新寫入檔案在提交後下一 S3 請求即見，具與其他 Archil 客戶端相同的讀後寫一致性。無獨立「S3 物件」集合，僅為相同資料的不同通訊協定視圖。

**分享 URL**  
用於一次性下載，無需憑證，從主控台檔案瀏覽器行選單「分享」或控制平面 API 產生。  
- expiresIn 支援 3600（1 小時）、28800（8 小時）、86400（24 小時）或 604800（7 天），預設 24 小時。  
- URL 由 Archil 內部 KMS 金鑰簽署，耐控制平面重啟並跨複本有效，可在瀏覽器開啟，具適當 Content-Type 和 Content-Disposition，支援內嵌渲染。

**不支援操作**  
寫入操作（PutObject、DeleteObject、CopyObject、多段上傳）和 ListBuckets 回傳 MethodNotAllowed 或 NotImplemented。修改磁碟須掛載檔案系統或用 disk.exec。

**限制與效能考量**  
- 唯讀，所有寫入方法回傳 MethodNotAllowed。  
- 每個憑證限單一儲存桶，跨磁碟需獨立憑證。  
- ListObjectsV2 僅支援 / 作為分隔符。  
- 無 ListBuckets，因憑證範圍僅一儲存桶，操作無意義。  
- 效能優化便利而非吞吐量，持續高吞吐串流建議用 Archil 客戶端。  
Archil S3 API 已對所有 Archil 檔案系統開放，主控台可檢視檔案並分享給同事或 Claude，即使檔案正於雲端產生中。詳細文件見 https://docs.archil.com/protocols/s3-api。

## 標籤

新產品, 功能更新, 其他, Archil