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

一、Kaneo介紹

1.1 Kaneo簡介

Kaneo是一個專注於簡潔與高效的開源項目管理平台。它可以自建部署，支持個性化定製，真正為你所用。無論是個人項目還是團隊協作，Kaneo 都能提供恰到好處的功能，既不過度複雜，也不失實用性。

1.2 Kaneo主要特點

  • 簡潔直觀的界面設計 —— 讓你專注於工作本身，而不是操作工具。
  • 支持自建部署（Self-hosted） —— 完全掌控你的數據，保障隱私與安全。
  • 性能優化出色，響應迅速 —— 從用户體驗出發，打造真正高效的使用流程。
  • 完全開源且永久免費 —— 無任何隱藏費用，代碼透明，社區驅動持續改進。
  • 功能強大但不冗餘 —— 滿足複雜項目需求的同時，保持使用上的輕便與靈活。

二、本次實踐規劃

2.1 本地環境規劃

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

hostname IP地址 操作系統版本 Docker版本 部署項目
jeven01 192.168.3.88 Ubuntu 22.04.1 LTS 27.1.1 Kaneo

2.2 本次實踐介紹

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

三、本地環境檢查

3.1 檢查Docker服務狀態

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

root@jeven01:~#  systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
     Active: active (running) since Wed 2025-07-02 14:16:57 UTC; 21h ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 878 (dockerd)
      Tasks: 28
     Memory: 1.2G
        CPU: 1min 50.356s
     CGroup: /system.slice/docker.service
             ├─  878 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

3.2 檢查Docker版本

檢查Docker版本

root@jeven01:~# docker -v
Docker version 27.1.1, build 6312585

3.3 檢查docker compose 版本

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

root@jeven01:~# docker compose version
Docker Compose version v2.19.1

四、拉取Kaneo鏡像

拉取Kaneo相關容器鏡像，如下所示：

docker pull ghcr.io/usekaneo/api:latest
docker pull ghcr.io/usekaneo/web:latest
docker pull postgres:16-alpine

在這裏插入圖片描述

五、部署Kaneo服務

5.1 創建部署目錄

  • 創建部署目錄
mkdir -p /data/kaneo/data  &&  cd /data/kaneo

5.2 編輯部署文件

在`部署目錄下，創建docker-compose.yaml文件，注意修改KANEO_API_URL中的IP地址為自己服務器IP地址。

vim docker-compose.yaml

services:
  postgres:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: kaneo
      POSTGRES_USER: kaneo_user
      POSTGRES_PASSWORD: kaneo_password
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

  backend:
    image: ghcr.io/usekaneo/api:latest
    environment:
      JWT_ACCESS: "your-secret-key-here"
      DATABASE_URL: "postgresql://kaneo_user:kaneo_password@postgres:5432/kaneo"
    ports:
      - 1337:1337
    depends_on:
      - postgres
    restart: unless-stopped

  frontend:
    image: ghcr.io/usekaneo/web:latest
    environment:
      KANEO_API_URL: "http://localhost:1337"
    ports:
      - 5173:5173
    depends_on:
      - backend
    restart: unless-stopped

volumes:
  postgres_data:

5.3 創建Kaneo容器

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

docker compose up -d

在這裏插入圖片描述

5.4 查看Kaneo容器狀態

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

root@jeven01:/data/kaneo# docker compose ps
NAME               IMAGE                         COMMAND                  SERVICE    CREATED          STATUS                    PORTS
kaneo-backend-1    ghcr.io/usekaneo/api:latest   "docker-entrypoint.s…"   backend    17 seconds ago   Up 14 seconds (healthy)   0.0.0.0:1337->1337/tcp, [::]:1337->1337/tcp
kaneo-frontend-1   ghcr.io/usekaneo/web:latest   "/docker-entrypoint.…"   frontend   17 seconds ago   Up 15 seconds             80/tcp, 0.0.0.0:5173->5173/tcp, [::]:5173->5173/tcp
kaneo-postgres-1   postgres:16-alpine            "docker-entrypoint.s…"   postgres   17 seconds ago   Up 16 seconds             5432/tcp
root@jeven01:/data/kaneo#

5.5 查看Kaneo容器日誌

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

docker compose logs

在這裏插入圖片描述

六、訪問Kaneo服務

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

在這裏插入圖片描述

第一次進入Kaneo初始頁，我們選擇註冊賬號選項，進入賬號註冊頁。

在這裏插入圖片描述

自定義填寫賬號信息，確認創建賬號。

在這裏插入圖片描述

在這裏插入圖片描述

七、Kaneo基本使用

7.1 創建工作空間

進入Kaneo首頁，點擊中間的“Create Workspace ”選項，創建工作空間。

在這裏插入圖片描述

填寫創建的工作空間名稱，設置完畢後，點擊確認創建。

在這裏插入圖片描述

在這裏插入圖片描述

7.2 創建項目

我們點擊“ Create Project” 創建項目，如下所示：

在這裏插入圖片描述

在這裏插入圖片描述

7.3 創建任務

在創建的項目中，創建新的任務，可參考如下設置：

在這裏插入圖片描述

八、總結

通過本次實踐，我們成功使用 Docker 部署了 Kaneo 項目管理工具，實現了快速搭建和運行。整個過程操作簡便，依賴清晰，非常適合希望輕量級部署項目管理平台的團隊或個人。Kaneo 憑藉其簡潔界面、自建部署和開源免費等特性，展現出強大的實用性與靈活性。未來可以根據實際需求進一步探索其插件生態和高級功能，充分發揮其在項目管理中的潛力。