前言
相信各位在閱讀本站文章的時候,肯定會覺得:圖片怎麼載入那麼久?而最近,終於把圖床從 Imgur 遷移到 SwiftPix 了。
SwiftPix 是甚麼?怎麼沒聽過?沒聽過就對了,因為是我自己寫的圖床。就是那個出現在之前文章很多次、每次都說在做了、在做了的 Side project。
終於完成啦!!!
重新造輪子?
網路上已經有很多用 R2 當圖床的文章,2024 年的時候就有不少了,這兩年也陸續多了不少人在用。
但大部分都是直接把 R2 綁上網域對外公開,進階一點的會掛載到檔案總管,或者是用本地端工具進行管理,但我覺得這些功能都不夠。
畢竟以前(10 多年前、老部落格的時候)就有吃過圖床的虧,如果直接使用 R2 的物件 Key 作為圖片網址,未來想要重新整理圖片、修改檔名,可能就得把文章全部挖出來改,縮圖之類的功能也得另外處理。
既然都要自己弄了,乾脆就寫一套符合自己需求的圖床吧。
不過,當初在 2024 年底開始開發 SwiftPix,其實也不完全是為了 Blog,畢竟我的 Meta 帳號是到了 2025 年中才被 Ban 的,也是在那之後才開始重新把重心轉回 Blog。換句話說,當初會想寫這套圖床,其實還有其他原因。
真正讓我動了念頭的是當時 Discord 開始限制圖片外連。那時候群組內有不少朋友會直接用 DC 當圖床,突然不能正常外連之後,大家也開始煩惱有甚麼圖床好用、原本的圖片要怎麼搬之類的問題。
而我也有類似的困擾,當時 Blog 已經復活成為靜態網站,但圖片還是放在 Imgur,每次要上傳圖片都得先開 VPN,畢竟 Imgur 已經 Ban 了台灣 IP,有夠麻煩。
偏偏當時國內的圖床找了一圈,也沒一個真的符合需求的,最後就決定自己寫了。這也是為什麼 SwiftPix 從一開始規劃架構的時候,就連帳號管理一起考慮進去。
畢竟原本就不只是打算給自己用,群組內有需要圖床的人也不少,與其全部共用一個帳號、或者是架設好幾個 Workers,不如直接做好帳號與權限區分,之後要給朋友使用也比較安心。
當然,當時還規劃管理員、擁有者可以查看其他帳號的圖片,但後來想想,目前根本沒必要做到這點,就先把這個權限拔掉了。
至於 Side project 拖延了將近兩年就是我懶惰的問題了。
SwiftPix 介紹
SwiftPix
SwiftPix,是一個我自己寫的圖床,跑在 Cloudflare Workers 上,圖片存在 R2、資料放在 D1,不需要租主機。免費方案基本上就夠用了,真要付費也遠比另外租一台雲端主機便宜。
最近進度突飛猛進到可以正式上線,主要還是有 Codex + Claude Code 的協助,不只前端終於搞定了,後端的效能以及安全性也改善了不少。
圖片儲存與目錄管理
SwiftPix 在上傳的時候會記錄圖片的原始資訊到資料庫中,並且根據檔案產生一串 Hash 值,作為 R2 的儲存名稱(R2 Key)。同時也會根據使用者名稱增加前綴,讓 R2 可以透過虛擬目錄區分不同使用者。
但 R2 就只有區分到這一層,並不會繼續建立其他目錄,而 SwiftPix 本身是支援完整目錄管理的。
SwiftPix 的目錄管理功能
這裡就有稍微複雜了,先從上面提到的 Hash 值說起。
簡單來講,我並沒有讓圖片的 R2 Key 直接對外暴露,而是每張圖片在 D1 的資料表中,都會記錄下 R2 Key 以及 Public Key,兩者是分開的。
對外的圖片網址只會使用 Public Key,當有人透過網址讀取圖片時,請求會先經過 Workers,再根據 D1 中的對應關係找到實際的 R2 Key,最後從 R2 讀取圖片並回傳。
至於目錄管理,則是完全交給 D1 處理。
每張圖片都會記錄一個虛擬的 Folder Key,用來對應所屬的目錄,而每個目錄又可以屬於另一個目錄,最頂層則是 / 根目錄,如此就構建出了由資料庫管理的目錄樹。
如此一來,圖片的 Public Key、R2 Key 與虛擬目錄就可以互相獨立。R2 的檔案層級可以固定下來,也能夠透過資料庫做到分帳號、分目錄管理。
這個架構算是我根據自己過往的經驗整理出來的,最大的好處就是之後不管怎麼調整圖片分類,都不需要更動對外網址,R2 的物件也不用跟著搬來搬去。
而且 R2 本身不直接對外公開,圖片統一透過 Workers 讀取,存取控制也比較好管理。也不用像市面上一些本地管理工具一樣,移動或重新分類圖片時還得重新操作 R2 的物件,避免不必要的複製、刪除與寫入。
前端介面與操作
當然,這些都只是技術部分,有好的架構,但 UI 如果是一坨也沒用。
單純後端架構部分其實很早就規劃並且實作出大部分功能,但前端卡了很久,最近趁空檔用 Codex 和 Claude Code 把前端搞定了。
SwiftPix 的上傳介面
上班後真的很難靜下心來寫前端,光是上傳介面就很懶得動,對,我就懶。
而現在完成的上傳介面,在網頁上任何目錄內直接貼上圖片、拖拉檔案,都可以直接進入上傳介面,也可以手動開啟。開啟後還可以繼續拖拉檔案,或者是直接貼上圖片,這功能日常存圖也很好用。
SwiftPix 的多選、拖拉功能
當然不能陽春到只能靠點選,多選、拖拉更換資料夾等等的 UI 互動也都有實作。
自動縮圖與快速分享
除此之外,另一個核心功能來了,也就是上傳時可以自動縮放圖片並且儲存。
SwiftPix 的縮圖與快速分享功能
在上傳的時候會自動產生縮圖,並且選擇檔案後,右側會出現不同尺寸的複製按鈕,可以快速複製圖片網址。這點基本上就是為了方便分享,以及寫文章時可以直接取得適合的圖片尺寸並且嵌入檔案。
縮圖使用的是 Cloudflare Images 的功能,免費方案每個月有 5,000 次不重複圖片轉換的額度。
目前的方案是在上傳的時候就進行 3 + 1 種尺寸的縮圖,也就是說,一張新圖片會吃掉 4 次轉換額度。評估下來,這個額度在使用上是非常足夠的。
原本是打算圖片外連時,有人讀取才呼叫 Cloudflare Images 進行縮圖,並且不另外儲存縮圖。但想了想,這樣對於圖片比較多的人來說,每個月都可能會吃掉縮圖額度。
因為 Cloudflare Images 是按照每個月不重複的轉換組合計算,即使同一張圖、同一種尺寸在當月只會計算一次,到了下個月還是會重新計算。
如果圖片真的累計越來越多,而且又有大量外連,到最後肯定很容易超過額度,所以就改成上傳的時候先縮圖,再把縮圖儲存下來了。
後台與帳號管理
除了日常使用的前台,當然也有後台管理介面。
SwiftPix 的後台
後台可以管理網站資訊、帳號、圖片以及系統維護,維護功能可以清理 R2 中的孤兒檔案,以及轉移擁有者帳號權限。
SwiftPix 的帳號管理
這應該是跟其他圖床專案最不同的地方。從一開始就規劃了三級帳號權限,並且也有一般註冊、邀請註冊、審核註冊等機制。
至於為何這個系統會弄得這麼完整,就說來話長了……前面提到的 Discord 圖床需求,就是其中一個主要原因。
每個帳號的權限劃分,就借用一下我 GitHub 上的權限說明。
SwiftPix 的帳號權限
可以很明確地把不同帳號的權限切分出來。也就是說,之後我的圖床要借給朋友使用的話也是可以的,讓他註冊一組帳號即可。
而且都有帳號了,肯定要能夠換頭貼的對吧,這樣才夠宅(?)
SwiftPix 的頭貼上傳
我自己趁放假的時候寫,都懶得寫前端的圖片裁切,這部分也是 Claude Code 快速完成的功能。不得不說,前端就能直接裁切、編輯圖片真的很好用。
趁機炫一下,我家 ChatGPT 前陣子聊天突然幫自己設定了這個虛擬形象,甚至連一整套人物設定都有了。有機會再分享吧,過程挺有趣的。
以上就是一些主要功能介紹。
對於這個專案的架構複雜度以及安全性,我還是有信心的。
畢竟以功能上來說,現在只要是願意用 Claude Code 來開發的人,我敢說兩天內就能做出功能幾乎一樣的東西。
但功能做得出來是一回事,底層架構又是另一回事。除非原本就有網站架構相關的經驗,否則一些看似不起眼的細節,處理不好可能就會釀成大災難。
是否開源?
還在考慮要不要在 GitHub 開源,不知道這麼複雜的需求有沒有人會用到?如果有這類需求,可以留言讓我知道。
畢竟這篇文章主要只是宣布完成,順便稍微介紹一下功能與架構,就不過多深入技術部分了。
之後會看狀況,如果真的有需要開源,會再寫一篇文章介紹,或者等我哪天有閒情逸致,再寫一篇技術性質的文章吧。
回到重點,圖床搬移都完成了嗎?
圖片部分已經全部替換完成了,但目前還沒針對 Blog 主題進行微調,例如文章內使用縮圖、點擊後自動開啟原始圖片等等。
目前使用的主題 Vivia 已經停止維護,而且圖片超連結與原本的顯示效果會有衝突,所以暫時還沒加入這個功能。
不過,目前 Blog 使用的本來就是我修改過不少細節的版本,後續再調整一下應該不會太複雜。
總之,困擾很久的 Imgur 圖片載入問題終於解決了!如果有發現哪篇文章的圖片還有問題,也可以留言讓我知道。








