海豹手册

主题

QQ - Docker 中的海豹 ​

本节内容

本节将包含通过 docker 部署海豹时，你在 QQ 平台接入海豹核心需要了解的特定内容。

请至少完成 QQ 一节中，前言部分的阅读。

本节假定你对 docker 与 docker compose 有足够的了解。

通过 docker compose 同时部署海豹与 Lagrange ​

通过此方式部署的海豹与 Lagrange 容器共同构成一个服务栈，可以方便地进行集中管理。请首先阅读 QQ 一节中，Lagrange 部分，大致了解 Lagrange 的部署过程。

创建 docker-compose.yml ​

首先，在工作目录下创建 docker-compose.yml 文件，并填入以下内容：

yaml
name: sealdice

services:
  sealdice:
    image: ghcr.io/sealdice/sealdice:edge
    ports:
      - 3211:3211
    volumes:
      - ./seal_data:/data
      - ./seal_backups:/backups
    restart: unless-stopped

  lagrange:
    image: ghcr.io/lagrangedev/lagrange.onebot:edge
    volumes:
      - ./lagrange_data:/app/data
      - ./seal_data:/data
    restart: unless-stopped

此文件参考了通过 docker 部署海豹与通过 docker 部署 Lagrange 相关内容。

此文件将宿主机 3211 端口映射到海豹容器的 3211 端口，如有需要，请根据实际情况自行调整端口映射。

此文件将工作目录下 seal_data 与 seal_backups 目录分别挂载到海豹容器的 /data 与 /backups 目录，并将 lagrange_data 与 seal_data 目录分别挂载到 Lagrange 容器的 /app/data 与 /data 目录。由于通过 QQ 后端发送本地图片时，海豹会将图片在容器内的绝对路径传递给 QQ 后端，所以需要将海豹数据也挂载到 Lagrange 容器以使 Lagrange 得以访问图片。如有需要，请根据实际情况自行调整挂载的目录。

注意：在容器内以非 root 用户执行海豹进程可能会导致一些权限问题。

因此，示例文件以 root 用户生成容器进程。后续需要修改 seal_data、seal_backups 及 lagrange_data 目录中的内容（包括 Lagrange 配置文件、海豹数据等）时，需要 root 权限。

补充：登录多个 QQ 账号

只需简单修改 docker-compose.yml 即可登录到多个 QQ 号：

yaml
name: sealdice

services:
  sealdice:
    image: ghcr.io/sealdice/sealdice:edge
    ports:
      - 3211:3211
    volumes:
      - ./seal_data:/data
      - ./seal_backups:/backups
    restart: unless-stopped

  lagrange-1:
    image: ghcr.io/lagrangedev/lagrange.onebot:edge
    volumes:
      - ./lagrange_data_1:/app/data
      - ./seal_data:/data
    restart: unless-stopped

  lagrange-2:
    image: ghcr.io/lagrangedev/lagrange.onebot:edge
    volumes:
      - ./lagrange_data_2:/app/data
      - ./seal_data:/data
    restart: unless-stopped

分别对每个 Lagrange 容器完成下述配置文件修改及扫码登录过程，并在下述海豹连接 Lagrange 填写 WS 地址时，将 {Host} 分别填入 lagrange-1、lagrange-2 即可。

首次启动容器 ​

在工作目录下使用以下命令启动容器：

bash
docker compose up -d

首次启动容器后，docker compose 会自动创建 seal_data、seal_backups 以及 lagrange_data 目录。

Lagrange 容器配置 ​

首先使用以下命令停止容器运行：

bash
docker compose stop

随后，按照 QQ 一节中运行 Lagrange 部分修改 lagrange_data/appsettings.json 文件。需要特别注意的是，为了允许海豹容器正常访问 Lagrange 端口，需要将监听地址修改为 0.0.0.0：

appsettings.json：

json
{
  "Implementations": [
    {
      "Type": "ForwardWebSocket",
      "Host": "0.0.0.0",
      "Port": 8081,
      "HeartBeatInterval": 5000,
      "AccessToken": ""
    }
  ]
}

随后，通过 docker compose up -d 重新启动容器。通过 docker compose logs lagrange 访问 Lagrange 容器的日志，在日志中即可看到 QQ 登录二维码。同时 lagrange_data/qr-0.png 也是登录二维码。选择任一方式，尽快使用手机 QQ 扫码连接。

海豹连接 Lagrange ​

请参见 QQ 一节中海豹连接 Lagrange 部分。在填写 WS 正向服务地址 ws://{Host}:{Port} 时，{Host} 填写为 lagrange 即可，如果配置了多个 Lagrange 容器，填入对应服务的名称，docker compose 会自动处理主机名解析。{Port} 正常填写配置文件中设定的监听地址，在上文的例子中为 8081。

更新海豹容器或 Lagrange 容器 ​

运行以下命令：

bash
docker compose pull
docker compose up -d

当任一镜像有更新时，以上命令会完成容器更新。

通过 docker-compose 部署海豹与 NapCat ​

通过此方式快速部署的海豹与 NapCat 容器并集中管理。

创建 docker-compose.yml ​

首先，在工作目录下创建 docker-compose.yml 文件，并填入以下内容：

yaml
services:
  sealdice:
    image: ghcr.io/sealdice/sealdice:edge
    container_name: sealdice
    ports:
      - "3211:3211"
    volumes:
      - "./data:/data"
      - "./backups:/backups"
    networks:
      - sealdice_network
    depends_on:
      - napcat

  napcat:
    image: mlikiowa/napcat-docker:latest
    container_name: napcat
    ports:
      - "6099:6099"
    volumes:
      - "./napcat/config:/app/napcat/config"
      - "./napcat/QQ_DATA:/app/.config/QQ"
      - "./data:/data"
      - "./backups:/backups"
    environment:
      - NAPCAT_UID=${NAPCAT_UID:-1000}
      - NAPCAT_GID=${NAPCAT_GID:-1000}
      - MODE=sealdice
      - ACCOUNT=${ACCOUNT}
    networks:
      - sealdice_network
    mac_address: "02:42:ac:11:00:02"

networks:
  sealdice_network:
    driver: bridge

该示例文件中，映射海豹容器的 WebUI 端口 3211 到宿主机的 3211，映射 NapCat 容器的 WebUI 6099 端口为 6099。

为保证海豹数据的持久化，以及图片语音等资源的正常发送，映射 ./data 和 ./backups 目录到宿主机，且映射到 NapCat 容器内的相同位置。

为确保 NapCat 能够持久化配置文件和 QQ 数据，映射 ./napcat/config 和 ./napcat/QQ_DATA 目录到宿主机。

mac_address 用于指定容器 MAC 地址，用于固化 QQ 识别的设备信息，推荐自行修改 mac_address，注意必须是 02:42 开头的 MAC 地址，否则无法正常启动。

首次启动容器 ​

根据示例文件定制完毕后，通过以下命令行来启动容器。（你也可以选择不修改任何内容直接尝试启动）

bash
echo 'ACCOUNT=123456' > .env # 请将 ACCOUNT 的数字替换为骰娘的 QQ 号
NAPCAT_UID=$(id -u) NAPCAT_GID=$(id -g) docker-compose up -d

海豹连接 NapCat ​

以示例 docker-compose.yml 文件的默认设置为例，访问 NapCat 的 WebUI：http://宿主机IP:6099 。

在 NapCat 的 WebUI 登录页面输入 TOKEN napcat，然后选择右侧的扫码登录按钮，扫描二维码登录。

随后访问海豹的 WebUI：http://宿主机IP:3211 。

在「账号设置」中新增账号，「账号类型」选择 QQ(onebot11正向WS)，「连接地址」填写 ws://{Host}:{Port}，其中 {Host} 填写为 napcat 即可。 {Port} 则填写 1234，这是 NapCat 运行在 MODE=sealdice 模式下的预置端口，无需再另行设置。

以示例 docker-compose.yml 文件的默认设置为例，此处应填写 ws://napcat:1234。

补充：多个账号连接同一个海豹

如果配置了多个 NapCat 容器，则 {Host} 填入对应服务的名称，docker compose 会自动处理主机名解析。

关于登录多个 QQ 号的 docker-compose.yml 文件修改方法，请参考上一节 通过-docker-compose-同时部署海豹与-lagrange 中的 补充：登录多个 QQ 号 部分。

补充：多个账号连接不同的海豹

如果想要配置多个独立的海豹，可以直接在 另一个文件目录 中创建 docker-compose.yml 文件，然后再次从头设置并启动容器。

建议在 docker-compose.yml 文件中，将 container_name 、ports 、 network 、 mac_address等关键设置修改为不同的值，以区分不同的海豹。

例如：

yaml
services:
  sealdice:
    image: ghcr.io/sealdice/sealdice:edge
    container_name: sealdice-114514  # 为容器指定个性化的名称方便管理
    ports:
      - "13211:3211"  # 为容器指定新的宿主机端口，冒号左侧是宿主机端口，冒号右侧是容器端口
    volumes:
      - "./data:/data"
      - "./backups:/backups"
    networks:
      - sealdice_114514  # 为容器指定新的网络
    depends_on:
      - napcat

  napcat:
    image: mlikiowa/napcat-docker:latest
    container_name: napcat-114514   # 为容器指定个性化的名称方便管理
    ports:
      - "16099:6099"  # 为容器指定新的宿主机端口
    volumes:
      - "./napcat/config:/app/napcat/config"
      - "./napcat/QQ_DATA:/app/.config/QQ"
      - "./data:/data"
      - "./backups:/backups"
    environment:
      - NAPCAT_UID=${NAPCAT_UID:-1000}
      - NAPCAT_GID=${NAPCAT_GID:-1000}
      - MODE=sealdice
      - ACCOUNT=${ACCOUNT}
    networks:
      - sealdice_114514  # 保持和上面容器同一个网络
    mac_address: "02:42:ac:22:00:01"  # 为容器指定新的 MAC 地址

networks:
  sealdice_114514:  # 定义新的网络
    driver: bridge

海豹内「账号设置」中新增账号时的 {Host} 无需修改，docker compose 会自动处理主机名解析。

管理容器 ​

  • 启动所有服务

    bash
    docker-compose up -d

  • 查看容器状态

    bash
    docker-compose ps

  • 停止服务

    bash
    docker-compose down

  • 更新服务

    bash
    docker-compose pull
docker-compose up -d

  • 重新创建容器

    bash
    docker-compose up -d --force-recreate

连接到宿主机上的 QQ 后端 ​

注意：此种部署方式可能不能正常发送本地图片。

由于通过 QQ 后端发送本地图片时，海豹会将图片在容器内的绝对路径传递给 QQ 后端。宿主机上的 QQ 后端无法正确解析海豹数据目录的路径，因此可能无法正常发送图片。

首先按照 QQ 一节中的介绍，完成 QQ 后端的配置。

Docker 自动为容器构建了一个子网，容器默认接入此网络，并通过端口映射将容器端口暴露在宿主机。因此，容器中的海豹不能直接访问宿主机监听本地端口的 QQ 后端。需要连接时，有两种解决方案。

保持容器与宿主机网络隔离 ​

Docker 为宿主机也分配了子网中的 IP，可以通过 ip a 等命令查看。例如：

bash
$ ip a
...
9: docker0: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc noqueue state DOWN group default
    link/ether 02:42:33:50:ca:2d brd ff:ff:ff:ff:ff:ff
    inet 172.17.0.1/16 brd 172.17.255.255 scope global docker0
       valid_lft forever preferred_lft forever
    inet6 fe80::42:33ff:fe50:ca2d/64 scope link proto kernel_ll
       valid_lft forever preferred_lft forever
...

其中 172.17.0.1 为宿主机在 docker 子网中的 IP。

此时，首先修改 QQ 后端的监听设置，以确保其接受任何来源的连接（例如将 127.0.0.1 修改为 0.0.0.0），然后在配置海豹时，{Host} 填入宿主机在 docker 子网中的 IP（本例中为 172.17.0.1）。

配置容器使用宿主机网络 ​

通过将 docker run 命令中的 -p ... 替换为 --network host，或在 docker-compose.yml 文件中将 ports: ... 替换为 network_mode: host，即可令容器使用宿主机网络。此时，在配置海豹时，{Host} 写为类似 127.0.0.1 或 localhost 即可正常访问监听本地端口的 QQ 后端。