Stream

快速開始

標準 S3 協議。用 aws-cli 改兩行配置就能開始用,不需要裝我們的 SDK。

# aws-cli 配置
aws configure set default.s3.signature_version s3v4
export AWS_ACCESS_KEY_ID=AKIAxxxxxxxxxxxx
export AWS_SECRET_ACCESS_KEY=xxxxxxxxxxxxxxxxxxxxxxxx
export AWS_DEFAULT_REGION=hk-1

# 建桶
aws --endpoint-url https://s3.stream.161777.xyz s3 mb s3://backup-prod-01

# 上傳
aws --endpoint-url https://s3.stream.161777.xyz s3 cp dump.sql.gz s3://backup-prod-01/mysql/

# 列舉
aws --endpoint-url https://s3.stream.161777.xyz s3 ls s3://backup-prod-01/mysql/

Endpoint 與區域

每個區域有獨立的 endpoint。跨區域存取會走公網流量並計費,同區域內互通不計流量。

區域RegionEndpoint
香港hk-1https://s3-hk-1.stream.example
台北tw-1https://s3-tw-1.stream.example
新加坡sg-1https://s3-sg-1.stream.example
香港jp-1https://s3-jp-1.stream.example
新加坡kr-1https://s3-kr-1.stream.example

路徑風格(endpoint/bucket/key)與虛擬主機風格(bucket.endpoint/key)都支援,預設走路徑風格,開 CDN 後自動切換為虛擬主機風格。

金鑰與簽名

採用 AWS Signature V4。任何支援 S3 的 SDK 都能直接對接,簽名細節不需要自己實現。

  • 每個帳號可建立多組 Access Key,許可權按桶授權
  • 金鑰可在控制檯隨時停用或輪換,舊金鑰立即失效
  • 建議為不同應用分配不同金鑰,避免一處洩露全線失守
  • 管理介面必須啟用雙因素認證,S3 介面不支援帳號密碼訪問

預先簽署 URL

私有桶的檔案不能直接公開訪問。要給臨時訪問權,用預先簽署 URL,帶有效期,過期立即失效。

# python 生成預先簽署 URL
import boto3
s3 = boto3.client("s3",
    endpoint_url="https://s3.stream.161777.xyz",
    region_name="hk-1")

url = s3.generate_presigned_url("get_object",
    Params={"Bucket": "backup-prod-01", "Key": "report/q4.pdf"},
    ExpiresIn=3600)   # 1 小時後失效
print(url)

最長有效期 7 天。建議按使用者會話發放短時效地址(幾分鐘到幾小時),比長期公開連結安全得多。

分段上傳

檔案超過 100 MB 建議用分段上傳,可斷點續傳、可併發、失敗不用從頭再來。

# aws-cli 自動分片,閾值可調
aws --endpoint-url https://s3.stream.161777.xyz s3 cp \
  large-video.mov s3://media-bucket/uploads/ \
  --expected-size 8589934592
  • 單分段最小 5 MB,最大 5 GB,最多 10000 片
  • 分段順序無關,服務端按序號拼接
  • 未完成的分段 7 天后自動清理,不計儲存費
  • 上傳中斷後用 ListMultipartUploads 找回進度繼續傳

生命週期規則

按規則自動下沉儲存層或刪除,不用寫定時任務。

{
  "Rules": [{
    "ID": "logs-to-archive",
    "Filter": { "Prefix": "logs/" },
    "Transitions": [
      { "Days": 30,  "StorageClass": "STANDARD_IA" },
      { "Days": 90,  "StorageClass": "ARCHIVE" }
    ],
    "Expiration": { "Days": 730 }
  }]
}

規則按物件最後修改時間計算。轉層不產生額外費用,但會重置最短儲存期。

版本控制

開啟後每次覆蓋或刪除都保留歷史版本,誤操作可恢復。

  • 版本佔用的儲存按標準層計費,不額外收費
  • 可配置只保留最近 N 個版本,舊版本自動清除
  • 刪除標記(Delete Marker)可移除以恢復物件
  • 桶鎖(WORM)開啟後版本不可刪除,滿足合規留存

錯誤碼

錯誤碼HTTP含義處理建議
AccessDenied403金鑰無權訪問該桶檢查桶策略與金鑰許可權
SignatureDoesNotMatch403簽名校驗失敗核對金鑰與時鐘偏差(需 < 15 分鐘)
NoSuchKey404物件不存在核對 key 大小寫與路徑
NoSuchBucket404桶不存在或不在該區域檢查 region 配置
BucketAlreadyExists409桶名已被佔用桶名全域性唯一,換一個
EntityTooLarge400超出單檔案或分片限制改用分段上傳
SlowDown503請求過於頻繁退避重試,降低併發
InvalidBucketState409桶處於歸檔鎖定等狀態檢查桶鎖與合規設定

更新記錄

  • 2026-09:新增冷歸檔層與桶鎖;圖片處理支援 AVIF 輸出。
  • 2026-03:香港與新加坡區域上線,支援跨區複製。
  • 2025-10:分段上傳支援找回中斷會話,單檔案上限提到 5 TB。