Ansible Role: Adaptix C2 的启动和配置教程

1. 项目目录结构及介绍

Adaptix C2 是一个Ansible角色，用于在基于Debian的Linux主机上安装Adaptix框架的服务器和/或客户端以及所有扩展。项目的目录结构如下：

.
├── .gitignore
├── defaults
│   └── main.yml
├── docs
├── meta
│   └── main.yml
├── README.md
├── tasks
│   └── main.yml
├── templates
├── workflows
└── ludus_adaptix_c2.egg-info
    ├── PKG-INFO
    ├──薛定谔
    ├──拓扑
    └──依赖关系

• .gitignore: 用于指定Git应该忽略的文件和目录。
• defaults: 包含默认变量的YAML文件，这些变量将在角色执行时使用。
• docs: 存放项目文档的地方。
• meta: 包含角色的元数据，例如角色依赖。
• README.md: 项目的自述文件，提供了项目的基本信息和说明。
• tasks: 包含角色执行的任务列表，这些任务通常是Ansible的playbook中的步骤。
• templates: 存放模板文件的地方，这些模板通常用于生成配置文件或其他文件。
• workflows: 包含GitHub Actions的工作流文件，用于自动化角色相关的流程。

2. 项目的启动文件介绍

项目的启动主要是通过Ansible的playbook来执行的。以下是一个简单的playbook示例，用于安装Adaptix C2服务器：

- hosts: adaptix_server_host
  roles:
    - badsectorlabs.ludus_adaptix_c2
  vars:
    ludus_adaptix_c2_install_server: true

在这个playbook中，hosts 定义了将要执行任务的主机，roles 定义了将要应用的Ansible角色，而 vars 部分则定义了角色中使用的变量。在这个例子中，我们告诉角色我们想要安装服务器。

3. 项目的配置文件介绍

配置文件主要位于 defaults/main.yml 文件中，以下是该文件中的一些关键配置项：

ludus_adaptix_c2_version: 56ced68c12be98f5086a7f3c62ecb39924061fd0 # 0.4 2024-04-28
ludus_adaptix_c2_install_server: false # 设置为true以安装服务器
ludus_adaptix_c2_install_client: false # 设置为true以安装客户端
ludus_adaptix_c2_profile_url:
ludus_adaptix_c2_profile_raw:
ludus_adaptix_c2_server_args: # 可以在这里使用 -debug
ludus_adaptix_c2_go_version: 1.24.3
# 以下所有选项都是用于Adaptix GUI客户端连接到服务器，而不是c2代理
ludus_adaptix_c2_port: 4321
ludus_adaptix_c2_endpoint: /endpoint
ludus_adaptix_c2_password: pass
ludus_adaptix_c2_generate_certificate: true
ludus_adaptix_c2_common_name: localhost
ludus_adaptix_c2_organization_name: Adaptix C2
ludus_adaptix_c2_subject_alt_name_array: "DNS:localhost,DNS:127.0.0.1,DNS:::1"

这些配置项允许你自定义角色的行为，例如是否安装服务器或客户端、服务器的端口和密码、是否生成证书等。你可以在Ansible的playbook中通过 vars 部分覆盖这些默认值。