add linux support
This commit is contained in:
UnbalancedCat
290
README_Ubuntu.md
Normal file
290
README_Ubuntu.md
Normal file
@@ -0,0 +1,290 @@
|
||||
# 智能网络监控脚本 - Ubuntu版本
|
||||
|
||||
## 📁 项目结构
|
||||
|
||||
```
|
||||
smart-shutdown/
|
||||
├── smart_shutdown.sh # 主监控脚本（用户模式）
|
||||
├── deploy_system.sh # 系统级部署脚本
|
||||
├── uninstall_system.sh # 系统级卸载脚本
|
||||
├── manage.sh # 管理工具脚本
|
||||
├── README.md # 本文件
|
||||
└── logs/ # 本地运行时的日志目录
|
||||
└── network_monitor_YYYYMMDD.log
|
||||
```
|
||||
|
||||
## 🚀 快速开始
|
||||
|
||||
### 系统级部署（推荐）
|
||||
|
||||
```bash
|
||||
# 1. 克隆或下载项目到本地
|
||||
cd /path/to/smart-shutdown/
|
||||
|
||||
# 2. 以root权限运行部署脚本
|
||||
sudo ./deploy_system.sh
|
||||
```
|
||||
|
||||
**部署效果：**
|
||||
- 程序文件：`/opt/smart-network-monitor/`
|
||||
- 配置文件：`/etc/smart-network-monitor/config.json`
|
||||
- 日志文件：`/var/log/smart-network-monitor/`
|
||||
- systemd服务：`smart-network-monitor.service`
|
||||
- 开机自启动，无需用户登录
|
||||
|
||||
### 用户级运行
|
||||
|
||||
```bash
|
||||
# 以root权限直接运行（需要用户登录）
|
||||
sudo ./smart_shutdown.sh
|
||||
```
|
||||
|
||||
## 🎯 系统部署后的文件位置
|
||||
|
||||
### 程序文件位置
|
||||
```
|
||||
/opt/smart-network-monitor/
|
||||
├── smart_shutdown_system.sh # 系统优化版监控脚本
|
||||
└── manage.sh # 管理工具脚本
|
||||
```
|
||||
|
||||
### 配置文件位置
|
||||
```
|
||||
/etc/smart-network-monitor/
|
||||
└── config.json # 配置文件
|
||||
```
|
||||
|
||||
### 日志文件位置
|
||||
```
|
||||
/var/log/smart-network-monitor/
|
||||
└── network_monitor_YYYYMMDD.log # 日志文件
|
||||
```
|
||||
|
||||
## 🔧 管理命令
|
||||
|
||||
### 使用管理工具（推荐）
|
||||
```bash
|
||||
# 使用快捷命令（系统安装后可用）
|
||||
smart-monitor
|
||||
|
||||
# 或者直接运行管理脚本
|
||||
sudo /opt/smart-network-monitor/manage.sh
|
||||
```
|
||||
|
||||
### 直接使用systemctl命令
|
||||
|
||||
#### 查看服务状态
|
||||
```bash
|
||||
systemctl status smart-network-monitor
|
||||
```
|
||||
|
||||
#### 启动/停止/重启服务
|
||||
```bash
|
||||
sudo systemctl start smart-network-monitor
|
||||
sudo systemctl stop smart-network-monitor
|
||||
sudo systemctl restart smart-network-monitor
|
||||
```
|
||||
|
||||
#### 启用/禁用开机自启动
|
||||
```bash
|
||||
sudo systemctl enable smart-network-monitor
|
||||
sudo systemctl disable smart-network-monitor
|
||||
```
|
||||
|
||||
### 查看日志
|
||||
|
||||
#### 查看今天的应用日志
|
||||
```bash
|
||||
cat /var/log/smart-network-monitor/network_monitor_$(date '+%Y%m%d').log
|
||||
```
|
||||
|
||||
#### 实时监控应用日志
|
||||
```bash
|
||||
tail -f /var/log/smart-network-monitor/network_monitor_$(date '+%Y%m%d').log
|
||||
```
|
||||
|
||||
#### 查看系统日志
|
||||
```bash
|
||||
# 查看最近的系统日志
|
||||
journalctl -u smart-network-monitor -n 50
|
||||
|
||||
# 实时监控系统日志
|
||||
journalctl -u smart-network-monitor -f
|
||||
```
|
||||
|
||||
## ⚙️ 配置说明
|
||||
|
||||
系统部署后，配置文件位于：`/etc/smart-network-monitor/config.json`
|
||||
|
||||
### 默认配置
|
||||
```json
|
||||
{
|
||||
"TargetIP": "192.168.3.3",
|
||||
"MonitorWindowSeconds": 180,
|
||||
"ShutdownCountdown": 60,
|
||||
"NormalPingInterval": 15
|
||||
}
|
||||
```
|
||||
|
||||
### 配置参数说明
|
||||
- `TargetIP`: 监控的目标IP地址
|
||||
- `MonitorWindowSeconds`: 监控窗口时长（秒），网络持续中断超过此时间将触发关机
|
||||
- `ShutdownCountdown`: 关机倒计时时长（秒）
|
||||
- `NormalPingInterval`: 正常监控时的ping间隔（秒）
|
||||
|
||||
### 修改配置
|
||||
```bash
|
||||
# 使用管理工具编辑（推荐）
|
||||
smart-monitor
|
||||
|
||||
# 或直接编辑配置文件
|
||||
sudo nano /etc/smart-network-monitor/config.json
|
||||
|
||||
# 修改配置后重启服务使配置生效
|
||||
sudo systemctl restart smart-network-monitor
|
||||
```
|
||||
|
||||
## 🗑️ 卸载
|
||||
|
||||
```bash
|
||||
# 运行卸载脚本
|
||||
sudo ./uninstall_system.sh
|
||||
```
|
||||
|
||||
卸载脚本会询问是否删除配置文件和日志文件，您可以选择保留或删除。
|
||||
|
||||
## 📊 功能特性
|
||||
|
||||
- ✅ 开机自启动，无需用户登录
|
||||
- ✅ 系统级权限运行
|
||||
- ✅ 智能日志管理（应用日志 + 系统日志）
|
||||
- ✅ JSON配置文件支持
|
||||
- ✅ 自动日志清理（30天）
|
||||
- ✅ 网络恢复自动取消关机
|
||||
- ✅ 完整的错误处理和信号处理
|
||||
- ✅ 彩色终端输出
|
||||
- ✅ 交互式管理工具
|
||||
|
||||
## 🔧 系统要求
|
||||
|
||||
### 必需软件包
|
||||
- `ping` (通常已预装)
|
||||
- `systemctl` (systemd)
|
||||
- `journalctl` (systemd)
|
||||
|
||||
### 推荐软件包
|
||||
```bash
|
||||
# 安装jq以获得更好的JSON配置支持
|
||||
sudo apt-get update
|
||||
sudo apt-get install jq
|
||||
```
|
||||
|
||||
### 支持的系统
|
||||
- Ubuntu 16.04+ (带systemd)
|
||||
- Debian 8+ (带systemd)
|
||||
- 其他使用systemd的Linux发行版
|
||||
|
||||
## 🔐 安全说明
|
||||
|
||||
- 脚本需要root权限以执行关机操作
|
||||
- systemd服务以root权限运行
|
||||
- 所有操作都会记录在应用日志和系统日志中
|
||||
- 支持通过systemd进行完整的服务管理和监控
|
||||
|
||||
## 📝 使用示例
|
||||
|
||||
### 1. 基本使用流程
|
||||
|
||||
```bash
|
||||
# 1. 部署系统级服务
|
||||
sudo ./deploy_system.sh
|
||||
|
||||
# 2. 检查服务状态
|
||||
systemctl status smart-network-monitor
|
||||
|
||||
# 3. 查看实时日志
|
||||
journalctl -u smart-network-monitor -f
|
||||
|
||||
# 4. 使用管理工具
|
||||
smart-monitor
|
||||
```
|
||||
|
||||
### 2. 自定义配置示例
|
||||
|
||||
```bash
|
||||
# 编辑配置文件
|
||||
sudo nano /etc/smart-network-monitor/config.json
|
||||
|
||||
# 修改为监控路由器
|
||||
{
|
||||
"TargetIP": "192.168.1.1",
|
||||
"MonitorWindowSeconds": 300,
|
||||
"ShutdownCountdown": 120,
|
||||
"NormalPingInterval": 30
|
||||
}
|
||||
|
||||
# 重启服务应用配置
|
||||
sudo systemctl restart smart-network-monitor
|
||||
```
|
||||
|
||||
### 3. 故障排除
|
||||
|
||||
```bash
|
||||
# 查看服务详细状态
|
||||
systemctl status smart-network-monitor -l
|
||||
|
||||
# 查看最近的错误日志
|
||||
journalctl -u smart-network-monitor --since "1 hour ago"
|
||||
|
||||
# 测试网络连接
|
||||
ping -c 4 192.168.3.3
|
||||
|
||||
# 手动运行脚本进行调试
|
||||
sudo /opt/smart-network-monitor/smart_shutdown_system.sh
|
||||
```
|
||||
|
||||
## 🚨 注意事项
|
||||
|
||||
1. **关机权限**：脚本需要root权限才能执行关机操作
|
||||
2. **网络依赖**：确保目标IP地址可达且稳定响应ping
|
||||
3. **测试模式**：默认脚本在关机时会输出模拟信息，取消注释 `shutdown -h now` 行以启用实际关机
|
||||
4. **备份重要数据**：在启用实际关机功能前，请确保重要数据已备份
|
||||
5. **防火墙设置**：确保ICMP ping包不被防火墙阻挡
|
||||
|
||||
## 🔗 相关命令速查
|
||||
|
||||
```bash
|
||||
# 服务管理
|
||||
sudo systemctl start smart-network-monitor # 启动
|
||||
sudo systemctl stop smart-network-monitor # 停止
|
||||
sudo systemctl restart smart-network-monitor # 重启
|
||||
sudo systemctl status smart-network-monitor # 状态
|
||||
sudo systemctl enable smart-network-monitor # 开机启动
|
||||
sudo systemctl disable smart-network-monitor # 禁用启动
|
||||
|
||||
# 日志查看
|
||||
journalctl -u smart-network-monitor # 所有日志
|
||||
journalctl -u smart-network-monitor -f # 实时日志
|
||||
journalctl -u smart-network-monitor -n 50 # 最近50行
|
||||
tail -f /var/log/smart-network-monitor/network_monitor_$(date '+%Y%m%d').log # 应用日志
|
||||
|
||||
# 配置管理
|
||||
sudo nano /etc/smart-network-monitor/config.json # 编辑配置
|
||||
cat /etc/smart-network-monitor/config.json # 查看配置
|
||||
|
||||
# 管理工具
|
||||
smart-monitor # 交互式管理
|
||||
```
|
||||
|
||||
## 📞 技术支持
|
||||
|
||||
如果您在使用过程中遇到问题，请：
|
||||
|
||||
1. 检查系统日志：`journalctl -u smart-network-monitor -n 100`
|
||||
2. 验证网络连接：`ping 目标IP`
|
||||
3. 检查配置文件格式：`jq . /etc/smart-network-monitor/config.json`
|
||||
4. 查看服务状态：`systemctl status smart-network-monitor -l`
|
||||
|
||||
---
|
||||
|
||||
**享受智能网络监控带来的便利！** 🎉
|
||||
Reference in New Issue
Block a user