Skip to content

Kener状态页封面|461x668

Kener 简介

Kener 是一款现代化的开源状态页系统(Status Page),专为个人和团队打造,帮助你优雅地展示服务/网站的运行状态、公告和事故历史。它不仅适合自托管,还支持多用户协作和品牌自定义。

官方演示站:https://kener.ing

主要特点

  • 极简美观:现代化UI,极易上手
  • Docker一键部署:支持Docker Compose快速上线
  • 多语言国际化:内置多国语言,支持全球用户
  • 品牌定制:支持自定义站点名称、Logo、主题色
  • 团队协作:可与GitHub集成,事故管理更高效

适用场景

  • 服务状态展示:SaaS/云服务/网站对外展示服务健康状态
  • 内部监控可视化:内部服务状态可视化、事故透明化管理
  • 个人项目监控:个人项目、独立开发者自建状态页

部署环境准备

  1. 已安装 DockerDocker Compose(参考本站《Linux Docker 安装指南》)
  2. 服务器资源建议:
    • CPU:1 核+
    • 内存:512 MB+
    • 磁盘:1 GB 可用空间
  3. (可选) 绑定域名,便于 HTTPS 访问和品牌展示

使用 Docker Compose 部署 Kener

1. 创建目录

bash
mkdir -p ~/kener/config
cd ~/kener

2. 编写 docker-compose.yml

bash
cat > docker-compose.yml << 'EOF'
services:
  kener:
    image: rajnandan1/kener:latest
    container_name: kener
    restart: always
    environment:
      - TZ=Asia/Shanghai
      - KENER_SECRET_KEY=${KENER_SECRET_KEY}  # 必填,见下方说明
      - ORIGIN=http://你的服务器IP:3212      # 必填,见下方说明
      # - GH_TOKEN=xxxxxx   # (可选)GitHub集成令牌
      # - PUID=1000         # (可选)主机用户ID
      # - PGID=1000         # (可选)主机用户组ID
    ports:
      - "3212:3000"   # 宿主机端口:容器端口
    volumes:
      - ./config:/config:rw  # 配置与监控数据持久化
EOF

参数说明

  • image:官方最新镜像,支持多平台
  • container_name:容器名称,便于管理
  • TZ:时区,建议设置为 Asia/Shanghai
  • KENER_SECRET_KEY必填,用于加密和安全校验,需使用高强度随机字符串。建议用如下命令生成:
    bash
    openssl rand -base64 32
  • ORIGIN必填,填写实际访问地址(如 http://你的服务器IP:3212https://你的域名)。
  • GH_TOKEN:如需GitHub集成可配置
  • PUID/PGID:如在Linux主机可指定运行用户权限
  • ports:默认3212映射到容器3000端口
  • volumes:挂载本地配置目录,确保数据持久化

注意:如缺少 KENER_SECRET_KEYORIGIN,页面会提示环境变量未设置,需补全后重启服务。

3. 启动服务

bash
docker compose up -d

基本配置

1. 访问主界面

浏览器访问:

bash
http://<服务器IP或域名>:3212

首次进入可根据提示完成初始配置。

2. 绑定域名(推荐)

如需通过 自定义域名 + HTTPS 访问 Kener,推荐搭配 Nginx Proxy Manager 进行反向代理与 SSL 证书配置。

详细步骤请参见:《使用 Docker 快速部署 Nginx Proxy Manager 实现多域名反向代理

配置完成后,即可安全地通过 https://status.example.com 访问你的 Kener 状态页。


数据备份与恢复

Kener 所有配置与监控数据均存放于 ./config(容器内 /config)目录。建议定期离线备份并验证可用性。

1. 备份数据

bash
# 创建备份文件
cd ~/kener
 tar -czvf kener-backup-$(date +%Y%m%d).tar.gz -C ./config .

2. 恢复数据

bash
# 停止服务
cd ~/kener
docker compose down

# 恢复备份(请将 YYYYMMDD 替换为实际备份日期)
tar -xzvf kener-backup-YYYYMMDD.tar.gz -C ./config

# 重新启动服务
docker compose up -d

常见问题(FAQ)

问题解决方案
页面提示 KENER_SECRET_KEY 或 ORIGIN 未设置?按文档补全环境变量,并重启服务
如何修改访问端口?修改 docker-compose.ymlports 映射并重启服务
如何添加/编辑监控?通过 Web 界面添加,首次添加后自动生成 monitors.yaml
支持HTTPS/自定义域名吗?推荐配合 Nginx Proxy Manager 反向代理实现
如何升级Kener?执行 docker compose pull && docker compose up -d
如何备份和恢复?直接备份/还原 ./config 目录

完成部署

至此,你已成功自托管部署优雅的状态页系统 Kener。如有问题,欢迎在评论区留言或访问项目 GitHub


相关阅读: