跳到主要内容

现场 IP 白名单

快速设置

将自助入住限制为指定的 IP 地址。适用于仅允许在现场自助机办理入住的场景。

控制哪些网络可以完成现场入住步骤，包括人脸验证和自助入住。IP 白名单可以防止客人在远程办理入住，适用于仅希望使用自助机办理入住的场景。

设置位置​

设置 → 入住 → IP 白名单

快速概览​

设置控制内容使用场景
启用现场 IP 白名单开启或关闭强制执行暂时允许从任何网络办理入住
IP 白名单允许的 IP 地址将入住限制为指定位置
当前 IP您当前的 IP 地址添加地址时快速查看
CIDR 网段整个网络范围一次性将多个设备加入白名单

对客人和员工的影响​

  • 客人： 使用其他网络的客人可以在到店前上传证件，但在连接到白名单网络或扫描酒店的 QR 码之前，无法完成入住。
  • 员工： 您可以控制哪些自助机和员工网络能够完成入住，从而减少未授权访问。

IP 白名单的工作方式​

IP 白名单包含两层控制：

  • 总开关：为酒店启用或停用强制执行。
  • 条目开关：在不删除 IP 的情况下，单独启用或停用指定 IP。

启用总开关后：

  • ✅ 允许： 来自白名单 IP 的入住请求
  • ❌ 阻止： 来自其他 IP 的入住请求
阻止行为

来自非白名单 IP 的客人会看到错误消息，无法完成自助入住。

支持的格式​

仅支持 IPv4 地址和 CIDR 范围。IPv4 映射的 IPv6 值会被接受并规范化。

格式示例说明
IPv4 地址192.168.1.5单个设备
CIDR 网段10.0.0.0/24整个子网（256 个地址）
CIDR /16 网段192.168.0.0/16大型子网（65,536 个地址）
IPv4 映射的 IPv6::ffff:192.168.1.5规范化为 IPv4
仅支持 IPv4

目前仅支持 IPv4 地址。IPv6 支持即将推出。

使用场景​

仅限自助机入住​

场景： 您在大堂设有专用自助机，不希望客人在客房或家中办理入住。

设置：

  1. 找到自助机的 IP 地址（使用 当前 IP 功能）
  2. 将自助机 IP 添加到白名单
  3. 启用白名单

✓ 现在只有在自助机旁的客人可以办理入住

多个位置​

场景： 您在大堂、停车区和商务中心都设有自助机。

设置：

  1. 获取每个位置的 IP 地址
  2. 将所有 IP 添加到白名单（如果它们位于同一网络，也可以使用 CIDR 网段）
  3. 从每个位置进行测试

仅限员工使用的入住终端​

场景： 只有前台终端可以为客人办理入住。

设置：

  1. 获取前台计算机的 IP 地址
  2. 将其添加到白名单
  3. 培训员工使用指定终端

酒店 Wi-Fi 网络​

场景： 允许客人在酒店 Wi-Fi 网络的任何位置办理入住。

设置：

  1. 获取 Wi-Fi 网络的 IP 范围（例如 192.168.1.0/24）
  2. 将 CIDR 网段添加到白名单
  3. 使用酒店 Wi-Fi 的客人可以在客房内办理入住

设置 IP 白名单​

第 1 步：查找您的 IP 地址​

  1. 前往 设置 → 入住 → IP 白名单

  2. 查找 当前 IP 显示区域

  3. 记下显示的 IP 地址

    ✓ 这是您当前访问 AVA 所使用的 IP 地址

当前 IP 功能

“当前 IP”功能会显示您当前的 IP 地址，方便您添加正在使用的地址。

第 2 步：开启白名单​

  1. 找到 启用现场 IP 白名单

  2. 将其切换为 开启

    ✓ IP 列表和条目字段会显示出来。

第 3 步：添加 IP 地址或 CIDR 网段​

选项 A：添加单个 IP

  1. 在 IP 白名单 字段中输入 IP 地址
  2. （可选）添加所有者标签（例如“大堂自助机 1”）
  3. 点击 添加 IP

选项 B：添加 CIDR 网段

  1. 输入 CIDR 范围（例如 192.168.1.0/24）
  2. （可选）添加所有者标签（例如“前台 VLAN”）
  3. 点击 添加 IP

选项 C：添加当前 IP

  1. 点击 添加我的当前 IP 按钮
  2. 系统会自动检测并添加您的 IP
  3. 添加标签以便参考

第 4 步：启用/停用条目​

  • 切换 启用，为每个条目开启或关闭强制执行
  • 停用的条目仍会保留在列表中，但不会限制访问
  • 适用于临时调整，无需删除条目

第 5 步：保存更改​

  1. 检查所有白名单条目
  2. 点击 保存白名单 以应用更新
  3. 从允许和阻止的位置分别进行测试
未保存的编辑仍会显示

您可以在保存前添加、移除或停用多个条目。 在点击 保存白名单 之前，列表会保留所有编辑内容。

第 6 步：测试白名单​

从白名单位置测试：

  1. 打开入住落地页
  2. 尝试开始入住
  3. ✓ 应正常运行

从非白名单位置测试：

  1. 使用其他设备或网络
  2. 尝试访问入住页面
  3. ✓ 应显示错误消息并被阻止

管理白名单​

添加条目​

多个 IP 地址（以逗号分隔）：

192.168.1.10, 192.168.1.11, 192.168.1.12

带标签的单个 IP：

  • IP：192.168.1.100 → 标签：“前台 1 号接待台”
  • IP：192.168.1.101 → 标签：“大堂自助机”
  • IP：192.168.1.102 → 标签：“停车区自助机”

用于网络的 CIDR 网段：

  • 192.168.1.0/24 → 标签：“前台 VLAN”
  • 10.0.0.0/16 → 标签：“酒店 Wi-Fi 网络”

移除条目​

  1. 找到要移除的条目

  2. 点击 移除 按钮

  3. 点击 保存白名单

    ✓ 访问权限会立即撤销

临时停用​

您可以临时停用条目，而不是将其移除：

  1. 将 启用 切换为关闭
  2. 点击 保存白名单
  3. 条目会保留，但不会限制访问

查找 IP 地址​

对于自助机设备​

  1. 在自助机设备上打开任意网页浏览器
  2. 搜索“what is my ip”
  3. 记下显示的公网 IP 地址
  4. 将其添加到白名单

对于办公计算机​

Windows：

  1. 打开命令提示符
  2. 输入 ipconfig
  3. 查找“IPv4 Address”

Mac：

  1. 打开系统偏好设置
  2. 前往网络
  3. 记下显示的 IP 地址

对于网络范围（CIDR）​

联系 IT 管理员获取：

  • 网络范围（例如 192.168.1.0/24）
  • 子网信息
  • 静态 IP 分配情况

常见配置​

场景要加入白名单的 IP示例
单个大堂自助机1 个 IP192.168.1.100
多个自助机（同一网络）1 个 CIDR 网段192.168.1.0/24
自助机 + 前台多个 IP 或 CIDR192.168.1.0/24, 10.0.5.0/24
酒店 Wi-Fi 网络CIDR 网段192.168.0.0/16
允许远程预先入住留空无白名单（开放访问）

停用 IP 白名单​

要允许从任何 IP 地址办理入住：

  1. 将 启用现场 IP 白名单 切换为 关闭
  2. 点击 保存白名单

✓ 现在可以从任何位置进行自助入住

保留条目供以后使用

关闭总开关会保留您的 IP 列表。准备好后可以重新开启。

远程入住

如果您希望客人从家中预先办理入住，请将 IP 白名单留空或停用。

最佳实践​

何时使用 IP 白名单​

✅ 适合使用的情况：

  • 您有固定的自助机位置
  • 您希望阻止远程入住
  • 合规要求必须在场内办理入住
  • 您有静态 IP 地址或已定义的网络

❌ 不适合使用的情况：

  • 客人应能够远程预先办理入住
  • 您的 IP 经常变化
  • 您使用移动热点作为自助机网络
  • 您希望获得最大灵活性

安全最佳实践​

  • 为自助机和前台设备使用静态 IP
  • 在启用强制执行前，将酒店 Wi-Fi 和自助机网络加入白名单
  • 每季度复查，移除已停用的设备和旧子网
  • 使用 CIDR 网段，更方便管理多个设备
  • 为所有条目添加标签，以便了解每个 IP/范围的用途
  • 在生产环境启用前进行充分测试

网络架构​

推荐设置：

  1. 为自助机设置专用 VLAN
  2. 为所有入住终端使用静态 IP
  3. 为客人 Wi-Fi 设置独立网络（如果允许在客房内办理入住）
  4. 配置与 IP 白名单配套的防火墙规则

故障排除​

白名单阻止合法用户​

现象： 自助机旁的客人无法办理入住

解决方法：

  1. 从自助机检查 当前 IP
  2. 确认此 IP 位于白名单中
  3. 确保 IP 地址没有拼写错误
  4. 检查条目是否已切换为 启用
  5. 再次点击 保存白名单

IP 列表缺失​

现象： 只能看到开关，看不到 IP 列表。

解决方法：

  1. 开启 启用现场 IP 白名单
  2. 等待列表显示
  3. 添加 IP 并点击 保存白名单

之前的白名单编辑消失​

现象： 添加新 IP、移除条目或切换开关后，修改内容没有继续显示。

解决方法：

  1. 刷新页面并重新打开 设置 → 入住 → IP 白名单。

  2. 重新执行每项更改。

  3. 确认每项更改都出现在列表中。

  4. 检查所有编辑内容后，点击一次 保存白名单。

    ✓ 保存后的列表应包含您所做的每项更改。

IP 地址持续变化​

现象： 自助机 IP 每天或每周变化

原因：

  • 动态 IP 分配（DHCP）
  • ISP 轮换您的公网 IP

解决方法：

  1. 联系 IT 部门
  2. 为自助机设备申请静态 IP
  3. 使用静态 IP 更新白名单
  4. 或者为整个 DHCP 范围使用 CIDR 网段

无法添加 IP 地址​

现象： 保存按钮显示为灰色或出现错误

检查以下各项：

  • IP 格式有效（xxx.xxx.xxx.xxx）
  • CIDR 表示法正确（xxx.xxx.xxx.xxx/xx）
  • IP 前后没有空格
  • 八位组之间使用点号（.），而不是逗号
  • IP 不是 0.0.0.0 或 255.255.255.255

未显示当前 IP​

现象：“当前 IP”字段为空

解决方法：

  1. 刷新页面
  2. 检查浏览器控制台是否有错误
  3. 停用浏览器 VPN/代理
  4. 尝试使用其他浏览器

CIDR 网段不起作用​

现象： 范围内的设备仍被阻止

检查以下各项：

  • CIDR 表示法正确（例如使用 /24，而不是 /255.255.255.0）
  • IP 范围包含您正在测试的设备
  • 条目已切换为 启用
  • 更改已保存

与其他安全措施结合使用​

IP 白名单可以与以下功能配合使用：

  • 设备指纹识别
  • 会话超时
  • 用户身份验证
  • 人脸验证（IP 白名单控制可以在哪些位置进行验证）
  • 证件真实性检查

相关设置​

需要帮助？​

如果遇到以下情况，请联系 success@vouch-technologies.com：

  • ❌ 找不到自助机的 IP 地址
  • ❌ 申请静态 IP 后，IP 仍然持续变化
  • ❌ 白名单错误地阻止了用户
  • ❌ 需要帮助设置 CIDR 网段
  • ❌ 有网络架构相关问题

建议提供以下信息：

  • 您尝试加入白名单的 IP 地址或 CIDR 网段列表
  • 网络设置（Wi-Fi、以太网、移动网络）
  • 客人看到的错误截图
  • 网络拓扑图（如有）