用 docker compose 安裝與執行 VitePress

Tue, 15 Jul 2025 14:59:27 +0800

簡介

VitePress 是一種靜態網站產生器，類似 Git Book 那樣的東西，我用它來寫讀書筆記。官方文件只有用已經裝好 Node.js 的 VitePress 安裝方式，沒有用 docker 安裝的說明，Google 搜尋半天也找不到，好不容易自己試出了可以用的方式，所以記錄在這裡。

VitePress image

新增檔案 Dockerfile 內容如下

FROM node:22-alpine
RUN yarn add global vitepress

docker 一般把程式用 root 全域安裝，一般網路上找到的方法是設定 packages.json，然後用指令 npm install 安裝，這樣檔案容易有權限問題(packages.json 變成 root:root )。當然可以換成 npm add -g vitepress，用 yarn 只是因為安裝的比較快。

docker build . -t vitepress:latest

執行上述指令後，建立 vitepress:latest image。

載入需要的檔案和設定

新增檔案 docker-compose.yaml 內容如下

services:
 book_notes:
 image: vitepress:latest
 container_name: book_notes
 volumes:
 - ./:/app
 working_dir: /app
 command: "/node_modules/vitepress/bin/vitepress.js dev --host 0.0.0.0"
 restart: "no"
 ports:
 - "5173:5173"

用 docker compose 在載入容器後載入需要的檔案和設定，所以不是在 Dockerfile 設定：

VitePress on Tom 除錯中

用 docker compose 安裝與執行 VitePress

簡介

VitePress image

載入需要的檔案和設定