UniFi Voucher Service 使用教程

UniFi Voucher Service 使用教程

unifi-voucher-serviceEvery employee can simple print a voucher for your guests with one click. They do not have to login or see anything from your UniFi Controller or Hotspot Manager.项目地址:https://gitcode.com/gh_mirrors/un/unifi-voucher-service

1、项目介绍

UniFi Voucher Service 是一个基于 Raspberry Pi 的现代且高度可定制的票务系统，专为 UniFi 网络控制器设计。它允许员工通过简单的点击操作，为客人打印网络接入凭证（即 voucher），并自动将相关信息插入到 UniFi 控制器中，使客人能够轻松加入网络。该项目基于开源社区的力量，提供了灵活的配置选项和友好的用户界面。

2、项目快速启动

2.1 环境准备

确保你已经安装了以下软件：

• Raspberry Pi OS
• Git
• Python 3
• PHP

2.2 安装步骤

1. 克隆项目代码

   cd /var/www/html/
   sudo git clone https://github.com/PaintSplasher/unifi-voucher-service.git
   

2. 设置文件权限

   sudo chown pi -R /var/www/html && sudo chgrp pi -R /var/www/html
   sudo chmod 777 -R /var/www/html/unifi-voucher-service/codeimage
   

3. 配置 sudoers

   sudo nano /etc/sudoers
   

   在 User privilege specification 后添加：

   www-data ALL=(ALL) NOPASSWD: ALL
   

4. 安装 unclutter

   sudo apt-get install unclutter
   

5. 编辑 autostart 文件

   sudo nano /home/pi/config/lxsession/LXDE/autostart
   

   添加以下内容：

   @xset -dpms
   @unclutter
   @chromium-browser --kiosk http://localhost/unifi-voucher-service
   

6. 自动登录

   使用 raspi-config 工具设置自动登录。

7. 配置 rc.local

   sudo nano /etc/rc.local
   

   在 exit 0 前添加：

   cd /usr/src/brother_ql_web
   /usr/bin/python3 brother_ql_web.py&
   

   确保文件可执行：

   sudo chmod +x /etc/rc.local
   

8. 配置 UniFi API 客户端

   cd /usr/src/
   sudo git clone https://github.com/Art-of-WiFi/UniFi-API-client.git
   sudo cp /usr/src/UniFi-API-client/examples/site_provisioning_example/config_template.php /var/www/html/unifi-voucher-service/config.php
   sudo nano /var/www/html/unifi-voucher-service/config.php
   

   填写 UniFi 控制器的 Username、Password、URL 和 Version，并将 Debug mode 设置为 false。

3、应用案例和最佳实践

3.1 应用案例

UniFi Voucher Service 特别适用于需要为大量临时用户提供网络接入的场景，如露营地、酒店、会议中心等。通过简单的操作，员工可以快速为客人打印网络凭证，无需复杂的设置和管理。

3.2 最佳实践

• 安全性：确保 UniFi 控制器和 Raspberry Pi 的安全配置，避免未授权访问。
• 性能优化：根据实际需求调整 Raspberry Pi 的配置，确保系统稳定运行。
• 用户培训：对员工进行简单的培训，确保他们能够熟练使用系统。

4、典型生态项目

• UniFi Controller：UniFi 网络控制器，用于管理和配置网络设备。
• Raspberry Pi：作为 UniFi Voucher Service 的运行平台，提供稳定的硬件支持。
• Brother 打印机：用于打印网络凭证，确保快速和可靠的输出。

通过这些项目的协同工作，UniFi Voucher Service 能够提供一个高效、便捷的网络接入解决方案。

unifi-voucher-serviceEvery employee can simple print a voucher for your guests with one click. They do not have to login or see anything from your UniFi Controller or Hotspot Manager.项目地址:https://gitcode.com/gh_mirrors/un/unifi-voucher-service