wjy20030407/status

Status Docker镜像文档

镜像概述和主要用途

Status是基于ServerStatus-Hotaru的美化修改版Docker镜像，主要用于服务器状态的监控与管理。通过配置文件可添加多台服务器信息，支持Docker Engine和Docker Compose两种部署方式，方便用户快速搭建服务器监控系统。

核心功能和特性

• 支持多服务器配置与监控
• 提供简洁的配置文件格式
• 支持Docker容器化部署，便于维护和升级
• 自动重启机制，确保服务稳定运行
• 开放HTTP端口(8080)和主服务端口(35601)

使用场景和适用范围

适用于需要监控多台服务器状态的个人或企业用户，尤其适合对服务器资源使用情况、运行状态进行集中管理的场景。支持阿里云、腾讯云等不同类型服务器的监控配置。

详细使用方法和配置说明

设置Status配置文件

创建config.json配置文件，用于定义需要监控的服务器信息：

json
{
    "servers": [
        {
            "username": "阿里云用户名",
            "password": "阿里云密码",
            "name": "阿里云服务器",
            "type": "Dedicated",
            "host": "",
            "location": "中国北京",
            "disabled": false,
            "region": "cn"
        },
        {
            "username": "腾讯云用户名",
            "password": "腾讯云密码",
            "name": "腾讯云服务器",
            "type": "KVM",
            "host": "",
            "location": "中国香港",
            "disabled": false,
            "region": "hk"
        }
    ]
}

配置项说明：

• username: 服务器登录用户名
• password: 服务器登录密码
• name: 服务器名称（自定义）
• type: 服务器类型（如Dedicated、KVM等）
• host: 服务器主机地址（留空可自动检测）
• location: 服务器地理位置
• disabled: 是否禁用该服务器监控（true/false）
• region: 服务器所在地区代码

安装

Status Docker镜像支持以下两种安装方式：

使用Docker Engine安装

1. 设置STATUS_HOME变量（可选，用于自定义目录）
2. 运行以下命令启动容器：

bash
sudo docker run --detach \
    --publish 8080:8080 \
    --publish 35601:35601 \
    --name status \
    --restart always \
    --volume $PWD/config.json:/opt/config.json \
    wjy20030407/status:latest

参数说明：

• --detach: 后台运行容器
• --publish 8080:8080: 映射HTTP访问端口
• --publish 35601:35601: 映射主服务端口
• --name status: 容器名称
• --restart always: 系统重启后自动启动容器
• --volume: 挂载本地配置文件到容器内

使用Docker Compose安装

1. 安装Docker Compose
2. 创建docker-compose.yml文件：

yaml
status:
    image: "wjy20030407/status:latest"
    restart: always
    ports:
        - "8080:8080"
        - "35601:35601"
    volumes:
        - "$PWD/config.json:/opt/config.json"

3. 在docker-compose.yml所在目录执行以下命令启动服务：

bash
docker-compose up -d

更新

使用Docker Engine更新

1. 停止运行中的容器：

bash
sudo docker stop status

2. 删除现有容器：

bash
sudo docker rm status

3. 拉取最新镜像：

bash
sudo docker pull wjy20030407/status:latest

4. 使用之前的配置重新创建容器：

bash
sudo docker run --detach \
    --publish 8080:8080 \
    --publish 35601:35601 \
    --name status \
    --restart always \
    --volume $PWD/config.json:/opt/config.json \
    wjy20030407/status:latest

使用Docker Compose更新

执行以下命令更新镜像并重启服务：

bash
docker-compose pull
docker-compose up -d

注意：如果使用了特定镜像标签，需先编辑docker-compose.yml文件更新标签后再执行上述命令。

故障排除

诊断潜在问题

查看容器日志：

bash
sudo docker logs status

进入运行中的容器：

bash
sudo docker exec -it status /bin/sh

相关开源项目

• ServerStatus-Hotaru: https://github.com/CokeMine/ServerStatus-Hotaru
• ServerStatus-Toyo: https://github.com/ToyoDAdoubiBackup/ServerStatus-Toyo
• ServerStatus: https://github.com/BotoX/ServerStatus
• mojeda's ServerStatus: https://github.com/mojeda/ServerStatus
• BlueVM's project: [***]