【Docker系列】如何在 Docker 环境中部署和运行 One API

在开始今天的分享之前，我想先推荐一篇非常精彩的文章。

文章就是《渗透测试文件包含漏洞原理与验证(1)——文件包含概述》🚀🌟🚀🌟🚀🌟

链接是：点击这里。

这篇文章详细解释了文件包含漏洞的原理，以及如何在实际的Web应用程序中发现和验证这类漏洞。它提到，文件包含漏洞通常发生在PHP等脚本语言中，当开发者在引入文件时没有对文件名进行充分的校验，就可能导致意外的文件泄露或恶意代码注入。

文章还介绍了几种PHP中的文件包含函数，包括include()、include_once()、require()和require_once()，以及它们在找不到文件时的不同行为。此外，文章还探讨了利用文件包含漏洞的条件，比如函数通过动态变量引入文件，以及用户能够控制这个动态变量。

通过一些实际的示例，文章展示了如何通过修改文件扩展名来绕过某些安全限制，以及如何通过修改URL参数来实现文件包含攻击。

这篇文章不仅提供了丰富的技术细节，还强调了合法合规的重要性。它提醒我们，所有的渗透测试活动都应该在获得明确授权的情况下进行，并且要遵守相关法律法规。

如果你对Web安全感兴趣，或者想要提高你的Web应用程序的安全性，我强烈推荐你阅读这篇文章。它不仅能够提供实用的技术知识，还能帮助你更好地理解安全领域的法律和道德规范。让我们一起在合法合规的前提下，探索和提升Web安全吧！

随着技术的发展，API 作为服务连接的桥梁，变得越来越重要。One API 是一种流行的 API 管理平台，能够帮助我们更好地管理、监控和扩展 API 服务。

一、前置知识

在进入具体操作之前，我们需要了解一些背景知识：

1. Docker：Docker 是一个开源的容器化平台，它允许开发者将应用程序及其依赖项打包到一个轻量级的容器中，从而使应用程序可以在任何地方一致地运行。
2. Docker Compose：Docker Compose 是一个用于定义和运行多容器 Docker 应用的工具。通过 Docker Compose 文件（通常命名为 docker-compose.yml），可以在一个文件中定义多个服务，并通过一条命令启动这些服务。
3. One API：One API 是一个 API 网关平台，它能够帮助开发人员更轻松地管理 API 请求，提供统一的 API 接口、请求路由以及安全管理。

二、使用 Docker Compose 部署 One API

在 Docker Compose 中，我们可以定义 One API 服务和其相关的配置。以下是一个典型的 docker-compose.yml 配置：

one-api:
  container_name: one-api
  image: one-api:latest
  restart: always
  command: --log-dir /app/logs
  ports:
    - "3000:3000"
  volumes:
    - ./volumes/one-api/data:/data
    - ./volumes/one-api/logs:/app/logs
    - ./volumes/data-gym-cache:/tmp/data-gym-cache
  environment:
    - SQL_DSN=root:test2024@tcp(111.18.9.111:3306)/oneapi
    - SESSION_SECRET=random_string
    - TZ=Asia/Shanghai
  depends_on:
    mysql:
      condition: service_healthy
  healthcheck:
    test:
      [
        "CMD-SHELL",
        "wget -q -O - http://localhost:3000/api/status | grep -o '\"success\":\\s*true' | awk -F: '{print $2}'",
      ]
    interval: 30s
    timeout: 10s
    retries: 3

以上 docker-compose.yml 文件定义了一个名为 one-api 的服务，并设置了其依赖、端口、环境变量等配置项。下面我们详细解析该配置文件的各部分内容。

1. container_name: 设置容器名称为 one-api，方便通过名字快速识别和管理容器。
2. image: 指定了容器使用的镜像 one-api:latest，即 One API 的最新版本。
3. restart: 设置为 always，意味着无论容器退出的原因是什么，Docker 都会自动重启容器，以确保服务的持续可用性。
4. command: 通过命令 --log-dir /app/logs，将日志目录指定为 /app/logs。
5. ports: 将主机的 3000 端口映射到容器的 3000 端口，这样我们可以通过 http://localhost:3000 访问 One API 服务。
6. volumes: 定义了多个数据卷，以便持久化存储数据和日志：

• ./volumes/one-api/data:/data：将本地 ./volumes/one-api/data 目录挂载到容器中的 /data 目录，用于存储持久化数据。
• ./volumes/one-api/logs:/app/logs：将日志文件挂载到本地 ./volumes/one-api/logs，便于日志管理和分析。
• ./volumes/data-gym-cache:/tmp/data-gym-cache：将缓存数据存放在 ./volumes/data-gym-cache。

1. environment: 定义了几个环境变量：

• SQL_DSN：用于连接数据库的 DSN 配置，格式为 user:password@tcp(host:port)/dbname。
• SESSION_SECRET：设置会话密钥，用于加密和验证会话。
• TZ：时区设置为 Asia/Shanghai，确保日志时间等信息符合本地时区。

1. depends_on: 该配置用于声明服务之间的依赖关系。例如，One API 依赖于 MySQL 数据库，depends_on 配置确保 MySQL 数据库在 One API 启动前处于健康状态。
2. healthcheck: 定义了健康检查的命令和时间间隔：
   • test：健康检查的命令，使用 wget 请求 One API 的状态接口，检测返回结果中是否包含 "success": true。
   • interval、timeout 和 retries 分别设置健康检查的间隔、超时和重试次数。

启动服务

运行以下命令启动服务：

docker-compose up -d

该命令会在后台启动服务，并自动根据 docker-compose.yml 文件中的配置，完成 One API 容器的初始化和启动。

在这里插入图片描述

三、使用 Docker Run 命令直接运行 One API 容器

如果不想使用 Docker Compose，我们还可以使用 docker run 命令来直接启动 One API 容器：

docker run -d \
  --name one-api \
  --restart always \
  -p 3000:3000 \
  -v $(pwd)/volumes/one-api/data:/data \
  -v $(pwd)/volumes/one-api/logs:/app/logs \
  -v $(pwd)/volumes/data-gym-cache:/tmp/data-gym-cache \
  -e SQL_DSN=root:test2024@tcp(111.18.9.111:3306)/oneapi \
  -e SESSION_SECRET=random_string \
  -e TZ=Asia/Shanghai \
  --health-cmd="wget -q -O - http://localhost:3000/api/status | grep -o '\"success\":\\s*true' | awk -F: '{print $2}'" \
  --health-interval=30s \
  --health-timeout=10s \
  --health-retries=3 \
  one-api:latest \
  --log-dir /app/logs

命令参数解析

1. -d：表示在后台运行容器。
2. --name：指定容器的名称为 one-api。
3. --restart always：设置容器自动重启。
4. -p 3000:3000：映射端口，与 Docker Compose 配置一致。
5. -v：挂载卷，与 Docker Compose 中的卷配置一致。
6. -e：设置环境变量。
7. --health-cmd、--health-interval、--health-timeout 和 --health-retries：健康检查配置。