在前文中，我们详尽阐述了QQ机器人的搭建过程及其最终实现的各项功能展示。接下来，我们将转向探讨该项目基于Docker构建服务的具体实践。本篇将以QQ机器人签名服务——qsign为起点，逐步展开论述。

1 获取和运行 xzhouqd/qsign:8.9.63 镜像

1.1 获取镜像

获取镜像有两种方式

1.1.1 从 Docker Hub 拉取镜像

docker pull xzhouqd/qsign:8.9.63

1.1.2 从本地存储文件加载镜像

docker load -i xzhouqd_qsign_8.9.63.tar

上面提及的示例文件 “xzhouqd_qsign_8.9.63.tar” ，实际上是由 Docker 镜像导出并存储到本地的压缩文件。那么，这样的文件是如何生成的呢？接下来，我们将逐步揭示这一过程。
首先，我们需要使用 Docker 的镜像列举命令来确认目标镜像是否已经存在于本地的 Docker 环境中：

docker images

执行的结果如下图：

通过执行上述命令，您将看到一个列表，其中包含了本地已有的所有镜像或指定镜像的信息。如果目标镜像确实存在，它将在列表中显示；否则，需要从远程仓库（如Docker Hub）拉取或通过其他方式获取（如：1.1.1所述 ）。

假设“xzhouqd/qsign:8.9.63”镜像已存在于本地Docker环境中，接下来我们将演示如何将其导出为.tar文件：

docker save -o xzhouqd_qsign_8.9.63.tar xzhouqd/qsign:8.9.63

这条命令中：

• docker save 是用于导出镜像的Docker命令。
• -o xzhouqd_qsign_8.9.63.tar 指定了导出后压缩文件的名称和路径。
• xzhouqd/qsign:8.9.63 是要导出的镜像的完整名称（包括仓库名、镜像名和标签）。

执行此命令后，Docker将把指定镜像及其依赖的所有层打包成一个名为“xzhouqd_qsign_8.9.63.tar”的.tar文件，并将其保存到当前工作目录下。至此，我们就成功创建了由Docker镜像生成的本地压缩文件。

1.2 由镜像运行生成容器

docker run -d `# -d 表示保持后台运行` \
	--restart=always `# 表示开机即自动运行` \
	--name bs-qsign `容器名称` \
	-p 18080:8080 `# 端口映射，将容器的 8080 端口映射到宿主机的 18080 端口` \
	-e ANDROID_ID=xxxxxxx `# 此值可以随便设置，但需要和 cqhttp 里的设置一致` \
	xzhouqd/qsign:8.9.63 # 镜像文件

小贴士： 在多行Shell命令文件中，欲在行尾使用反斜杠 \ 进行续行的同时添加注释，可于 \ 之前插入一对反引号 ` 包裹的 # 字符来实现，以此实现续行与注释的结合。

至此，bs-qsign 签名服务器已顺利完成搭建。为便于后续进行参数的动态调整、实现与其他容器间配置的统一管理，以及一键启动具有复杂功能的扩展服务，建议将相关参数迁移至配置文件进行妥善存储。

2 创建配置文件：config.sh

此配置文件，由以下几个部分构成

2.1 基本参数

appName="bs-qsign" # 应用名称
appVersion="0.0.1" # 应用版本号
imageName="xzhouqd/qsign:8.9.63" # 镜像名称
containerName="$appName" # 容器名称

2.2 docker run 相关配置

通常情况下，我们在配置Docker容器时会涉及以下三个核心要素：

• Volumes —— 用于宿主机与容器之间实现文件或目录的双向同步映射，确保数据持久化及共享。在配置文件里以变量 volumes 表示。

• Ports —— 通过端口映射，使得外部能够访问到容器内部运行的服务，实现网络通信。在配置文件里以变量 ports 表示。

• Environments —— 设置环境变量，为容器内应用程序提供必要的运行时配置信息。在配置文件里以变量 envs 表示。

对于上述各项配置，可根据实际应用场景自由选择适用的项目。对于暂时无需使用的配置项，可以选择对其进行注释以备后续参考，或者直接删除以保持配置文件简洁。

# docker run 相关配置（可选项，如为空，可不填）

volumes=(/path_in_host:/path_in_container) 
# /path_in_host - 宿主机目录
# /path_in_container - 容器目录

ports=("18080:8080") # 宿主机端口:容器端口

envs=("ANDROID_ID=tanbushi01") # 变量名=变量值

上述以圆括号 () 包围的数据结构在Shell脚本中定义了一个数组。其中，用单引号或双引号包裹的文本构成数组的各个元素，多个元素之间以空格分隔。以包含多个端口映射的数组为例：

ports=("18080:8080" "15703:5703")

这里，数组 ports 包含两个元素：“18080:8080” 和 “15703:5703”，分别代表将宿主机的18080端口映射到容器的8080端口，以及将宿主机的15703端口映射到容器的5703端口。

类似地，对于 volumes（卷映射）和 envs（环境变量）数组的定义，只需按照相同的方式指定各自的映射关系或环境变量键值对即可：

volumes=("host_path1:container_path1" "host_path2:container_path2")
envs=("VAR1=value1" "VAR2=value2")

以上述方式声明的 volumes 数组表示将宿主机的 host_path1 目录映射到容器的 container_path1，host_path2 目录映射到 container_path2。而 envs 数组则设置了两个环境变量：VAR1 的值为 value1，VAR2 的值为 value2。

2.3 标记 config.sh 脚本执行状态

通过设置变量 configured 来标记 config.sh 脚本是否已执行过：

configured=true

当该变量值为 true 时，表明 config.sh 脚本已成功执行过一次，旨在防止后续重复加载或执行配置，确保系统的稳定性和一致性。

最终的config.sh内容如下：

#!/bin/bash

# 基本参数
appName="bs-qsign" # 应用名称
appVersion="0.0.1" # 应用版本号
imageName="xzhouqd/qsign:8.9.63" # 镜像名称
containerName="$appName" # 容器名称

# docker run 相关配置（可选项，如为空，可不填）
ports=("18080:8080")
envs=("ANDROID_ID=tanbushi01")

# 标记是否已经配置过
configured=true # 标记变量——此脚本已经被执行过

3 运行容器的脚本：run.sh

#!/bin/bash

# 运行初始化脚本
. ../../shell-scripts/run_init.sh

# 创建并执行临时文件——实现 docker run 命令（临时文件不是在容器里哦！）
. ../../shell-scripts/run_in_tmp.sh

echo ""
echo "*********************************************************"
echo "成功创建容器：【 $containerName 】！"
echo "*********************************************************"
echo ""

3.1 初始化脚本：run_init.sh

#!/bin/bash

set -e # 遇到错误时退出脚本

# 判断是否运行过配置文件 config.sh，如果未运行过，则运行配置文件
if [ -z "$configured" ]; then
  . ./config.sh
fi

# 检查 Docker 是否在运行
if ! docker info > /dev/null 2>&1; then
  echo "Docker 没有运行。请启动 Docker 再试！"
  exit 1
fi

# 查看指定名称和TAG的镜像是否存在
str=$imageName
IFS=":"
read -ra parts <<< "$str"
_img_name=${parts[0]}
_img_tag=${parts[1]}
set +e
rslt=`docker images | grep -E "^$_img_name\s+$_img_tag\s+"`
set -e
# 判断字符串是否为空
if [ -z "$rslt" ]; then
  echo "镜像不存在，请先构建镜像！"
  exit 2
fi

# 检查容器是否存在
if docker ps -a --filter "name=$containerName" | grep -q "$containerName"; then
  echo ""
  echo "容器【 $containerName 】存在，先停止，再删除..."
  # 容器存在，先停止，再删除
  echo ""
  echo "停止容器【 $containerName 】..."
  docker stop $containerName > /dev/null 2>&1
  echo ""
  echo "删除容器【 $containerName 】..."
  echo ""
  docker rm $containerName > /dev/null 2>&1
fi

3.2 临时生成的运行 docker run 的脚本：run_in_tmp.sh

#!/bin/bash

OS=$(uname)

is_windows=false
 
case "$OS" in
  Linux) # 在 Linux 系统上运行 
    ;;
  Darwin) # 在 macOS 系统上运行
    ;;
  CYGWIN*|MINGW32*|MSYS*|MINGW*) # 在 Windows 系统上运行
    is_windows=true
    ;;
  *)
    echo "Unknown OS: $OS" # 在其他系统上运行
    ;;
esac

# 执行 docker run 命令的临时脚本文件名
shell_script="/tmp/${containerName}_run.sh"

# 输出数组元素生成映射 volume、port、env
function exportMapItems() {
  local script_name=$1 # 脚本文件名
  shift
  local type_prefix=$1 # 类型前缀
   shift 
  # 如果是windows，同时$type_prefix是-v 则自动添加斜杠
  if [ "$is_windows" = true ] && [ "$type_prefix" = "-v" ]; then
    auto_slash=/
  else
    auto_slash=""
  fi
  # echo "auto_slash=$auto_slash"
  local -a items=("$@")
  for map_item in "${items[@]}"; do
    # 输出数组元素
    echo "  ${type_prefix} ${auto_slash}${map_item} \\" >> $script_name
    # echo "  ${type_prefix} ${auto_slash}${map_item} \\"
  done
}

# 创建临时文件：/tmp/_run.sh（不是在容器里哦！）
echo "#!/bin/bash" > $shell_script
echo "" >> $shell_script
echo "docker run -itd \\" >> $shell_script
echo "  --restart always \\" >> $shell_script

# 写入 volumes，注意，此处只能是-v，不是-V
exportMapItems $shell_script "-v" "${volumes[@]}"

# 写入 ports，注意，此处只能是-p，不是-P
exportMapItems $shell_script "-p" "${ports[@]}"

# 写入 envs，注意，此处只能是-e，不是-E
exportMapItems $shell_script "-e" "${envs[@]}"

# 写入 name
echo "  --name $containerName \\" >> $shell_script

# 写入 imageName
echo "  $imageName" >> $shell_script

chmod 755 $shell_script
. $shell_script
rm -f $shell_script

4 总结

本篇首先讲述了Docker 镜像拉取、保持到本地、从本地加载等操作流程；其次通过两个文件构建了一种可配置的机制，使得基于指定镜像创建并运行容器的过程更具通用性和灵活性。不仅适用于当前的 bs-qsign 服务部署场景，还能无缝应用于后续提及的其他服务搭建，从而增强了部署流程的标准化程度、适应性和代码复用性。

---

上一篇：docker安装并跑通跑通QQ机器人实践（1）-前言及展示

下一篇：docker安装并跑通QQ机器人实践（3）-bs-nonebot搭建

---