loginetsolutions/mews-wifi

mews-wifi

镜像概述

mews-wifi是MEWS PMS系统的无线互联网访问控制器，作为MEWS与RADIUS服务之间的桥梁，实现Wi-Fi接入的认证与管理。适用于集成MEWS PMS的场所（如酒店），提供便捷的Wi-Fi访问控制功能。

核心功能

1. 集成MEWS PMS与RADIUS服务，实现Wi-Fi接入认证
2. 支持测试环境与生产环境配置切换
3. 提供FreeRADIUS安装与配置指导
4. 支持日志记录与状态监控

使用场景

• 酒店、民宿等使用MEWS PMS系统的住宿场所
• 需要对客人Wi-Fi接入进行统一管理与认证的场景

配置说明

环境变量配置

需设置以下环境变量：

• CLIENT_TOKEN: MEWS API客户端令牌
• ACCESS_TOKEN: MEWS API访问令牌
• MEWS_PRODUCTION: 是否启用生产环境（true/false）
• SENDER_NAME: 通知邮件发送者***
• SENDER_PASSWORD: 发送者***密码
• SMTP_SERVER: SMTP服务器地址

示例：

bash
export CLIENT_TOKEN=E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D
export ACCESS_TOKEN=C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D
export MEWS_PRODUCTION=true

FreeRADIUS配置

安装FreeRADIUS

• macOS: brew install freeradius-server
• Linux: 参考FreeRADIUS官方下载页面

启用SQLite3支持

修改mods-available/sql配置文件，设置驱动为rlm_sql_sqlite并配置数据库路径：

bash
sql {
    driver = "rlm_sql_sqlite"
    sqlite {
        filename = "/tmp/freeradius.db"
        busy_timeout = 200
        bootstrap = "${modconfdir}/${..:name}/main/sqlite/schema.sql"
    }
    dialect = "sqlite"
    # 其他配置保持默认
}

启用外部访问

在clients.conf中取消注释以下行：

bash
ipv4addr = *	# any.  127.0.0.1 == localhost

启用SQL模块

创建符号链接到mods-enabled：

bash
ln -s ../mods-available/sql sql

测试FreeRADIUS

bash
radiusd -X

Docker部署

构建镜像

bash
git clone https://github.com/mobmax/mews-wifi.git
cd mews-wifi
docker build -t loginet.mews-wifi -f Dockerfile .

启动容器

bash
docker run -d --name mews-wifi.1 \
-e ACCESS_TOKEN='C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D' \
-e SENDER_NAME='notification@example.com' \
-e SENDER_PASSWORD='MyStrongPassword' \
-e SMTP_SERVER='mail.example.com' \
-v /tmp:/mews-wifi/db -v ~/app-logs:/mews-wifi/logs loginet.mews-wifi:latest

检查容器状态

bash
docker ps

查看日志

bash
tail -200f ~/app-logs/mews-wifi.log