源码系统概览
文章正文
Kaneo 是近年热度较高的开源项目管理平台，主打「少即是多」设计，GitHub 上约三千三百颗星标，采用 MIT 协议免费开源。
本次发布的是 Kaneo 完整项目源码，前端为 React 单页应用，后端为 Node.js 的 Hono API 服务，前后端分离，支持自托管部署。
想给团队搭一套轻量项目管理系统，或者想研究现代工程化实践，这份源码都够用。
源码简介
Kaneo 由开源社区 usekaneo 团队维护，GitHub 原版仓库为 usekaneo/kaneo，项目至今保持活跃维护，采用宽松的 MIT 协议，允许自由使用、修改与商用。
源码采用 pnpm 管理的 Monorepo 结构，包含 Web 前端、API 服务、邮件服务与 MCP 服务，共一千三百余个文件，TypeScript 占比超过九成。
功能覆盖看板、列表、Backlog 需求池、甘特图、任务、标签、评论、时间记录、成员邀请与角色权限等项目管理全流程。
系统内置开放 REST API 与 OpenAPI 文档，支持 API Key 编程式管理，还自带 MCP 服务，可接入 Claude Code 等 AI 编程工具。
适用场景
觉得 Jira 过于臃肿、又需要数据完全可控的中小团队，可以把 Kaneo 当作轻量替代方案。
企业可在内网部署，所有项目数据保存在自己的 PostgreSQL 数据库中，不依赖第三方云服务。
前端开发者也能从这份源码学习 React 19、TanStack Router、dnd-kit 拖拽与 Tailwind CSS 的工程化用法。
功能亮点
看板视图基于 dnd-kit 实现卡片拖拽，支持跨列移动，拖拽时带过渡动画。
列表视图与 Backlog 需求池让需求收集、排期与执行在一处完成，甘特图则直观展示任务时间线。
内置 GitHub 与 Gitea 集成，支持 issue 导入与 Webhook 同步，工作流规则可自动移动任务到指定列。
认证基于 better-auth，支持邮箱密码、验证码与第三方 OAuth 登录，可选接入 Cloudflare Turnstile 人机验证。
与同类项目相比，WeKan 偏纯看板，Planka 同样开源免费，但 Kaneo 在视图丰富度、托管集成与开放 API 上更接近商业工具。
Kaneo 与同类开源看板项目对比：
| 对比项 | Kaneo | WeKan | Planka |
|---|---|---|---|
| 开源协议 | MIT | MIT | AGPL |
| 主要视图 | 看板、列表、Backlog、甘特图 | 看板 | 看板 |
| 代码托管集成 | GitHub、Gitea | 有限 | 有限 |
技术架构与部署指南
技术栈与运行环境
前端：React 19、Vite 构建、TanStack Router 路由、TanStack Query 数据请求、Tailwind CSS 样式、Radix UI 组件库与 dnd-kit 拖拽库。
后端：Node.js 与 TypeScript，Hono 轻量框架提供 REST API，better-auth 处理认证授权，Drizzle ORM 操作数据库，WebSocket 支撑实时协作。
数据库：PostgreSQL 16 及以上版本，包含用户、工作区、项目、任务、列、标签、评论、时间记录、邀请与 API Key 等二十余张数据表。
运行环境：Node.js 20.19 及以上，支持 Docker Compose 一键部署，也提供 Kubernetes Helm Chart 与 drim CLI 两种生产安装方式。
其他依赖：Redis 可选用于多实例 WebSocket 消息同步，未配置时自动降级为内存模式，对象存储兼容 S3 接口用于保存附件。
安装与部署提示
官方推荐 Docker Compose 方式，一条 compose 文件即可拉起 PostgreSQL 与 Kaneo 容器，复制 .env.sample 为 .env 即可启动。
生产环境务必配置 AUTH_SECRET，可用 openssl rand -hex 32 生成，否则服务重启后用户会话会全部失效。
Kubernetes 用户可直接使用官方 Helm Chart，图表内置 API、Web、PostgreSQL 及可选的 Ingress 网关配置。
本地开发在仓库根目录执行 pnpm install 与 pnpm dev，Turbo 会同时启动前后端开发服务。
截图与演示说明
本页为源码发布页面，不含在线演示截图，以下依据源码结构描述主要界面。
登录后进入工作区仪表盘，侧边栏提供项目导航与工作区切换，全局命令面板可快速搜索并跳转任务。
看板页面位于项目下的 board 路由，列按工作流顺序排列，卡片显示任务标题、标签颜色与负责人，支持拖拽排序与跨列移动。
Backlog 需求池与列表视图用于需求收集和排期，甘特图页面以时间条形式直观呈现任务计划。
任务详情页包含描述、评论、子任务、附件、标签、时间记录、关联任务与外部链接，并内置键盘快捷键面板。
常见问题
问：Kaneo 是什么？
答：Kaneo 是一款开源的极简项目管理平台，主打看板与任务管理，前后端分离，可自托管部署。
问：这套源码怎么使用？
答：本地开发运行 pnpm install 与 pnpm dev，生产环境推荐用 Docker Compose 或 Helm Chart 一键部署，源码已包含完整部署配置。
问：Kaneo 与 Jira、Linear、Focalboard 有什么区别？
答：Jira 功能全面但配置复杂，Linear 体验出色却无法自托管，Focalboard 侧重看板与表格视图，Kaneo 则以轻量自托管提供看板、Backlog、甘特图等常用能力。
问：这个源码是否免费？
答：完全免费，项目采用 MIT 协议，个人与企业均可自由使用、修改与二次分发，商用需保留版权声明。
安全风险提示
本次对源码进行了安全扫描，未发现 eval、base64_decode、shell_exec 等危险函数调用，也未检出硬编码的真实凭据或后门代码。
特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
下载说明
本页仅提供 Kaneo 开源项目源码的介绍与免费下载入口，源码版权归原作者所有，使用请遵守 MIT 条款。
下载后请先核对源码完整性，在隔离环境完成部署测试与安全审计后再接入生产业务。
GitHub项目开源地址：https://github.com/usekaneo/kaneo
最后更新：2026-08-18
