| 步驟 | 在哪裡做 | 做完拿到什麼 |
|---|---|---|
| 0 先安裝 Hugo | 自己電腦的終端機 | hugo version 有版本號 |
| 1 用 Hugo 建站 | 自己電腦 | 瀏覽器開 localhost:1313 看得到網站 |
| 2 放上 GitHub | 終端機 → GitHub | 一個放原始檔的 repo |
| 3 Cloudflare Pages 部署 | Cloudflare 後台 | 你的專案名.pages.dev 網址 |
| 4 買網域 | Cloudflare 後台 | 自己的網址,例如 corgi-station.com |
| 5 接上網域 | Cloudflare 後台 | 打自己的網址,開出自己的網站 |
重點:你只在自己電腦改內容。推上 GitHub 之後,Cloudflare 會自動重新建置、上線。
git --version 有出現版本號就有Hugo 還沒裝沒關係,下面第 0 步就是裝它。
hugo version,出現 0.160 以上的版本號。Hugo 是「把文字檔變成網站」的工具,電腦預設沒有,要先裝。沒做這一步,後面全部跑不動。
hugo version
command not found(找不到指令)→ 往下裝| 電腦 | 安裝指令 |
|---|---|
| Mac | brew install hugo |
| Windows | winget install -e --id Hugo.Hugo.Extended |
hugo version 確認幫我檢查這台電腦有沒有裝 Hugo(跑 hugo version)。 沒有的話幫我裝最新版,裝完再跑一次 hugo version 給我看結果。
$ hugo version
hugo v0.170.0+withdeploy darwin/arm64 BuildDate=2026-11-13T14:17:19Z VendorInfo=Homebrew
這是 Mac 實測的畫面。v0.170.0 那一段就是版本號,數字比 0.160 大就可以。
| 狀況 | 解法 |
|---|---|
Mac 出現 brew: command not found | 還沒裝 Homebrew。到 brew.sh 複製首頁那一行指令貼到終端機,裝完再跑 brew install hugo |
| 版本比 0.160 舊 | Mac 跑 brew upgrade hugo;Windows 跑 winget upgrade Hugo.Hugo.Extended |
| Windows 裝完還是找不到 hugo | 把終端機整個關掉重開,再打一次 hugo version |
| Windows 要用哪個終端機 | Hugo 官方說不要用「命令提示字元」和舊的「Windows PowerShell」,請用 PowerShell 7 或 Git Bash |
實際打開看:corgi-site.pages.dev。主題換成你自己的題目就好,柯基只是示範。
| 頁面 | 檔案放哪裡 | 網址 |
|---|---|---|
| 首頁 | content/_index.md | / |
| 內頁:柯基犬介紹 | content/corgi.md | /corgi/ |
| 部落格列表 | content/posts/_index.md | /posts/ |
| 部落格文章 | content/posts/文章名.md | /posts/文章名/ |
corgi-site/ ├─ hugo.toml ← 網站設定:名稱、網址、上方選單 ├─ content/ ← 你寫的內容都在這裡(Markdown) │ ├─ _index.md ← 首頁 │ ├─ corgi.md ← 柯基犬介紹 │ └─ posts/ ← 部落格 │ ├─ _index.md │ ├─ first-walk.md │ └─ bath-day.md └─ themes/ananke/ ← 主題(網站的外觀)
幫我用 Hugo 建一個網站,資料夾叫 corgi-site。 1. 先跑 hugo version 確認 Hugo 是 0.160 以上。 2. 用 Ananke 主題,用 git submodule 加到 themes/ananke。 3. 做三種頁面:首頁、柯基犬介紹(網址 /corgi/)、部落格(網址 /posts/,先放兩篇文章)。 4. 上方選單放「柯基犬介紹」和「部落格」。 5. 所有文章的 draft 都設成 false。 6. 做完用 hugo server 開起來,告訴我要開哪個網址。
① 建站+加主題
hugo new site corgi-site cd corgi-site git init git submodule add https://github.com/gohugo-ananke/ananke themes/ananke
② 把 hugo.toml 改成這樣
baseURL = 'https://example.org/'
locale = 'zh-tw'
title = '柯基小站'
theme = 'ananke'
[menus]
[[menus.main]]
name = '柯基犬介紹'
pageRef = '/corgi'
weight = 10
[[menus.main]]
name = '部落格'
pageRef = '/posts'
weight = 20
③ 新增頁面,再開預覽
hugo new content corgi.md hugo new content posts/first-walk.md # 打開剛產生的 .md,把 draft = true 改成 draft = false,再寫內容 hugo server # 終端機會顯示網址,通常是 http://localhost:1313/ # 按 Ctrl + C 停止
http://localhost:1313/,畫面跟上面範例的 ① 首頁一樣,上方有兩個選單| 狀況 | 原因和解法 |
|---|---|
| 新增的文章沒出現 | Hugo 新增的文章預設是草稿。把檔案最上面的 draft = true 改成 draft = false |
| 改了內容沒變 | hugo server 開著時存檔就會自動更新;關掉了就重新跑一次 |
幫我把 corgi-site 推到我的 GitHub,開一個新的私人(private)repo 叫 corgi-site。 1. 先加 .gitignore,把 public/、resources/_gen/、.hugo_build.lock 排除。 2. 列出這次會被推上去的檔案給我看,確認沒有密碼、金鑰、個資。 3. commit 之後推到 main 分支。 4. 做完給我 repo 的網址。
① 在 corgi-site 資料夾新增 .gitignore,內容三行
public/ resources/_gen/ .hugo_build.lock
② commit
git add . git commit -m "first commit"
③-A 有裝 GitHub CLI(gh):一行開 repo 並推上去
gh repo create corgi-site --private --source . --push
③-B 沒有 gh:到 github.com 右上角「+」→ New repository,名字填 corgi-site,選 Private,不要勾 Add README,建好後照畫面上的指令
git remote add origin https://github.com/你的帳號/corgi-site.git git branch -M main git push -u origin main
github.com/你的帳號/corgi-site,看得到 hugo.toml、content、themesthemes/ananke 會顯示成一個連結(後面帶 @ 和一串英數),這是正常的你的專案名.pages.dev 網址,任何人都能開。這一段在 Cloudflare 後台用滑鼠點。截圖裡黃框+數字就是要點的地方。截圖是深色模式,你的畫面可能是淺色。
1
2
3
4
corgi-site → 按「開始設定」
1
2
hugo、組建輸出目錄 public 會自動填好HUGO_VERSION、值 0.170.0
1
2
3
7
✕
not compatible with this Hugo version 或 can't evaluate field LocaleHUGO_VERSION 和 0.170.0 →「儲存」,再推一次 commit 就會重新部署。
1
2
把 hugo.toml 的 baseURL 改成 https://我的專案名.pages.dev/(結尾要有斜線),commit 之後 push。
https://你的專案名.pages.dev/,三種頁面都跟本機一樣git push,Cloudflare 都會自動重新部署,約 1 分鐘上線
✓
corgi-station.com。
1
2
1
2
| 結尾 | 第一年 | 每年續約 |
|---|---|---|
| .com | $11.17 | $11.17 |
| .org | $8.50 | $11.20 |
| .dev | $1.00 | $12.20 |
| .app | $1.00 | $14.20 |
| .xyz | $13.50 | $13.50 |
| .io | $32.00 | $50.00 |
Cloudflare 賣的是成本價,不加價。價錢會變,以你當下看到的為準。
| 事情 | 說明 |
|---|---|
| 買不到 .tw、.com.tw | Cloudflare 的清單裡沒有,搜尋也不會出現 |
| 聯絡資料只能填英文和數字 | 官方規定。姓名、地址都用英文拼音 |
| 預設會自動續約 | 不想續可以在「網域 → 註冊」把「自動續訂」關掉 |
| 一定要收驗證信 | 沒驗證 Email,網域會被暫停 |
| 買了 60 天內不能轉走 | 要轉到別家註冊商得等 60 天 |
1
2
corgi-station.com → 按「繼續」
1
2
www.你的網域 也能開:同樣的流程再做一次,這次填 www.你的網域把 hugo.toml 的 baseURL 改成 https://我的網域/(結尾要有斜線),commit 之後 push。
https://你的網域/,開出來是你的網站,網址列有鎖頭content/ 裡的檔案,或新增一篇文章hugo server 看一眼git push,約 1 分鐘後正式網址就更新我們今天做的事一模一樣:把檔案推上 GitHub、部署成公開網站。所以同樣的事也可能發生在我們身上。
| 你以為 | 實際上 |
|---|---|
| repo 開公開,只有知道網址的人會看 | 公開 repo 的每個檔案、每一次修改紀錄,任何人都看得到 |
| repo 開私人就安全了 | 原始檔別人看不到,但部署出去的網站頁面,全世界都能開 |
| 檔案刪掉就沒事了 | Git 會留歷史紀錄,舊的 commit 裡還找得到 |
.env 檔、帳號密碼推上 GitHub 之前,幫我檢查這個資料夾: 1. 有沒有金鑰、密碼、.env 檔。 2. 有沒有個資或公司內部數據(業績、毛利、客戶名單)。 3. 列出這次會被推上去的檔案給我看。 有問題先停下來告訴我,不要 push。
| 原則 | 放到我們今天的網站 |
|---|---|
| ① 曝險最小化 | 不用的測試站、舊專案,從 Cloudflare 和 GitHub 刪掉 |
| ② 授權最小化 | Cloudflare 連 GitHub 時,只授權這一個 repo,不要全部 |
| ③ 漏洞最小化 | 發現放錯東西,馬上處理,不要等 |
| ④ 個資最小化 | 網站用不到的資料,一開始就不要放進資料夾 |
四個原則出自上面那篇報導引述的資安署提醒;右欄是對應到今天操作的做法。