一、搞清日志类型：不是所有日志都有用
SafeW 的日志分为两层：
- 用户界面日志（
safew-gui.log）只记录界面交互事件，启动失败时几乎毫无帮助。 - 内核日志（
safew-core.log）记录 WireGuard 握手、驱动加载、DNS 解析、Kill‑Switch 防火墙指令等关键行为。99% 的启动错误都藏在这里。
但内核日志默认只输出“信息”级别，很多报错会被隐藏，必须手动切换为“调试”级别。
开启详细日志（一次性操作）
- Windows：设置 → 高级 → 诊断 → 日志级别 → 选择“调试” → 重启客户端。
- macOS：菜单栏 SafeW 图标 → Preferences → Diagnostics → Log level → Debug → 退出并重新打开。
- Android：侧边栏 → 关于 → 连续点击版本号 7 次进入开发者选项 → 日志级别 → Debug。
⚠️ 调试模式单文件每小时可产生约 50 MB 日志，排障完成后务必切回“信息”级别，避免撑满磁盘。
二、从报错关键词直达根因（决策树）
打开 safew-core.log，翻到文件末尾，按时间倒序找到第一条 [FATAL] 或 [ERROR] wireguard-go，然后用下表快速定位。
日志关键词根本原因首选行动bind: address already in use端口 51820/UDP 被其他进程占用查端口占用并结束冲突进程，或修改 SafeW 本地监听端口CreateFile failed 0x5权限不足，驱动无法加载以管理员身份运行客户端（macOS 旧版需关闭 SIP）netfilter.sys mismatch旧版 NetFilter 驱动残留运行官方清理工具 SafeW-CleanTool.exe /uninstalldriverscertificate has expired系统时间错误或服务器证书轮换同步网络时间，再尝试切换接入点out of memory: wireguard-go32 位进程内存耗尽改用 64 位安装包，或关闭 AI 预测中心panic: send on closed channel6.4.0 已知缺陷（已修复）直接“检查更新”安装热补丁，无需手动改动
若出现 panic: send on closed channel，这是 6.4.0 早期版本的 bug，官方已在 2026‑02‑03 推送修复补丁，只需联网更新即可解决。
三、三步修复路径
3.1 快速提取日志
- Windows：右击托盘图标 → 帮助 → 导出调试包，自动生成
safew-logs-yyyymmdd.zip，内含核心日志和注册表快照。 - macOS：Finder →
⌘+Shift+G→/Library/Logs/SafeW/，将core.log和ui.log打包。 - Android：侧边栏 → 反馈 → 勾选“附加日志”，系统自动压缩 SafeW 私有日志和 logcat 到
/sdcard/Android/data/com.safew/files/。
3.2 依据决策表执行修复
以最常见的“端口冲突”为例：
- 用命令行找到占用端口的进程：
- Windows：
netstat -ano | findstr 5182，记下 PID。 - macOS：
sudo lsof -iUDP:51820。
- 结束该进程。若为系统服务（如
svchost），不要强制结束，改为修改 SafeW 本地端口：
- 设置 → 高级 → 本地端口 → 改为
52820（或更高）→ 保存，3 秒内自动重连。
- 检查日志中出现
UDP bind on 0.0.0.0:52820 success即表示修复成功。
3.3 回退与安全模式
若直接修复无效，可进入“安全模式”隔离第三方驱动干扰：
- Windows 11：设置 → 系统 → 恢复 → 高级启动 → 立即重启 → 疑难解答 → 启动设置 → 按 4 进入安全模式，运行
SafeW-CleanTool.exe /factoryreset。 - macOS：关机 → 长按电源键 → 选项 → 继续 → 顶部菜单“实用工具” → 终端，执行
/Applications/SafeW.app/Contents/MacOS/safew --reset。
⚠️ 工厂重置会清空所有节点收藏和自定义分流规则，请提前导出 settings.json。四、不适合硬修的例外场景
- 企业电脑已安装其他过滤驱动且无法卸载：改用 SafeW 的“浏览器扩展模式”（仅代理 80/443 端口），虽然失去 Kill‑Switch，但可满足日常海外需求。
- 2025 款国行路由器自带安全扫描模块：会强制重置 51820 端口映射。即使本地换端口，路由器也会在 30 秒内重新抢占。解决办法是刷国际版固件，或在路由器后台将 SafeW 设备的 MAC 地址加入“游戏模式”白名单。
- 合规渗透测试要求零第三方驱动：可开启“用户态代理链”（Beta），路径：设置 → 实验室 → 用户态网络栈。该模式性能下降约 18%，但不加载内核驱动，可审计。
五、修后三验证：不止看图标变绿
- 数据通道：浏览器访问
https://ip.safew.io，显示的 IP 应与节点出口一致。 - DNS 泄漏：执行
nslookup myip.opendns.com resolver1.opendns.com，返回的 IP 必须是节点 DNS 地址。 - Kill‑Switch 有效性：手动断开节点，
ping 1.1.1.1必须 100% 丢包；重连后 3 秒内恢复通信。
六、高频疑问速查
日志中大量 [WARN] DNS-over-QUIC fallback 是不是故障？
并非故障。这条告警表示 DoQ 服务器 500 ms 内未响应，自动切换为 DoH。若每小时出现频率超过 20%，可尝试将远程 DNS 更改为 8.8.8.8。
6.4.0 的 AI 威胁预测让游戏掉帧？
8 GB 显存以下的笔记本在开启“实时行为拦截”后，GPU 会分出 5–8% 算力做推理。解决方案：设置 → 安全 → AI 预测中心 → 游戏模式白名单，添加游戏主程序。
导出日志时提示“文件被占用”？
SafeW 主进程正在写日志。需完全退出客户端（而非仅关闭窗口），再执行导出。Windows 下可用任务管理器确认 SafeW.exe 进程已归零。
调试日志会占多少空间？
实测 100 Mbps 持续跑量 1 小时，safew-core.log 约 47 MB；若开启量子签名功能额外增加 15%。建议排错后立即切回信息级别，并定期清理 7 天前的日志文件。
热补丁推送后仍出现相同 panic 怎么办？
可能本地缓存未刷新。退出 SafeW，删除 %LOCALAPPDATA%\SafeW\update\staging 目录，重启后再次检查更新。若仍复现，将新生成的时间戳日志提交官方工单。
七、日常维护最佳实践
- 升级前执行
SafeW-CleanTool.exe /checkdrivers，避免旧驱动冲突。 - 调试日志保留不超过 24 小时，排完即改回“信息”级别。
- 企业部署零信任策略时，先在测试组下发，确认日志无
[FATAL] policy reject loop再全量推送。 - 每月第一个周六手动导出一次调试包并加密存档，作为健康基线。
- 节点列表突然变空时，先检查
config.safew.cloud是否被本地 DNS 劫持，再用手机 4G 热点验证。
八、版本差异与迁移注意
6.3.x 升级到 6.4.0 后，日志系统从 spdlog 换为自研 safew-logd，旧日志路径 %APPDATA%\SafeW\logs 会自动迁移至 %PROGRAMDATA%\SafeW\logs，权限也变为 SYSTEM 级，防止篡改。如果发现历史日志“消失”，用 Everything 搜索 safew-core-2025* 即可。
另外，6.4.0 的量子签名模块仅支持 x64 和 arm64，32 位系统安装器会自动置灰该选项。若日后收到“量子签名加载失败”日志，请检查是否误装了 32 位包。
九、未来趋势：日志上链，防篡改审计
SafeW 计划在 2026 年第二季度将 safew-logd 与以太坊 L2 锚定，用户导出调试包时可一键生成链上哈希，形成不可篡改的审计凭证。届时提交工单，官方会优先校验链上哈希，极大加快问题定位速度。导出时勾选“生成链上凭证”即可，全程不到 5 秒。
总结：SafeW 无法启动的排查核心是 开启调试级日志→根据关键词决策→执行修复→执行三阶段验证。遵循这条闭环，90% 的启动问题可在 10 分钟内定位并解决，无需重装系统或回退版本。
术语表
- Kill‑Switch：隧道意外断开时瞬间阻断所有外网流量，防止真实 IP 泄露。
- DoQ：DNS-over-QUIC，基于 QUIC 协议的加密 DNS，具备连接复用和低延迟优势。
- 链上哈希：对日志包做 SHA‑256 计算后将哈希值写入区块链，提供不可篡改的时间戳证明。
风险与边界
- 公司网络若强制 SSL 解密，SafeW 可能因证书链被替换导致 TLS 握手失败，需申请
*.safew.cloud例外。 - 32 位 Windows 7 不再受支持，6.4.0 安装器直接阻止安装。唯一方案是回退 6.2.5，但不再获得安全更新。
- 工厂重置会清空分流规则，如果需要自定义国内直连列表，务必提前备份
settings.json。