运营维护与故障排查

查看当前客户端与服务器之间的连接

可以在客户端运行 mieru get connections 指令查看当前客户端与服务器之间的连接。该指令输出的一个示例如下。

Session ID  Protocol  Local       Remote        State        Recv Q+Buf  Send Q+Buf  Last Recv  Last Send
2187011369  UDP       [::]:59998  1.2.3.4:5678  ESTABLISHED  0+0         0+1         1s         1s
1466481848  UDP       [::]:59999  1.2.3.4:5678  ESTABLISHED  0+0         0+1         3s         3s

类似的，可以在服务器运行 mita get connections 指令查看当前服务器与所有客户端之间的连接。

配置文件存放地址

代理服务器软件 mita 的配置存放在 /etc/mita/server.conf.pb。这是一个以 protocol buffer 格式存储的二进制文件。为保护用户信息，mita 不会存储用户密码的明文，只会存储其校验码。

客户端软件 mieru 的配置文件同样是一个二进制文件。它在不同操作系统中存储的位置如下表所示

操作系统	配置文件位置	示例
Linux	$HOME/.config/mieru/client.conf.pb	/home/enfein/.config/mieru/client.conf.pb
Mac OS	$HOME/Library/Application Support/mieru/client.conf.pb	/Users/enfein/Library/Application Support/mieru/client.conf.pb
Windows	%USERPROFILE%\AppData\Roaming\mieru\client.conf.pb	C:\Users\enfein\AppData\Roaming\mieru\client.conf.pb

查看代理服务器 mita 的日志

用户可以使用下面的指令打印 mita 的全部日志

sudo journalctl -u mita -xe --no-pager

查看客户端 mieru 的日志

客户端 mieru 的日志存放位置如下表所示

操作系统	日志文件位置	示例
Linux	$HOME/.cache/mieru/ or $XDG_CACHE_HOME/mieru/	/home/enfein/.cache/mieru/
Mac OS	$HOME/Library/Caches/mieru/	/Users/enfein/Library/Caches/mieru/
Windows	%USERPROFILE%\AppData\Local\mieru\	C:\Users\enfein\AppData\Local\mieru\

每个日志文件的格式为 yyyyMMdd_HHmm_PID.log，其中 yyyyMMdd_HHmm 是 mieru 进程启动的时间，PID 是进程号码。每次重启 mieru 会生成一个新的日志文件。当日志文件的数量太多时，旧的文件会被自动删除。

打开和关闭调试日志

mieru / mita 在默认的日志等级下，打印的信息非常少，不包含 IP 地址、端口号等敏感信息。如果需要诊断单个网络连接，则需要打开调试日志（debug log）。

本项目在 configs/templates 目录下提供了快速打开和关闭调试日志的配置文件。请将它们下载到服务器或本地计算机上，并输入以下指令。注意，改变 mieru 的设置后，需要重新启动服务才能生效。

# enable debug logging
mita apply config server_enable_debug_logging.json

# OR disable debug logging
mita apply config server_disable_debug_logging.json

# This will not interrupt traffic
mita reload

# enable debug logging
mieru apply config client_enable_debug_logging.json

# OR disable debug logging
mieru apply config client_disable_debug_logging.json

mieru stop

mieru start

判断客户端与服务器之间的连接是否正常

要确定连接是否正常，可以查看客户端指标。要获取指标，请运行命令 mieru get metrics。在下面的例子中，

{
    "cipher - client": {
        "DirectDecrypt": 25683,
        "FailedDirectDecrypt": 0
    },
    "connections": {
        "ActiveOpens": 2,
        "CurrEstablished": 2,
        "MaxConn": 2,
        "PassiveOpens": 0
    },
    "HTTP proxy": {
        "ConnErrors": 0,
        "Requests": 2,
        "SchemeErrors": 0
    },
    "replay": {
        "KnownSession": 0,
        "NewSession": 0
    },
    "socks5": {
        "ConnectionRefusedErrors": 0,
        "DNSResolveErrors": 0,
        "HandshakeErrors": 0,
        "HostUnreachableErrors": 0,
        "NetworkUnreachableErrors": 0,
        "UDPAssociateErrors": 0,
        "UnsupportedCommandErrors": 0
    },
    "socks5 UDP associate": {
        "InBytes": 0,
        "InPkts": 0,
        "OutBytes": 0,
        "OutPkts": 0
    },
    "traffic": {
        "InBytes": 14680428,
        "OutBytes": 1853242,
        "OutPaddingBytes": 271334
    },
    "underlay": {
        "ActiveOpens": 2,
        "CurrEstablished": 2,
        "MaxConn": 2,
        "PassiveOpens": 0,
        "UnderlayMalformedUDP": 0,
        "UnsolicitedUDP": 0
    }
}

如果 connections -> CurrEstablished 的值不为 0，说明此刻客户端与服务器之间有活跃的连接。如果 cipher - client -> DirectDecrypt 的值不为 0，说明客户端曾经成功解密了服务器返回的数据包。

故障诊断与排查

mieru 为了防止 GFW 主动探测，增强了服务器端的隐蔽性，但是也增加了调试的难度。如果你的客户端和服务器之间无法建立连接，从以下几个排查方向入手可能会有所帮助。

服务器是否在正常工作？用 ping 指令确认客户端是否可以到达服务器。
mita 代理服务是否已经启动？用 mita status 指令查看。
mieru 客户端是否已经启动？用 mieru status 指令查看。
客户端和服务器的设置中，端口号是否相同？用户名是否相同？密码是否相同？用 mieru describe config 和 mita describe config 查看。
打开客户端和服务器的调试日志，查看具体的网络连接情况。

如果未能解决问题，可以提交 GitHub Issue 联系开发者。

重置服务器指标

服务器指标存储在文件 /var/lib/mita/metrics.pb 文件中。如果想重置指标，可以运行下面的命令：

sudo systemctl stop mita && sudo rm -f /var/lib/mita/metrics.pb && sudo systemctl start mita

环境变量

如有必要，用户可以使用环境变量控制服务器和客户端的行为。

MITA_CONFIG_JSON_FILE 从这个路径加载 JSON 格式的服务器配置文件。
MITA_CONFIG_FILE 从这个路径加载 protocol buffer 格式的服务器配置文件。
MIERU_CONFIG_JSON_FILE 从这个路径加载 JSON 格式的客户端配置文件。通常用于同时运行多个客户端进程。
MIERU_CONFIG_FILE 从这个路径加载 protocol buffer 格式的客户端配置文件。
MITA_LOG_NO_TIMESTAMP 这个值非空时，服务器日志不打印时间戳。因为 journald 已经提供了时间戳，我们默认开启这项设置，以避免打印重复的时间戳。
MITA_UDS_PATH 使用这个路径创建服务器 UNIX domain socket 文件。默认的路径是 /var/run/mita.sock。
MITA_INSECURE_UDS 这个值非空时，不强制修改服务器 UNIX domain socket 文件 /var/run/mita.sock 的用户和访问权限。这个设置可以用于某些非常受限（例如不能创建新用户）的系统中。

6.8 KiB Raw Blame History