当前位置：

社区首页

电脑数码

软件应用

办公软件

文章详情

Docker实战：使用Docker部署Kaneo项目管理工具

一、Kaneo介绍

1.1 Kaneo简介

Kaneo是一个专注于简洁与高效的开源项目管理平台。它可以自建部署，支持个性化定制，真正为你所用。无论是个人项目还是团队协作，Kaneo 都能提供恰到好处的功能，既不过度复杂，也不失实用性。

1.2 Kaneo主要特点

简洁直观的界面设计 —— 让你专注于工作本身，而不是操作工具。
支持自建部署（Self-hosted） —— 完全掌控你的数据，保障隐私与安全。
性能优化出色，响应迅速 —— 从用户体验出发，打造真正高效的使用流程。
完全开源且永久免费 —— 无任何隐藏费用，代码透明，社区驱动持续改进。
功能强大但不冗余 —— 满足复杂项目需求的同时，保持使用上的轻便与灵活。

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为Ubuntu 22.04.1。

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 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 凭借其简洁界面、自建部署和开源免费等特性，展现出强大的实用性与灵活性。未来可以根据实际需求进一步探索其插件生态和高级功能，充分发挥其在项目管理中的潜力。

作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～