Skip to content

故障速查手册

Jump to bottom Edit New page
candy edited this page Jun 13, 2017 · 33 revisions

本页面收集整理常见的故障“现象”和对应的分析、解决方法。
你可以在本页面中寻找或者搜索你所遇到的问题，并查看对应的解决方案。欢迎大家添加自己遇到的问题和解决途径。
关于XX-Net的疑问、错误报告、意见建议，可以发布在issue区。

指标说明

注：这一章列举了常见的“好指标”和“坏指标”，请对照着检查一下，在发issue的时候，可以说明你看到了哪些好指标，哪些坏指标。这有助于开发者和其他用户确定问题的原因。
这些指标涉及到了状态页面和日志页面中的信息。你可以在相应的wiki页面中更多地了解它们：配置页面简介。
在发布issue的时候，如果你能附上完整的状态信息和相关的日志信息，则更好不过。

代表“好消息”的指标

  • 能够翻墙（尽管存在一些问题），在线查IP显示为国外地址
  • 尽管出问题了，但错误提示与翻墙前不同（说明XX-Net带来了一些变化，请在本文查找具体的错误提示）
  • GAEProxy状态信息中block stat显示为OK（表示网络畅通）
  • GAEProxy状态信息中connect link不是0,0（表示目前已经与GAE服务器连接上了）
  • 当你打开某个墙外网站时，日志中能看到相关的网址的字样。（说明XX-Net接收到了浏览器发出的代理请求）
  • 日志中可见“[DEBUG] create_ssl update [IP地址] time:[时间]”的字样（说明这个IP是可用的）

代表“坏消息”的指标

  • 网速慢或者不稳定
  • 浏览器显示错误提示（请在本文查找具体的错误提示标题）
  • GAEProxy状态信息中block stat显示为connect block（表示网络有问题）
  • GAEProxy状态信息中connect link显示为0,0（表示目前还没连接上GAE服务器）
  • 日志中出现较多的“[DEBUG] create_ssl [IP地址] fail:timed out”之类的字样（说明这个IP不可用）
  • 日志中出现较多的“[DEBUG] report_connect_fail network fail”之类的字样（表示网络有问题）
  • 日志中出现“ssl handshake failure”字样（可能是证书错误）

下载、安装、和部署问题

部署故障

APPID使用中

部署GAE时，appid正在使用，导致部署失败。请参考Deploy-fail-when-appid-in-use。

启用弱安全应用

部署失败时，请检查你是否启用了弱安全应用。

密码问题

部署时提示密码错误，或其他密码相关问题。请参考Deploy password problem。
如果你已经启用2步登录验证，那么需要设置应用专用密码。

重新授权

请参考重新授权

其他部署问题

你还可以在这里查看和补充其他部署问题。

Linux及Mac系统问题

Linux下无法正常运行

在Linux系统下无法运行XX-Net，日志中显示：
“start module gae_proxy fail:libssl.so.1.0.0: 无法打开共享对象文件: 没有那个文件或目录”
（例子参见：issue #779）

这是因为XX-Net自带的OpenSSL无法在部分Linux下工作。执行以下命令安装系统库：

  • Fedora
    sudo dnf install pyOpenSSL.noarch
  • CentOS
    sudo yum install pyOpenSSL

缺少名为pygtk的module

可能是部分系统没有自带这个模块。如Ubuntu，可以通过运行下面的命令来解决
sudo apt-get install -y python-gtk2
（例子参见：issue #1381）

Linux下以纯终端模式运行报错

例子和解决方案参见：issue #715

使用过程中的问题

网络连接问题

时断时续，有时候能翻，有时候连接超时

网速慢或者不稳定，有时候能翻，有时候显示“连接超时，请休息一会儿”。
日志中出现较多的“create_ssl [IP地址] fail:timed out”之类的字样。

可能是你目前只有个别可用IP，由于“Google IP使用频率限制”选项的影响，会在各个IP之间切换。当切换到无效IP时就无法连接。

请参考：“Google IP使用频率限制”选项

XX-Net运转正常但无法翻墙

打开被墙网站，浏览器显示“无法打开该页”，与翻墙前毫无区别。XX-Net日志中找不到与你打开的网址相关的任何记录，但其他迹象显示XX-Net运行正常（参见上文：代表“好消息”的指标）。
（例子参见：issue #749）

这可能是因为你没有设置好代理。请看设置代理一文。

频繁遭遇人机验证（验证码）

如果是在使用Google的过程中频繁遇到验证码，可以配置直连规则来改善。（注：配置直连规则不是完美解决方案，有可能引发其他问题） 方法是：在data/gae_proxy/manual.ini（如果没有这个文件，则新建一个）中添加：

[hosts]
.google.com = direct

然后重启GAE_proxy。

无法观看youtube

在data/gae_proxy/manual.ini（如果没有这个文件，则新建一个）中添加：

[hosts]
.youtube.com = gae

然后重启GAE_proxy。

关闭XX-Net后，浏览器无法上网

关闭XX-Net之后，浏览器显示无法链接到代理服务器，无法上网。（例子参见：issue #785）

通常这个问题出自浏览器的代理设置。当浏览器的代理设置指向某个地址（比如XX-Net的127.0.0.1:8087），但你关闭了提供相应代理的软件，那么就会出现无法链接到代理服务器的情况。解决的方法是调整浏览器的代理设置。

参考：安装和使用SwichySharp、托盘右键菜单、如何设置代理。

打开XX-NET后，国内网站（直接连接的）打不开

现象：

1.打开XX—NET后，过一会儿，直接连接的网站（国内网站）不能访问，而通过代理访问的网 站（国外网站），可以访问。如果让国内网站也走代理（即全局代理），则也可以访问。

2.连接同一路由器的其它设备不能访问网络。

方法：路由器性能不好，减小扫描线程数（如减到5）试试。

来源 #1431

卡（电脑反应迟钝顿）

可能是由于后台扫描IP的线程数太高导致的。尝试将扫描线程调为1，点击“更新”。

证书问题

浏览器打开https://链接时报错

浏览器会阻止对该网址的访问，显示警告文字。大意是无法验证网站所有者的身份，无法信任服务器证书，安全凭据不可靠，等。
错误提示的标题类似于：
“SSL错误”
“您的链接不是私密链接”
“该网站的安全证书不受信任”
“此链接是不受信任的”
“此网站的安全证书有问题”
……

请参考：
证书错误

SSL握手失败

日志中出现“ssl handshake failure”字样。（例子参见：issue #883）

可能是证书导入失败，建议手动导入证书。参考：证书错误。

您的连接不是私密连接 (NET::ERR_CERT_COMMON_NAME_INVALID)

取消XX-NET根目录\code\default\gae_proxy\local\cert_util.py代码内252行的注释（将代码开头的 “#”删除，然后保存，如果已经删除，请看下一步）
源码参见：https://github.com/XX-net/XX-Net/blob/master/code/default/gae_proxy/local/cert_util.py#L252
然后删除XX-NET根目录\data\gae_proxy\下的 CA.crt和 certs文件夹 ,重启 xx-net

Add a custom sidebar
Clone this wiki locally