镜像概览

完整引用
docker.io/koishijs/koishi
Registry
docker.io
命名空间
koishijs
仓库
koishi
已缓存 Tag 数
133
最近同步
07/05/2026, 10:36 PM

简介

Koishi 跨平台聊天机器人框架镜像,QQ/Telegram/Discord 插件生态,Node.js 即时通讯 Bot 运行时。

详细介绍

koishijs/koishi 运行 Koishi 跨平台聊天机器人框架,通过插件生态接入 QQ、Telegram、Discord 等平台,支持指令路由、中间件与数据库持久化。定位为 Bot Web/API 运行时,需 plugins volume 与 bot token 配置;K8s Deployment 聊天机器人服务。

快速启动

docker run -d --name koishi \
  -p 5140:5140 \
  -v /data/koishi:/koishi \
  docker.io/koishijs/koishi:latest

推荐实践

docker run -d --name koishi \
  --restart unless-stopped \
  -p 5140:5140 \
  -v /data/koishi:/koishi \
  -e KOISHI_ENV=production \
  docker.io/koishijs/koishi:4.14.0

核心参数说明

  • -p 5140:5140 — Koishi 控制台/API
  • -v .../koishi:... — 插件与配置持久化
  • -e KOISHI_ENV — 运行环境
  • 插件 — adapter-qq/telegram 等

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: koishi
spec:
  replicas: 1
  selector:
    matchLabels:
      app: koishi
  template:
    metadata:
      labels:
        app: koishi
    spec:
      containers:
        - name: koishi
          image: docker.io/koishijs/koishi:4.14.0
          ports:
            - containerPort: 5140
          envFrom:
            - secretRef:
                name: koishi-tokens
          volumeMounts:
            - name: data
              mountPath: /koishi
      volumes:
        - name: data
          persistentVolumeClaim:
            claimName: koishi-data
---
apiVersion: v1
kind: Service
metadata:
  name: koishi
spec:
  selector:
    app: koishi
  ports:
    - port: 5140
      targetPort: 5140

Bot Token 存 Secret;插件配置持久化至 PVC。

最新 Tag(20 条)

查看全部 133 个 Tag →
Tag架构推送时间大小Digest同步期望操作
docker.io/koishijs/koishi
:latest-lite
linux/amd64linux/arm64
2026/02/28 14:2068.1 MBsha256:8f62a18b4b08
docker.io/koishijs/koishi
:v1.16.0-lite
linux/amd64linux/arm64
2026/02/28 14:2068.1 MBsha256:8f62a18b4b08
docker.io/koishijs/koishi
:latest
linux/amd64linux/arm64
2026/02/28 14:20435.1 MBsha256:228f6d3fff5c
docker.io/koishijs/koishi
:v1.16.0
linux/amd64linux/arm64
2026/02/28 14:20435.1 MBsha256:228f6d3fff5c
docker.io/koishijs/koishi
:v1.15.0-lite
linux/amd64linux/arm64
2024/08/07 12:0457.4 MBsha256:c93012bee36f
docker.io/koishijs/koishi
:v1.15.0
linux/amd64linux/arm64
2024/08/07 12:04378.2 MBsha256:892795d05ccc
docker.io/koishijs/koishi
:v1.14.7-lite
linux/amd64linux/arm64
2024/05/31 02:1257.3 MBsha256:5a944fece8be
docker.io/koishijs/koishi
:v1.14.7
linux/amd64linux/arm64
2024/05/31 02:11375.6 MBsha256:f8b809a9c894
docker.io/koishijs/koishi
:v1.14.6-lite
linux/amd64linux/arm64
2024/05/30 17:3257.6 MBsha256:6eeae7a62d56
docker.io/koishijs/koishi
:v1.14.6
linux/amd64linux/arm64
2024/05/30 17:32376.0 MBsha256:0f886386204a
docker.io/koishijs/koishi
:v1.14.5-lite
linux/amd64linux/arm64
2024/05/30 04:1657.2 MBsha256:3305146024f4
docker.io/koishijs/koishi
:v1.14.5
linux/amd64linux/arm64
2024/05/30 04:15375.5 MBsha256:dafcdc8690a9
docker.io/koishijs/koishi
:v1.14.4-lite
linux/amd64linux/arm64
2024/05/12 16:2156.8 MBsha256:52669ea2821c
docker.io/koishijs/koishi
:v1.14.4
linux/amd64linux/arm64
2024/05/12 16:21371.8 MBsha256:ace72cdc4e7d
docker.io/koishijs/koishi
:v1.14.3-lite
linux/amd64linux/arm64
2024/04/26 17:3056.7 MBsha256:13b623eff342
docker.io/koishijs/koishi
:v1.14.3
linux/amd64linux/arm64
2024/04/26 17:30371.6 MBsha256:8c380f22a0eb
docker.io/koishijs/koishi
:v1.14.2-lite
linux/amd64linux/arm64
2024/04/26 13:3056.7 MBsha256:908e0319e64e
docker.io/koishijs/koishi
:v1.14.2
linux/amd64linux/arm64
2024/04/26 13:30371.6 MBsha256:a64c0eaa9ff0
docker.io/koishijs/koishi
:v1.14.1-lite
linux/amd64linux/arm64
2024/03/26 05:0357.5 MBsha256:a3b7a8d6c44a
docker.io/koishijs/koishi
:v1.14.1
linux/amd64linux/arm64
2024/03/26 05:03371.9 MBsha256:3f433d0aabfa