DStatus 探针是一款现代化的服务器状态监控系统,提供简洁美观的用户界面和强大的探针代理监控功能。
DStatus是一个现代化的服务器状态监控系统,提供简洁美观的UI界面和强大的监控功能。
在线演示: https://demo.vps.mom
交流群组: TG
主要功能模块:
无论您是技术专家还是新手,都可以轻松部署DStatus监控系统。
只需一条命令即可完成安装:
# 下载并运行安装脚本
bash -c "$(curl -fsSL https://raw.githubusercontent.com/fev125/dstatus/main/dstatus.sh)"安装脚本提供以下功能:
如果您还没有安装Docker,请先安装:
curl -fsSL https://get.docker.com | sh打开终端或命令提示符,输入以下命令:
# 创建项目文件夹
mkdir -p dstatus
# 进入文件夹
cd dstatus
# 创建必要的数据存储文件夹
mkdir -p data database logs首先创建必要的目录并设置正确权限:
# 创建数据目录
mkdir -p data
# 设置正确的权限(确保Docker有读写权限)
chmod -R 777 data复制粘贴以下命令到终端中运行:
# 一键启动DStatus服务
docker run -d \
--name dstatus \
-p 5555:5555 \
--restart unless-stopped \
-e TZ=Asia/Shanghai \
-e NODE_ENV=production \
-v $(pwd)/data:/app/data \
ghcr.io/fev125/dstatus:latest⚠️ 注意:如果遇到权限问题(如错误信息中出现EACCES: permission denied),可以尝试以下解决方案:
方案1: 使用当前用户权限运行容器
docker run -d \ --name dstatus \ -p 5555:5555 \ --user $(id -u):$(id -g) \ --restart unless-stopped \ -e TZ=Asia/Shanghai \ -e NODE_ENV=production \ -v $(pwd)/data:/app/data \ ghcr.io/fev125/dstatus:latest方案2: 重新设置目录权限
sudo chown -R $(id -u):$(id -g) data chmod -R 777 data
http://localhost:5555http://服务器IP:5555dstatus
如果您想要更灵活的配置,可以使用Docker Compose:
确保创建必要的目录并设置正确权限:
# 创建数据目录
mkdir -p data
# 设置正确的权限
chmod -R 777 data在dstatus目录中,创建一个名为docker-compose.yml的文件,将以下内容复制粘贴进去:
version: '3.8'
services:
web:
image: ghcr.io/fev125/dstatus:latest
container_name: dstatus
ports:
- "5555:5555" # Web界面端口,可以修改为其他端口
volumes:
- ./data:/app/data # 数据库持久化
# 如果遇到权限问题,取消下面一行的注释,并替换为你的用户ID和组ID
# user: "1000:1000" # 使用 id -u 和 id -g 命令获取ID
environment:
- NODE_ENV=production
- TZ=Asia/Shanghai
restart: unless-stopped在终端中,确保您在dstatus目录下,然后运行:
docker-compose up -d与上面相同,打开浏览器访问 http://localhost:5555 或 http://服务器IP:5555
http://服务器IP:5555dstatus
当有新版本发布时,您可以按照以下步骤更新系统:
# 进入您的dstatus目录
cd dstatus
# 备份数据目录
cp -r data data_backup_$(date +%Y%m%d)确保数据目录和权限正确:
# 确保数据目录存在并有正确权限
mkdir -p data
chmod -R 777 data然后执行更新命令:
# 自动停止旧容器、拉取新镜像并启动新容器
docker stop dstatus && docker rm dstatus && docker pull ghcr.io/fev125/dstatus:latest && docker run -d --name dstatus -p 5555:5555 --restart unless-stopped -e TZ=Asia/Shanghai -v $(pwd)/data:/app/data ghcr.io/fev125/dstatus:latestDStatus服务端支持使用Docker进行部署,您可以使用以下命令快速启动:
# 拉取镜像
docker pull ghcr.io/fev125/dstatus:latest
# 启动服务
docker run -d --name dstatus \
-p 5555:5555 \
-v /path/to/database:/app/database \
-v /path/to/logs:/app/logs \
ghcr.io/fev125/dstatus:latest或者使用docker-compose进行部署(推荐):
# 下载docker-compose.yml到本地
wget https://raw.githubusercontent.com/fev125/dstatus/main/docker-compose.yml
# 创建所需目录
mkdir -p /root/dstatus/database /root/dstatus/logs
# 启动服务
docker-compose up -dDStatus提供两种方式实现Docker容器的自动更新:
我们在docker-compose.yml中已集成Watchtower容器,它会自动检查并更新DStatus容器。默认配置下,更新检查周期为24小时。
使用docker-compose启动服务时,会自动启动Watchtower:
docker-compose up -d您可以通过修改docker-compose.yml中的环境变量来调整Watchtower的行为:
WATCHTOWER_POLL_INTERVAL: 检查更新的间隔时间(秒),默认为86400(24小时)WATCHTOWER_CLEANUP: 更新后是否清理旧镜像,默认为true如果您不希望使用Watchtower,也可以使用我们提供的更新脚本手动更新容器:
# 下载更新脚本
wget https://raw.githubusercontent.com/fev125/dstatus/main/docker-update.sh
chmod +x docker-update.sh
# 执行更新
./docker-update.sh更新脚本会自动执行以下操作:
您也可以将此脚本添加到crontab中实现定时自动更新:
# 编辑crontab
crontab -e
# 添加以下内容(每天凌晨3点执行更新)
0 3 * * * cd /path/to/dstatus && ./docker-update.sh >> /path/to/dstatus/update.log 2>&1答:这是权限问题导致的,有以下解决方法:
mkdir -p datachmod -R 777 data--user $(id -u):$(id -g) 参数user: "1000:1000" (使用实际的用户ID和组ID)答:DStatus本身非常轻量,Docker容器仅占用约50-100MB内存,CPU使用率极低。
答:运行命令 docker logs -f dstatus 可以实时查看日志。
答:您可以重置密码,执行:
docker exec -it dstatus node reset-password.js答:修改docker启动命令中的-p 5555:5555,将第一个5555改为您想要的端口,例如:-p 8080:5555
答:定期备份data目录即可:
cp -r ./data ./data_backup_$(date +%Y%m%d)server {
listen 443 ssl;
server_name status.example.com;
ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;
location / {
proxy_pass http://127.0.0.1:5555;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}mkdir -p data
chmod -R 777 data# 备份数据目录
cp -r ./data ./data_backup_$(date +%Y%m%d)/app/data目录以持久化数据# 添加每日备份任务到crontab
echo "0 2 * * * cd /path/to/dstatus && cp -r ./data ./data_backup_\$(date +\%Y\%m\%d)" >> /etc/crontab# 启动容器
docker start dstatus
# 停止容器
docker stop dstatus
# 查看日志
docker logs -f dstatus
# 进入容器
docker exec -it dstatus /bin/bash# 启动服务
node nekonekostatus.js
# 后台运行
npm install -g forever
forever start nekonekostatus.js
# 查看日志
tail -f logs/app.log| 变量名 | 默认值 | 描述 |
|---|---|---|
| TZ | Asia/Shanghai | 时区设置 |
| NODE_ENV | production | 运行环境 |
| PORT | 5555 | 服务端口 |
| DB_PATH | /app/database | 数据库存储路径 |
| DATA_PATH | /app/data | 核心数据存储路径(SQLite数据库) |
| LOG_LEVEL | info | 日志级别 (debug/info/warn/error) |
| BOT_ENABLED | false | 是否启用 Telegram Bot |
| BOT_TOKEN | - | Telegram Bot Token |
DStatus 提供了简单的 API 接口,用于获取服务器状态数据:
GET /stats/:serverID/data响应示例:
{
"sid": "server123",
"stat": {
"cpu": {
"multi": 0.12,
"single": [0.08, 0.15, 0.14, 0.11]
},
"mem": {
"mem": 0.45,
"swap": 0.02
},
"disk": {
"used": 128849018880,
"total": 512110190590
},
"net": {
"delta": {
"in": 51200,
"out": 24576
},
"total": {
"in": 1073741824,
"out": 536870912
}
}
}
}本项目采用 MIT License 开源协议。
系统使用neko-status作为探针采集服务器数据。探针支持以下功能:
我们通过GitHub Actions自动构建neko-status二进制文件:
在管理员设置页面中,您可以配置neko_status_url参数指向正确的下载地址。推荐使用GitHub Pages链接:
https://fev125.github.io/dstatus/neko-status暂无开放 Issues,或尚未同步最近议题。