glenndehaan/unifi-voucher-site

これは何？

主な機能

• 01有効期限、1回または複数回の利用、速度とデータ量の上限を設定してバウチャーを作成できます。
• 02バウチャーをPDFまたは80mm用紙対応のESC/POSネットワークプリンターで印刷できます。
• 03SMTP経由でバウチャーをメール送信できます。
• 04ゲストが自分でバウチャーを発行できるキオスクページを提供します。
• 05内部ログイン、OpenID Connect SSO、または認証なしに対応します。
• 06ベアラートークンで保護されたREST APIを提供します。

ユースケース

• カフェ、ホテル、コワーキングスペースで、ゲストにWiFiアクセスコードを発行する。
• フロントデスクのスタッフがレシートプリンターでバウチャーを印刷する。
• APIを通じてHome Assistantなどのシステムからバウチャー作成を自動化する。
• キオスクを設置し、公共エリアでインターネットアクセスをセルフサービスで提供する。

クイックスタート

1. 1

   voucher認証を有効にしてUniFi Hotspot Portalを設定します

2. 2

   READMEの例をもとにdocker-compose.ymlを作成し、UniFiの設定を入力します

使う前に知っておきたいこと

• !バージョン8.xにはUniFi OSが必要です。従来のUniFi Network Serverでは動作しません。
• !Local Network APIキーとSite Manager APIキーは相互に使用できません。
• !voucher認証が有効なUniFi Hotspot Portalが必要です。

トピック

よくある質問

unifi-voucher-site とは？

UniFiネットワークのゲスト用WiFiバウチャーを作成・管理・印刷できるWebアプリとREST API。 UniFi Voucher Siteは、UniFiネットワーク向けのゲストアクセス用バウチャーを発行・管理するセルフホスト型Webアプリケーションです。管理者は、有効期限、1回または複数回の利用制限、アップロードとダウンロードの速度上限、データ転送量の上限を設定してバウチャーを作成し、ゲストに渡せます。

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 のインストール方法は？

voucher認証を有効にしてUniFi Hotspot Portalを設定します READMEの例をもとにdocker-compose.ymlを作成し、UniFiの設定を入力します

unifi-voucher-site はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/glenndehaan/unifi-voucher-site