Files
pigway-device-agent/config/pigway-pi-control.conf
T

269 lines
7.7 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# =============================================================================
# Pigway Pi Control v3.6.0 - 用户配置文件
# =============================================================================
#
# 正式安装后的配置路径:
# /etc/pigway-pi-control.conf
#
# 编辑:
# sudo nano /etc/pigway-pi-control.conf
#
# 保存后让配置生效:
# sudo systemctl restart pigway-pi-control
#
# 查看运行状态:
# systemctl status pigway-pi-control --no-pager -l
#
# 查看实时日志:
# journalctl -u pigway-pi-control -f
#
# 重要:
# 1. 只建议修改本文件,不要直接修改 /usr/local/sbin/pigway-pi-control。
# 2. “#” 开头是注释,不生效。要启用示例项,删除行首的 #。
# 3. 数值单位和建议范围见每项上方注释。
# 4. 配置写错导致服务无法启动时,可查看 journalctl 日志并修正本文件。
# =============================================================================
[api]
# API 与 Web 使用同一监听地址和端口。0.0.0.0 允许局域网访问;
# 如只允许本机访问可改为 127.0.0.1。修改后重启 API 服务生效。
bind = 0.0.0.0
port = 6001
log_limit = 200
[timing]
# 传感器采样周期,单位:秒。
# CPU / 内存 / 温度 / 磁盘以及风扇控制按此周期更新。
# 推荐:1。通常不要低于 1。
sensor_interval = 1
# OLED 当前页面刷新周期,单位:秒。
# 这只是刷新当前页面数据,不负责切换页面。
# 推荐:1。
oled_refresh_interval = 1
# OLED 在主页和当前告警页之间轮播的周期,单位:秒。
# 页面切换只影响 OLED;RGB 始终由当前 Display Owner 决定。
page_interval = 10
# 网络状态检查周期,单位:秒。
# 推荐:5。太短会产生不必要的网络探测。
network_interval = 5
# systemd 服务和自定义进程检查周期,单位:秒。
# 推荐:5。
service_interval = 5
# 本机健康检查周期,单位:秒。
# 检查 Raspberry Pi 欠压/降频状态、根文件系统只读状态等。
# 推荐:1。当前电源状态必须及时反映到 OLED/RGB;历史状态仅记录一次日志。
health_interval = 1
[fan]
# 风扇温控档位,单位:摄氏度。
#
# 默认曲线:
# < 50°C OFF
# 50~53°C L1
# 53~56°C L2
# 56~59°C L3
# 59~62°C L4
# >= 62°C MAX
#
# 如希望更安静,可适当提高阈值;如更重视散热,可降低。
# 建议保持 start < level2 < level3 < level4 < max。
# 低于此温度,风扇完全停止。
start = 50
# L2 起始温度;start 到 level2 之间为 L1。
level2 = 53
# L3 起始温度。
level3 = 56
# L4 起始温度。
level4 = 59
# MAX 全速起始温度。
max = 62
# 降档回差,单位:°C。
# 防止温度在临界值附近上下波动时风扇频繁升降档。
# 推荐:1.0~2.0。
hysteresis = 1.5
[alerts]
# ---------------- CPU ----------------
# CPU 使用率达到此百分比后开始累计高负载时间。
cpu_high = 90
# CPU 降到此百分比以下,清除高负载累计。
cpu_recover = 75
# CPU 必须持续高负载多少秒才触发告警。
# 避免瞬时峰值造成误报。
cpu_high_seconds = 30
# ---------------- 内存 ----------------
# 内存使用率达到此百分比后开始累计。
memory_high = 90
# 内存降到此百分比以下,清除累计。
memory_recover = 85
# 持续多少秒才触发内存告警。
memory_high_seconds = 30
# ---------------- 温度 ----------------
# 温度普通告警阈值,单位:°C。
temp_high = 68
# 温度严重告警阈值,单位:°C。
temp_critical = 75
# ---------------- 磁盘 ----------------
# 根分区使用率达到此百分比触发普通告警。
disk_high = 90
# 根分区使用率达到此百分比触发严重告警。
disk_critical = 95
# ---------------- Wi-Fi 信号 ----------------
# 仅当 Wi-Fi 是 Linux 当前默认路由/主接口时生效。
# RSSI 单位 dBm,越接近0越强;约 -50很好,-70一般,-80较弱。
# 连续低于 wifi_weak 达到 wifi_weak_seconds 后触发蓝色告警。
wifi_weak = -75
# 已告警后恢复到该值以上才解除,形成滞回避免反复闪烁。
wifi_recover = -68
# 弱信号持续多少秒才正式告警。
wifi_weak_seconds = 30
[led]
# DisplayController 按集中定义的 priority 仲裁 owner。告警页显示时 RGB 同步显示
# 该页对象;主页使用最高优先级 active owner。颜色表示对象,速度表示严重等级:
# CPU/频率/温度/散热 = 红色
# 供电/欠压 = 橙色闪烁(实机校准,避免内置黄色偏绿)
# 内存 = 紫色
# 磁盘 = 白色
# 网络/Wi-Fi = 蓝色
# 服务/进程 = 青色
# 颜色通道范围为 0..255。以下是本机实测后的默认值。
cpu_r = 255
cpu_g = 0
cpu_b = 0
power_r = 255
power_g = 40
power_b = 0
memory_r = 255
memory_g = 0
memory_b = 255
storage_r = 255
storage_g = 255
storage_b = 255
network_r = 0
network_g = 0
network_b = 255
service_r = 0
service_g = 255
service_b = 96
# 各严重等级可分别设置亮灯和灭灯时长,单位:毫秒,最小值 50。
# 默认完整周期:Warning 3秒、Critical 1.5秒、Emergency 0.6秒。
warning_flash_on_ms = 1500
warning_flash_off_ms = 1500
critical_flash_on_ms = 750
critical_flash_off_ms = 750
emergency_flash_on_ms = 300
emergency_flash_off_ms = 300
# NORMAL_HOME 为 owner 时 RGB OFF。
#
# 每次点亮使用 v3.2.0 已验证的 selector -> R -> G -> B 完整写入顺序,
# 只在亮/灭边沿访问 MCU,不做高频软件 PWM。
write_delay_ms = 10
# v3.3.0 RC 期间使用过的 brightness、*_breathe_seconds、rgb_update_ms、
# warning_color、critical_color、warning_flash_ms、critical_flash_ms 和
# emergency_flash_ms
# 可以继续留在现有配置中;硬件灯效引擎会安全忽略它们。
[dark_mode]
# Raspberry Pi 4 板载 PWR / ACT LED。
# 本机硬件只支持开/关,不支持真正的 PWM 调暗。
#
# off = Pigway Pi Control 启动时关闭该灯。
# 若不希望程序干预,可改为 on。
#
# 注意:
# 散热板上的 D1/D8 黄色硬件状态灯以及独立电源模块绿灯
# 不属于已确认的软件控制接口,本程序不会尝试操作。
pi_pwr_led = off
pi_act_led = off
[services]
# =============================================================================
# systemd 服务监控(推荐)
# =============================================================================
#
# 格式:
# OLED显示名称 = systemd真实unit名称
#
# 左侧名称建议尽量短(OLED只有128×32)。
# 右侧必须是真实的 systemd unit。
#
# 如何确认服务名:
# systemctl status ssh.service
# systemctl list-units --type=service
#
# 暂停监控:
# 在该行最前面加 #
#
# 新增监控:
# 直接增加一行,例如:
# TAILSCALE = tailscaled.service
#
# 修改后:
# sudo systemctl restart pigway-pi-control
#
# 默认监控 SSH 和向日葵核心后台服务。
SSH = ssh.service
AWESUN = runawesun.service
# 以下仅为示例,默认不启用:
# TAILSCALE = tailscaled.service
# DOCKER = docker.service
# SAMBA = smbd.service
# NGINX = nginx.service
[processes]
# =============================================================================
# 普通进程监控
# =============================================================================
#
# 仅在程序没有 systemd service 时使用。
# 如果存在 systemd service,优先放到上面的 [services]。
#
# 格式:
# OLED显示名称 = pgrep -f 可以匹配到的进程关键字/命令行
#
# 示例:
# MYAPP = /opt/myapp/server
#
# 可以先在终端测试:
# pgrep -af '/opt/myapp/server'
#
# 有输出说明匹配成功。
#
# 示例默认全部注释,不会监控任何普通进程。
# MYAPP = /opt/myapp/server