NET4MQTT (NET For MQTT)

MQTT 网络代理扩展

client <---> local <--[MQTT]--> agent <---> server

这个工具就像 Shadowsocks 或 V2Ray 一样，但网络是用 MQTT 来完成的

如果你熟悉 V2Ray 或者 Shadowsocks，这里有个对照表，可以很容理解这里面的功能：

NET4MQTT	V2Ray	Shadowsocks
agent	freedom	ss-server
local-port	dokodemo	ss-local::tunnel
local-socks	socks	ss-local::socks

MQTT Topic

<prefix>/<agent id>/<local id>/<label>/<protocol>/<src(addr:port)>/<dst(addr:port)>

network input/output

Publish topic example:

prefix/agent-0/local-0/i/udp/127.0.0.1:4444/127.0.0.1:4433
prefix/agent-0/local-0/o/udp/127.0.0.1:4444/127.0.0.1:4433
prefix/agent-0/local-0/o/udp/127.0.0.1:4444/-

Subscribe topic example:

TOPIC: <prefix>/< + | agent id>/< + | local id>/<label>/#

Sub topic example: prefix/+/local-0/i/#
Sub topic example: prefix/agent-0/+/o/#

WARNING

Only MQTT QoS: 0

online/offline status sync (Option)

prefix/agent-0/local-0/v/-

• Retain: true
• QoS: 1

Agent

If No set dst, use default target as dst

Local-Port

• tcp
• tcp over kcp
• udp

Local-Socks

• tcp
• tcp over kcp
• cluster internal domain, nslookup to agent-id

net4mqtt-cli

我们提供了一个独立的命令行工具，可以独立使用或是用来 Debug 产品环境

cargo build --bin=net4mqtt

Usage: net4mqtt [OPTIONS] <COMMAND>

Commands:
  local-socks  [mode::local], use socks5 proxy. Look like: [shadowsocks::local] or [v2ray::socks]
  local-port   [mode::local], port forwarding. Look like: [shadowsocks::tunnel] or [v2ray::dokodemo]
  agent        [mode::agent]. Look like: [shadowsocks::server] or [v2ray::freedom]
  help         Print this message or the help of the given subcommand(s)

Options:
  -v...          Verbose mode [default: "warn", -v "info", -vv "debug", -vvv "trace"]
  -h, --help     Print help
  -V, --version  Print version

1. Up a MQTT broker server

mosquitto

You can use a Monitor MQTT topic messages for debug

mosquitto_sub -L 'mqtt://localhost:1883/net4mqtt/#' -v

TCP Proxy

TCP/UDP simulation server test

2. up a TCP Server

nc -l 7777

3. up a net4mqtt agent

net4mqtt -vvv agent --id 0

4. up a net4mqtt local

net4mqtt -vvv local-port --agent-id 0 --id 0

5. up a TCP Client

nc 127.0.0.1 4444

For UDP

nc -l -u 7777
nc -u 127.0.0.1 4444

Integration

• live777 integration net4mqtt agent
• liveman integration net4mqtt local-socks

You can enable --feature=net4mqtt to use it.

cargo build --bin=live777 --features=net4mqtt
cargo build --bin=liveman --features=net4mqtt

Live777

注意

live777 会集成 net4mqtt agent

Enable in live777.toml

[net4mqtt]
mqtt_url = "mqtt://localhost:1883/net4mqtt"
alias = "liveion-0"

Liveman

注意

liveman 会集成 net4mqtt local-socks

Enable in liveman.toml

[net4mqtt]
mqtt_url = "mqtt://localhost:1883/net4mqtt"
alias = "liveman-0"
listen = "127.0.0.1:1077"
domain = "net4mqtt.local"