Kener - 精美的状态页面系统

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

什么是 Kener？

Kener 是一个基于 SvelteKit 和 NodeJS 构建的简洁轻量状态页面系统。它并非旨在取代 Datadog 或 Atlassian 等重量级工具，而是提供一种简单、现代且轻松无虞的方式，以最小的 effort 搭建美观的状态页面。

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 >= 20
• 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 以处理事件、监控和报告

使用的技术

• SvelteKit
• shadcn-svelte

支持我

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

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

• 请我喝杯咖啡

贡献

如您希望为 Kener 做贡献，请阅读 https://github.com/rajnandan1/kener/blob/main/.github/CONTRIBUTING.md%E3%80%82

Star History