Infoboard项目安装与配置指南

2025-04-19 21:54:26作者：郦嵘贵Just

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：版本控制系统。

安装步骤

克隆项目仓库

打开终端（或命令提示符），使用以下命令克隆项目仓库：
```
git clone https://github.com/SixBytesUnder/infoboard.git
```
配置项目

进入项目文件夹：
```
cd infoboard
```
将.env.example文件复制并重命名为.env：
```
cp .env.example .env
```
在.env文件中配置所需的变量和API密钥。
安装依赖

使用以下命令安装项目依赖：
```
npm install
```
如果您有DHT传感器，还需要安装相应的包：
```
npm install node-dht-sensor
```
构建生产版本

使用以下命令构建生产版本的应用程序：
```
npm run build
```
启动应用程序

使用以下命令启动应用程序：
```
npm start
```
应用程序默认会在localhost:3000上运行。

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;
  }
}