SANGE Studio 改用 Next.js:網站架構與上線前的三個晚上
我在 2026 年 11 月 11 日至 13 日,利用每天下班後約 3~4 小時,將 SANGE Studio 網站從靜態 HTML 遷移至 Next.js。保留既有網址與 12 種語言的內容,同時新增可在瀏覽器操作的草稿、預覽與發布功能。這篇文章介紹網站架構、Cloudflare 各項服務的用途,以及直到正式上線的工作順序。
我在 2026 年 11 月 11 日至 13 日,利用每天下班後約 3~4 小時,將 SANGE Studio 網站從靜態 HTML 遷移至 Next.js。保留既有網址與 12 種語言的內容,同時新增可在瀏覽器操作的草稿、預覽與發布功能。這篇文章介紹網站架構、Cloudflare 各項服務的用途,以及直到正式上線的工作順序。
為什麼遷移?
舊網站使用 HTML、CSS、JavaScript 與 Python 腳本預先產生頁面,已能提供應用程式介紹、法律文件與部落格。但每次修改文章,還得維持文章列表、翻譯與網站地圖的一致性。支援 12 種語言,代表需要檢查的地方也更多。
因此,我把文章資料與頁面產生邏輯分開,改由資料庫管理部落格。希望建立「撰寫、儲存草稿、確認畫面、再發布」的工作流程。
Next.js 負責什麼?
Next.js 是使用 React 開發網頁應用程式的框架。這次用來建立公開頁面與管理介面。伺服器讀取文章資料後,回傳已包含正文的 HTML,這稱為伺服器端渲染,也就是 SSR。讀者繼續使用原本的網址;編輯端則從修改個別 HTML 檔案,轉為管理草稿與發布狀態。
Cloudflare 服務各自的角色
Cloudflare 除了網站傳遞與防護,也提供程式執行環境及資料儲存服務。這次組合了四項分工不同的服務。
Workers:執行程式的地方
Cloudflare Workers 在 Cloudflare 網路上執行程式碼。執行基礎設施交由服務管理,不必自己準備伺服器主機與維護作業系統。它負責讀取文章、產生頁面,以及處理管理介面的儲存請求。
D1:儲存文章與翻譯的資料庫
Cloudflare D1 是資料庫服務,可以把資訊依欄位整理,並依條件查詢。這裡儲存標題、正文、語言、草稿、公開版本與編輯紀錄。例如取得已發布的英文文章列表,或某篇文章的日文版本。
R2:儲存上傳的圖片
Cloudflare R2 用來儲存檔案。D1 保存文章資訊,R2 保存從管理介面上傳的圖片。既有圖片與 CSS 仍以靜態檔案提供。
Access:限制管理介面的存取
Cloudflare Access 控制哪些人可以進入網頁應用程式。讀者不必登入,但編輯需要登入。應用程式本身也會驗證身分資訊與儲存操作的正當性。
整體架構如何連接?
圖片為日文原版。讀者進入公開網站,管理者經 Access 驗證後進入管理介面;兩者使用 Workers,再連接 D1、R2 與靜態檔案。
打開文章時,Workers 從 D1 讀取已發布的正文,組成頁面回傳。圖片來自 R2 或靜態檔案。經 Access 登入後,編輯操作透過 Workers 寫入 D1。
OpenNext 負責把 Next.js 整理成能在 Workers 執行的形式。並非所有頁面都移進資料庫:應用程式介紹與法律文件使用從舊 HTML 抽出的資料顯示,繼續透過版本控制工具 Git 更新。這次瀏覽器編輯功能主要針對部落格。
把草稿與公開版本分開
管理介面支援建立文章、儲存草稿、預覽、發布、翻譯與圖片管理。儲存草稿不會改變讀者看到的內容;確認後執行發布,才切換公開版本。
系統保留編輯紀錄,也能把舊版本還原成新草稿。每種語言各自管理草稿與發布狀態。正文支援 HTML 與 Markdown,可切換標題、圖片與表格的格式化檢視和原始碼編輯,也能預覽已儲存的內容。
作業時間:每天下班後約 3~4 小時
作業期間為 2026 年 11 月 11 日至 13 日,共三天。每天約 3~4 小時,合計約 9~12 小時。這是依日常作業時間推估,並非實際計時。文章、翻譯、圖片與設計已經存在,因此不是從零製作整個網站的時間;各階段也未分別計時。
| 日期 | 主要工作 |
|---|---|
| 11 月 11 日 | 調查既有網站與多語言資料,設計架構 |
| 11 月 12 日 | 實作公開頁面、管理介面與本機驗證 |
| 11 月 13 日 | 準備正式環境、切換上線、分離管理入口與驗證 |
上線前的八個步驟
日文圖片所列的流程,以下以繁體中文說明。
1. 盤點既有網站
確認 300 個公開網址、12 種語言的 404 頁面,以及七篇文章共 84 個語言版本。將網址、正文、圖片與搜尋引擎用的中繼資料列為遷移驗證基準。
2. 設計架構與資料
D1 存文章與翻譯,R2 存新圖片,Workers 處理程式邏輯。定義草稿、公開版本、編輯紀錄及各語言狀態,把儲存與發布分開。
3. 準備本機環境
以 Docker Compose 建立與正式環境分離的測試環境。Docker 可把程式與所需環境一起執行,讓我不更動正式文章就能測試儲存與上傳。使用 Windows 開發,正式版本則在 Linux 建置。
4. 實作畫面與功能
匯入既有內容,實作顯示、編輯與發布,保留標題、圖片、表格及各語言頁面。既有連結與書籤仍可使用,舊式語言選擇網址則加上重新導向。
5. 自動測試與驗證環境確認
自動測試與獨立驗證環境涵蓋儲存、發布、翻譯、圖片、網址、語言及網站地圖。也確認未授權操作會被拒絕,草稿不會影響已發布文章。
6. 準備正式環境
建立與測試分離的正式 D1 與 R2,匯入文章並設定 Access。在上線前,以正式建置版本驗證身分驗證功能。
7. 備份並分階段公開
備份資料並確認一致性。先接上管理介面測試,再把公開網站切換到新的 Worker。保留原有的內容傳遞設定以便回復,之後將管理介面移到專用網域。
8. 透過實際網址再次驗證
切換後確認頁面、各語言 404、標準網址、網站地圖、圖片、資料庫連線與管理保護。之後也更新 Node.js 與建置相依套件,重新建置、測試及部署,再次對照 300 個網址與 61 個靜態檔案。
改變了什麼,還要衡量什麼?
現在能在瀏覽器編輯部落格,同時保留既有網址與多語言內容,將草稿、翻譯、圖片與公開版本納入同一流程。搜尋排名與速度效果仍需後續量測:舊網站原本就回傳含正文的 HTML,這次具體改善的是編輯方式與資料管理。
基礎設施由服務管理,不代表應用程式更新、權限設定與備份可以省略。我會持續透過實際寫作與翻譯,調整編輯工具。
本文依據截至 2026 年 11 月 13 日的架構與遷移紀錄撰寫。服務連結指向 Cloudflare 官方文件。
留言 0
不代表國籍或居住地,VPN等可能影響結果。
目前沒有內容。