Kaneo | 开源自托管的项目管理与看板工具

Kaneo 是采用 MIT 许可的开源项目管理工具，提供工作区、项目、任务和多种工作视图，可以自托管，也有云服务。它适合需要把任务描述、负责人、讨论与执行状态放在一起的小团队；选择自托管以后，应用、数据库、备份和升级也要有人维护。

从一个项目开始，把状态含义定下来

新建工作区和项目以后，先放入少量真实任务。以网站改版为例，“调整导航”“补齐移动端布局”“核对表单”可以分别设负责人、截止时间和描述；把完成条件写清楚，接手的人才知道要交付什么。

建立项目，确定待办、进行中、待检查和完成等状态的实际含义。
添加任务与负责人，把需要交付的结果、资料和依赖写进描述。
选择适合当前工作的视图，使用过滤与搜索定位任务。
在任务评论中记录变更原因和待解决问题，再按约定更新状态。

状态列是团队的约定。进入“完成”究竟表示开发结束、审核通过还是已经上线，要先讲明白。否则即使任务都能拖动，其他人也无法据此判断下一步。

Kaneo 官方看板项目管理界面 — Kaneo 官方仓库展示的看板界面，包含状态列、任务卡片、过滤条件和项目导航；这是产品界面截图，不是本文生成的示意图。来源：https://github.com/usekaneo/kaneo/blob/main/apps/site/public/images/hero.png

同一组任务，用不同视图回答不同问题

视图或区域	主要用途	阅读时关注
Board 看板	看任务如何经过状态列	当前卡在哪一步、哪些需要交接
List 列表	集中查看、筛选与查找任务	负责人、截止时间和遗漏信息
Backlog 待规划区	整理尚未进入执行的工作	是否值得做、何时进入项目计划
Calendar / Gantt	当前 README 另列的日期与计划视图	已安装版本是否包含，以及日期、依赖是否维护准确

当前 README 还列出子任务、依赖、附件、自定义字段和时间记录等能力。需要时再加入相应信息：没有依赖关系的任务不必强行连线，不记录时间也不影响先用看板协作。旧版本的功能范围以对应说明为准。

自托管的第一步，是把应用与数据配置好

当前 Docker Compose 文档需要 Docker 与 Compose V2，提供 Kaneo 应用容器、PostgreSQL 和 postgres_data 持久卷。应用镜像整合 Web 与 API；看板数据保存在数据库中，重建应用容器不能恢复丢失的数据库。

先取得官方 compose.yml 与配套配置，再在同目录准备 .env。主要参数可以分成两组：

访问地址：KANEO_CLIENT_URL 要对应实际浏览器地址。本地示例是 http://localhost:5173；改为域名时，同时配置反向代理与 HTTPS。
数据与认证：设置 POSTGRES_DB、POSTGRES_USER、强 POSTGRES_PASSWORD 和稳定的 AUTH_SECRET。官方用 openssl rand -hex 32 分别生成密码与认证密钥。

本次核对的官方部署文档固定了 2.28.3 镜像示例，并把端口绑定在 127.0.0.1:5173；仓库根目录 Compose 则仍使用 latest 和不同端口绑定。按所选版本和部署文档准备成套文件，不混用旧版本参数与最新功能说明。

docker compose up -d
docker compose ps
curl --fail http://localhost:5173/api/health

等初始化与迁移完成，再打开界面建立初始账号。服务不健康时可以检查 docker compose logs --tail=100 kaneo postgres。官方打包镜像能从 POSTGRES_* 推导数据库连接，并从客户端地址推导 API 地址；这种方式不要求再手工拼一套不同的连接配置。

备份需要覆盖数据库、配置与实际启用的附件存储。已有数据库修改环境变量中的密码，不会自动同步数据库密码；随意更换认证密钥也会影响会话。升级前保存这些材料，检查迁移说明，并确认可以恢复。

接入开发工具时，区分两种权限

GitHub 同步使用 GitHub App

仓库同步通过 GitHub App 接入，和“使用 GitHub 账号登录 Kaneo”是两个功能。官方设置要求 Issues 读写权限，以及 Pull Requests、Contents、Metadata 的读取权限，并订阅相应事件。App 还要安装到选中的仓库，Webhook 能到达 Kaneo。

任务与 issue 可以双向同步，分支和 PR 活动也能按工作流映射移动任务。团队若把 PR 合并视为代码完成、把上线另设状态，就应按实际流程配置映射；不能只因收到仓库事件就认定业务交付完成。

MCP 按登录用户访问任务

内置 HTTP 入口是 /api/mcp，支持 OAuth 的客户端通过登录与批准接入，工具按该用户身份运行。需要 stdio 的客户端可用官方 @kaneo/mcp 包；当前文档要求 Node.js 24+，并通过设备授权登录。

HTTP 与 stdio 提供管理任务、项目、评论和标签等工具。Agent 能调用它们，不表示每次改状态或写评论都已经符合团队意图；连接权限、操作范围和项目列的实际含义仍要明确。

附件上传还需要可选的 S3 兼容存储，邮件和通知等功能也有自己的配置。可以先完成核心看板使用，再加入有明确用途的集成。自托管适合愿意维护这些条件的团队，临时个人待办则应一并衡量部署成本。

项目仓库：https://github.com/usekaneo/kaneo
Docker Compose 部署：https://kaneo.app/docs/core/installation/docker-compose
GitHub App 设置：https://kaneo.app/docs/core/integrations/github/setup
MCP 文档：https://kaneo.app/docs/core/integrations/mcp

1.本站所发布资源部分收集于网络，仅限用于学习和研究测试使用。2.本站资源售价仅为赞助网站，赞助收费仅用于网站维护运营更新，感谢您的支持。3.本站仅保证资源的正常下载和测试使用，售后不包含相关技术咨询服务，请知悉谅解。4.本站所发布资源为非实物商品，不接受退款，请考虑好再进行支付赞助获取下载。
赞助获取下载注意：
1.支付赞助成功后请勿关闭窗口或其他操作，等待系统自动确认，按钮变为获取下载按钮。2.游客操作请使用 Chrome、Edge 或 FireFox 浏览器，以免支付刷新失败(浏览器缓存7天有效)。3.如支付赞助成功后刷新无法显示下载按钮、链接失效等问题请到 【公告留言】 处理或参考下载说明文档。

THE END