一天一个开源项目（第208篇）：Kaneo - 极简自托管项目管理工具

冬奇Lab2026-09-05 20:03

引言

"The best tools are invisible --- they amplify your natural workflow instead of forcing you to adapt to them."

这是"一天一个开源项目"系列的第 208 篇文章。今天带你了解的项目是 Kaneo。

你用过 Jira 吗？用过的人大概都有这样的记忆：在能创建第一张卡片之前，先要配置项目类型、工作流方案、权限方案、通知方案......光是"开始用"就需要一个下午。

Kaneo 是对这类工具的直接反应。它的设计原则只有一句话："All you need. Nothing you don't."

Kanban 看板、列表视图、GitHub 集成、内置 MCP 服务器、Docker 一键部署------够用的功能，没有多余的按钮。8.9k Stars，MIT 协议，自托管，数据完全自主。

你将学到什么

  • Kaneo 的 Hono + React + PostgreSQL 技术栈
  • 内置 MCP 服务器如何让 Claude、Cursor 等 AI 工具直接管理项目任务
  • GitHub 集成和 Gitea 集成的工作方式
  • Board 和 List 双视图的数据模型设计
  • 四种部署方式：drim CLI、Docker Compose、Coolify、Kubernetes Helm

前置知识

  • 知道什么是 Kanban 看板
  • 了解 Docker 基础操作
  • 对 MCP（Model Context Protocol）有基本认知（可选）

项目背景

项目简介

Kaneo（发音 /kəˈneɪ.oʊ/）是一个自托管的极简项目管理工具。

它的定位很清晰：不是 Jira 的功能替代，而是 Jira 的哲学反叛。

Jira 代表的是"把所有可能的需求都放进工具里"的设计思路。Kaneo 代表的是"只放真正需要的东西"。官方描述：

"Kaneo was built as a reaction to bloated, overcomplicated project management platforms. Every unnecessary button, every complex workflow, every feature that exists to impress in demos rather than solve real problems --- all of it pulls your team's attention away from building."

在功能层面，Kaneo 提供：看板、列表、积压工作（Backlog）管理、任务分配与优先级、标签、评论、时间记录、工作流自动化、团队成员管理，以及一个公开 API。

它刻意不提供的：复杂的权限方案、自定义问题类型层级、第三方 Marketplace 应用。

作者/团队介绍

  • 主要维护者: andrejsshell（Kaneo 团队）
  • 理念来源: 作者 Andrej 描述，理想的工具应该是"不可见的"------放大团队的自然工作流，而不是强迫他们适应工具
  • 官网 : kaneo.app
  • 云服务 : cloud.kaneo.app
  • 社区 : Discord

项目数据

  • ⭐ GitHub Stars: 8,900+
  • 🍴 Forks: 746
  • 📄 License: MIT
  • 💻 主要语言: TypeScript（React + Hono）
  • 🌐 官网: kaneo.app
  • 📦 镜像: ghcr.io/usekaneo/kaneo:latest

主要功能

核心作用

Kaneo 提供一个完整的项目管理工作流，从需求规划到任务执行：

arduino 复制代码 
Workspace（工作区）
    ↓
Project（项目）
    ↓
┌──────────────────┬───────────────────┐
│  Board 视图       │   List 视图        │
│  看板拖拽         │   列表筛选排序      │
└──────────────────┴───────────────────┘
    ↓ 共享同一份数据（状态、优先级、标签同步）
Task（任务）
    ├── 负责人 + 截止日期
    ├── 优先级（P0-P3）
    ├── 标签（自定义）
    ├── 评论 + 时间记录
    └── 任务关联（前置依赖等）

使用场景

  1. 小团队替代 Jira

    • 不需要 Jira 的权限方案和自定义工作流，只需要看板和任务管理，Kaneo 的配置成本是分钟级而不是天级。

  2. AI 辅助任务管理

    • 通过内置 MCP 服务器，在 Claude 或 Cursor 对话中直接创建、查询、更新任务------不需要打开浏览器。

  3. 自托管数据主权

    • Docker 部署，数据存在自己的 PostgreSQL，不依赖任何第三方服务，完全符合数据隐私要求。

  4. 开发团队 GitHub 联动

    • 直接在 Kaneo 里看到 GitHub Issues 的状态，产品规划和代码开发用同一个视图管理。

  5. 通知集成

    • 支持 Discord、Slack、Telegram、邮件、ntfy、Gotify 和 Webhook------任意一种通知渠道都可以接入。

快速开始

最简方式（drim CLI）：

bash 复制代码 
curl -fsSL https://assets.kaneo.app/install.sh | sh
drim setup

自动处理 HTTPS、数据库配置和服务启动，适合直接部署到服务器。

Docker Compose（本地开发）：

yaml 复制代码 
# docker-compose.yml
services:
  postgres:
    image: postgres:16
    environment:
      POSTGRES_DB: kaneo
      POSTGRES_USER: kaneo
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    ports:
      - "5432:5432"

  kaneo:
    image: ghcr.io/usekaneo/kaneo:latest
    environment:
      DATABASE_URL: postgresql://kaneo:${POSTGRES_PASSWORD}@postgres:5432/kaneo
      AUTH_SECRET: ${AUTH_SECRET}
      KANEO_CLIENT_URL: http://localhost:5173
    ports:
      - "5173:5173"
    depends_on:
      - postgres
bash 复制代码 
# 生成 AUTH_SECRET
openssl rand -hex 32

# 启动
docker compose up -d
# 访问 http://localhost:5173

本地开发：

bash 复制代码 
git clone https://github.com/usekaneo/kaneo.git
cd kaneo
pnpm install
pnpm dev

核心特性

1. Board + List 双视图

两个视图共享同一份数据，状态、优先级、标签实时同步：

  • Board 视图：Kanban 拖拽，直观看到任务流转，适合日常站会
  • List 视图：表格形式，支持多维度筛选排序，适合 Sprint 计划和批量操作

切换视图不会丢失任何数据，也不需要重新配置------这是很多工具做不好的一点。

2. 内置 MCP 服务器

Kaneo 内置了一个 HTTP MCP 端点，地址是 /api/mcp，让 AI 工具可以直接操作项目任务：

bash 复制代码 
# 在 Claude Desktop 中配置
# claude_desktop_config.json
{
  "mcpServers": {
    "kaneo": {
      "command": "npx",
      "args": ["-y", "@kaneo/mcp"],
      "env": {
        "KANEO_URL": "http://localhost:5173",
        "KANEO_API_KEY": "your-api-key"
      }
    }
  }
}

配置完成后，可以在 Claude 对话里直接说：

  • "帮我在 项目名 里创建一个任务：实现用户注册功能，优先级 P1"
  • "查看本周所有未完成的高优先级任务"
  • "把 #42 任务的负责人改为 Alice"

3. GitHub 和 Gitea 集成

通过 GitHub App 授权，Kaneo 可以同步 GitHub Issues：

  • GitHub Issue 在 Kaneo 中可见，状态双向同步
  • 开发分支与任务关联，PR 合并时自动更新任务状态
  • 支持 Gitea（自托管 Git 服务）

4. Backlog 管理

独立的积压区，存放规划中但尚未进入执行的任务。按需拖入看板，不让未来的工作污染当前 Sprint 的视野。

5. 工作流自动化

自定义列（Column）和自动化规则，例如：

  • 任务移入"In Review"列时，自动通知负责人
  • 截止日期临近时，自动提升优先级
  • PR 合并时，自动将关联任务移入"Done"

6. 认证与 SSO

支持多种认证方式，所有方案在自托管版本中均免费：

  • 用户名 + 密码
  • GitHub OAuth
  • Google OAuth
  • Discord OAuth
  • 自定义 OIDC（企业 SSO）

这是与 Jira 的关键差异之一------Jira 的 SSO 需要 Guard 或 Enterprise 订阅，Kaneo 免费开放。

与 Jira 的对比

维度 Jira Kaneo
上手时间 需要配置工作流、权限方案、通知方案 分钟级
SSO 需要 Guard/Enterprise 订阅 自托管免费
自托管授权 需要 Data Center 年费 MIT 免费
云端用户数 按用户计费 $4/月起
MCP / AI 集成 无 ✅ 内置
数据所有权 托管在 Atlassian 完全自主
适合场景 大型企业复杂工作流 小团队快速迭代

项目详细剖析

技术栈：Hono + React + PostgreSQL

bash 复制代码 
apps/
  web/       ← React + TypeScript + Tailwind（前端）
  api/       ← Hono + TypeScript（后端）

packages/
  mcp/       ← @kaneo/mcp npm 包（MCP stdio 客户端）
  db/        ← PostgreSQL schema + 迁移

部署产物：
  ghcr.io/usekaneo/kaneo    ← 单一捆绑镜像（推荐）
  ghcr.io/usekaneo/web      ← 前端独立镜像
  ghcr.io/usekaneo/api      ← 后端独立镜像

选用 Hono 作为后端框架是一个值得关注的技术选择：

  • 比 Express 轻得多（约 12KB）
  • TypeScript 原生支持，无需额外配置
  • 跨运行时（Node.js、Deno、Bun、Cloudflare Workers）
  • 内置中间件覆盖认证、CORS、日志等常见需求

MCP 服务器的两种接入方式

Kaneo 的 MCP 支持两种使用模式：

HTTP 端点（服务端内嵌）：

bash 复制代码 
POST /api/mcp

适合 Web 客户端和支持 HTTP MCP 的工具。

stdio 包（npm 安装）：

bash 复制代码 
npx -y @kaneo/mcp

适合 Claude Desktop、Cursor 等基于 stdio 的 MCP 客户端。两种模式暴露相同的工具集，覆盖项目、任务、标签的完整 CRUD 操作。

部署选项对比

方式 适用场景 难度
drim CLI 生产服务器一键部署 ★☆☆
Docker Compose 本地开发或小型生产环境 ★★☆
Coolify 自托管 PaaS 用户 ★★☆
Helm / Kubernetes 企业级集群部署 ★★★

单一捆绑镜像（ghcr.io/usekaneo/kaneo:latest）是最简单的方案，前后端打包在一起。分离镜像（api + web）适合需要独立扩缩容的生产环境。

存储与通知扩展

对象存储（附件）： 支持 S3 兼容接口，可接入 MinIO（自托管）、AWS S3、Cloudflare R2。

通知渠道：

  • Discord、Slack、Telegram
  • 邮件
  • ntfy、Gotify（自托管通知服务）
  • Webhook（通用出站）

这个通知覆盖范围比大多数同类工具更广，特别是 ntfy/Gotify 的支持体现了对自托管用户生态的理解。

项目地址与资源

官方资源

相关项目

  • Hono --- 极简 Web 框架，Kaneo 后端核心
  • Planka --- 另一款开源 Trello 替代（Kaneo 提供从 Planka 的迁移工具）
  • Linear --- 商业产品，与 Kaneo 同定位（速度优先），Kaneo 有专页对比

总结与展望

核心要点回顾

  1. "Less is more"不是借口，而是设计原则：每个功能都解决真实问题，没有展示用的花活
  2. MCP 服务器是差异化亮点：项目管理工具内置 AI 接口，可以在 Claude/Cursor 里直接操作任务
  3. Hono 后端：轻量、TypeScript 原生，跨运行时------技术选型有自己的判断
  4. SSO 免费：自托管版本所有认证方案开放，不设付费墙
  5. 通知生态完整：支持 ntfy/Gotify 体现了对自托管用户群体的深刻理解

适用人群

  • 厌倦了 Jira 配置地狱的小团队：开箱即用，分钟级上手
  • 重视数据主权的开发团队：MIT 协议，自托管，数据不经过任何第三方
  • AI 工具重度用户：通过 MCP 在 Claude/Cursor 里直接管理任务，减少上下文切换
  • 开源爱好者和自托管玩家：完整的 Docker + Helm + Coolify 支持，自由部署

一句话评价

Kaneo 的答案不是"功能更少"，而是"功能恰好够用"------这两件事听起来一样，做起来完全不同。

欢迎访问 PrimeSkills ------ 一个精心策划的 AI Agent 与技能市场，所有内容均经过真实企业级工作流验证。没有噱头，只有真正有效的东西。

更多实用知识和有趣产品，欢迎访问我的个人主页

相关推荐
冬奇Lab2 小时前
Code Agent 解剖（20）：从零扩展——给 agent 加一个新工具
人工智能·开源
pandownload27 小时前
网盘不限速工具有哪些？2026实测PanDownload多线程提速方案
开源
tedcloud1239 小时前
OpenLogi 怎么搭建？用 Rust 打造一个轻量的 Logitech 外设管理工具
linux·运维·服务器·开发语言·后端·rust·开源
DolphinDB智臾科技9 小时前
不懂复杂金融数据，也能让 AI 做投研：DolphinDB 股票分析 MCP 已开源
人工智能·金融·开源
pnoker10 小时前
从工业软件到 AI 智能体：工业 AIoT 技术路线的系统梳理
java·人工智能·物联网·microsoft·开源·工业互联网
智码看视界10 小时前
Apodex-1.1-mini 部署实测：Int4 量化 18GB 单卡跑通 Agent Team，35B 开源逼近 1T Kimi
开源·agent·模型量化·智能体·开源大模型·大模型本地部署·apodex
夏文强10 小时前
DeepSeek Harness 底层探秘：Cordis 元框架与「一切皆插件」的实现
人工智能·开源·大模型·agent·deepseek
郝学胜-神的一滴11 小时前
C++11 工程级应用 08：Lambda表达式与Tuple元组
开发语言·jvm·c++·python·程序人生·开源
夏文强11 小时前
DeepSeek Harness 可追溯性实战：会话日志的 resume、fork 与 replay
人工智能·开源·大模型·agent·deepseek
热门推荐
01国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）02ZCode 周末送额度活动开启：3 亿 Token 免费领取03GitHub 镜像站点04历年考研数学一、数学二、数学三真题试卷及答案PDF05蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接062026 国产 AI 大模型横评：DeepSeek、通义千问、Kimi、文心一言、星火、豆包谁更能打？07微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新08AI 编程 IDE 全景解析 2026：Agent 全面接管开发链路09Agnes AI 免费 API 接入指南：文本、生图、生视频，一套接口全免费10VSCode SSH 连接远程服务器后，Codex 插件登录失败