重新整修這個部落格

November 15, 2026

上一篇文章停在 2020 年 3 月。這幾年換了幾份工作,部落格就這樣放著,連自己都快忘了它還在線上。

先搞清楚網站跑在哪裡

這個部落格是從 gatsby-starter-blog 改出來的,gatsby-config.js 裡的 siteUrl 還寫著好幾年前的 Netlify 網址,打開是 404。我一度以為網站早就下線了,結果它其實一直好好地跑在 Cloudflare Pages 上,掛著自己的網域。

教訓:設定檔裡的網址不一定是真的,要去看實際的部署設定。

Cloudflare Pages 的設定很單純:

  • 連接 GitHub repo,master 有 push 就自動 build 並部署
  • 其他分支和 PR 會產生獨立的預覽網址
  • Build 指令是 npm run build,輸出目錄是 public

也就是說,這個部落格的 CI/CD 全部由 Cloudflare Pages 負責,repo 裡沒有任何 GitHub Actions。Build 失敗就不會部署,線上會停在上一個成功的版本,對個人部落格來說已經夠用。

升級 Node 版本

.nvmrc 寫的是 lts/hydrogen,也就是 Node 18,已經過了維護期。本機改用 Node 22 跑 npm ci 和 npm run build,Gatsby 5 可以正常 build。

要注意的是,Cloudflare Pages 專案裡還設了一個環境變數 NODE_VERSION=18,環境變數的優先順序高於 .nvmrc。只改 .nvmrc 的話,線上 build 還是會用 Node 18,所以兩邊都要改成 22。

修正網站設定

幾個放了很久沒處理的小地方:

  • siteUrl 改成目前真正的網域,RSS feed 和 SEO 用到的網址才會正確
  • 個人簡介更新成現在的職稱和公司,LinkedIn 從短網址換成正式網址,加上 GitHub 連結,拿掉不再使用的 Twitter
  • 刪掉一個完全沒被引用的舊元件

加上安全 header

靜態部落格沒有後端、沒有表單、沒有登入,可以被攻擊的地方很少。不過檢查線上的 response header 後,發現少了幾個基本的:

  • Strict-Transport-Security(HSTS)
  • Content-Security-Policy(CSP)
  • 防止被 iframe 嵌入的 X-Frame-Options / frame-ancestors

Cloudflare Pages 支援在輸出目錄放一個 _headers 檔來設定 response header。Gatsby 會把 static/ 底下的檔案原封不動複製到 public/,所以只要新增 static/_headers:

/*
  Strict-Transport-Security: max-age=31536000
  Content-Security-Policy: default-src 'self'; script-src 'self' 'unsafe-inline' https://static.cloudflareinsights.com; style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self' data:; connect-src 'self' https://cloudflareinsights.com; object-src 'none'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'; upgrade-insecure-requests
  X-Frame-Options: DENY
  Permissions-Policy: camera=(), microphone=(), geolocation=(), payment=(), usb=(), interest-cohort=()
  Cross-Origin-Opener-Policy: same-origin

幾個取捨:

  • 'unsafe-inline':Gatsby 每一頁都會插入內容不同的 inline <script> 和 <style>,沒辦法用 hash 一一列出。部落格沒有使用者輸入的內容,實際風險不高。
  • HSTS 沒有加 includeSubDomains:同一個網域底下還有其他子網域,不確定每個都支援 HTTPS 之前先保守一點。
  • data::gatsby-plugin-image 的模糊預覽圖用的是 data URI,字型也可能被內嵌,所以 img-src 和 font-src 要放行。

踩到的坑:Cloudflare 自己注入的 script

在本機套上 header 測試時一切正常,部署上線後打開 console 卻看到 CSP 錯誤:static.cloudflareinsights.com/beacon.min.js 被擋掉了。

這是 Cloudflare Web Analytics 在邊緣自動插入的 script,repo 裡根本看不到,所以本機測不出來。解法是在 CSP 裡放行兩個網域:

  • script-src 加上 https://static.cloudflareinsights.com
  • connect-src 加上 https://cloudflareinsights.com(統計資料送出的目的地)

教訓:CSP 一定要在正式環境打開 console 確認一次,CDN 或平台可能會偷偷幫你加東西。

不再公開 source map

Gatsby 預設會在 production build 產出 .js.map,任何人都能下載回推前端原始碼。部落格的程式碼沒有什麼機密,但沒有必要公開,所以在 gatsby-node.js 裡關掉:

exports.onCreateWebpackConfig = ({ stage, actions }) => {
  if (stage === `build-javascript`) {
    actions.setWebpackConfig({ devtool: false })
  }
}

改完要先 gatsby clean 再 build,不然 public/ 裡還會留著舊的 .map 檔。

另外,舊的 .map 網址在部署後還能下載一陣子,原因有兩個:

  1. Cloudflare 對帶 hash 的靜態檔案設了較長的快取(s-maxage=604800),會自然過期
  2. Cloudflare Pages 會保留每次舊部署的獨立網址,舊檔案在那裡一直都在,要徹底清掉得刪除舊部署

關於 npm audit

npm ci 之後跳出一百多個漏洞警告,看起來很嚇人。實際看一下,critical 和 high 的套件大多是 express、@babel/traverse、@graphql-codegen/* 這類 build 時或 dev server 才會用到的工具,不會出現在訪客下載的網頁裡。

真正要擔心的是 build 環境的供應鏈風險,以及 Gatsby 近年幾乎沒有在積極維護,這些警告只會越積越多。長期來看,可能會考慮把內容搬到 Astro 之類還在活躍開發的框架;好在文章本來就是 Markdown,要搬並不難。

結語

整修完之後,寫文章的流程回到最簡單的樣子:

  1. 在 content/blog/<slug>/index.md 新增一篇 Markdown
  2. commit、push 到 master
  3. 等一兩分鐘,Cloudflare Pages 自動部署上線

基礎打好了,接下來就是有時間要好好寫下去。


Profile picture

Written by YU-HSIN, CHEN,
Senior Software Engineer at TSMC.
Loves pursuing modern web development.Find me on LinkedIn · GitHub