Cardinal 项目安装和配置指南
1. 项目基础介绍和主要编程语言
Cardinal 是一个由 Vidar-Team 开发的 AWD(Attack with Defense)线下赛平台,主要用于 CTF(Capture The Flag)比赛。该项目使用 Go 语言 编写,旨在为团队提供一个高效的 AWD 比赛环境。Cardinal 不仅适用于线下比赛,还可以用于团队内部的 AWD 模拟练习。
2. 项目使用的关键技术和框架
Cardinal 项目主要使用了以下关键技术和框架:
- Go 语言:作为项目的核心编程语言,Go 语言的高并发性能和简洁的语法使得 Cardinal 能够高效地处理比赛中的各种任务。
- 前后端分离:Cardinal 采用前后端分离的架构,前端部分开源可定制,后端使用 Go 语言编写。
- Docker:项目支持通过 Docker 进行部署,简化了安装和配置过程。
- WebHook:支持触发 WebHook,方便接入第三方应用。
3. 项目安装和配置的准备工作和详细安装步骤
准备工作
在开始安装之前,请确保您的系统满足以下要求:
- 操作系统:支持 Linux、macOS 和 Windows。
- Go 语言环境:确保已安装 Go 语言环境(建议版本 1.16 及以上)。
- Docker 和 Docker Compose:如果选择通过 Docker 部署,请确保已安装 Docker 和 Docker Compose。
安装步骤
方法一:通过 Release 安装
-
下载程序包: 访问 Cardinal 的 GitHub Release 页面,下载适用于您目标机器的架构程序包(例如
Cardinal_VERSION_OS_ARCH.tar.gz
)。 -
解压程序包:
tar -zxvf Cardinal_VERSION_OS_ARCH.tar.gz
-
赋予执行权限:
chmod +x ./Cardinal
-
运行程序:
./Cardinal
方法二:通过源码编译安装
-
克隆代码:
git clone https://github.com/vidar-team/Cardinal.git cd Cardinal
-
编译代码:
go build -o Cardinal
-
赋予执行权限:
chmod +x ./Cardinal
-
运行程序:
./Cardinal
方法三:通过 Docker 部署
-
安装 Docker 和 Docker Compose: 访问 Docker 官网 下载并安装 Docker 和 Docker Compose。
-
配置 Docker 环境: 确保当前用户拥有 Docker 及 Docker Compose 权限,然后执行以下命令:
curl https://sh.cardinal.ink | bash
-
配置
docker-compose.yml
: 初次使用时,请根据您的需求配置docker-compose.yml
文件中的各项参数。 -
启动 Docker 容器:
docker-compose up -d
开始使用
- 默认端口:19999
- 选手端:
http://localhost:19999/
- 后台管理:
http://localhost:19999/manager
通过以上步骤,您可以成功安装并配置 Cardinal 项目,开始使用它进行 AWD 比赛或团队内部的模拟练习。