(【Docker項目實戰】使用Docker部署Eigenfocus項目管理工具)

一、Eigenfocus介紹

1.1 Eigenfocus簡介

Eigenfocus是一款自託管的項目管理、規劃與時間追蹤工具，基於團隊多年產品開發的經驗打造，兼顧簡潔性與靈活性，適用於從個人項目到多成員團隊的各種場景。

1.2 Eigenfocus主要特點

  • 項目管理：支持創建、編輯、更新和歸檔項目，靈活管理整個項目生命週期。
  • 看板功能：每個項目配備可自定義列的看板，適配你的工作流程。
  • 任務管理（Issues）：可創建任務，支持 Markdown 描述和文件附件，便於詳細記錄和協作。
  • 實時看板協作：在看板上進行操作時，所有變更實時同步，提升團隊協作效率。
  • 標籤與快捷方式：通過標籤和快捷操作對任務進行分類和快速處理，優化工作流。
  • 任務評論與筆記：支持在任務中添加 Markdown 格式的評論和筆記，方便溝通與記錄。
  • 時間追蹤：可在項目或具體任務上追蹤所花費的時間，精確掌握工作投入。
  • 時間報表：按項目和時間段生成時間報告，幫助分析和總結工作成果。
  • 專注空間（Focus Space）：提供專屬的專注模式，幫助用户集中精力處理關鍵任務。
  • 主題自定義：支持界面主題個性化設置，滿足不同用户的視覺偏好。

二、本次實踐規劃

2.1 本地環境規劃

本次實踐為個人測試環境，操作系統版本為 Ubuntu 24.04.2 LTS。

hostname IP地址 操作系統版本 Docker版本 部署項目
jeven01 192.168.3.88 Ubuntu 24.04.2 LTS 28.3.3 Eigenfocus

2.2 本次實踐介紹

1.本次實踐部署環境為個人測試環境，生產環境請謹慎； 2.在Docker環境下部署Eigenfocus項目管理工具。

三、本地環境檢查

3.1 檢查Docker服務狀態

檢查Docker服務是否正常運行，確保Docker正常運行。

root@jeven:~# systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
     Active: active (running) since Mon 2025-08-04 10:10:52 UTC; 30min ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 860 (dockerd)
      Tasks: 10
     Memory: 97.2M (peak: 98.4M)
        CPU: 606ms
     CGroup: /system.slice/docker.service

3.2 檢查Docker版本

檢查Docker版本

root@jeven:~# docker -v
Docker version 28.3.3, build 980b856

3.3 檢查docker compose 版本

檢查Docker compose版本，確保2.0以上版本。

root@jeven:~# docker -v
Docker version 28.3.3, build 980b856

四、拉取Eigenfocus鏡像

拉取Eigenfocus容器鏡像，當前最新版本為1.2.0-free.

 docker pull   eigenfocus/eigenfocus:1.2.0-free

在這裏插入圖片描述

五、部署Eigenfocus服務

5.1 創建部署目錄

  • 創建部署目錄
mkdir -p /data/eigenfocus/app-data   &&  cd /data/eigenfocus
  • 目錄授權
chmod -R 755 /data/eigenfocus/

5.2 編輯部署文件

使用docker-cli方式部署，命令參考如下：

docker run \
    --restart always \
    -v /data/eigenfocus/app-data:/eigenfocus-app/app-data \
    -p 3001:3000 \
    -e DEFAULT_HOST_URL=http://192.168.3.88:3001 \
    -d \
    eigenfocus/eigenfocus:1.2.0-free

在部署目錄下，創建docker-compose.yaml文件，內容如下所示：

vim docker-compose.yaml

services:
  web:
    image: eigenfocus/eigenfocus:1.2.0-free
    restart: always
    volumes:
      - ./app-data:/eigenfocus-app/app-data
    environment:
     - DEFAULT_HOST_URL=http://192.168.3.88:3001
    ports:
      - 3001:3000

5.3 創建Eigenfocus容器

執行以下命令，創建Eigenfocus容器。

docker compose up -d

在這裏插入圖片描述

5.4 查看Eigenfocus容器狀態

檢查Eigenfocus容器運行狀態，確保Eigenfocus容器正常啓動。

root@jeven:/data/eigenfocus# docker compose ps
NAME               IMAGE                              COMMAND                  SERVICE   CREATED         STATUS         PORTS
eigenfocus-web-1   eigenfocus/eigenfocus:1.2.0-free   "bin/docker-entrypoi…"   web       9 minutes ago   Up 9 minutes   0.0.0.0:3001->3000/tcp, [::]:3001->3000/tcp

5.5 查看Eigenfocus容器日誌

檢查Eigenfocus容器運行日誌，確保Eigenfocus服務正常運行。

docker compose logs

在這裏插入圖片描述

六、訪問Eigenfocus服務

6.1 訪問初始頁

瀏覽器地址： http://<個人的服務器IP>:3001，訪問Eigenfocus的初始頁。如果無法訪問，請確保宿主機的防火牆已關閉或已放行相關端口，對於雲服務器還需配置相應的安全組規則。

在這裏插入圖片描述

6.2 設置時區

目前系統支持英語和葡萄牙語（巴西），我們選擇時區為北京時區，提交即可。

在這裏插入圖片描述

七、Eigenfocus基本使用

7.1 任務看板類型

點擊“Create project”選項，進入項目創建界面。

在這裏插入圖片描述

在項目類型中，我們選擇【基礎看板】的類型。

在這裏插入圖片描述

可以看到創建的任務管理項目，打開後可自行編輯進行操作，非常簡單容易上手。

在這裏插入圖片描述

7.2 軟件開發類型

我們選擇項目模版為軟件開發類型，確認後，效果如下所示：

在這裏插入圖片描述

在這裏插入圖片描述

7.3 時間追蹤功能

我們點擊Eigenfocus右上角的 “Go to time tracking ”選項，進入時間追蹤管理界面。

在這裏插入圖片描述

時間追蹤填寫的內容：

  • Project：項目名稱，這裏選擇剛才創建的看板類型項目。
  • Issue：問題，這裏寫任務事項，例如打羽毛球。
  • Description：描述，自定義填寫即可。
  • Logged time (minutes)：記錄時間（分鐘）

在這裏插入圖片描述

7.4 查看時間報告

當填寫的任務done完成時候，點擊“stop”按鈕，停止計時。

在這裏插入圖片描述

在這裏插入圖片描述

在 Eigenfocus 左側選擇 Time reports 模塊，然後點擊右上角的 Generate report 選項，即可生成如下所示的時間報告。

在這裏插入圖片描述

八、總結

本次Docker部署Eigenfocus項目管理工具的實踐順利完成，通過容器化方式快速搭建了一套功能完整的項目管理平台。實踐過程中驗證了Docker環境的兼容性，併成功配置了時區、任務看板等核心功能模塊。該工具的時間追蹤和可視化報告功能特別適合敏捷開發團隊的需求，顯著提升了項目管理效率。Eigenfocus以其輕量級架構和豐富的功能特性，在容器化部署場景下展現出了良好的易用性和實用性。