GPU 服务器监控工具。支持通过 Server Chan 或 Bark 推送通知（两者均支持多账号同时推送），配套 Web 界面可在局域网（Tailscale）查看 GPU 状态、管理监控任务、查看事件日志，并可启用 LLM Agent 用自然语言查询系统状态和管理 PID 监控。
推荐直接使用项目根目录下的 manage.sh：
git clone https://github.com/nanoxxs/sserveros.git && \
cd sserveros && \
bash ./manage.sh首次运行时自动初始化配置并启动服务；后续提供交互菜单管理启停和密码。
如果首次未配置通知渠道，manage.sh 会先帮你启动 WebUI，待在设置页配置完成后再启动监控脚本。
- Linux 系统
- Python 3.8+，需安装依赖：
pip install flask psutil "httpx[socks]" "httpcore[socks]" nvidia-smi（NVIDIA 驱动已正确安装）curl（Server Chan 推送依赖）
- GPU 显存监控：低于阈值持续 N 次时推送通知；恢复后重新识别主 PID
- 主 PID 跟踪：自动发现显存最大进程；进程消失时通知
- 指定 PID 监控：手动添加要跟踪的进程，支持备注
- 多渠道推送：Server Chan / Bark，每种渠道支持配置多个账号，同时推送
- WebUI：查看 GPU 实时状态 / CPU 内存磁盘 / 管理监控 PID / 调整参数 / 浏览事件日志
- LLM Agent：自然语言查询 GPU、进程、systemd 服务、端口、磁盘和系统信息；添加/移除 PID 监控前需要用户确认
- 日志归档：超过大小阈值自动压缩为
.json.gz
sserveros/
├── manage.sh # 一键初始化 / 启动 / 停止 / 改密码
├── monitor.py # 主监控脚本（Python）
├── notifier.py # 推送渠道模块（Server Chan / Bark）
├── webui.py # Web 后端（Flask）
├── webui.html # 前端页面（单文件）
├── config_bootstrap.py # 首启自动生成配置
├── storage.py # 配置读写 / 路径管理
├── agent/
│ ├── _shell.py # 安全子进程封装
│ ├── runner.py # LLM tool-use 循环 + SessionStore
│ ├── schema.py # OpenAI 兼容工具 schema + system prompt
│ └── tools/ # GPU/进程/服务/端口/磁盘/系统信息工具
├── tests/
│ ├── test_webui.py # WebUI / API 测试
│ ├── test_sserveros.py # 监控脚本测试
│ └── test_agent_tools.py # Agent 工具层测试
├── .env.example # 敏感变量示例
├── ARCHITECTURE.md # 架构说明
├── CONFIG.md # 配置项说明
└── README.md # 本文件
运行时生成（均在 .gitignore，不提交）：
config.json # 配置文件（密码哈希 + 监控参数 + LLM 配置）
runtime/
state.json # 当前 GPU/PID 快照
log.json # 事件日志（JSON Lines）
log_*.json.gz # 历史日志存档
sserveros.pid # 监控脚本 PID
webui.pid # WebUI 进程 PID
watch_pids.queue # 动态添加 PID 队列
remove_pids.queue # 动态删除 PID 队列
agent_sessions.json # Agent 会话持久化
.env # 本地敏感变量（不提交）
启动 WebUI 后，在「设置」→「通知渠道」中填写 Server Chan 密钥或 Bark 地址，支持添加多个。
cp .env.example .env编辑 .env，按需填写：
# Server Chan（支持多个密钥，逗号分隔）
SERVERCHAN_KEYS=SCTkey1,SCTkey2
# Bark（格式：URL|设备Key，多个逗号分隔）
BARK_CONFIGS=https://api.day.app|YourKey1,https://api.day.app|YourKey2
# 旧版单 key 写法（仍然有效）
# SENDKEY=SCTxxxxxxxxxxxxxxxx两种渠道可以同时配置，推送时会同时发送到所有渠道。
说明：
- 通过
.env/ 环境变量提供的通知渠道只在运行时生效，不会自动回写到config.json - 在 WebUI 保存通知渠道后，后续通知会以
config.json为准，避免已运行的监控进程继续使用启动时残留的旧环境变量 - WebUI 检测到环境变量渠道时，会提示“已配置但不回显明文”；测试通知仍会按当前有效配置发送
# 在项目目录中执行；从其他目录启动时请使用绝对路径
cd /path/to/sserveros
# 启动监控脚本
nohup python "$(pwd)/monitor.py" >> "$(pwd)/runtime/monitor.log" 2>&1 &
# 启动 WebUI（可选）
nohup python "$(pwd)/webui.py" >> "$(pwd)/runtime/webui.log" 2>&1 &或直接使用 manage.sh，它会自动处理初始化和启停。
如果当前尚未配置任何通知渠道，monitor.py 不会启动；可以先启动 WebUI 完成设置。
- 默认端口：
6777（可在config.json的webui_port修改） - 初始密码：首次启动时自动生成并打印到终端
- 修改密码：WebUI → 右上角菜单 → 修改密码
- Agent：WebUI → 设置 → Agent 中开启并填写 OpenAI 兼容 API Base URL、API Key 和模型名；随后在 Agent 标签页对话
python3 - <<'PY'
import json
from werkzeug.security import generate_password_hash
path = 'config.json'
new_password = '你的新密码'
with open(path) as f:
cfg = json.load(f)
cfg['password_hash'] = generate_password_hash(new_password)
with open(path, 'w') as f:
json.dump(cfg, f, indent=2, ensure_ascii=False)
print('已重置密码为:', new_password)
PY# 命令行方式
python monitor.py add <pid>
# 或通过 WebUI → PIDs 标签页添加Agent 默认关闭。开启后，它可以调用只读工具查询当前 GPU 快照、监控 PID、进程、systemd 服务、端口、磁盘和系统信息；涉及写操作的 add_watch_pid / remove_watch_pid 会先进入待确认状态，需要在 WebUI 中确认后才会真正写入配置并通知 monitor.py。
pytest tests/详见 CONFIG.md。
- Python 3.8+
- Flask（含 Werkzeug）
- psutil
- httpx[socks] + httpcore[socks]（Agent LLM 调用，支持系统 SOCKS 代理）
nvidia-smi（NVIDIA 驱动自带）curl（Server Chan 推送使用）
- 通过
manage.sh主动停止monitor.py时，会发送“管理员停止”通知，并附带操作者和来源信息 - 直接向进程发送
SIGTERM/SIGINT时，会发送“外部停止信号”通知 - 运行时异常退出会发送“异常退出”通知
SIGKILL、断电、内核崩溃等无法优雅处理的场景，无法在退出前主动上报