如果您不想在系统上安装Python，可以使用以下便携版本之一：

- https://www.anaconda.com/distribution/#download-section（适用于Windows、Linux和macOS）
- https://github.com/winpython/winpython/releases/tag/2.1.20190928（仅适用于Windows）

## 当前模块

覆盖模块：

- `io`：从标准输入读取，通过SOTP连接发送。从SOTP连接读取，输出到标准输出。
- `shell`：执行通过SOTP连接接收的命令并返回输出。与io模块兼容。
- `tcpconnect`：连接到TCP端口。从套接字读取，通过SOTP连接发送。从SOTP连接读取，通过套接字发送。
- `tcplisten`：绑定到TCP端口。从套接字读取，通过SOTP连接发送。从SOTP连接读取，通过套接字发送。

包装模块：

- `dns`：使用不同方法在DNS查询/响应中对数据进行编码/解码。
- `http`：使用不同方法在HTTP或HTTPS请求/响应中对数据进行编码/解码。
- `icmp`：在ICMP回显请求/响应的数据部分对数据进行编码/解码。

## 使用方法

`ms.py`：Mística 服务器

以下是帮助信息的显示效果：```txt
usage: ms.py [-h] [-k KEY] [-l LIST] [-m MODULES] [-w WRAPPER_ARGS]
             [-o OVERLAY_ARGS] [-s WRAP_SERVER_ARGS]

Mistica server. Anything is a tunnel if you're brave enough. Run without
parameters to launch multi-handler mode.

optional arguments:
  -h, --help            show this help message and exit
  -k KEY, --key KEY     RC4 key used to encrypt the comunications
  -l LIST, --list LIST  Lists modules or parameters. Options are: all,
                        overlays, wrappers, <overlay name>, <wrapper name>
  -m MODULES, --modules MODULES
                        Module pair in single-handler mode. format:
                        'overlay:wrapper'
  -w WRAPPER_ARGS, --wrapper-args WRAPPER_ARGS
                        args for the selected overlay module (Single-handler
                        mode)
  -o OVERLAY_ARGS, --overlay-args OVERLAY_ARGS
                        args for the selected wrapper module (Single-handler
                        mode)
  -s WRAP_SERVER_ARGS, --wrap-server-args WRAP_SERVER_ARGS
                        args for the selected wrap server (Single-handler
                        mode)
  -v, --verbose         Level of verbosity in logger (no -v None, -v Low, -vv
                        Medium, -vvv High)

### 参数

- `-l, --list` 用于列出 `all` 模块，或仅列出一种类型：（`overlays` 或 `wrappers`），或列出某个模块可通过 `-o`、`-w` 或 `-s` 接受的参数。
- `-k, --key` 用于指定加密覆盖通信的密钥。客户端和服务器端必须相同，目前是强制性的。如果未来实现秘密共享方案，这可能会改变。
- `-m, --modules` 用于指定要使用的模块对。必须使用以下格式：**overlay_module** + **:** + **wrap_module**。该参数也是强制性的。
- `-w, --wrapper-args` 允许为封装模块指定特定配置。
- `-o, --overlay-args` 允许为覆盖模块指定特定配置。
- `-s, --wrap-server-args` 仅出现在 `ms.py` 上。它允许为封装服务器指定特定配置。每个封装模块依赖于一个封装服务器，两者的配置均可调整。

## 示例与高级用法

> 记住，你可以通过输入 `-l <module_name>`（例如 `./ms.py -l dns`）查看模块的所有可接受参数。也要记住使用长且复杂的密钥来保护你的通信！

### HTTP

为了说明 HTTP 封装的不同方法，每个示例都将使用 IO 重定向覆盖模块（`io`）。

- 使用默认 URI 的 HTTP GET 方法，b64 编码，使用 localhost 和 8080 端口（默认值）。
  - Mística 服务器端：`./ms.py -m io:http -k "rc4testkey"`
  - Mística 客户端：`./mc.py -m io:http -k "rc4testkey"`
- 使用默认 URI 的 HTTP GET 方法，b64 编码，**指定 IP 地址和端口**。
  - Mística 服务器端：`./ms.py -m io:http -k "rc4testkey" -s "--hostname x.x.x.x --port 10000"`
  - Mística 客户端：`./mc.py -m io:http -k "rc4testkey" -w "--hostname x.x.x.x --port 10000"`
- 使用 **自定义 URI** 的 HTTP GET 方法，b64 编码，使用 localhost 和 8080 端口（默认值）。
  - Mística 服务器端：`./ms.py -m io:http -k "rc4testkey" -w "--uri /?token="`
  - Mística 客户端：`./mc.py -m io:http -k "rc4testkey" -w "--uri /?token="`
- 使用 **自定义头部** 的 HTTP GET 方法，b64 编码，使用 localhost 和 8080 端口（默认值）。
  - Mística 服务器端：`./ms.py -m io:http -k "rc4testkey" -w "--header laravel_session"`
  - Mística 客户端：`./mc.py -m io:http -k "rc4testkey" -w "--header laravel_session"`
- 使用默认字段的 HTTP **POST** 方法，b64 编码，使用 localhost 和 8080 端口（默认值）。
  - Mística 服务器端：`./ms.py -m io:http -k "rc4testkey" -w "--method POST"`
  - Mística 客户端：`./mc.py -m io:http -k "rc4testkey" -w "--method POST"`
- 使用 **自定义头部** 的 HTTP **POST** 方法，b64 编码，使用 localhost 和 8080 端口（默认值）。
  - Mística 服务器端：`./ms.py -m io:http -k "rc4testkey" -w "--method POST --header Authorization"`
  - Mística 客户端：`./mc.py -m io:http -k "rc4testkey" -w "--method POST --header Authorization"`
- 使用 **自定义字段** 的 HTTP **POST** 方法，b64 编码，使用 localhost 和 8080 端口（默认值）。
  - Mística 服务器端：`./ms.py -m io:http -k "rc4testkey" -w "--method POST --post-field data"`
  - Mística 客户端：`./mc.py -m io:http -k "rc4testkey" -w "--method POST --post-field data"`
- 使用 **自定义字段、自定义数据包大小、自定义重试次数、自定义超时时间，并指定 IP 和端口** 的 HTTP **POST** 方法，b64 编码：
  - Mística 服务器端：`./ms.py -m io:http -k "rc4testkey" -w "--method POST --post-field data --max-size 30000 --max-retries 10" -s "--hostname 0.0.0.0 --port 8088 --timeout 30"`
  - Mística 客户端：`./mc.py -m io:http -k "rc4testkey" -w "--method POST --post-field data --max-size 30000 --max-retries 10 --poll-delay 10 --response-timeout 30 --hostname x.x.x.x --port 8088"`
- 使用 **自定义字段** 的 HTTP **POST** 方法，b64 编码，**使用自定义错误模板**，使用 localhost 和 8080 端口（默认值）。
  - Mística 服务器端：`./ms.py -m io:http -k "rc4testkey" -w "--method POST --post-field data" -s "--error-file /tmp/custom_error_template.html --error-code 408"`
  - Mística 客户端：`./mc.py -m io:http -k "rc4testkey" -w "--method POST --post-field data"`
- 使用默认 URI 的 HTTP GET 方法，b64 编码，使用 **自定义 HTTP 响应码**，使用 localhost 和 8080 端口（默认值）：
  - Mística 服务器端：`./ms.py -m io:http -k "rc4testkey" -w "--success-code 302"`
  - Mística 客户端：`./mc.py -m io:http -k "rc4testkey" -w "--success-code 302"`
- 使用默认 URI 的 HTTPS GET 方法，b64 编码，使用 443 端口。必须在 Mística 服务器端生成证书才能使用 ssl 选项，Mística 客户端只需接收 ssl 标志：
  - Mística 服务器端：
      - `openssl req -new -x509 -keyout server.pem -out server.pem -days 365 -nodes`
      - `sudo ./ms.py -m io:http -k "rc4testkey" -s "--port 443 --ssl --ssl-cert server.pem"`
  - Mística 客户端：`./mc.py -m io:http -k "rc4testkey" -w "--ssl --port 443"`
- 使用默认 URI 的 HTTP GET 方法，b64 编码，在 Mística 客户端中使用代理服务器（可用于 HTTP 通信必须经过公司代理的环境，而计算机配置中未指定代理）。使用 Burpsuite 测试以下示例：
  - Mística 服务器端：`./ms.py -m io:http -k "rc4testkey" -s "--port 8000 --timeout 30"`
  - Mística 客户端：`./mc.py -m io:http -k "rc4testkey" -w "--proxy 127.0.0.1:8080 --port 8000 --poll-delay 30 --response-timeout 30"`

### DNS

为了说明 DNS 封装的不同方法，每个示例都将使用 IO 重定向覆盖模块（`io`）。

- TXT 查询，使用 localhost 和 5353 端口（默认值）：
  - Mística 服务器端：`./ms.py -m io:dns -k "rc4testkey"`
  - Mística 客户端：`./mc.py -m io:dns -k "rc4testkey"`
- NS 查询，使用 localhost 和 5353 端口（默认值）：
  - Mística 服务器端：`./ms.py -m io:dns -k "rc4testkey" -w "--queries NS"`
  - Mística 客户端：`./mc.py -m io:dns -k "rc4testkey" -w "--query NS"`
- CNAME 查询，使用 localhost 和 5353 端口（默认值）：
  - Mística 服务器端：`./ms.py -m io:dns -k "rc4testkey" -w "--queries CNAME"`
  - Mística 客户端：`./mc.py -m io:dns -k "rc4testkey" -w "--query CNAME"`
- MX 查询，使用 localhost 和 5353 端口（默认值）：
  - Mística 服务器端：`./ms.py -m io:dns -k "rc4testkey" -w "--queries MX"`
  - Mística 客户端：`./mc.py -m io:dns -k "rc4testkey" -w "--query MX"`
- SOA 查询，使用 localhost 和 5353 端口（默认值）：
  - Mística 服务器端：`./ms.py -m io:dns -k "rc4testkey" -w "--queries SOA"`
  - Mística 客户端：`./mc.py -m io:dns -k "rc4testkey" -w "--query SOA"`
- TXT 查询，使用 localhost 和 5353 端口（默认值）以及 **自定义域名**：
  - Mística 服务器端：`./ms.py -m io:dns -k "rc4testkey" -w "--domains mistica.dev sotp.es"`
  - Mística 客户端：  
      - `./mc.py -m io:dns -k "rc4testkey" -w "--domain sotp.es"`
      - `./mc.py -m io:dns -k "rc4testkey" -w "--domain mistica.dev"`
- TXT 查询，指定端口和主机名：
  - Mística 服务器端：`./ms.py -m io:dns -k "rc4testkey" -s "--hostname 0.0.0.0 --port 1337"`
  - Mística 客户端：`./mc.py -m io:dns -k "rc4testkey" -w "--hostname x.x.x.x --port 1337"`
- TXT 查询，使用多个子域名：
  - Mística 服务器端：`./ms.py -m io:dns -k "rc4testkey"`
  - Mística 客户端：`./mc.py -m io:dns -k "rc4testkey" -w "--multiple --max-size 169"`

### ICMP

Linux 内核在接收到 ICMP 回显请求数据包时，默认会自动响应一个 ICMP 回显应答数据包（不给我们任何回复选项）。因此，我们必须禁用 ICMP 响应，以便能够发送包含与客户端发送数据不同的自定义数据包。为此，请执行以下操作：

通过编辑 `/etc/sysctl.conf` 文件禁用内核的自动 ICMP 响应（需要 *root 权限*）：

- 将以下行添加到你的 /etc/sysctl.conf 文件中：```
net.ipv4.icmp_echo_ignore_all=1

* 其次，使用以下命令创建网络：```
sudo docker network create misticanw

* 第四次运行客户端：```
sudo docker run --network misticanw -v $(pwd):/opt/Mistica -it mistica /bin/bash

* 现在，使用以下命令编译 Mística Client：```
pyinstaller --onefile \
  --hiddenimport overlay.client.io \
  --hiddenimport overlay.client.shell \
  --hiddenimport overlay.client.tcpconnect \
  --hiddenimport overlay.client.tcplisten \
  --hiddenimport wrapper.client.http \
  --hiddenimport wrapper.client.dns \
  --hiddenimport wrapper.client.icmp \
  --hiddenimport overlay.server.io \
  --hiddenimport overlay.server.shell \
  --hiddenimport overlay.server.tcpconnect \
  --hiddenimport overlay.server.tcplisten \
  --hiddenimport wrapper.server.wrap_module.http \
  --hiddenimport wrapper.server.wrap_module.dns \
  --hiddenimport wrapper.server.wrap_module.icmp \
  --hiddenimport wrapper.server.wrap_server.httpserver \
  --hiddenimport wrapper.server.wrap_server.dnsserver \
  --hiddenimport wrapper.server.wrap_server.icmpserver \
  mc.py

## 未来工作

- 交叉编译方法，以便能够为目标操作系统之外的多个操作系统编译Mistica。
- 用于SOTP协议的透明Diffie-Hellman密钥生成
- 多处理程序模式：`ms.py`的交互模式。这将允许用户在一个包装服务器上组合多个覆盖层、多个包装器和多个包装模块。
- 自定义模块开发的模块开发文档。目前不建议这样做，因为模块规范仍在开发中。
- 下一个模块：
    - SMB包装器
    - RAT和RAT处理程序覆盖层
    - SOCKS代理和动态端口转发覆盖层
    - 文件传输覆盖层
    - RDP包装器
- 用于更复杂封装的自定义HTTP模板
- 自定义客户端或服务器的SOTP协议规范文档。目前不建议这样做，因为该协议仍在开发中。

## 作者与许可证

本项目由Carlos Fernández Sánchez和Raúl Caro Teixidó开发。代码基于GNU通用公共许可证v3发布。

本项目使用了第三方开源代码，特别是：

- [Bitstring](https://github.com/scott-griffiths/bitstring)由Scott Griffiths开发。
- [一个二进制安全的RC4实现](https://github.com/DavidBuchanan314/rc4)由David Buchanan开发。
- [一个无依赖的DNS客户端](https://github.com/vlasebian/simple-dns-client)由Vlad Vitan开发。
- [一个无依赖的ICMP服务器和客户端](https://github.com/rcaroncd/ICMPack/)由Raul Caro开发。