安装

选一种安装方式即可。脚本会识别包管理器，安装 yq、iproute/iproute2，并配置 SSH 登录状态栏。

系统要求

一键安装

bash <(curl -sSL baixiaosheng.de/sysinfo)

从 GitHub 安装

curl -sSL https://raw.githubusercontent.com/baixiaoshengofficial/sysinfo-cli/main/install.sh | bash

克隆后安装

git clone https://github.com/baixiaoshengofficial/sysinfo-cli.git
cd sysinfo-cli
sudo ./install.sh

安装参数

升级与卸载

升级

cd sysinfo-cli && git pull && sudo ./install.sh

如果想顺便把配置恢复成模板：

sudo ./install.sh --overwrite-config

卸载

sudo ./uninstall.sh

会删除脚本、配置文件、状态文件和 zsh 登录 hook。

常用命令

面板说明

登录后或运行 sysinfo 时，面板会显示四块信息：

================================================================
  系统信息面板 - 2026-06-29 17:49:12
================================================================
核心信息
  CPU      : Intel(R) Core(TM) i5-9600 @ 3.10GHz (6 core(s))
  IPv4     : 10.103.241.153
  运行时间 : 1 week, 4 days, 4 hours
资源使用
  负载     : 71.3%                             进程数   : 3725
  内存     : 19Gi / 31Gi (62%)
网络
  下载     : 55.5 KB/s                         上传     : 0 KB/s
  使用率   : [██████████] 48%
  限速状态 : 未限速
磁盘
  /                      162G      90G      59% [██████████]
================================================================

进度条：白色方块表示已用，灰色方块表示剩余。

配置文件

配置文件是 /etc/sysinfo/config.yaml。改完后执行 sudo sysinfo -r。

完整示例

network:
  interface: ""                    # 留空自动检测网卡
  force_gateway_throttle: false    # 网关模式下是否强制限速

nat:
  enabled: false
  mappings:
    - "8080:80"                    # 公网端口:内网端口
    - "9000:3000"

traffic:
  enabled: true
  limit: "1T"                      # 1T / 500G / 100M / UNLIMITED / 0
  reset_day: 1                     # 每月几号重置流量
  mode: "both"                     # upload / download / both

throttle:
  enabled: true
  threshold: 95                    # 用到 95% 开始限速
  rate: "10mbps"                   # 限速到 10 Mbps

display:
  language: "auto"                 # auto / zh / en
  refresh_interval: 1
  show_traffic: true
  show_nat: true
  show_throttle: true

notify:
  enabled: false
  bark:
    url: "https://api.day.app"
    key: ""
  cooldown: 1800
  rules:
    cpu:      { enabled: false, threshold: 90 }
    net:      { enabled: false, threshold: 90 }
    nic:      { enabled: false, threshold: 80, mode: both, upload_rate: 0, download_rate: 0 }
    throttle: { enabled: false }
    disk:     { enabled: false, threshold: 90, paths: [] }

流量统计与限速

流量怎么统计

• 从 /proc/net/dev 读取网卡收发字节数，按月累计
• 数据写入 /etc/sysinfo-traffic.json，到 reset_day 自动重置
• mode 可设为 upload、download 或 both

自动限速怎么工作

当本月流量达到 threshold 后，sysinfo-cli 会调用 Linux tc，把网速限制到 rate。

排查限速问题

bash scripts/test_throttle.sh

推送通知

告警通过 Bark 推到 iPhone。默认关闭，需要在 config.yaml 里手动开启。

怎么开启

1. 在 iPhone 上安装 Bark App，拿到推送 Key
2. 编辑 config.yaml，填上 bark.key，把 notify.enabled 改成 true
3. 开启需要的规则，比如 cpu.enabled: true
4. 执行 sudo sysinfo -r 应用配置
5. 运行 sysinfo --notify-test，确认手机能收到

告警规则

定时检查（cron）

# 每 5 分钟检查一次告警规则
*/5 * * * * /usr/local/bin/sysinfo --notify-check

切换语言

在 config.yaml 里改 display.language：

display:
  language: "zh"    # auto / zh / en

• auto — 跟随系统语言
• zh — 中文界面
• en — 英文界面

改完后运行 sysinfo 会立即使用新语言；执行 sudo sysinfo -r 后，SSH 登录状态栏也会切换。

SSH 登录横幅

安装后，SSH 登录会自动显示一次状态面板，不用手动敲 sysinfo。

• bash 用户：通过 /etc/profile.d/ 加载
• zsh 用户：通过 /etc/zsh/zprofile 加载
• scp、sftp、ssh host command 这类非交互操作不会显示
• 同一次登录只显示一次

文件路径

常见问题

开发测试

项目根目录有 Makefile，常用命令：