开始使用

Yogurt 是基于 acidify-core 实现的 QQ 协议端，实现了 Milky 协议 ，支持 PC 和 Android 两种登录方式，提供 HTTP 和 WebSocket 接口供应用端调用。

Acidify + Milky = Yogurt!

启动

Yogurt 原生支持在 Windows / macOS / Linux 平台上运行，同时通过 JVM 也可以在其他平台上运行。

通过 npm 安装和运行（推荐）

Yogurt 的预编译二进制包发布在 npm 的 @acidify/yogurt 包中。先安装 Node.js （通常会包含一个 npm），然后运行以下命令安装 Yogurt：

npm install -g @acidify/yogurt

安装完成后，可以直接通过 yogurt 命令启动 Yogurt。

支持的平台如下：

从 Releases 下载和运行

Yogurt 的构建产物发布在 SaltifyDev/yogurt-releases  仓库的 Releases 下。下载对应平台的压缩包，解压后运行 yogurt.(k)exe 即可。支持的平台如下：

Yogurt 的构建产物中还包含可在 JVM 上运行的 fat-jar。配置 Java 25+ 运行时，然后在 Releases 中下载 yogurt-jvm-all.jar，运行：

java -jar yogurt-jvm-all.jar

注意：Yogurt 的 JVM 版本理论上可以在任何支持 Java 25+ 的平台上运行，但由于 Yogurt 依赖 LagrangeCodec  的预编译构建，因此只支持在以下平台发送语音和视频消息：

通过 Docker 部署

使用 Docker Compose 部署

以下是一个简单的 docker-compose.yml 示例：

services:
  yogurt:
    image: ghcr.io/shoucandanghehe/yogurt-docker:latest
    container_name: yogurt
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - ./config.json:/app/config.json
      - data:/app/data
 
volumes:
  data:

在包含 docker-compose.yml 的目录下运行以下命令：

# 先创建空配置文件，避免 Docker 将挂载目标创建为目录
touch config.json
docker compose up

在 Yogurt 首次启动生成默认配置后按 Ctrl+C 停止，随后编辑 config.json，补全 QQ 号、签名 API 地址等必要配置，再重新启动容器：

docker compose up -d

使用 Docker 部署

以下是不使用 Docker Compose，直接通过 docker run 命令部署的示例：

docker run -d \
  --name yogurt \
  --restart unless-stopped \
  -v $(pwd)/config.json:/app/config.json \
  -v $(pwd)/data:/app/data \
  -p 3000:3000 \
  ghcr.io/shoucandanghehe/yogurt-docker:latest