SANGE Studio 改用 Next.js:網站架構與上線前的三個晚上

我在 2026 年 11 月 11 日至 13 日,利用每天下班後約 3~4 小時,將 SANGE Studio 網站從靜態 HTML 遷移至 Next.js。保留既有網址與 12 種語言的內容,同時新增可在瀏覽器操作的草稿、預覽與發布功能。這篇文章介紹網站架構、Cloudflare 各項服務的用途,以及直到正式上線的工作順序。

發布 更新
  • Next.js
  • 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 官方文件。

受 PHP 漏洞啟發的 WordPress 替代品

比較是繼續使用 WordPress 還是遷移到靜態網站或託管 CMS。我們將透過插圖解釋 Cloudflare 的 WAF、查詢表以及一般用途和企業用途的定價範例。

應用程式介紹

應用程式介紹 →

留言 0

不代表國籍或居住地,VPN等可能影響結果。

目前沒有內容。

姓名、內容與連線國家或地區將於核准後公開。請勿填寫個人資料。