Docker + K3s

先来解释一下关系，在这种部署方法中，CdsCTF 及其中间件（Kubernetes 除外）都依赖于 Docker 运行，而 K8s 则仅是作为 CdsCTF 的题目动态环境提供者。

我们需要安装的是 DockerCE，这可不是 apt-get install docker 这么简单。

安装 DockerCE，你可以按照官方文档一步步做下去。

但如果你是国内用户，你可以在互联网上查找更多符合当前网络条件的教程。在此处推荐参考清华大学开源软件镜像站中的 DockerCE 安装方法。

如果你能顺利安装完 DockerCE，且是国内用户，那么请你不要忘记配置镜像源。

通常，Docker 针对源的配置文件通常存放于 /etc/docker/daemon.json，如果没有，那就创建一个，然后写出类似于下面的配置：

json

{
  "registry-mirrors": ["..."]
}

至于具体的镜像源链接，请参考互联网上的更多资料。

至此，你的 Docker 安装完毕。

但是这么多个中间件，如果依靠独立的 Docker 命令进行管理会显得冗杂，所以我们需要使用 Docker Compose。

可以先建立一个空目录，然后在里面新建一个文件 compose.yml，这里便记录了 CdsCTF 和其中间件的镜像及依赖关系。

NOTE

可观测性（Telemetry）设施（如 OpenTelemetry Collector）不随本 Compose 提供；如需可观测性，请参考可观测性自行部署 Collector 及后端。

yaml

services:
  server:
    image: docker.io/elabosak233/cdsctf:1.8.1
    ports:
      - "127.0.0.1:8888:8888"
    restart: always
    volumes:
      - "server:/app/data"
      - "./configs:/etc/cdsctf"
    depends_on:
      - db
      - queue
      - cache

  db:
    image: docker.io/library/postgres:18-alpine
    restart: always
    environment:
      POSTGRES_USER: cdsctf
      POSTGRES_PASSWORD: cdsctf
      POSTGRES_DB: cdsctf
    volumes:
      - "db:/var/lib/postgresql/18/docker"

  queue:
    image: docker.io/library/nats:2-alpine
    restart: always
    command:
      - "--js"
      - "--sd=/data"
    volumes:
      - "queue:/data"

  cache:
    image: docker.io/valkey/valkey:9-alpine
    restart: always
    volumes:
      - "cache:/data"

volumes:
  server:
  db:
  queue:
  cache:

如果你在短时间内无法理解这段 Compose，不妨寻求 LLM 的帮助。

此处未显式定义网络，Compose 会使用默认网络，各服务可通过服务名（如 db、queue、cache）互相访问。

然后我们需要在同一个目录下创建 configs 目录，这个目录将挂载到 CdsCTF 后端容器内（对应 /etc/cdsctf），用于存放 CdsCTF 的配置文件。

然后你需要新建一个 config.toml 在 configs 目录中，这里面定义了大部分需要的配置。

以及你还需要向目录中添加一个 k8s.yml，因为在这种方法部署的 CdsCTF 中，CdsCTF 需要连接到 K8s 控制平面的凭据，你可以这样获得：

bash

cat /etc/rancher/k3s/k3s.yaml

你可以将获得到的文本保存为 k8s.yml。

我们需要对 config.toml 中的一些地址定义做些可能的改变。

比如 db.host，需要写成 db，而非具体的 IP 地址。因为在 Docker Compose 中，服务可以直接使用服务名称（在这个案例中为 db）作为主机名来访问彼此。那么一次类推，针对缓存、消息队列的配置也是如此。

我们还需要对 k8s.yml 做出一些小小的改变，你最开始获得的 k8s.yml 长这样：

yaml

apiVersion: v1
clusters:
  - cluster:
      certificate-authority-data: ...
      server: https://127.0.0.1:6443
    name: default
# ...

CdsCTF 的 backend 运行在容器内，需要从容器内访问宿主机上的 K3s API，因此不能使用 127.0.0.1，而应使用该 Compose 默认网络在宿主机上的网关地址。

先用下面命令查看默认网络的网关 IP。Compose 的默认网络名一般为「当前目录名 + _default」，例如目录为 cdsctf 时网络名为 cdsctf_default：

bash

docker network inspect <网络名>

在输出 JSON 中，找到 IPAM → Config → Gateway，其值即为网关 IP（例如 172.18.0.1）。将 k8s.yml 里的 server 从 https://127.0.0.1:6443 改为 https://<网关IP>:6443，例如：

yaml

apiVersion: v1
clusters:
  - cluster:
      certificate-authority-data: ...
      server: https://172.18.0.1:6443
    name: default
# ...

此时如果你在目录下运行 docker compose up 启动这个 Compose，你若发现 server 的报错是无法连接 Cluster，我们需要为 K3s 重新配置一下证书，具体可参考 Q&A。

如果顺利启动了，你可以通过 http://127.0.0.1 进入 CdsCTF，但你会发现 K3s 携带的 Traefik 可能拦截了你的请求，给了你一个 404 page not found 的返回，此时我们需要对 Traefik 做一些处理，参考 Q&A。

此时运行 docker compose up -d，即可顺利启动 CdsCTF。

Docker + K3s ​

Docker + K3s