ZOYKUHot Board

woodjme/unifi-hotspot기술 문서

A Node.js based external portal server for authorising Wi-Fi guests on Unifi products

언어 대체 안내:해당 저장소의 한국어 문서가 제공되지 않아 공식 영문 원본(English)으로 표시됩니다.
npm i unifi-hotspot

unifi-hotspot

Want this without running a server? GuestGate is the hosted version, from the same author. It connects with a UniFi API key, so it works with MFA-protected accounts and needs no port forwarding, and adds branded login pages, a guest list, webhooks and Zapier. Start a free trial.

A versatile external captive portal server designed for authorizing Wi-Fi guests on Unifi products. It supports flexible user data storage solutions, including integration with Google Sheets and webhooks.

Documentation

For detailed information on how to set up and use this application, please refer to the Documentation.

What's New in V3

Features and Improvements

  • Added support for devices with built-in controllers such as the Unifi Dream Machine.
  • Upgraded to NodeJS Version 20.
  • Codebase rewritten in Typescript.

Breaking Changes

  • The URI environment variable has been renamed to UNIFI_CONTROLLER_URL.
  • The SITENAME environment variable has been renamed to UNIFI_SITE_IDENTIFIER.
  • The LOG_AUTH_GOOGLE_SERVICE_ACCOUNT_EMAIL and LOG_AUTH_GOOGLE_SERVICE_ACCOUNT_PRIVATE_KEY environment variables have been replaced with LOG_AUTH_GOOGLE_CREDENTIALS.
GitHub 공식 원본 저장소에서 아카이브된 문서 미러 · GitHub 저장소 방문
동기화 기준일: 2026-11-10