HandyCafe Docs
owner it-admin

IP 日志与访问记录

不少国家要求网吧记录哪位顾客在什么时候用了哪台机器。日志页面上的 IP 日志标签页保存的就是这些访问记录。

访问记录并不保存在 HandyCafe 数据库中,而是每天写入一个纯文本文件。每个文件都存放在数据库之外,并用校验和封存。因此,封存之后再改动文件是能被发现的。


开启访问日志记录

访问日志默认关闭,需要您手动开启。打开设置,进入安全,找到**访问日志(IP 日志)**区块。

设置项 作用
启用访问日志记录 把每台设备的内网 IP、MAC 地址和会话活动记录到每日文件中
记录出站连接 同时记录出站连接的目标 IP 和端口。这会明显增加日志量
记录目标域名 把每个目标 IP 关联到该机器为它解析出的域名
记录发起程序 记录是机器上的哪个程序发起了这个连接,例如 chrome.exe
保留期(天) 每日文件保留多久。730 天(两年)符合土耳其 5651 号法律要求的留存期
网吧固定 IP 地址 运营商分配给本店的固定公网 IP

后四项设置只有在它们上面的开关打开后才会出现。目标域名和发起程序都从属于出站连接记录。

对客户端版本的要求

采集目标域名需要 Windows 上的客户端 5.0.14 或更新版本,采集发起程序需要客户端 5.0.15 或更新版本。旧版客户端照常上报基础记录,只是没有这两个字段。

浏览器内部通过安全 DNS 解析的域名对机器本身不可见,这类域名不会被记录。

关于域名的一点提醒

一个访问过的域名,能说明的东西远比一个 IP 地址多。开启记录目标域名之前,请先确认本地的数据保护义务。对多数留存规定来说,只记录连接就已经够了。

固定 IP 字段

法规通常要求在机器内网地址旁边一并提供本店共用的公网地址。请把运营商分配的固定公网 IP 填在这里。如果本店没有固定 IP,留空即可。


查看记录

打开日志页面,选择 IP 日志标签页。该视图的标题是访问记录

记录种类

筛选 显示内容
会话 设备上线、离线事件,以及会话的开始和结束
连接 各机器发出的出站连接
全部 两类记录一起显示

事件类型

事件 含义
设备上线 有机器出现在网络中
设备离线 有机器离开了网络
会话已开始 某台机器上开启了会话
会话已结束 会话已关闭
连接 某台机器发起了一个出站连接

事件、PC、用户、本地 IP、MAC、目标、协议和公网 IP。没有会员的会话在用户列显示访客

选中一条记录可以打开详情。详情里还会补上会员 ID、会话 ID、远程 IP 和端口、本地端口、解析出的域名、发起程序以及原始记录行。原始记录行可以复制下来,用于配合执法调取。

翻页与搜索

该视图一次显示一天,用前一天后一天切换。全文搜索覆盖 IP 地址、MAC 地址、主机名、会员和域名。协议和事件筛选可以进一步缩小范围。

在一条会话记录上选择查看此 PC 的连接记录,可跳转到该机器的连接列表。

跨度超过 31 天的范围会给出警告,结果数量可能受到限制。


当日文件完整性

每天对应一个文件。这一天结束后,文件被封存并压缩为 .log.zst当日文件完整性面板显示:

字段 含义
文件名 磁盘上的当日文件
大小与磁盘占用 记录的原始大小和压缩后的大小
行数 这一天有多少条记录
当前 SHA-256 文件当前状态的校验和
前一天哈希值 前一天的校验和,把各天串成一条链
封存时间 这一天是什么时候关闭并封存的

某一天旁边显示的状态是以下三种之一:

  • 校验通过:文件与记录在案的校验和一致。
  • 已篡改:文件已经对不上了,说明封存之后有人改动过。
  • 无文件:这一天没有任何记录。

由于每个当日文件都带着前一天的校验和,删掉或改动其中任何一天,都会让这一天往后的链条断开。

导出当日文件会导出一份副本,用于提交给主管部门。


文件存放位置

访问日志的当日文件放在自己的文件夹里,与应用日志和数据库分开。要更改位置,请打开设置,进入文件夹,在 IP 日志文件夹区块中修改。新位置立即生效,无需重启应用。

参见文件夹位置


合规提示

HandyCafe 负责记录并保存访问数据。但只做到留存,并不等于场所就合规了。备案义务、告知义务、过滤义务以及主管部门要求的格式,各国规定并不相同。请向当地顾问确认您自己需要承担哪些义务。


相关页面