Kaneo

项目动机

Kaneo 是一款轻量、自托管的项目管理工具，针对市面上过于臃肿、流程繁杂的项目管理平台而设计。作者认为问题不在于功能不足，而在于冗余：过多的通知、按钮和工作流会干扰团队专注真正的目标——打造优秀产品。Kaneo 秉持"少即是多"的理念，每个功能只为解决真实问题而存在，目标是让工具"隐形"于工作流之中。

核心差异点：

• 简洁界面：聚焦工作内容本身
• 自托管：数据完全归用户所有
• 高性能：注重响应速度与运行效率
• 开源：采用宽松的 MIT 协议

快速部署

一键部署脚本

通过官方 CLI 工具 drim 可完成自动 HTTPS、数据库与服务初始化：

curl -fsSL https://assets.kaneo.app/install.sh | sh
drim setup

Docker Compose

将以下内容保存为 compose.yml，复制 .env.sample 为 .env，设置 POSTGRES_PASSWORD 与 AUTH_SECRET（可使用 openssl rand -hex 32 生成），启动后访问 http://localhost:5173：

services:
  postgres:
    image: postgres:16-alpine
    env_file:
      - .env
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U kaneo -d kaneo"]  # 健康检查
      interval: 10s
      timeout: 5s
      retries: 5

  kaneo:
    image: ghcr.io/usekaneo/kaneo:latest
    ports:
      - "5173:5173"
    env_file:
      - .env
    depends_on:
      postgres:
        condition: service_healthy  # 等待数据库就绪后再启动
    restart: unless-stopped

volumes:
  postgres_data:

注意事项：Compose 网络内使用服务名 postgres 连接数据库；若在宿主机直接运行 API，需改为 localhost 或显式设置 DATABASE_URL。

Kubernetes 部署

提供完整的 Helm Chart，支持生产级配置、TLS 证书、Ingress 等设置，详见 charts/kaneo/README.md。

开发模式

克隆仓库后使用 pnpm 启动：

git clone https://github.com/usekaneo/kaneo.git
cd kaneo
pnpm install
# 在根目录创建 .env 文件，参考 ENVIRONMENT_SETUP.md
pnpm dev  # 同时启动 API 与 Web 开发服务器

环境变量、CORS 配置、数据库连接等细节需查阅 ENVIRONMENT_SETUP.md。

MCP 集成

Kaneo 提供官方 MCP（Model Context Protocol）服务器，允许 Claude、Cursor 等 AI 工具直接管理任务、项目与标签：

• HTTP 端点：每个实例内置 /api/mcp
• stdio 客户端：通过 npm 包 @kaneo/mcp 接入

npx -y @kaneo/mcp

配置说明

Docker Compose 已自动处理数据库连接，但 API 与 Web 服务仍需配置环境变量。高级部署场景可分别使用独立镜像 ghcr.io/usekaneo/api 与 ghcr.io/usekaneo/web。

社区与贡献

项目通过 Discord、GitHub Issues 维护用户与开发者沟通。贡献形式涵盖 Bug 报告、功能建议、文档改进、代码提交以及社区答疑，具体流程参见 CONTRIBUTING.md。

许可证

采用 MIT 协议，详见 LICENSE 文件。