在NAS上使用Docker安裝HedgeDoc的經驗分享

Docker是一個強大的容器化平台,能夠讓應用程式在獨立的環境中運行,並且在不同的系統上實現一致性。儘管我對Docker有所了解,但一直沒有機會應用。然而,最近與同事討論了協作筆記的需求,便決定使用HedgeDoc作為實踐的對象。在這篇文章中,我將分享在NAS上使用Docker安裝HedgeDoc的經驗。

第一步：準備NAS環境和Docker 在開始之前，確保你的NAS已經設置好並且有Docker運行環境。以Synology來說，可以直接在「套件中心」安裝Docker¹。

第二步：使用Docker composer來安裝Hedgedoc與對應的資料庫 當使用Docker Compose 安裝 HedgeDoc 時，可以使用以下方式編寫 docker-compose.yml 檔案：

    version: '3'
    services:
      hedgedoc:
        image: hedgedoc/hedgedoc
        ports:
        - 3000:3000
        volumes:
        - ./data:/hedgedoc/data
        environment:
        - DB_TYPE=sqlite
        - DB_STORAGE=/hedgedoc/data/database.sqlite
        - DB_FILE=/hedgedoc/data/database.sqlite
        restart: always

這個 docker-compose.yml 檔案定義服務 hedgedoc，並指定使用 HedgeDoc 的官方映像。它將容器的 3000 port 對應到主機的 3000 port。同時，它也設定了一個名為 ./data 的本地目錄作為 HedgeDoc 容器中的資料卷宗，用於長期存儲數據。

前述範例使用了 SQLite 作為資料庫。如果你想使用其他資料庫，可以修改相應的環境變數。例如，如果要使用 PostgreSQL，可以改用以下環境變數：

        environment:
        - DB_TYPE=postgres
        - DB_HOST=your_postgres_host
        - DB_PORT=5432
        - DB_USER=your_postgres_user
        - DB_PASS=your_postgres_password
        - DB_NAME=your_postgres_database

請在執行 docker-compose up 命令之前確定已經在工作目錄中建立了 docker-compose.yml 檔案。然後用以下命令來啟動 HedgeDoc 容器：

docker-compose up -d -p 3000:3000

這將在後台執行 HedgeDoc 服務。使用 Docker Compose 的優勢是可以更方便地管理和設定多個容器化服務，並且在需要時可以輕鬆修改和更新。

第三步：訪問HedgeDoc

現在可以利用瀏覽器檢視安裝的HedgeDoc了。在網址欄中輸入NAS的IP地址，加上port 3000，例如：

http://your.nas.ip:3000

將顯示HedgeDoc的首頁

後記  

Nextcloud上線後，與筆記的功能重複，就讓 HedgeDoc 下線了。