Day 03：工欲善其事：用 Docker 架設 n8n 開發環境與避坑指南

嗨，大家今天過得好嗎？歡迎來到鐵人賽 Day 3。

昨天我們把系統架構理清楚了，今天不講廢話，直接來把這套架構的核心—— n8n 跑起來。

為什麼堅持要 Local 端架設？

其實 n8n 有提供官方的 Cloud 雲端版本，按幾下就能註冊使用。但在開發這種會瘋狂打 API、測試 Webhook 的專案時，我強烈建議你乖乖在自己的電腦上用 Docker 架設。

原因很現實：

1. 免費吃到飽： Cloud 版有執行次數限制。開發初期光是 debug 資料流，很容易就把免費額度燒光。
2. 乾淨安全： 之後我們會頻繁串接 OpenAI 的 API Key，或是連接本地的 PostgreSQL 資料庫。把環境留在 Localhost 測試，不用煩惱防火牆跟外洩風險。
3. 隨時可搬家： 用 Docker 包起來的好處就是，等 30 天後我們專案要上線了，這包設定直接丟到雲端主機就能跑，無縫接軌。

不要鐵齒，直接用 Docker Compose

很多人剛碰 Docker 喜歡直接下 docker run 指令，但在 n8n 上千萬別這麼做。只要你的 Container 不小心重啟或關掉，你辛辛苦苦拉好的工作流（Workflow）就會當場灰飛煙滅，保證讓你欲哭無淚。

最穩的做法是寫一個 docker-compose.yml，把設定跟資料庫掛載 (Volume) 出來。

請在你電腦隨便開個空資料夾（例如 n8n-local），在裡面建一個 docker-compose.yml，把下面這段貼進去：

version: "3.8"

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      # 必填踩坑點：時區沒設好，你之後看 Log 抓 Bug 會對不到時間
      - GENERIC_TIMEZONE=Asia/Taipei
      - TZ=Asia/Taipei
      - NODE_ENV=production
    volumes:
      # 把設定檔跟工作流資料存在本地，保命用的
      - n8n_data:/home/node/.n8n

volumes:
  n8n_data:

把引擎開起來

存檔後，打開你的終端機 (Terminal)，切換到這個資料夾底下，輸入：

docker-compose up -d

等它把 Image 拉下來並跑完後，打開瀏覽器輸入 http://localhost:5678。

如果一切正常，你會看到 n8n 的初始畫面。第一次進去它會逼你設定一組管理員帳號密碼，反正這是在你自己電腦上，設一組你不會忘記的就好。

進去之後，你會看到一個非常乾淨的工作流畫布 (Canvas)。這就是我們接下來 30 天的後端主戰場了。

小結

今天我們搞定了後端引擎的基礎建設。把這個跑起來後，我們就等於有了一個隨時待命的無程式碼 API 伺服器。

不過，先別急著在裡面拉節點。既然是「全端」專案，前端的戰場也得顧。明天我們要來聊聊 Vibe Coding 最核心的技術：怎麼寫出能讓 AI 乖乖吐出「符合 MVC 架構」的 Prompt，而不是給你一坨義大利麵條 Code。

我們 Day 04 見！