树莓派项目-PI仪表盘项目

Pi Dashboard（Pi 仪表盘）是一个开源的 IoT设备监控工具，专为树莓派（Raspberry Pi）平台设计，并兼容其他类树莓派硬件。它通过 Web UI 提供直观的可视化界面，帮助用户实时监控树莓派的硬件状态和运行信息。以下是该项目的详细介绍：

---

核心功能

1. 硬件状态监控

   • CPU：显示CPU基本信息（型号、温度）、使用率、负载等实时数据。
   • 内存与缓存：监控内存使用情况（RAM、缓存、SWAP分区）。
   • 磁盘空间：展示SD卡（或存储设备）的占用情况。
   • 网络接口：实时显示网络流量、IP地址、连接状态等。

2. 系统基础信息

   • 树莓派的IP地址、运行时间、操作系统版本、主机名（HOST）等。
   • 实时进程数据（如运行中的服务、资源占用）。

3. 响应式设计

   • 支持任何带有浏览器的设备访问，包括电脑、平板、手机等，且适配不同屏幕尺寸。

---

安装与部署

1. 安装Nginx和PHP环境

1. 更新软件包列表：

   sudo apt-get update
   

2. 安装Nginx和PHP组件：

   sudo apt-get install nginx php7.4-fpm php7.4-cli php7.4-curl php7.4-gd php7.4-cgi
   

3. 启动服务并配置Nginx处理PHP：
   • 修改Nginx配置文件 /etc/nginx/sites-available/default，替换以下内容：

     location / {
         index index.html index.htm index.php;
     }
     location ~\.php$ {
         fastcgi_pass unix:/run/php/php7.4-fpm.sock;
         fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
         include fastcgi_params;
     }
     

   • 重启Nginx：

     sudo service nginx restart
     

2. 部署Pi Dashboard

• 方法一：通过GitHub克隆：

  sudo apt-get install git  # 安装git（如果未安装）
  cd /var/www/html
  sudo git clone https://github.com/nxez/pi-dashboard.git
  sudo chown -R www-data pi-dashboard  # 赋予权限
  

• 方法二：通过SFTP上传
  从GitHub下载源码后，使用FTP工具（如FileZilla）上传到树莓派的 /var/www/html 目录，并设置权限。

• 访问仪表盘
  在浏览器中输入：

  http://<树莓派IP>/pi-dashboard
  

---

常见问题与解决方案

1. PHP安装问题

   • 如果树莓派无法安装PHP 7.4，可尝试更换软件源为国内镜像（如阿里云），或调整PHP版本（如PHP 7.3/8.x）。
   • 示例：

     sudo nano /etc/apt/sources.list.d/raspi.list
     # 替换源地址为国内镜像，例如阿里云。
     

2. 外网访问限制
   方法1：

   • 国内ISP通常不提供独立外网IP，可通过 花生壳 等内网穿透工具实现外网访问。
   • 或修改Nginx监听端口（如8080），并通过 <IP>:<端口> 访问。
     方法2：
     国内gitee源上找该项目进行clone下载，比如我找到的一个下载地址为：
     sudo git clone https://gitee.com/thinkyoung/pi-dashboard.git

3. 域名绑定

   • 使用动态DNS服务（如DNSPod）将域名解析到树莓派的动态IP。
   • 修改Nginx配置文件中的 server_name 字段为你的域名。

4. 权限问题

   • 如果页面无法显示，检查文件权限：

     sudo chown -R www-data /var/www/html/pi-dashboard
     

---

项目特点

• 开源免费：基于GPL v3.0协议，允许自由使用和修改。
• 轻量级：占用资源少，适合树莓派等低功耗设备。
• 可扩展：支持添加自定义监控模块（如MQTT传感器数据）。
• 社区支持：提供论坛（Talk.quwj.com）和技术文档，方便用户交流问题。

---

适用场景

• 家庭服务器监控：实时查看树莓派的运行状态，防止过热或资源耗尽。
• 教学与实验：作为IoT设备监控的教学案例，学习Web开发与嵌入式系统结合。
• 远程管理：通过Web界面远程管理树莓派，无需物理连接显示器或键盘。

---

注意事项

1. PHP版本兼容性：确保安装的PHP版本与Pi Dashboard要求的版本匹配（如PHP 7.4）。
2. 安全性：若需外网访问，建议启用HTTPS加密（如Let's Encrypt证书）。
3. 定期更新：项目持续维护，建议定期拉取GitHub最新代码以获取功能改进和修复。

---

项目链接

• GitHub源码：https://github.com/nxez/pi-dashboard
• 项目详情页：https://make.quwj.com/project/10
• 社区支持：https://talk.quwj.com/

通过Pi Dashboard，你可以轻松掌握树莓派的运行状态，提升设备管理效率！ 🚀

最终效果