开源项目 GitHub Trending 2026-07-31T12:00 正文 ok 642 words

Kaneo：为团队而非工具服务的开源项目管理平台

英文标题：🔥 usekaneo/kaneo

Kaneo 是一个采用 MIT 许可证的开源、自托管项目管理平台，主张以简洁、快速和低干扰的体验帮助团队专注于产品构建。项目认为，许多管理工具的问题并非功能不足，而是功能、通知和复杂流程过多，反而分散团队注意力。开发者可通过 drim 一键部署、Docker Compose 快速启动，也可使用 Helm Chart 在 Kubernetes 上部署。该项目同时提供环境配置、贡献指南和完整文档，支持开发者进行本地开发、生产配置与社区协作。

打开原文相关 2 · 机会 4

5.8 KB

1.2 KB

1.3 KB

2.9 KB

1.2 KB

159.2 KB

39.3 KB

14.9 KB

43.7 KB

162.3 KB

中文

在多年使用臃肿、过度复杂且会分散实际工作注意力的项目管理平台后，我们决定打造一个与众不同的 Kaneo。

多数工具的问题不在于功能不足，而在于功能过多。每一条通知、每一个不必要的按钮、每一套复杂的工作流，都会让团队偏离真正重要的事情：打造优秀产品。

我们相信，最好的工具应当是无形的。它们应当增强团队原有的自然工作流，而不是迫使团队适应工具的工作方式。Kaneo 遵循“少即是多”的原则——每一项功能的存在，都是因为它解决了真实问题，而不是因为它在演示中看起来很炫酷。

它有何不同：

简洁的界面，聚焦你的工作而非工具本身
自托管，让你的数据始终属于你
真正快速，因为我们重视性能
采用宽松 MIT 许可证的开源项目

如需了解 Kaneo 的功能与能力，请参阅我们的文档。

赞助者

Kaneo 是开源项目。如果你觉得它有用，欢迎赞助该项目，以支持持续开发。

使用 drim 一键部署

如需直接部署，可使用 drim——这是一款可为你处理全部事项的 CLI 工具：

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

就这么简单。你的 Kaneo 实例将运行起来，并自动配置 HTTPS、数据库及所有服务。

这非常适合快速部署，以及希望一切开箱即用的生产环境配置。

使用 Docker Compose 快速开始

试用 Kaneo 的最快方式是使用 Docker Compose。它会通过一个 Kaneo 容器完成 Kaneo 和 PostgreSQL 的部署：

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.yml，把 .env.sample 复制为 .env，取消注释 KANEO_CLIENT_URL=http://localhost:5173，并设置 POSTGRES_PASSWORD=<password> 和 AUTH_SECRET=<output of openssl rand -hex 32>。随后运行 docker compose up -d，并打开 http://localhost:5173。

在 Docker Compose 中，随附的 Kaneo 容器会通过服务主机名 postgres 连接 PostgreSQL。如果你在宿主机上而非 Compose 内运行 API，请使用 localhost，或显式设置 DATABASE_URL。

**重要提示：**有关详细的安装说明、环境变量配置和故障排查指南，请参阅我们的完整文档。

如需进行开发，请参阅我们的环境配置指南，其中详细说明了如何配置环境变量，以及如何排查 CORS 等常见问题。

Kaneo 需要配置多个环境变量。上述 Docker Compose 配置会自动处理数据库，但你仍需为 API 和 Web 服务配置环境变量。

如需完整配置说明，包括所有必需环境变量、非 Docker 部署的数据库配置及高级设置，请参阅文档。高级部署仍可使用独立的 ghcr.io/usekaneo/api 和 ghcr.io/usekaneo/web 镜像。

如果你运行 Kubernetes，我们提供了完整的 Helm Chart。请查看 Helm Chart 文档，获取详细安装说明、生产配置示例、TLS 设置等内容。

想要参与 Kaneo 的开发？请参阅我们的环境配置指南，其中详细说明了如何配置环境变量，以及如何排查 CORS 等常见问题。

快速开始：

# 克隆项目并安装依赖
git clone https://github.com/usekaneo/kaneo.git
cd kaneo
pnpm install

# 在根目录创建包含必需环境变量的 .env 文件
# 详细说明请参阅 ENVIRONMENT_SETUP.md

# 启动开发服务器
pnpm dev

如需了解贡献指南、代码结构和开发最佳实践，请查看我们的贡献指南和文档。

社区

我们始终欢迎以下形式的帮助：

报告 Bug 或提出功能建议
改进文档
贡献代码
在 Discord 上帮助其他用户

请查看 CONTRIBUTING.md，了解参与方式的详细信息。

MIT License——详情请参阅 LICENSE。

由 Kaneo 团队和贡献者用 ❤️ 打造

English / 原文

After years of using bloated, overcomplicated project management platforms that distracted from actual work, we built Kaneo to be different.

The problem with most tools isn't that they lack features—it's that they have too many. Every notification, every unnecessary button, every complex workflow pulls your team away from what matters: building great products.

We believe the best tools are invisible. They should amplify your team's natural workflow, not force you to adapt to theirs. Kaneo is built on the principle that less is more —every feature exists because it solves a real problem, not because it looks impressive in a demo.

What makes it different:

Clean interface that focuses on your work, not the tool
Self-hosted so your data stays yours
Actually fast because we care about performance
Open source with a permissive MIT license

Learn more about Kaneo's features and capabilities in our documentation.

Sponsors

Kaneo is open source. If you find it useful, consider sponsoring the project to help support ongoing development.

One-Click Deployment with drim

For straightforward deployments, use drim - a CLI tool that handles everything for you:

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

That's it. Your Kaneo instance will be running with automatic HTTPS, database setup, and all services configured.

Perfect for quick deployments and production setups where you want things to just work.

Quick Start with Docker Compose

The fastest way to try Kaneo is with Docker Compose. This sets up Kaneo and PostgreSQL with a single Kaneo container:

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:

Save this as compose.yml, copy .env.sample to .env, uncomment KANEO_CLIENT_URL=http://localhost:5173, and set POSTGRES_PASSWORD=<password> and AUTH_SECRET=<output of openssl rand -hex 32>, run docker compose up -d, and open http://localhost:5173.

In Docker Compose, the bundled Kaneo container reaches PostgreSQL at the service hostname postgres. If you run the API on your host instead of inside Compose, use localhost or set DATABASE_URL explicitly.

Important: See our full documentation for detailed setup instructions, environment variable configuration, and troubleshooting guides.

For development, see our Environment Setup Guide for detailed instructions on configuring environment variables and troubleshooting common issues like CORS problems.

Kaneo requires several environment variables to be configured. The Docker Compose setup above handles the database automatically, but you'll need to configure environment variables for the API and web services.

For complete configuration instructions, including all required environment variables, database setup for non-Docker deployments, and advanced settings, see the documentation. Advanced deployments can still use the separate ghcr.io/usekaneo/api and ghcr.io/usekaneo/web images.

If you're running Kubernetes, we provide a comprehensive Helm chart. Check out the Helm chart documentation for detailed installation instructions, production configuration examples, TLS setup, and more.

Want to hack on Kaneo? See our Environment Setup Guide for detailed instructions on configuring environment variables and troubleshooting common issues like CORS problems.

Quick start:

# Clone and install dependencies
git clone https://github.com/usekaneo/kaneo.git
cd kaneo
pnpm install

# Create a .env file in the root with required environment variables
# See ENVIRONMENT_SETUP.md for detailed instructions

# Start development servers
pnpm dev

For contributing guidelines, code structure, and development best practices, check out our contributing guide and documentation.

Community

We're always looking for help, whether that's:

Reporting bugs or suggesting features
Improving documentation
Contributing code
Helping other users on Discord

Check out CONTRIBUTING.md for the details on how to get involved.

MIT License - see LICENSE for details.

Built with ❤️ by the Kaneo team and contributors