ghcr.io/rajnandan1/kener:main-with-docs-eec52e6

Kener - 出色的状态页面系统

| ----------------------------------- | ----------------------------------------------------------------------- | -------------------------------------------------------------------------- |

什么是 Kener？

Kener 是一个使用 SvelteKit 和 NodeJS 构建的简洁轻量型状态页面系统。它并非旨在替代 Datadog 或 Atlassian 等重量级工具，而是提供一种简单、现代且无麻烦的方式，让您以最小的工作量快速搭建美观的状态页面。

Kener 以 易用性 和 可定制性 为设计理念，提供状态页面所需的所有核心功能，同时避免不必要的复杂性。

为什么选择 Kener？

✅  低开销 – 快速搭建，拥有简洁现代的 UI
✅  可定制 – 轻松调整以匹配您的品牌
✅  开源免费 – 因为优秀的工具应面向所有人开放

名称由来？

“Kener” 的灵感来源于阿萨姆语单词 “Kene”，意为 “最近怎么样？”。添加 ‘.ing’ 后缀是因为……那个域名可用。😄

快速开始

几分钟内即可启动 Kener。

Docker（推荐）

git clone https://github.com/rajnandan1/kener.git
cd kener

# 使用 docker-compose.yml（包含 Redis + Kener）
# 首次运行前，在 docker-compose.yml 中设置强 KENER_SECRET_KEY 和 ORIGIN
docker compose up -d

打开 http://localhost:3000。

[!IMPORTANT] 首次启动前，设置强 KENER_SECRET_KEY 并将 ORIGIN 设置为您的公共 URL。

如果希望从本地源代码构建而非拉取已发布镜像，请使用 docker-compose.dev.yml：

docker compose -f docker-compose.dev.yml up -d --build

或者组合两个文件，以保留基础生产配置，同时使用本地构建覆盖 Kener：

docker compose -f docker-compose.yml -f docker-compose.dev.yml up -d --build

运行预构建镜像

您可以使用以下任一镜像：

• docker.io/rajnandan1/kener:latest
• ghcr.io/rajnandan1/kener:latest

对于子路径部署（/status），使用：

• docker.io/rajnandan1/kener:latest-status
• docker.io/rajnandan1/kener:latest-status-alpine
• ghcr.io/rajnandan1/kener:latest-status
• ghcr.io/rajnandan1/kener:latest-status-alpine

mkdir -p database
docker run -d \
--name kener \
-p 3000:3000 \
-v "$(pwd)/database:/app/database" \
-e "KENER_SECRET_KEY=replace_with_a_random_string" \
-e "ORIGIN=http://localhost:3000" \
-e "REDIS_URL=redis://host.docker.internal:6379" \
docker.io/rajnandan1/kener:latest

运行预构建子路径镜像（/status）

mkdir -p database
docker run -d \
--name kener-status \
-p 3000:3000 \
-v "$(pwd)/database:/app/database" \
-e "KENER_SECRET_KEY=replace_with_a_random_string" \
-e "ORIGIN=http://localhost:3000" \
-e "KENER_BASE_PATH=/status" \
-e "REDIS_URL=redis://host.docker.internal:6379" \
docker.io/rajnandan1/kener:latest-status

[!NOTE] 对于子路径模式，请将 ORIGIN 保留为站点源（http://localhost:3000），而非 http://localhost:3000/status。

不使用 Docker 运行

要求：

• Node.js >= 24.14
• Redis

git clone https://github.com/rajnandan1/kener.git
cd kener
npm install

# 启动 Redis（示例）
docker run -d --name kener-redis -p 6379:6379 redis:7-alpine

npm run build
npm run start

创建至少包含以下内容的 .env 文件：

KENER_SECRET_KEY=replace_with_a_random_string
ORIGIN=http://localhost:3000
REDIS_URL=redis://localhost:6379
PORT=3000

完整快速入门（包括本地 Docker 构建和开发模式），请参阅文档：

• [***]

功能特性

Kener 结合了公共状态页面的基本功能与高级管理工作流。

📊  监控、可靠性与通信

• 监控 API、Ping、TCP、DNS、SSL、SQL、Heartbeat 和 GameDig 检查
• 通过清晰的时间线、更新和确认来管理事件
• 安排维护窗口并全程通知用户
• 通过 **Email、Webhook、Slack 和 ***** 发送通知
• 探索历史监控数据和正常运行时间趋势

🎨  状态页面体验与品牌化

• 构建品牌化、可定制的状态页面（徽标、颜色、CSS、主题）
• 支持 明暗模式、本地化和时区感知显示
• 将状态小部件和徽章嵌入外部网站和门户
• 为全球用户提供 SEO 友好的公共页面

🛠️  运营、协作与自动化

• 邀请团队进行跨工作流的基于角色的协作
• 从一个 Kener 实例管理多个状态页面
• 使用基于触发器的工作流和模板驱动的消息传递
• 管理 API 密钥以实现安全集成和自动化
• 集成分析提供商，如 GA、Plausible、Mixpanel、Umami 和 Clarity
• 访问完整的 REST API 以处理事件、监控和报告

使用的技术

• https://kit.svelte.dev/
• shadcn-svelte

支持我

如果您喜欢 Kener 并希望支持其开发，请考虑在 GitHub 上赞助我或请我喝杯咖啡。您的支持有助于项目不断发展！🚀

• https://github.com/***/rajnandan1

• 请我喝杯咖啡

贡献指南

如果您想为 Kener 做贡献，请阅读 https://github.com/rajnandan1/kener/blob/main/.github/CONTRIBUTING.md。

Star History