Repolode
提交项目
glenndehaan

glenndehaan/unifi-voucher-site

用于在 UniFi 网络上创建、管理和打印访客 WiFi 凭证的 Web 应用与 REST API。

在 GitHub 查看
Star
312
Fork
37
未关闭 Issue
1
最近提交
3天前

这是什么？

UniFi Voucher Site 是一个可自托管的 Web 应用，用于为 UniFi 网络生成和管理访客上网凭证。管理员可以设置有效期、单次或多次使用、上传和下载速率限制以及流量配额，然后将凭证分发给访客。

凭证可以通过多种方式交付：导出为 PDF 或通过 ESC/POS 网络小票打印机以 80mm 纸打印，经 SMTP 发送邮件，也可以在公共场所的自助终端（Kiosk）页面由访客自行生成。项目基于 Node.js、Express 和 EJS 开发，支持 Docker 部署和 Home Assistant 应用安装。登录认证可选内置密码、OpenID Connect 单点登录，或直接关闭。

项目通过 UniFi API Key 连接 UniFi OS 控制台。8.x 版本要求 UniFi OS v4.2.8 及以上，以及 UniFi Network v9.1.119 及以上。

核心功能

  • 01创建凭证，可设置有效期、单次或多次使用，以及速率和流量限制。
  • 02以 PDF 形式或通过 ESC/POS 网络打印机在 80mm 纸上打印凭证。
  • 03通过 SMTP 邮件发送凭证。
  • 04提供自助终端页面，访客可自行生成凭证。
  • 05支持内置登录、OpenID Connect 单点登录或关闭认证。
  • 06提供受 Bearer Token 保护的 REST API。

适用场景

  • 为咖啡馆、酒店或共享办公空间的访客发放 WiFi 访问码。
  • 让前台工作人员通过小票打印机打印凭证。
  • 通过 API 或 Home Assistant 自动化创建凭证。
  • 在公共区域通过自助终端提供自助上网服务。

快速上手

  1. 1

    设置 UniFi Hotspot Portal 并启用凭证认证

  2. 2

    根据 README 示例创建 docker-compose.yml 并填写你的 UniFi 设置

使用前须知

  • 8.x 版本需要 UniFi OS，不支持旧版 UniFi Network Server。
  • 本地网络 API 密钥与 Site Manager API 密钥不可互换。
  • 需要启用了凭证认证的 UniFi Hotspot Portal。

标签

#unifi#wifi#guest-access#voucher#express#nodejs#docker#home-assistant#unifi-voucher-site

常见问题

unifi-voucher-site 是什么？
用于在 UniFi 网络上创建、管理和打印访客 WiFi 凭证的 Web 应用与 REST API。 UniFi Voucher Site 是一个可自托管的 Web 应用，用于为 UniFi 网络生成和管理访客上网凭证。管理员可以设置有效期、单次或多次使用、上传和下载速率限制以及流量配额，然后将凭证分发给访客。
unifi-voucher-site 可以免费使用吗？用的什么许可证？
unifi-voucher-site 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
unifi-voucher-site 还在维护吗？
活跃维护中。unifi-voucher-site 最近一次提交是在 2026年11月4日。
unifi-voucher-site 适合用来做什么？
为咖啡馆、酒店或共享办公空间的访客发放 WiFi 访问码。 让前台工作人员通过小票打印机打印凭证。 通过 API 或 Home Assistant 自动化创建凭证。 在公共区域通过自助终端提供自助上网服务。
unifi-voucher-site 怎么安装和运行？
设置 UniFi Hotspot Portal 并启用凭证认证 根据 README 示例创建 docker-compose.yml 并填写你的 UniFi 设置
在哪里获取 unifi-voucher-site？
源代码和安装说明在 GitHub 上：https://github.com/glenndehaan/unifi-voucher-site

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目