客户端安装与配置

下载 mieru 客户端

mieru 客户端软件支持 Windows，Mac OS 和 Linux 系统。用户可以在 GitHub Releases 页面下载。解压缩后请将 mieru 可执行文件放置于系统路径 PATH 中。

如果你的客户端操作系统是 Linux，也可以使用 debian 和 RPM 安装包安装 mieru。

修改客户端的设置

用户可以通过

mieru apply config <FILE>

指令来修改客户端的设置，这里的 <FILE> 是一个 JSON 格式的配置文件。客户端配置的一个示例如下。

{
    "profiles": [
        {
            "profileName": "default",
            "user": {
                "name": "ducaiguozei",
                "password": "xijinping"
            },
            "servers": [
                {
                    "ipAddress": "12.34.56.78",
                    "domainName": "",
                    "portBindings": [
                        {
                            "portRange": "2012-2022",
                            "protocol": "TCP"
                        },
                        {
                            "port": 2027,
                            "protocol": "TCP"
                        }
                    ]
                }
            ],
            "mtu": 1400,
            "multiplexing": {
                "level": "MULTIPLEXING_HIGH"
            }
        }
    ],
    "activeProfile": "default",
    "rpcPort": 8964,
    "socks5Port": 1080,
    "loggingLevel": "INFO",
    "socks5ListenLAN": false,
    "httpProxyPort": 8080,
    "httpProxyListenLAN": false
}

请用文本编辑器修改如下的内容：

在 profiles -> user -> name 属性中，填写用户名。此处必须与代理服务器中的设置相同。
在 profiles -> user -> password 属性中，填写密码。此处必须与代理服务器中的设置相同。
在 profiles -> servers -> ipAddress 属性中，填写代理服务器的公网地址。支持 IPv4 和 IPv6 地址。
如果你为代理服务器注册了域名，请在 profiles -> servers -> domainName 中填写域名。否则，请勿修改这个属性。
在 profiles -> servers -> portBindings -> port 中填写 mita 监听的 TCP 或 UDP 端口号。这个端口号必须与代理服务器中的设置相同。如果想要监听连续的端口号，也可以改为使用 portRange 属性。
请为 profiles -> mtu 属性中指定一个从 1280 到 1500 之间的值。默认值为 1400。这个值可以与代理服务器中的设置不同。
如果想要调整多路复用的频率，是更多地创建新连接，还是更多地重用旧连接，可以为 profiles -> multiplexing -> level 属性设定一个值。这里可以使用的值包括 MULTIPLEXING_OFF, MULTIPLEXING_LOW, MULTIPLEXING_MIDDLE, MULTIPLEXING_HIGH。其中 MULTIPLEXING_OFF 会关闭多路复用功能。默认值为 MULTIPLEXING_LOW。
请为 rpcPort 属性指定一个从 1025 到 65535 之间的数值。
请为 socks5Port 属性指定一个从 1025 到 65535 之间的数值。该端口不能与 rpcPort 相同。
如果客户端需要为局域网中的其他设备提供代理服务，请将 socks5ListenLAN 属性设置为 true。
如果要启动 HTTP / HTTPS 代理，请为 httpProxyPort 属性指定一个从 1025 到 65535 之间的数值。该端口不能与 rpcPort 和 socks5Port 相同。如果需要为局域网中的其他设备提供 HTTP / HTTPS 代理，请将 httpProxyListenLAN 属性设置为 true。如果不需要 HTTP / HTTPS 代理，请删除 httpProxyPort 和 httpProxyListenLAN 属性。

如果你安装了多台代理服务器，或者一台服务器监听多个端口，可以把它们都添加到客户端设置中。每次发起新的连接时，mieru 会随机选取其中的一台服务器和一个端口。如果使用了多台服务器，请确保每一台服务器都启动了 mita 代理服务。

假设这个配置文件的文件名是 client_config.json，在修改完成之后，调用指令 mieru apply config client_config.json 写入该配置。

如果配置有误，mieru 会打印出现的问题。请根据提示修改配置文件，重新运行 mieru apply config <FILE> 指令写入修正后的配置。

写入后，可以用

mieru describe config

指令查看当前设置。

启动客户端

mieru start

如果输出显示 mieru client is started, listening to 127.0.0.1:xxxx，表示 mieru 客户端已经开始运行。

mieru 客户端不会与系统一同启动。在重新启动计算机后，需要手动使用 mieru start 指令启动客户端。

Windows 用户请注意，在命令提示符或 Powershell 中使用 mieru start 指令启动客户端之后，请勿关闭命令提示符或 Powershell 窗口。关闭窗口将导致 mieru 客户端停止运行。一些新版本的 Windows 允许用户把命令提示符或 Powershell 最小化到托盘。

如果需要停止 mieru 客户端，请输入指令

mieru stop

注意，每次使用 mieru apply config <FILE> 修改设置后，需要用 mieru stop 和 mieru start 重启客户端，才能使新设置生效。

配置浏览器

Chrome / Firefox 等浏览器可以通过安装插件，使用 socks5 代理访问墙外的网站。关于 socks5 代理的地址，请填写 127.0.0.1:xxxx，其中 xxxx 是客户端设置中 socks5Port 的值。这个地址在调用 mieru start 指令时也会打印出来。

mieru 不使用 socks5 用户名和密码进行身份验证。

关于在 Tor 浏览器中配置 socks5 代理，参见翻墙安全指南。

如果需要通过代理转发所有应用程序的流量，或者自定义路由规则，请使用 clash 等代理平台，将 mieru 作为代理平台的后端。下面提供了 clash 配置的例子。

配置 clash

在下面的例子中，clash 监听 7890 端口。如果流量访问 LAN 或者目标地址在中国，则不使用代理。其他情况下使用 mieru 代理。

mixed-port: 7890

proxies:
  - name: mieru
    type: socks5
    server: 127.0.0.1
    port: 1080
    udp: true

dns:
  enable: true
  ipv6: true
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16
  nameserver:
    - https://1.1.1.1/dns-query
    - 8.8.8.8

rules:
  - DOMAIN-KEYWORD,google,mieru
  - DOMAIN-KEYWORD,gmail,mieru
  - DOMAIN-KEYWORD,youtube,mieru
  - IP-CIDR,127.0.0.0/8,DIRECT
  - IP-CIDR,172.16.0.0/12,DIRECT
  - IP-CIDR,192.168.0.0/16,DIRECT
  - GEOIP,CN,DIRECT
  - MATCH,mieru

6.5 KiB Raw Blame History Unescape Escape