上一篇文章停在 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.comconnect-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 網址在部署後還能下載一陣子,原因有兩個:
- Cloudflare 對帶 hash 的靜態檔案設了較長的快取(
s-maxage=604800),會自然過期 - Cloudflare Pages 會保留每次舊部署的獨立網址,舊檔案在那裡一直都在,要徹底清掉得刪除舊部署
關於 npm audit
npm ci 之後跳出一百多個漏洞警告,看起來很嚇人。實際看一下,critical 和 high 的套件大多是 express、@babel/traverse、@graphql-codegen/* 這類 build 時或 dev server 才會用到的工具,不會出現在訪客下載的網頁裡。
真正要擔心的是 build 環境的供應鏈風險,以及 Gatsby 近年幾乎沒有在積極維護,這些警告只會越積越多。長期來看,可能會考慮把內容搬到 Astro 之類還在活躍開發的框架;好在文章本來就是 Markdown,要搬並不難。
結語
整修完之後,寫文章的流程回到最簡單的樣子:
- 在
content/blog/<slug>/index.md新增一篇 Markdown - commit、push 到
master - 等一兩分鐘,Cloudflare Pages 自動部署上線
基礎打好了,接下來就是有時間要好好寫下去。