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

【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
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

null

五、部署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

null

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

null

六、访问Kaneo服务

浏览器地址： http://<个人的服务器IP>:5173，访问Kaneo的初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。

null

第一次进入Kaneo初始页，我们选择注册账号选项，进入账号注册页。

null

自定义填写账号信息，确认创建账号。

null

null

七、Kaneo基本使用

7.1 创建工作空间

进入Kaneo首页，点击中间的“Create Workspace ”选项，创建工作空间。

null

填写创建的工作空间名称，设置完毕后，点击确认创建。

null

null

7.2 创建项目

我们点击“ Create Project” 创建项目，如下所示：

null

null

7.3 创建任务

在创建的项目中，创建新的任务，可参考如下设置：

null

八、总结

通过本次实践，我们成功使用 Docker 部署了 Kaneo 项目管理工具，实现了快速搭建和运行。整个过程操作简便，依赖清晰，非常适合希望轻量级部署项目管理平台的团队或个人。Kaneo 凭借其简洁界面、自建部署和开源免费等特性，展现出强大的实用性与灵活性。未来可以根据实际需求进一步探索其插件生态和高级功能，充分发挥其在项目管理中的潜力。