常见问题 (FAQ)

数据共享

默认情况下，Kite 不会收集任何分析数据。 如果您希望帮助改进产品，您可以在初始化页面或通用设置中，通过「启用数据统计」开关开启或关闭统计。

开启后，Kite 服务端每 24 小时上报一次安装统计，用于帮助改进产品。上报内容包括：

• 随机生成的安装 ID
• Kite 版本及已连接的 Kubernetes 集群版本
• 已安装插件的 ID、版本和启用状态
• 运行平台的操作系统和 CPU 架构

上报实现见源代码。

权限问题

如果在访问资源时，遇到如下错误提示，

用户 admin 没有权限在集群 in-cluster 的命名空间 kite 中执行 获取 configmaps

表示用户 admin 没有权限访问 kite 命名空间中的 configmaps 资源。

你需要参考 RBAC 配置指南 来配置用户的权限。

托管 Kubernetes 集群连接问题

如果您使用托管 Kubernetes 集群（AKS、EKS、GKE 等）并在将集群添加到 Kite 时遇到身份验证错误，这通常是因为默认的 kubeconfig 使用了需要 CLI 工具（如 kubelogin、aws 或 gcloud）的 exec 插件。

Kite 作为服务端应用运行，无法执行这些客户端身份验证工具。相反，您应该使用基于 Service Account token 的身份验证。

请参考托管 Kubernetes 集群配置指南，了解如何创建和使用 Service Account token 进行身份验证的详细说明。

持久化相关

Kite 支持使用 SQLite、MySQL 或 PostgreSQL 作为数据库。

你可以通过环境变量 DB_DSN 来配置数据库连接字符串，DB_TYPE 来指定数据库类型（默认为 sqlite）。

• 如果使用 SQLite，默认情况下数据将存储在容器内，这意味着如果容器被删除，数据也会丢失。为了持久化数据，你需要将一个持久化卷挂载到 /data 路径，并设置环境变量 DB_DSN=/data/db.sqlite。（注意：/data 并非默认路径，你可以根据需要选择其他路径，但必须确保 DB_DSN 中的路径与挂载路径一致。）
• 如果使用 MySQL 或 PostgreSQL，你需要提供相应的连接字符串，例如 DB_DSN=user:password@tcp(host:port)/dbname。

建议通过 Helm Chart 进行安装，这样你可以更方便地配置持久化存储和数据库连接。

SQLite 使用 hostPath 存储问题

如果您使用 SQLite 作为数据库，并在使用 hostPath 进行持久化存储时遇到"out of memory"错误：

panic: failed to connect database: unable to open database file: out of memory (14)

此问题与 Kite 使用的纯 Go SQLite 驱动有关（为避免 CGO 依赖）。该驱动在访问某些存储后端上的数据 库文件时存在限制。

解决方案：添加 SQLite 连接选项以提高与 hostPath 存储的兼容性。在 Helm values 中设置：

db:
  sqlite:
    options: "_journal_mode=WAL&_busy_timeout=5000"

这些选项启用预写日志（WAL）模式并增加忙碌超时时间，可以解决大多数 hostPath 兼容性问题。

生产环境推荐：对于需要持久化存储的生产环境部署，建议使用 MySQL 或 PostgreSQL 代替 SQLite。这些数据库更适合容器化环境和持久化存储场景。

更多详情请参见 Issue #204。

如何更改字体

Kite 默认提供三种字体：系统默认、Maple Mono 和 JetBrains Mono。

如果您想使用其他字体，则需要自己构建项目。

用 make 构建 kite，并在 ./ui/src/index.css 中更改字体

@font-face {
  font-family: "Maple Mono";
  font-style: normal;
  font-display: swap;
  font-weight: 400;
  src:
    url(https://cdn.jsdelivr.net/fontsource/fonts/maple-mono@latest/latin-400-normal.woff2)
      format("woff2"),
    url(https://cdn.jsdelivr.net/fontsource/fonts/maple-mono@latest/latin-400-normal.woff)
      format("woff");
}

body {
  font-family: "Maple Mono", var(--font-sans);
}

我如何为 Kite 做出贡献？

我们欢迎贡献！您可以：

• 在 GitHub Issues 上报告错误和功能请求
• 提交拉取请求
• 改进文档
• 分享反馈和使用案例

我在哪里可以获得帮助？

您可以通过以下方式获得支持：

• GitHub Issues 用于提交错误报告和功能请求
• Slack Community 用于提问和社区支持

---

没有找到您要找的内容？ 欢迎在 GitHub 上提交问题或开始一个讨论。