Infoboard开源项目使用与部署教程

1. 项目介绍

Infoboard 是一个开源的信息展示板项目，它可以显示时间、天气、日历事件、背景图片和伦敦交通状态更新。该项目主要用于树莓派，但也适用于任何安装了 NodeJS 的机器。Infoboard 可以从本地文件夹或网络源展示背景图片，支持多种天气标签的图片，以及播放 MP4 视频作为背景。此外，它还支持显示来自 Tomorrow.io 的天气信息，以及使用 DHT 传感器获取本地温度和湿度。

2. 项目快速启动

以下是快速启动 Infoboard 项目的步骤：

首先，创建一个新文件夹来保存应用文件：

$ sudo mkdir /srv/http
$ chown pi:pi /srv/http/

然后，进入项目文件夹：

$ cd /srv/http/

克隆项目仓库到当前文件夹：

$ git clone https://github.com/SixBytesUnder/infoboard.git

复制或重命名配置文件 .env.example 为 .env：

$ cp .env.example .env

编辑 .env 文件，提供所有必要的变量和 API 密钥：

$ vim.tiny .env

安装依赖：

$ npm install

如果安装了 DHT 传感器，还需要安装相应的包：

$ npm install node-dht-sensor

构建生产环境包：

$ npm run build

安装 pm2 作为进程管理器：

$ sudo npm i -g pm2

启动 pm2：

$ pm2 start npm --name "infoboard" -- start

配置 nginx 来服务 MP4 视频和其他静态文件：

$ sudo vim.tiny /etc/nginx/sites-enabled/default

添加以下配置到 nginx：

server {
    listen 80 default_server;
    listen [::]:80 default_server;
    access_log /var/log/nginx/infoboard-access.log;
    error_log /var/log/nginx/infoboard-error.log;
    gzip on;
    gzip_types text/plain application/xml text/css application/javascript;
    gzip_min_length 1000;
    server_name _ 192.168.1.99 infoboard.local;
    location / {
        proxy_redirect off;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 1m;
        proxy_connect_timeout 1m;
        proxy_pass http://127.0.0.1:3000;
    }
    location ~* \.(mp4)$ {
        mp4;
        mp4_buffer_size 1M;
        mp4_max_buffer_size 5M;
        proxy_pass http://127.0.0.1:3000;
    }
}

测试新的 nginx 配置：

$ sudo nginx -t

重新加载 nginx：

$ sudo nginx -s reload

在浏览器中访问你的树莓派的 IP 地址，例如 http://192.168.1.99/。

3. 应用案例和最佳实践

• 个性化定制：在 .env 文件中配置天气 API、日历链接和其他个性化设置。
• 部署为 PWA：将 Infoboard 部署为渐进式 Web 应用，以便在手机或平板电脑上使用，无需打开浏览器。
• 集成传感器：如果你有 DHT 传感器，可以集成到项目中，实时显示温度和湿度。

4. 典型生态项目

Infoboard 可以集成到各种开源生态中，例如：

• 智能家居系统：将 Infoboard 集成到 Home Assistant 等智能家居平台中，实现信息联动。
• 社区公告板：在社区或办公环境中部署 Infoboard，作为公告板使用。
• 教学辅助：在学校或教育机构中部署，为学生和教师提供实时信息。