介绍
# Raspberry Pi Administration
针对 Raspberry Pi 主机的完整系统监控和内省功能。访问网络详细信息、系统资源、存储、服务等。
## 何时使用 - 检查 Pi 网络配置(IP、Tailscale) - 监控系统资源(CPU、内存、存储) - 查看正在运行的服务及其状态 - 检查温度和硬件信息 - 系统故障排查 - 获取调试所需的系统概览
## 用法
```bash # Information Commands cd /home/srose/clawd/skills/pi-admin ./skill.sh overview ./skill.sh network ./skill.sh tailscale ./skill.sh resources ./skill.sh storage ./skill.sh services ./skill.sh hardware
# Maintenance Commands ./skill.sh update # Update system packages ./skill.sh clean # Clean unused packages, logs, Docker ./skill.sh reboot # Reboot with countdown ./skill.sh restart-gateway # Restart the Clawdis Gateway
# Complete system info ./skill.sh all ```
## 可用工具
| 工具 | 描述 | |------|-------------| | `overview` | 快速系统摘要 | | `network` | IP 地址、主机名、网络接口 | | `tailscale` | Tailscale 状态、IP、对等节点 | | `resources` | CPU、内存、温度 | | `storage` | 磁盘使用情况、挂载点 | | `services` | 正在运行的服务、网关状态 | | `hardware` | CPU 信息、Raspberry Pi 型号、GPU | | `all` | 完整详细转储 |
## 示例
```bash # Quick system check ./skill.sh overview
# Debug network issues ./skill.sh network && ./skill.sh tailscale
# Check if Gateway is running ./skill.sh services | grep gateway
# Monitor disk space ./skill.sh storage ```
## 收集的信息
**网络:** - 主机名 - 本地 IP 地址(eth0、wlan0) - 网络接口详细信息 - DNS 配置
**Tailscale:** - 状态(运行/已停止) - Tailscale IP - 已连接的对等节点 - 退出节点状态
**资源:** - CPU 使用率 - 内存使用率(已用/空闲/总计) - CPU 温度 - 运行时间
**存储:** - 按挂载点划分的磁盘使用情况 - Inode 使用情况 - 可用空间
**服务:** - 网关服务状态 - Docker 容器 - Systemd 服务 - 端口监听器
**硬件:** - CPU 型号和核心数 - Raspberry Pi 型号 - GPU 内存 - 总内存
## 维护命令
### `update` 通过 apt 更新系统软件包: - 更新软件包列表 - 显示可升级的软件包 - 升级前需要确认 - 报告是否需要重启 - **试运行:** `./skill.sh update --dry-run` 显示将要更新的内容
### `clean` 清理系统以释放磁盘空间: - 删除未使用的软件包(autoremove) - 清除软件包缓存 - 清理旧的日志(保留 7 天) - 可选清理 Docker 工件 - 显示节省的空间 - **试运行:** `./skill.sh clean --dry-run` 显示将要清理的内容
### `reboot` 优雅的系统重启: - 10 秒倒计时 - Ctrl+C 取消 - 使用 systemctl reboot - **试运行:** `./skill.sh reboot --dry-run` 显示倒计时但不重启
### `restart-gateway` 重启 Clawdis 网关服务: - 停止所有正在运行的网关进程 - 在端口 18789 上启动全新的网关 - 确认端口正在监听 - 显示访问 URL - **试运行:** `./skill.sh restart-gateway --dry-run` 显示将会发生的情况
### `optimize` 应用安全的系统优化: - 禁用蓝牙服务(节省约 50MB RAM) - 禁用 ModemManager(节省约 30MB RAM) - 禁用 Avahi/Zeroconf(节省约 20MB RAM) - 将 swappiness 设置为 10(更好的 RAM 利用率) - **试运行:** `./skill.sh optimize --dry-run` 显示将要更改的内容 - **撤销:** `./skill.sh optimize --undo` 还原所有更改
**总计节省 RAM:** 约 100MB **可逆性:** 是,使用 `--undo` 标志还原
**注意:** 所有维护命令都需要 sudo,并且在进行更改前会请求确认。使用 `--dry-run` 标志可在不应用更改的情况下预览更改。