【Dify 安裝教學】解決 Windows WSL2 下 PostgreSQL 無限重啟：為什麼源碼開發必須遠離 C 槽？
在 Windows 環境下透過 WSL2 安裝 Dify 原始碼（Source Code）時，最常遇到的挫折不是程式碼寫錯，而是資料庫（Database）連線失敗。本文將深入解析如何解決 PostgreSQL 權限報錯與 Restarting (unhealthy) 問題，並提供 2026 年最完整的安裝流程。
為什麼 Dify 在 Windows C 槽安裝會失敗？
當你將 Dify 專案放在 /mnt/c/Users/...（NTFS 格式）時，會觸發 WSL2 的底層權限衝突。
1. 檔案系統的權限代溝 (chmod 0700)
PostgreSQL 對資料夾權限要求極嚴。在啟動時，它會嘗試執行 chmod 0700 來保護數據。然而，Windows 的 NTFS 磁碟不支援 Linux 的權限鎖定位元，導致報錯：
initdb: error: could not change permissions: Operation not permitted
2. I/O 效能的「降維打擊」
WSL2 存取 Windows 磁碟（C 槽）需經過 9P 協議轉換，讀寫效能比原生 Linux 檔案系統慢了將近 10 倍。這會導致 pnpm install 或 uv sync 異常緩慢。
🛠️ Dify Windows 安裝「避坑」指南：正確流程
為了確保 Dify 穩定運行，請務必將專案「移民」至 WSL 原生路徑（如 /home/username/）。
第一步：徹底清理舊容器
在嘗試新安裝前，先移除 C 槽殘留的損壞數據卷：
cd /mnt/c/your/old/path/docker
docker compose -p dify down -v
第二步：移民至 WSL 原生地盤 (極速關鍵)
不要在 /mnt/c/ 下執行 git clone！ 請執行以下指令：
cd ~ # 回到 Linux 家目錄
mkdir -p Projects && cd Projects
git clone https://github.com/langgenius/dify.git
cd dify/docker
第三步：啟動中間件 (Docker Middleware)
複製環境變數範本並啟動資料庫：
cp middleware.env.example middleware.env
docker compose -f docker-compose.middleware.yaml --profile postgresql --profile weaviate -p dify up -d
SEO 檢查點： 執行 docker ps，確保 dify-db_postgres-1 狀態為 Up (healthy)。
第四步：後端 API 配置與 SECRET_KEY 修正
在建立 .env 時，若 SECRET_KEY 包含斜線會導致 sed 錯誤，請使用以下修正指令：
cd ../api
cp .env.example .env
# 使用冒號作為分隔符避開 Base64 斜線衝突
sed -i "s:SECRET_KEY=.*:SECRET_KEY=$(openssl rand -base64 42):" .env
uv sync --dev
uv run flask db upgrade
第五步：前端環境隔離 (nvm & pnpm)
WSL 內部必須安裝獨立的 Node.js，不要調用 Windows 端的 node：
nvm install 22
npm install -g pnpm
cd ../web
pnpm install
pnpm dev
💡 常見問題與解決方案 (FAQ)
| 常見錯誤 (Keyword) | 核心原因 | 快速解法 |
| Connection Refused | DB 沒啟動或 IP 轉發問題 | 檢查 docker ps 並將 .env 的 DB_HOST 改為 127.0.0.1 |
| node: not found | WSL 內未安裝 Node.js | 使用 nvm install 22 安裝 Linux 版 Node |
| Restarting (1) | 檔案在 C 槽權限不足 | 搬家到 ~/ 原生目錄，重新執行 docker compose |
結語：優雅的開發姿態
透過 VS Code Remote - WSL 插件，你依然可以在熟悉的 Windows 介面編輯代碼，但讓編譯與資料庫在 Linux 核心下全速運轉。這不僅解決了 Dify 的啟動問題，更能讓你的開發效率提升數倍。
延伸閱讀：
👨💻 工程師小筆記 (SEO Tags)
#Dify教學 #WSL2 #Docker #PostgreSQL #AI應用開發 #Python #NodeJS #工程師日常
留言
張貼留言