TorBrowser 中文文档 下载 App

查看 Tor 日志——从日志里定位连接问题的技巧

Tor 日志是什么

Tor Browser 连接失败时，Tor Launcher 会在内部记录 Tor 守护进程的运行日志——从启动、目录服务器连接、电路构建到最终成功或失败的完整过程。这些日志是排查问题的第一手资料。

三种查看方式

方式一：错误弹窗（最直接）

连接失败时，Tor Launcher 会弹出错误对话框。对话框里有一个按钮："将 Tor 日志复制到剪贴板上"。点击后打开记事本粘贴即可。

这是最推荐的方式——在弹窗里看到的日志就是导致你失败的那次连接的完整日志。

方式二：运行中的 Tor Launcher

如果 Tor Browser 已经打开（但有某些功能异常）：

  1. 菜单按钮 → "偏好设置"
  2. 左侧栏选择"洋葱"
  3. 页面底部找到"查看 Tor 日志" → 点击按钮

方式三：命令行（Linux/macOS）

从命令行启动 Tor Browser 并保存日志到文件：

# 启动并在终端显示详细日志
./start-tor-browser.desktop --verbose

# 保存日志到文件
./start-tor-browser.desktop --log /path/to/tor-browser.log

日志关键段落解读

Bootstrapped（引导进度）

这是每次连接时都会显示的进度信息：

Bootstrapped 10% (conn): Connecting to a relay
Bootstrapped 15% (handshake): Now handshaking with a relay
Bootstrapped 20% (handshake): Handshake with a relay done
Bootstrapped 40% (desc): Loading relay descriptors
Bootstrapped 60% (status): Loading network status
Bootstrapped 80% (ap): Requesting a relay
Bootstrapped 90% (circuit): Creating a one-hop circuit
Bootstrapped 100% (done): Connected to the Tor network!

卡在某个百分比不动 → 该阶段有问题。常见卡点：

卡点含义可能原因
10% 不动连不上任何中继审查封锁 / 防火墙
40~60% 不动下载中继描述符卡住目录服务器不可达 / DNS 问题
80% 不动挑不出合适的中继可用中继太少（被封了）
任何阶段反复重试Tor 尝试不同方法但都失败检查网桥/传输方式配置

Warning 和 Error 行

日志里的 Warning 和 Error 是关键问题信号：

[Warning] TLS handshake failure (原因：证书无效)
[Error] Proxy server is refusing connection on port 9150
[Warning] Connection to directory server timed out

逐行扫描 Warning 和 Error，关键词通常直接指向问题。

常见日志错误对照表

日志关键词含义解决
certificate expired / not yet valid系统时间不对查系统时钟
cannot reach any directory server目录服务器被封用网桥/传输方式
Proxy server refusing connection9150 端口被占用杀残留进程
TLS handshake failure + 正常时间加密握手失败可能是审查/防火墙
TLS handshake failure + 时间异常时钟问题查系统时钟
Connection rejected / Connection closed中继主动拒绝换中继/换传输方式
DNS resolution failedDNS 解析失败可能是防火墙封了 DNS 请求
SOCKS request rejectedSOCKS 代理配置有问题检查 Tor Launcher SOCKS 设置

怎么把日志发给别人（请教/搜索）

不要发送完整日志

完整 Tor 日志包含你的 Tor 中继指纹和本地路径信息，虽然不直接暴露你的真实 IP，但可能被关联分析。

正确做法：

  1. 复制日志里的 Warning 和 Error 行（去掉 Info 级别）
  2. 把时间戳替换成模糊值
  3. 把你的本地路径（如 C:\Users\xxx\...）替换成通用路径
  4. 把这部分精简后的日志发到论坛/搜索引擎/AI

精简示例

原始（太长）：

[Info] Bootstrapped 10%: Connecting to guard relay 'abcdef123456' at 1.2.3.4:9001
[Warning] TLS handshake failure for relay 'abcdef123456' - certificate not yet valid
[Error] Bootstrapped 10% failed
...（几十行 Info）...

精简后（够用）：

[Warning] TLS handshake failure - certificate not yet valid
[Error] Bootstrapped 10% failed

把日志提交给 Tor 项目

如果问题确认是 Tor 自身的 bug（不是用户网络配置问题）：

  1. 访问 Tor Project 的 Issue 追踪（GitLab）
  2. 按照模板提交，附上精简后的日志
  3. 说明你的系统信息（Windows/macOS/Linux + 版本 + Tor Browser 版本）

Tor 项目的 Issue 系统链接可以在 Tor 手册的"已知问题"页面找到。

日常维护建议