日志、时区与隐私

配置 `[log]`

[log]
level = "warn"          # debug / info / warn / error
timezone = ""           # 空 = 自动读取系统时区
hide_address = false    # 隐私模式

日志等级

等级	输出内容
`error`	仅错误
`warn`（默认）	警告与错误：配置项被忽略、封禁 / 解封失败、端口被丢弃等
`info`	额外输出启动参数、检测告警（疑似 / 持续 / 结束）、封禁与解封、UPnP 拦截、抓包缓冲等业务事件
`debug`	额外输出调试信息

默认 warn 意味着普通告警不会出现。排查「为什么没封禁」「为什么看不到检测结果」时，第一件事就是把 level 改成 info——它支持热重载即时生效，不必重启进程。

时区

按顺序尝试：-z / --timezone 参数 → TZ 环境变量 → OpenWrt 的 /etc/TZ → 系统默认（可能是 UTC）。支持 IANA 名称（Asia/Shanghai）或 POSIX 串（CST-8）。

C 版使用 IANA 名称时要求目标系统存在 /usr/share/zoneinfo（Alpine 需装 tzdata）；用 POSIX 偏移写法（8:00、CST-8）则无此依赖。

启动日志会说明时区来源：

日志时区：CST（来源：/etc/TZ，当前偏移 +08:00）

隐私模式

开启后日志中的设备自身身份信息被掩码：

类型	原值 → 掩码
MAC	`60:21:01:1b:0a:23` → `60:21:...:23`
IPv6	`2408:8240:9411:37b0:4e9:adaa:3a1a:b2a3` → `2408:8240:...:b2a3`
公网 IPv4	`112.245.115.51` → `112...51`
内网 IPv4	`192.168.1.100` 保持原样（非公网地址）

规则：MAC 与 IPv6 保留前两段与最后一段；公网 IPv4 保留首段与末段。远端对端 IP （告警中的「相关IP」）不受影响，始终完整展示，便于定位。

该选项只影响日志展示：黑白名单、防火墙封禁仍使用真实 MAC / IP；HTTP API 也返回原始值。命令行等价项 -H / --hide-address。

输出示例（`level = "info"`）

2026/10/03 12:00:02 日志时区：CST（来源：/etc/TZ，当前偏移 +08:00）
2026/10/03 12:00:02 日志等级：info（可在 [log] level 中调整，或热重载生效）
2026/10/03 12:00:02 已加载配置文件：config.toml
2026/10/03 12:00:02 名单：黑名单（只检测名单内的 2 个设备）
2026/10/03 12:00:02 已启用防火墙对接：nftables（bridge pcdn_detect 集合 banned，按源 MAC + UDP 端口丢弃）
2026/10/03 12:00:02 开始监听网卡 br-lan：触发阈值=20，时长=1m0s，持续提示时长=10m0s，扫描间隔=2s
2026/10/03 12:00:42 00:11:22:33:44:55(192.168.1.100) 的端口 40000 疑似产生PCDN行为（近 1m0s 内 27 个对端IP，累计上行 3.4MiB / 下行 12.1KiB），相关IP为: 1.2.3.4, 5.6.7.8, 9.10.11.12, ...
2026/10/03 12:01:30 00:11:22:33:44:55(192.168.1.100) 的端口 40000 持续产生PCDN行为（本轮累计 31 个对端IP，累计上行 4.1MiB / 下行 15.2KiB），新增相关IP为: 13.14.15.16, 17.18.19.20
2026/10/03 12:09:05 00:11:22:33:44:55(192.168.1.100) 的端口 40000 PCDN行为结束（本轮累计 31 个对端IP，累计上行 5.6MiB / 下行 20.3KiB）

封禁 / 解封同样按 info 输出（已封禁、已解封、已执行全 UDP 端口封禁）。

在 OpenWrt 上查看

日志写 stdout，由 procd 收集进系统日志，syslog tag 为二进制文件名：

Sat Oct 24 12:00:42 2026 daemon.info pcdn-detect[1234]: ... 疑似产生PCDN行为 ...

logread -e pcdn-detect            # 按 tag 过滤
logread -f -e pcdn-detect         # 实时跟踪

LuCI 面板的「日志」页同样按 tag 精确筛选，不会把正文里提到 pcdn-detect 的其它进程日志混进来。可查看的历史长度取决于系统日志缓冲区，需要长期保存请配置 logread 落盘或远程 syslog。