使用 Gitblog + Markdown 快速建立個人部落格：Nginx 環境部署與主題客製化

使用 Gitblog + Markdown 快速建立個人部落格：Nginx 環境部署與主題客製化

Gitblog 是一套無資料庫、純 Markdown 檔案驅動的靜態部落格系統，支援評論、代碼高亮、數學公式、PV 統計、多主題、響應式設計，並可一鍵導出靜態站點部署至 GitHub Pages。本文記錄 Nginx + PHP 環境部署全流程。

1. 網域解析

在 DNS 服務商（推薦 DNSPod）新增 A 記錄指向伺服器公網 IP，生效後可用 dig yourdomain.com 驗證。

2. Nginx + PHP-FPM 環境

• PHP ≥ 5.3（建議 7.4+ / 8.1+）。
• 安裝 Nginx、PHP-FPM、必要擴展（mbstring、json、gd、curl）。
• Nginx 虛擬主機設定範例：

  server {
      listen 80;
      server_name blog.yourdomain.com;
      root /data/vhosts/blog.yourdomain.com;
      index index.html index.htm index.php;
  
      location ~ \.(jpg|png|gif|js|css|swf|flv|ico)$ {
          expires 12h;
      }
  
      location / {
          if (!-e $request_filename) {
              rewrite ^(.*)$ /index.php?$1 last;
              break;
          }
      }
  
      location ~* ^/(doc|logs|app|sys)/ {
          return 403;
      }
  
      location ~ \.php$ {
          fastcgi_pass 127.0.0.1:9000;
          fastcgi_index index.php;
          fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
          include fastcgi_params;
      }
  }

• 重載 Nginx：nginx -s reload。

3. 權限設定

chown -R www-data:www-data /data/vhosts/blog.yourdomain.com/app/cache
chmod -R 755 /data/vhosts/blog.yourdomain.com/app/cache

Gitblog 需寫入 app/cache 產生快取，確保 PHP-FPM 執行使用者（通常 www-data）擁有寫入權限。

4. 部署 Gitblog

1. 下載原始碼：git clone https://github.com/your/gitblog.git 或官網下載 ZIP。
2. 解壓至網站根目錄 /data/vhosts/blog.yourdomain.com。
3. 瀏覽 https://blog.yourdomain.com，應見預設主題首頁。
4. 在 posts/ 目錄新增 .md 檔案即發布文章，支援 Front Matter：

---
title: "我的第一篇文章"
date: "2024-01-15"
tags: [Gitblog, Markdown, 部落格]
---
文章內容支援 **Markdown**、`code`、$$數學公式$$...

5. Gitblog 核心特色

6. 主題客製化

主題目錄結構：themes/your-theme/{views,assets,config.php}。修改 config.php 設定顏色、字體、側邊欄組件；編輯 views/ 下的 Blade/Twig 模板調整佈局；assets/ 放置 CSS/JS/圖片。啟用主題：修改 app/config.php 'theme' => 'your-theme'。

7. 靜態導出部署 GitHub Pages

cd /data/vhosts/blog.yourdomain.com
php console.php export
# 產出 public/ 目錄
cd public
git init
git remote add origin https://github.com/username/username.github.io.git
git add . && git commit -m "Deploy" && git push -f origin master

幾分鐘後 https://username.github.io 即可訪問完整靜態站點。

Gitblog 讓寫作回歸純粹，專注內容而非系統維護，適合開發者、技術寫作者建立個人品牌。