Garage是一個相容Amazon S3通訊協定的物件儲存服務。
文件撰寫時的軟體版本：Misskey 2026.6.0，Garage v2.3.0。
下面會說明如何在Misskey連接自行架設的Garage物件儲存服務。假設Misskey與Garage都已經架設好在運作中的狀態。
設置儲存空間（bucket）
以下是參考官網針對Mastodon的設置說明，大多都通用。
建立存取用的金鑰，記得抄下Key ID與Secret Key。
garage key create misskey-key
建立一個空的bucket
garage bucket create misskey-data
設置金鑰有讀寫misskey-data的權限
garage bucket allow misskey-data --read --write --key misskey-key
misskey-key是金鑰的名稱，misskey-data是bucket的名稱，都可以更改為自己喜歡的。
我們需要讓bucket可以被外部存取，這個作法叫做Exposing buckets as websites。
針對bucket設定DNS名稱，此名稱需要在DNS新增一筆紀錄。請把my-social-media.mydomain.tld改成真正要使用的名稱。
garage bucket alias misskey-data my-social-media.mydomain.tld
讓bucket可以被公開存取。
garage bucket website --allow misskey-data
搬遷已存在的資料
跟Mastodon不同，Misskey在設置物件儲存後不會自動更改已存在檔案的URL，如果要搬遷已存在的資料到Garage，除了移動實體檔案之外，還需要更改資料庫內容，因此在這裡不會解說這個作法。
設置Misskey
使用管理員帳號打開Misskey管理控制台/設定/物件儲存。
Base URL：https://my-social-media.mydomain.tld
記得之前設定的DNS名稱嘛，Base URL會需要用到。
儲存空間（bucket）： misskey-data
前綴（prefix）可填可不填，如果要填建議是 files ，跟本地儲存的路徑一致。
端點（endpoint）：192.168.x.x:3900
是Garage的endpoint，可填寫內部IP或者外部URL，要連接到Garage的3900 port。
區域（Region）：garage
區域設置參考Mastodon的設置範例。
Access key：Garage Key ID
Secret key ：上面Key ID對應的Secret Key
下面開關選項按照實際情況設置，唯一必須開啟的是 s3ForcePathStyle 這個選項。
設置完成後，可以上傳檔案測試看看，是否可以正確看到檔案，以及網址是否有改變。
