Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/cokemine/nodestatus

Yet another servers monitor written in TypeScript
https://github.com/cokemine/nodestatus

Last synced: 24 days ago
JSON representation

Yet another servers monitor written in TypeScript

Host: GitHub
URL: https://github.com/cokemine/nodestatus
Owner: cokemine
License: mit
Created: 2021-01-31T16:04:00.000Z (over 3 years ago)
Default Branch: master
Last Pushed: 2024-04-13T15:58:46.000Z (2 months ago)
Last Synced: 2024-04-14T06:07:26.434Z (2 months ago)
Language: TypeScript
Homepage: https://nodestatus-production.up.railway.app
Size: 2.65 MB
Stars: 331
Watchers: 3
Forks: 64
Open Issues: 45
Metadata Files:
- Readme: README.md
- License: LICENSE

Lists

awesome-stars - cokemine/nodestatus - Yet another servers monitor written in TypeScript (TypeScript)

README

# NodeStatus

Yet another servers monitor written in TypeScript.

Current Version: 1.2.9-beta

## How To Install

If you want to update from v1.1.0 to v1.2.0 or later, you need to rebuild the database to handle the breaking change.

```bash
mv /usr/local/NodeStatus/db.sqlite /usr/local/NodeStatus/db.sqlite.bak
```

### Install locally

```bash
# Install Node.js
# Using Ubuntu
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# Using Debian, as root
curl -fsSL https://deb.nodesource.com/setup_18.x | bash -
apt-get install -y nodejs

# RHEL, CentOS, CloudLinux, Amazon Linux or Fedora as root
curl -fsSL https://rpm.nodesource.com/setup_18.x | bash -

#Install From NPM
npm i pm2 -g
# Two cli tools `status-server and status-server-run` will be installed. Default database is located at `file:/usr/local/NodeStatus/server/db.sqlite` so it's needed to add `--unsafe-perm` flag.
# You can set environment variable `DATABASE` to the location in your user's home directory in advance if you don't want to add `--unsafe-perm` flag.
npm i nodestatus-server@latest --unsafe-perm -g
status-server # start nodestatus-server
status-server-run # start nodestatus-server with pm2
pm2 status # check running status
pm2 log nodestatus # check logs

# How to Update
npm i nodestatus-server@latest --unsafe-perm -g
```

### Install with Docker (Recommended)

```bash
# Install Docker with docker-compose v2
curl -fsSL https://get.docker.com | bash -s docker
docker --version
mkdir -p ~/.docker/cli-plugins/
curl -SL https://github.com/docker/compose/releases/latest/download/docker-compose-linux-x86_64 -o ~/.docker/cli-plugins/docker-compose # for x86_64
chmod +x ~/.docker/cli-plugins/docker-compose

# Download docker-compose.yml
mkdir ~/nodestatus
cd ~/nodestatus
wget https://raw.githubusercontent.com/cokemine/nodestatus/master/docker-compose.yml
vim docker-compose.yml #修改环境变量相关配置
docker compose up -d

# How to Update
cd ~/nodestatus
docker compose down
docker pull cokemine/nodestatus:latest
docker compose up -d
```

## Client

Go Version: https://github.com/cokemine/nodestatus-client-go

Node.js Version(**Deprecated, Not Recommended**): https://github.com/cokemine/nodestatus-client

## Environment

关于环境变量的相关配置，如果是使用 Docker 请直接在 `docker-compose.yml` 配置文件中修改。

若为手动安装，则需要在本地用户目录下新建一个 `.nodestatus/.env.local` 文件（注意路径），在这个文件填写相关环境变量配置。

**INTERVAL** : 服务端向前端（浏览器）推送的间隔时间, 默认 `1500` (1.5 秒)

**DATABASE** : 数据库位置文件存放位置, 默认使用 SQLite (Linux): `file:/usr/local/NodeStatus/server/db.sqlite`，支持的数据库有 `SQLite`、`MySQL`、`PostgreSQL`，请使用对应的正确数据源链接格式填写：`SQLite` 应以 `file:` 开头, `MySQL` 应以 `mysql:` 开头, `PostgreSQL` 应以 `postgresql:` 开头。

**PORT** : NodeStatus 所用端口, 默认 `35601`

**VERBOSE** : 是否输出更多日志信息，默认 `false`

**PING_INTERVAL** : 用于心跳检测是否与客户端异常断开连接, 默认 `30` (30 秒)

**TZ** : 用于设置时区，默认 `Asia/Shanghai`

**USE_PUSH** : 是否使用 Telegram 推送, 默认 `true`

**USE_IPC** : 是否需要 IPC 修改服务端配置, 默认 `true`

**USE_WEB** : 是否需要开启一个小型 web 面板修改服务端配置, 默认 `true`

**WEB_THEME** : NodeStatus 前端使用的主题，默认 `hotaru-theme` , 可选 `hotaru-theme` | `classic-theme`

**WEB_TITLE** : 自定义站点显示标题，默认 `Server Status`

**WEB_SUBTITLE** : 自定义站点显示副标题，默认 `Servers' Probes Set up with NodeStatus`

**WEB_HEADTITLE** : 用于定义 head 标签中的 title 元素，默认 `NodeStatus`

**WEB_USERNAME** : WEB 面板用户名，默认 `admin`

**WEB_PASSWORD** : WEB 面板密码

**WEB_SECRET** : 用于 jsonwebtoken, 建议设为一个随机的字符串

**PUSH_TIMEOUT** : 客户端报警推送超时时间 (在这个时间内无论客户端发生了什么只要重新恢复与客户端的连接就不会推送), 默认 `120` (120 秒)

**PUSH_DELAY** : 报警推送服务启动延迟 (防止重启服务端后导致的集中推送), 默认 `15` (15 秒)

**TGBOT_TOKEN** : Telegram Bot Token (从 BotFather 申请到)

**TGBOT_CHATID** : Telegram Bot 需要推送的 chat_id, 如不清楚可以先启动 NodeStatus, 对 Bot 发送 `/start` 获取这个 id, 多个请用 `,` 隔开

**TGBOT_PROXY** : Telegram 代理服务器配置，例 `http://127.0.0.1:10808`，仅支持 http 代理

**TGBOT_WEBHOOK** : Telegram Webhook 配置，不填写默认 Polling,例: `https://tz.mydomain.com`，使用 Webhook 务必需要开启 https，若你使用了 https，则建议填写你的域名以开启 Webhook, 而非 Polling

## 部署到容器服务

如果你需要将 NodeStatus 部署到如 Railway 或 Okteto 等容器服务中。请注意数据持久化问题。你应该使用外部的 `MySQL` 或是 `PostgreSQL` 而不是本项目默认的 `SQLite`，因为如果使用 `SQLite` 在每次重置服务端都会导致原有的配置失效。使用时注意通过调整环境变量以使用可持续存储的数据库服务。

目前本项目还无法部署到如 Vercel 等 Serverless 服务中，因为目前 Serverless 不支持 WebSocket。

## 修改客户端配置

NodeStatus 有两种方式修改（添加 / 删除）服务器配置。

### NodeStatus-cli

若你启用了 IPC, 则可以通过 `status-cli` 修改服务器相关配置。

```shell
npm i nodestatus-cli -g
status-cli help # check cli help
```

### Web

若你启用了 Web, 则可以通过 Web 修改服务器相关配置。不需要手动安装，访问 `http://status.domain.com/admin` 即可访问面板。

同时通过 Web 面板你可以很简单的从 ServerStatus 迁移至 NodeStatus, 你可以在面板 `Import` 处将 ServerStatus 的 JSON 文件粘贴过去一键添加服务器。（需要去除多余的 `host` 字段）

面板开源地址：https://github.com/cokemine/nodestatus/tree/master/web/hotaru-admin

## 前端样式调整

如果你需要进行比较大规模的 Web 前端样式调整，建议直接修改本项目前端源代码并重新编译。本项目自带 Docker 发布的 CI，CI 环境下修改 Docker Hub 相关环境变量即可发布自定义镜像到自己的 Docker Hub 下方便后续使用，或手动通过 `docker build` 命令手动构建自定义镜像。

如果仅需进行细微调整，可以创建一个自定义样式表映射到容器内，该样式通过 `/custom/style.css` 这个 URL 自动引入到前端。

例如若你想删除 `hotaru-theme` 的头图。可以在当前目录创建一个 `assets` 目录，在其中创建 `style.css` 文件填入以下内容。

```css
#header {
background: none !important;
}

@media (max-width: 768px) {
#header {
background: none !important;
}
}
```

然后在 `docker-compose.yml`文件的 `volumes` 键中，将这个文件映射到容器内部（不要删除原有的映射条目）。

```
volumes:
- ./assets/style.css:/app/packages/nodestatus-server/build/dist/hotaru-theme/assets/custom/style.css
```

现在，你编写的样式表已经可以通过 `/custom/style.css` 这个 URL 访问，并且自动引入到了对应主题的前端生效。

## Telegram Commands

`/start` 查询当前 `chat_id`，当前 NodeStatus 版本号

`/status [name...] ` 查询当前某个服务器状态信息，匹配规则为请求为服务器名称的子字符串，多个条件请用空格分隔，若有多个条件只需满足一个条件。

## Reverse Proxy

下面是对几种常见 Web 服务器配置反向代理的实例

### Nginx v1.25.1+

```nginx
# Mozilla modern configuration
server {
listen 80;
listen [::]:80;
server_name status.domain.com; # 需要绑定的域名

location / {
return 301 https://$host$request_uri;
}
}

server {
listen 443 ssl;
listen [::]:443 ssl;
# 开启 HTTP/3
listen 443 quic reuseport;
listen [::]:443 quic reuseport;
# 开启 HTTP/2
http2 on;

server_name status.domain.com; # 需要绑定的域名
access_log /var/log/nginx/status.domain.com_nginx.log combined; # 日志位置, 目录如果不存在需要提前创建好

ssl_certificate /etc/nginx/conf.d/ssl/status.domain.com.crt; # SSL 证书路径
ssl_certificate_key /etc/nginx/conf.d/ssl/status.domain.com.key; # SSL Key 证书路径
# ssl_trusted_certificate /etc/nginx/conf.d/ssl/status.domain.com.ca.crt; # SSL CA
ssl_session_timeout 1d;
ssl_session_cache shared:MozSSL:10m; # about 40000 sessions
ssl_session_tickets off;

# modern configuration
ssl_protocols TLSv1.3;
ssl_prefer_server_ciphers off;

# HSTS (ngx_http_headers_module is required) (63072000 seconds)
add_header Strict-Transport-Security "max-age=63072000" always;

ssl_stapling on;
ssl_stapling_verify on;

location / {
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $http_host;
proxy_set_header X-NginX-Proxy true;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "Upgrade";
proxy_pass http://127.0.0.1:35601; # 反代地址
proxy_http_version 1.1;
}
}
```

### Caddy V2

```
https://status.domain.com {
encode zstd gzip
# tls your_cert_file your_key_file
# tls your_email
reverse_proxy http://127.0.0.1:35601
}
```

### Caddy V1

```
https://status.domain.com {
gzip
# tls your_cert_file your_key_file
# tls your_email
proxy / http://127.0.0.1:35601 {
websocket
transparent
}
}
```

## How To Debug

```shell
npm i pnpm -g
git clone https://github.com/cokemine/nodestatus.git
cd nodestatus
pnpm install
pnpm dev
```

## CLI Options

```shell
Usage: NodeStatus [options]

Options:
-p, --port
-i, --interval
-v, --verbose
-pi, --ping-interval
-ipc, --use-ipc
-web, --use-web
-push, --use-push
-wt, --web-theme
-wmt, --web-title
-wst, --web-subtitle
-wht, --web-headtitle
-wu, --web-username
-wp, --web-password
-ws, --web-secret
-ia, --ipc-address
-pt, --push-timeout
-pd, --push-delay
-ti, --telegram-bot-token
-tc, --telegram-chat-id
-tp, --telegram-proxy
-tw, --telegram-web-hook
-h, --help
``` Web server listening port (default: 35601, env: PORT) Update interval (default: 1500, env: INTERVAL) Verbose mode (default: false, env: VERBOSE) Ping interval (default: 30, env: PING_INTERVAL) Use IPC (default: true, env: USE_IPC) Use Web (default: true, env: USE_WEB) Use Push (default: true, env: USE_PUSH) Web theme (default: "hotaru-theme", env: THEME) Web title (default: "Server Status", env: WEB_TITLE) Web subtitle (default: "Servers' Probes Set up with NodeStatus", env: WEB_SUBTITLE) Web head title (default: "NodeStatus", env: WEB_HEADTITLE) Web username (default: "admin", env: WEB_USERNAME) Web password (default: "", env: WEB_PASSWORD) Web jwt secret (default: "node-secret", env: WEB_SECRET) IPC address (default: "\\\\.\\pipe\\status_ipc", env: IPC_ADDRESS) Push timeout (default: 120, env: PUSH_TIMEOUT) Push delay (default: 15, env: PUSH_DELAY) Telegram bot token (default: "", env: TGBOT_TOKEN) Telegram chat id (default: "", env: TGBOT_CHATID) Telegram proxy (env: TGBOT_PROXY) Telegram web hook (env: TGBOT_WEBHOOK) display help for command