Infoboard项目安装与配置指南

1. 项目基础介绍

Infoboard是一个开源项目，旨在创建一个信息展示面板，它可以显示时间、日期、天气信息、日历事件、背景图片以及伦敦交通情况等。该项目适用于Raspberry Pi，但也可以在任何安装了Node.js的机器上运行。

该项目主要使用JavaScript编程语言，并基于Nuxt.js框架进行开发。

2. 项目使用的关键技术和框架

• Node.js：服务端运行环境，用于运行JavaScript代码。
• Nuxt.js：一个基于Vue.js的框架，用于构建服务端渲染的应用程序。
• Vue.js：渐进式JavaScript框架，用于构建用户界面。
• Tailwind CSS：一个功能类优先的CSS框架，用于快速UI开发。
• ClimeCell API：用于获取天气信息的API服务。
• Transport for London API：用于获取伦敦交通信息的API服务。

3. 项目安装和配置的准备工作

在开始安装之前，请确保您的系统中已安装以下软件：

• Node.js：至少版本12以上。
• npm：Node.js的包管理器。
• git：版本控制系统。

安装步骤

1. 克隆项目仓库

   打开终端（或命令提示符），使用以下命令克隆项目仓库：

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

2. 配置项目

   进入项目文件夹：

   cd infoboard
   

   将.env.example文件复制并重命名为.env：

   cp .env.example .env
   

   在.env文件中配置所需的变量和API密钥。

3. 安装依赖

   使用以下命令安装项目依赖：

   npm install
   

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

   npm install node-dht-sensor
   

4. 构建生产版本

   使用以下命令构建生产版本的应用程序：

   npm run build
   

5. 启动应用程序

   使用以下命令启动应用程序：

   npm start
   

   应用程序默认会在localhost:3000上运行。

6. Nginx配置（可选）

   如果您希望使用Nginx作为Web服务器，请按照以下步骤进行配置：

   • 安装Nginx及其扩展：

     sudo apt install nginx nginx-extras
     

   • 配置Nginx，编辑/etc/nginx/sites-enabled/default文件，添加以下内容：

     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 _ your_raspberry_pi_ip 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
     sudo nginx -s reload
     

完成以上步骤后，您应该可以在浏览器中通过Raspberry Pi的IP地址访问Infoboard应用。