標準 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。跨區域存取會走公網流量並計費,同區域內互通不計流量。
| 區域 | Region | Endpoint |
|---|---|---|
| 香港 | hk-1 | https://s3-hk-1.stream.example |
| 台北 | tw-1 | https://s3-tw-1.stream.example |
| 新加坡 | sg-1 | https://s3-sg-1.stream.example |
| 香港 | jp-1 | https://s3-jp-1.stream.example |
| 新加坡 | kr-1 | https://s3-kr-1.stream.example |
路徑風格(endpoint/bucket/key)與虛擬主機風格(bucket.endpoint/key)都支援,預設走路徑風格,開 CDN 後自動切換為虛擬主機風格。
採用 AWS Signature V4。任何支援 S3 的 SDK 都能直接對接,簽名細節不需要自己實現。
私有桶的檔案不能直接公開訪問。要給臨時訪問權,用預先簽署 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
ListMultipartUploads 找回進度繼續傳按規則自動下沉儲存層或刪除,不用寫定時任務。
{
"Rules": [{
"ID": "logs-to-archive",
"Filter": { "Prefix": "logs/" },
"Transitions": [
{ "Days": 30, "StorageClass": "STANDARD_IA" },
{ "Days": 90, "StorageClass": "ARCHIVE" }
],
"Expiration": { "Days": 730 }
}]
}
規則按物件最後修改時間計算。轉層不產生額外費用,但會重置最短儲存期。
開啟後每次覆蓋或刪除都保留歷史版本,誤操作可恢復。
| 錯誤碼 | HTTP | 含義 | 處理建議 |
|---|---|---|---|
AccessDenied | 403 | 金鑰無權訪問該桶 | 檢查桶策略與金鑰許可權 |
SignatureDoesNotMatch | 403 | 簽名校驗失敗 | 核對金鑰與時鐘偏差(需 < 15 分鐘) |
NoSuchKey | 404 | 物件不存在 | 核對 key 大小寫與路徑 |
NoSuchBucket | 404 | 桶不存在或不在該區域 | 檢查 region 配置 |
BucketAlreadyExists | 409 | 桶名已被佔用 | 桶名全域性唯一,換一個 |
EntityTooLarge | 400 | 超出單檔案或分片限制 | 改用分段上傳 |
SlowDown | 503 | 請求過於頻繁 | 退避重試,降低併發 |
InvalidBucketState | 409 | 桶處於歸檔鎖定等狀態 | 檢查桶鎖與合規設定 |