silicer/go-cqhttp

go-cqhttp Docker镜像文档

镜像概述

本镜像为https://github.com/Mrs4s/go-cqhttp%E7%9A%84Docker%E5%8C%96%E9%83%A8%E7%BD%B2%E7%89%88%E6%9C%AC%EF%BC%8C%E5%9F%BA%E4%BA%8E%E5%AE%98%E6%96%B9Release%E7%89%88%E6%9C%AC%E6%9E%84%E5%BB%BA%EF%BC%88%E9%9D%9E%E4%BB%8E%E6%BA%90%E7%A0%81%E6%9E%84%E5%BB%BA%EF%BC%89%EF%BC%8C%E5%B7%A5%E4%BD%9C%E7%9B%AE%E5%BD%95%E5%9B%BA%E5%AE%9A%E4%B8%BA%60/data%60%E3%80%82go-cqhttp%E6%98%AF%E4%B8%80%E6%AC%BE%E5%9F%BA%E4%BA%8EOneBot%E5%8D%8F%E8%AE%AE%E7%9A%84QQ%E6%9C%BA%E5%99%A8%E4%BA%BA%E6%A1%86%E6%9E%B6%EF%BC%8C%E7%94%A8%E4%BA%8E%E5%AE%9E%E7%8E%B0QQ%E6%B6%88%E6%81%AF%E7%9A%84%E6%8E%A5%E6%94%B6%E3%80%81%E5%8F%91%E9%80%81%E5%8F%8A%E7%9B%B8%E5%85%B3%E8%87%AA%E5%8A%A8%E5%8C%96%E5%8A%9F%E8%83%BD%E3%80%82

核心功能与特性

• 基于Release版本：采用官方发布的稳定Release版本构建，确保部署可靠性和兼容性
• 固定工作目录：所有配置文件和运行数据均存储于/data目录，便于管理
• 明确的持久化需求：需对关键文件/文件夹进行持久化以保留配置和运行状态，具体如下：

使用场景

适用于需要部署go-cqhttp服务的各类场景，包括但不限于：

• QQ机器人开发与运行环境搭建
• 基于QQ消息的自动化通知/推送服务
• 需长期稳定运行且保留配置和数据的go-cqhttp部署需求

使用方法与配置说明

前置准备

1. 准备本地持久化目录（如/opt/go-cqhttp/data），用于挂载容器内的/data目录
2. 如需自定义配置，可提前准备config.yml、device.json等文件（首次启动会自动生成默认配置）

Docker Run部署示例

方式一：整体挂载工作目录（推荐）

将本地目录整体挂载到容器/data，自动管理所有持久化文件：

bash
docker run -itd --name go_cqhttp \
  -v /path/to/local/directory:/data \  # 本地目录挂载到容器/data
  -p 6700:6700 \  # 映射API端口（默认6700，根据config.yml配置调整）
  --restart always \  # 容器退出后自动重启
  silicer/go-cqhttp:latest

方式二：单独挂载文件/文件夹（精细化管理）

分别挂载各持久化文件/文件夹，适用于需要单独管理不同数据的场景：

bash
docker run -itd --name go_cqhttp \
  -v /path/to/local/data:/data/data \  # 数据文件夹
  -v /path/to/local/logs:/data/logs \  # 日志文件夹
  -v /path/to/local/config.yml:/data/config.yml \  # 配置文件
  -v /path/to/local/device.json:/data/device.json \  # 设备型号文件
  -v /path/to/local/session.token:/data/session.token \  # 会话令牌文件
  -p 127.0.0.1:6700:6700 \  # 限制本地访问（根据需求调整）
  --restart always \
  silicer/go-cqhttp:latest

配置说明

• 端口映射：默认需映射6700端口（API服务端口），具体端口需与config.yml中的port配置保持一致
• 持久化要求：必须挂载/data目录或其中的持久化文件，否则容器重启后配置、会话信息和运行数据将丢失
• 首次启动配置：首次运行时，若/data目录为空，容器会自动生成默认config.yml，需根据实际需求修改配置（如QQ账号、协议类型、API设置等）后重启容器使配置生效