antonyleons/ward

镜像概述

Ward是一款简洁简约的服务器监控工具，采用自适应设计系统，支持深色主题。它仅显示关键服务器信息，提供美观的仪表盘，替代传统的数字和图表堆砌，适合希望快速查看服务器状态的用户。

核心功能与特性

• 简洁设计：专注展示关键信息，避免冗余数据干扰
• 自适应布局：适配各种屏幕尺寸，在桌面和移动设备上均有良好显示效果
• 主题切换：支持light（浅色）和dark（深色）两种主题模式
• 跨平台兼容：基于OSHI库开发，支持所有主流操作系统（Windows、Linux、macOS等）
• 简单配置：通过环境变量或配置文件快速自定义服务器名称、端口、背景等参数

使用场景

适用于个人服务器、小型服务器环境或需要直观监控仪表盘的场景。尤其适合希望用简洁美观的界面替代复杂数据图表，快速掌握服务器基本状态的用户。

使用方法

Docker Run 命令

快速启动Ward容器：

bash
docker run --restart unless-stopped -it -d --name ward -p 4000:4000 -e WARD_PORT=4000 -e WARD_THEME=dark --cap-add SYS_PTRACE docker.xuanyuan.run/antonyleons/ward

启动后访问 localhost:4000 即可打开监控仪表盘。

Docker Compose 配置

创建 docker-compose.yml 文件，内容如下：

yaml
version: '3.3'
services:
    run:
        restart: unless-stopped
        container_name: ward
        ports:
            - '4000:4000'
        environment:
            - WARD_PORT=4000          # 服务监听端口
            - WARD_THEME=light        # 主题模式（light/dark）
            - WARD_NAME=Ward          # 界面显示的服务器名称
            - WARD_FOG=true           # 是否启用雾效背景（true/false）
            - WARD_BACKGROUND=#3c3c3c # 禁用雾效时的背景色（十六进制颜色值）
        cap_add:
            - SYS_PTRACE              # 必要的系统权限
        image: docker.xuanyuan.run/antonyleons/ward

执行 docker-compose up -d 启动服务。

配置说明

Ward的配置可通过环境变量或 setup.ini 文件管理。设置环境变量会在启动时自动生成配置文件；未设置环境变量时，首次访问网页将引导完成初始设置，也可手动创建配置文件并置于服务目录。

配置参数与环境变量

环境变量优先级高于配置文件，设置后会自动生成包含指定参数的 setup.ini。

配置文件示例

手动创建或修改 setup.ini 文件：

ini
[setup]
serverName = my-server
theme = dark
port = 8200
enableFog = true
backgroundColor = #303030

关于

为保障安全性，旧版本构建已移除，所有配置保持向后兼容。Ward基于 https://github.com/oshi/oshi 库实现跨平台硬件信息采集。

更多详情请访问 https://github.com/AntonyLeons/Ward