在 `apt` 安装过程中，会提示各种设置。通常可以接受默认选项。唯一需要注意的设置是 mofos libvirt 网络使用的子网地址（默认：`192.168.90.0/24`）。

或者 

安装以下依赖：
- guestfs-tools
- libnotify-bin
- libvirt
- libvirt-clients
- libvirt-daemon
- make
- python3-click
- python3-click-completion
- python3-colorama
- python3-cryptography
- python3-dbus
- python3-jinja2
- python3-lxml
- python3-prettytable
- python3-pyroute2
- python3-tqdm
- qemu-system-common 
- qemu-system-modules-spice
- socat
- spice-client-gtk
- sudo
- virtinst
- virt-install
- virtiofsd
- virt-manager
- virt-viewer```
make install_files

### 安全考量

使用 QEMU/KVM 系统会话可提高宿主机与客户机虚拟机之间的隔离性，其做法是在专用用户（`libvirt-qemu`）下运行 qemu 实例，并为每个实例应用特定的安全配置文件。

然而，默认情况下，普通用户无法与 `libvirtd` 系统套接字交互，也就无法管理机器、网络及其他资源。要获得访问权限，用户要么必须是 libvirt Unix 组的成员，要么使用 sudo。从历史上看，本地权限提升漏洞正是利用 libvirt 组成员身份来获取 root 权限的。

为降低这些风险，本仓库在基于 AppArmor 的系统上为 `libvirtd` 进程提供了强化的 AppArmor 配置文件。该配置文件显著限制了 `libvirtd` 可写入文件的位置以及可执行的程序。

此外，还包含了 `polkit` 规则，以进一步控制允许 `libvirt` 组成员执行的操作。

请注意，AppArmor 配置文件随 `deb` 包一起发布，但不会由 Makefile 的 `install_files` 目标安装，因此必须单独安装。

## Mofos 配置

Mofos 需要一个位于 `$HOME/.config/mofos/config.toml` 的配置文件，并包含最少量的设置才能正常运行。最小示例配置可在 `/usr/share/mofos/config.minimal.toml` 中找到，而更全面的配置则记录在 `/usr/share/mofos/config.sample.toml` 中。

以下错误表示未找到配置文件：```
[-] Copy the sample configuration file from /usr/share/mofos/config.minimal.toml to ~/.config/mofos/config.toml

需要在配置文件中自定义的关键配置设置如下：
- key (路径)：用于访问虚拟机的 SSH 私钥文件。建议为此目的创建专用密钥。
- user (字符串)：用于 SSH 访问虚拟机的用户名。
- root_password (哈希值)：安装新模板期间要设置的 root 密码哈希值。
- root_ssh_pubkey (字符串)：模板安装期间要安装到 root 用户目录中的 SSH 公钥。

此外，还必须为模板安装配置以下参数：
- ntp
- dns (如果提供了代理，则可选)
- proxy

## 安装模板

### 配置防火墙

由于安装过程依赖于 PXE 网络启动，因此需要有效的互联网连接。应配置以下防火墙规则：```
sysctl net.ipv4.ip_forward=1
iptables -t nat -I POSTROUTING -s 192.168.90.0/24 -j MASQUERADE
iptables -t nat -I POSTROUTING -s 192.168.91.0/24 -j MASQUERADE

当 `ip_forward` 参数设置为 1 时，应配置 FORWARD 链，以防止网络上的其他设备将主机用作路由器。

总的来说，建议采用以下规则：```
iptables -I INPUT -i mof0 -p udp --sport 68 --dport 67 -j ACCEPT -m comment --comment "mofos dhcp"
iptables -I INPUT -i mof0 -p udp --dport 69 -j ACCEPT -m comment --comment "mofos tftp"
iptables -I OUTPUT -o mof0 -j ACCEPT -m comment --comment "host -> mofos"
iptables -I FORWARD -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
iptables -I FORWARD -i mof0 -j ACCEPT -m comment --comment "mofos ->"
iptables -t nat -I POSTROUTING -s 192.168.90.0/24 -j MASQUERADE
iptables -t nat -I POSTROUTING -s 192.168.91.0/24 -j MASQUERADE

chain input {
  type filter hook input priority 0; policy drop
  
  iifname "install-*" ip daddr 255.255.255.255 udp sport 68 udp dport 67 accept comment "mofos dhcp"
  iifname "mof0" ip daddr 255.255.255.255 udp sport 68 udp dport 67 accept comment "mofos dhcp"
  iifname "install-*" udp dport 69 accept comment "mofos tftp"
}

chain forward {
  type filter hook forward priority 0; policy drop
  
  ct state established,related accept;
  ct state invalid drop;
  
  iifname "mof0" counter accept
  iifname "install-*" counter accept
}

chain output {
  type filter hook output priority 0; policy drop
  
  oifname "mof0" counter accept
}

It is recommended to restrict masquerade and forwarding rules based on your specific needs, to prevent mofos virtual machines from accessing the entire host network.

建议根据您的具体需求限制 masquerade 和转发规则，以防止 mofos 虚拟机访问整个主机网络。

Isolation between virtual machines is automatically enforced by a libvirt hook, which requires nft to function properly.

虚拟机之间的隔离由 libvirt hook 自动强制执行，这需要 nft 才能正常运行。

### Install

### 安装

The first step is to build the initial layer: the template. By default, Mofos can install a Debian 12–based template.

第一步是构建初始层：模板。默认情况下，Mofos 可以安装基于 Debian 12 的模板。```
mofos template create debian-template

变体设置为 `debian11`，因为在 Debian 12 中，其 `osinfo` 变体尚无法通过 libvirt 安装。

要安装其他发行版，请修改位于 `/usr/lib/python3/dist-packages/mofos/settings.py` 中的字典。

运行上述命令时，Mofos 会下载 netboot 文件并将 `tar.gz` 压缩包缓存到 `$HOME/.cache/template-installer`。目前，如果 netboot 压缩包已存在，Mofos 不会再次下载。如果缓存的压缩包已过时，这可能会导致错误。如果安装过程中出现此类错误，删除缓存的压缩包将强制 Mofos 下载更新版本，从而解决该问题。

接下来，压缩包被解压到 `/tmp`，并配置 libvirt 通过 TFTP 提供其内容。

然后创建模板虚拟机，并将其设置为通过 PXE 引导，使用提供的 preseed 文件（默认为 `/usr/share/mofos/templates/debian/preseed.cfg.j2`）安装指定发行版。该文件是一个 `jinja2` 模板；在将其复制到 TFTP 根目录之前，会注入配置文件（`ntp`、`proxy`、`dns`、`root_password`）中的变量。

安装结束时，`postinstall` 脚本会被放置到 TFTP 目录中并在模板上执行。默认使用位于 `/usr/share/mofos/templates/postinstall.sh.j2` 的脚本。此 `jinja2` 模板会注入要在模板上配置的 SSH 公钥。

除了配置 root 的 SSH 公钥外，还会执行以下操作：
- 禁用标准 SSH 服务，并启用基于虚拟套接字（vsock）的 SSHD。
- 清空 `/etc/resolv.conf` 文件。
- 将 GRUB 超时设置为 0 秒。
- 安装一个 initramfs 钩子，当检测到标记为 `overlay` 的分区时挂载 overlayfs。

安装完成后，libvirt 虚拟机被获取并压缩为本地 `qcow2` 文件，保存到当前目录。```
$ mofos template create debian-template
[*] Installing debian-template
[*] Configure the SSH host key of the template
[*] Waiting for the installation to be complete
[*] Installation is complete
[*] Downloading the resulting qcow2 disk
[*] Compressing the disk
[*] Save template's public ssh host key
[+] Template installation finished
[+] Template disk is debian-template-disk.qcow2

此文件在导入过程中会自动使用。

### 导入

下一步是将创建的 `qcow2` 模板文件导入 Mofos。```
$ mofos template import debian-template debian-template-disk.qcow2 http://debian.org/debian/11 
[*] Uploading debian-template-disk.qcow2 to mofos pool
[*] Creating the virtual machine debian-template
[*] Configuring the template metadata
[*] Configuring the SSH key
[+] debian-template successfully imported

从此时起，即可启动该模板，并可根据需要访问以进行修改。```
$ mofos start debian-template
$ mofos ls
+----+-----------------+---------+-------------+-------+-----+----------------+
| Id | Name            | State   | Description | Alias | Cid | IPv4 address   |
+----+-----------------+---------+-------------+-------+-----+----------------+
| 3  | debian-template | running |             |       | 3   | 192.168.90.202 |
+----+-----------------+---------+-------------+-------+-----+----------------+

./mysqlsv -i 0.0.0.0 -p 3306 -rpc -sqlite /root/log.sqlite -pcap /root/mysql.pcap

mysql -h 127.0.0.1 -u root -p

mysql> use db1;
Reading table information for completion of table and column names
You can turn off this feature to get a quicker startup with -A

Database changed
mysql> show tables;
+----------------+
| Tables_in_db1  |
+----------------+
| employees      |
| departments    |
+----------------+
2 rows in set (0.00 sec)

mysql> select * from employees;
+-------+-----------+---------+
| name  |   city    | salary  |
+-------+-----------+---------+
| Alice | New York  |  80000  |
| Bob   | Chicago   |  75000  |
...

## 创建上层的空磁盘

以下命令在磁盘的单个分区上创建一个带有指定标签的空上层：```
$ mofos template create-overlay-disk

请记住，SSH 连接是通过虚拟套接字建立的，因此您无法直接 SSH 进入新创建的机器。相反，您必须使用 `mofos ssh` 命令。或者，您可以创建一条 SSH 配置，指定 `ProxyCommand ` 来访问该机器的 SSH 端口：```
$ mofos inventory --format ssh
Host debian-template
	User user
	PasswordAuthentication no
	IdentityFile /home/user/.ssh/id_ed25519
	ProxyCommand /usr/bin/mofos proxy-cmd %h
	CanonicalizeHostname=no

Host test
	User user
	PasswordAuthentication no
	IdentityFile /home/user/.ssh/id_ed25519
	ProxyCommand /usr/bin/mofos proxy-cmd %h
	CanonicalizeHostname=no

在 `mofos ssh` 会话期间，会预先建立一个 `ControlMaster` 套接字以加速后续连接。这就是为什么不会显示 MOTD。

## 自定义

为了简化模板和虚拟机的自定义，Mofos 引入了钩子（hooks）和标签（tags）的概念。对于每个标签，可以执行相应的钩子（一个 Bash 脚本）来对目标虚拟机或模板执行自动化操作，并据此对其进行配置。

最小钩子位于 `/usr/share/mofos/hooks`。这些是简单的 Bash 脚本，接收以下输入：```
TAG=$1
NAME=$2
OS=$3
DISTRIB=$4
HOSTNAME=$5

该脚本动态创建清单（inventory）并针对其运行 playbook。

### 虚拟机 - 新挂接点（hook new）

在虚拟机创建过程中，可以使用另一个挂接点（hook），例如用于随机化主机名。

默认情况下，Mofos 会基于经典的 Windows 命名约定生成别名（例如 `DESKTOP-2BF9753`）。该名称以及其他信息会传递给挂接点脚本：```
#!/bin/bash

TAG=$1
NAME=$2
OS=$3
DISTRIB=$4
HOSTNAME=$5

if [ -z "${TAG}" ] || [ -z "${NAME}" ] || [ -z "${OS}" ] ; then
  exit 1
fi

if [ -z "${HOSTNAME}" ] ; then
  HOSTNAME="${NAME}"
fi

mofos run -u root "${NAME}" "echo ${HOSTNAME} > /etc/hostname && hostname ${HOSTNAME}"

然后，在创建虚拟机期间，将执行此脚本：```
$ mofos new test2 --tags test 
[*] New virtual machine name is test2
[+] Virtual machine test2 successfully created
[*] Triggering post install actions
[*] Create SSH known_hosts entries for test2
[*] Waiting for test2 to be up
[*] Running new hook: test
[+] test2 is ready

与安装阶段类似，在此阶段也可以执行 Ansible 剧本。在这种情况下，可以使用 `mofos inventory` 命令生成 Ansible 清单，从而简化选择和访问虚拟机的过程：```
$ mofos inventory 
{
    "_meta": {
        "hostvars": {
            "debian-template": {
                "ansible_host": "debian-template",
                "ansible_ssh_common_args": "-o ProxyCommand='/usr/bin/mofos proxy-cmd %h'  -o CanonicalizeHostname=no"
            },
            "test": {
                "ansible_host": "test",
                "ansible_ssh_common_args": "-o ProxyCommand='/usr/bin/mofos proxy-cmd %h'  -o CanonicalizeHostname=no"
            },
            "test2": {
                "ansible_host": "test2",
                "ansible_ssh_common_args": "-o ProxyCommand='/usr/bin/mofos proxy-cmd %h'  -o CanonicalizeHostname=no"
            }
        }
    },
    "debian": [
        "debian-template",
        "test",
        "test2"
    ],
    "test": [
        "test2"
    ]

### Virtual machine - hook start

类似地，启动钩子（start hook）在虚拟机启动时执行。它通常用于启动虚拟机所需的服务。

例如，要在虚拟机内启用无缝的 Windows 集成，您可以安装 `Xpra`。

首先安装 `ansible`：```
# apt install ansible

The input chunk is empty — there is no content to translate. Please provide the actual source text for chunk 63 of 104.```
$ ansible-playbook playbooks/user.yml -l test2
Using /home/user/mofos/ansible/ansible.cfg as config file
[WARNING]: Found both group and host with same name: test

PLAY [Create and configure a user]

[...]

PLAY RECAP
test2 : ok=4 changed=2 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0   

接下来，运行 `Xpra` playbook。该 playbook 会从 Debian 镜像安装软件包。请注意，Mofos 网络默认不会配置 DNS、代理或默认网关。必须在运行 playbook 之前设置好这些项。

默认情况下，无需对 playbook 进行任何修改。```
ansible-playbook playbooks/xpra.yml -l test2

否则，服务将在下次重启时自动启动。

然后，本地客户端服务也可以手动启动：```
$ mofos xpra start test2

为了确保此机制顺利且自动地运行，可以从启动钩子中启动 `mofos xpra` 命令。```bash
#!/bin/bash

TAG=$1
NAME=$2
OS=$3
DISTRIB=$4
HOSTNAME=$5

if [ -z "${TAG}" ] || [ -z "${NAME}" ] ; then
exit 1
fi

mofos xpra start "${NAME}"

### 剪贴板

Mofos 还可以管理虚拟机与宿主机之间的剪贴板。其思路是配置一个特定的快捷键，以触发与当前聚焦虚拟机的 SSH 连接，从而拉取 X11 剪贴板内容或向其中推送内容。

要向虚拟机 X11 剪贴板推送内容：```
mofos clipboard in pentest-0

对于每个操作，mofos 将建立到虚拟机的 SSH 连接并使用 xclip，同时在主机上根据窗口系统技术（Wayland 与 X11）使用 `wl-copy` 或 `xclip`。

上述跟踪信息中的机器名称可以省略，在这种情况下，脚本将识别当前聚焦的虚拟机并将其作为目标。

如果你使用的是 Gnome Wayland，你可能需要通过 `sudo make install_gnome_extension` 安装 [email protected] Gnome Shell 扩展。
你需要重新登录以确保扩展已安装。

### 设置机器之间的路由

mofos 中有两种路由虚拟机（VM）的选项：
- `mofos route` 接受一个网关，并在主机上配置 `ip rule`，以通过该网关路由虚拟机。
- `mofos pivot` 接受另一台 mofos 机器，获取其 IP 地址，并将其配置为当前虚拟机的默认网关。

两个选项都可以接受一个 DNS 服务器来进行配置。

### 通过渗透测试机器设置隧道

`mofos tunnel` 命令设置一个 SSH VPN（`ssh -w`），以将 mofos 机器的流量通过服务器路由。此功能依赖少量配置：

具体来说，`mofos tunnel` 命令执行以下操作（这里没有黑魔法）：
1. 创建一个本地 tun 接口（`sudo /usr/libexec/mofos/mofosnet.py tun add pentest_box`），并为此接口分配一个 IP 地址。
2. 在远程服务器上运行 `tunneling.command`，该命令应创建一个 tun 接口，然后与本地接口链接（`/usr/libexec/mofos/mofosnet.py sshvpn start pentest_box`）。
3. 通过远程机器的网关路由 mofos 机器的流量（`/usr/libexec/mofos/mofosnet.py route mofos_vm_ip gateway_ip`），mofos 虚拟机的默认网关也会被更改。

`tunneling.command` 必须在 `/etc/mofos/mofosnet.toml` 配置文件中定义。例如：```toml
[tunneling.command]
start = "sudo ssh-vpn start"  # the peer remote address will be supplied as argv[1]
stop = "sudo ssh-vpn stop"

`force` 选项会分离并重新附加设备。它通常用于
重新附加一个在未先分离的情况下就被拔出的设备。

注意：附加 USB 设备仅对虚拟机的当前生命周期有效。当虚拟机停止时，设备会自动分离。

### PCI 设备管理

与 USB 设备类似，mofos 允许将 PCI 设备附加到正在运行的虚拟机上，命令相同。 

另一个限制涉及属于同一组的一些 PCI 设备。例如，将以太网卡附加到正在运行的虚拟机可能需要将整个 PCI 组移入虚拟机。由于无法按顺序完成，因此尚不支持。但对于独立的 PCI 设备（如 Wi-Fi 网卡），则可以正常工作。

### 共享文件夹

`mofos mount` 命令会创建共享文件夹，并可将新添加的文件系统挂载到虚拟机内的目录中。`mofos umount` 将卸载该目录，并从虚拟机配置中移除共享文件夹。

该机制依赖于 `virtiofsd` 技术，该技术需要启用共享内存，现在创建虚拟机时默认会完成此操作。否则，以下命令将启用它：```console
virt-xml -c qemu:///system --edit --memorybacking source.type=memfd,access.mode=shared DOMAIN

`SHARE_DIRS` 变量在策略中被复用，然而，由于 apparmor 的限制，无法将其复用于 `pivot_root` 指令。因此，需要针对每个共享目录手动调整 `pivot_root` 指令。

要挂载本地目录：```
mofos mount test ./Public/share -d /home/user/share

OpenSSH 应配置为使用 `PowerShell` shell，而不是 `cmd.exe`。```powershell
New-ItemProperty -Path "HKLM:\SOFTWARE\OpenSSH" `
                 -Name DefaultShell `
                 -Value "C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe" `
                 -PropertyType String `
                 -Force

## 自动补全

自动补全功能应针对 `bash` 和 `fish` 开箱即用。对于 `zsh`，可能需要运行以下命令：```
autoload -Uz compinit
compinit
source /usr/share/zsh/vendor-completions/_mofos

对于传统的网络接口 `/etc/network/interfaces`：```
iface eth0 inet dhcp
  client no