在容器中使用

Docker 等容器化软件是以服务生产环境而开发的应用平台，在使用此类软件部署之时，我们相信你已经掌握了运维一台服务器所必须的知识，同时也理解了容器化的概念与相关软件的基础操作。如若不然，在除路由器或 NAS 等特殊环境外，请选择其他安装方式。

Koishi 提供了 Docker 镜像，方便你在容器中运行 Koishi。你需要首先安装 Docker 来运行容器

启动容器

使用以下命令启动容器：

docker run -p 5140:5140 koishijs/koishi

许多插件依赖 koishi-plugin-puppeteer 来进行图片渲染，故默认镜像中包含 Chromium。如果你认为镜像过大，不需要预装 Chromium，我们也提供了轻量版本：

docker run -p 5140:5140 koishijs/koishi:latest-lite

安装命令

自己按需更改不可复制粘贴

如果您希望以特定的容器名称（如 koishi）运行 Docker 容器，并确保它在崩溃或停止后能够自动重启，您可以使用以下命令

docker run -d \
  --name koishi \
  --restart unless-stopped \
  -p 5140:5140 \
  -v /opt/1panel/apps/koishi:/koishi \
  -e TZ=Asia/Shanghai \
  koishijs/koishi:latest


#命令解释
#docker run: 用于创建并运行一个新的容器。
#-d: 以分离模式（后台模式）运行容器。
#--name koishi: 指定容器的名称为 koishi。
#--restart unless-stopped: 设置重启策略为“除非手动停止”，这意味着如果#容器崩溃或 Docker 服务重启，容器会自动重启。
#-p 5140:5140: 将主机的 5140 端口映射到容器的 5140 端口。
#-v /opt/1panel/apps/koishi:/koishi 将主机的 /opt/1panel/apps/koishi 目录挂载到容器内的 /koishi 目录。
#-e TZ=Asia/Shanghai: 设置环境变量 TZ 为 Asia/Shanghai，以指定时区。
#koishijs/koishi: 指定要使用的 Docker 镜像。

启动后将会绑定 Koishi 控制台到 5140 端口。注意端口是否被占用

如果你需要持久化，请使用 -v /opt/1panel/apps/koishi 来映射 Koishi 的文件。自己映射自己的目录

如果需要更正时区，请使用 -e TZ=Asia/Shanghai 来设置时区。

Koishi 本体及其插件都可以控制台完成更新。在持久化文件过后更新容器仅会更新 Chromium 和 Node.js 等的版本。

访问使用

在容器运行时，可以通过在浏览器中访问 http://宿主机地址:5140 在控制台中安装和启用插件。若无法访问请检查你的防火墙配置是否正确。

反向ws使用

安装完成后连接机器人反向ws使用ncqq

先配置好Koishi的ws链接插件

插件市场搜索

adapter-onebot

安装如下图中插件

然后根据图片操作

进入插件配置

先配置机器人qq然后点击上方启动

根据教程安装docker容器ncqq

ncqq教程:Docker安装Napcat反向ws-鑫仔博客 (xinz.fun)

操作完成后打开webui添加反向ws

ws://ip:5140/onebot

ncqq安装

安装命令:

ncqq教程:Docker安装Napcat反向ws-鑫仔博客 (xinz.fun)

映射目录自己映射

docker run -d \
-e ACCOUNT="机器人qq号" \
-e NAPCAT_GID=0 \
-e NAPCAT_UID=0 \
-e MESSAGE_POST_FORMAT="string" \
-e WSR_ENABLE=true \
-e WS_URLS='["ws://宿主机ip:5140/onebot"]' \
-p 6099:6099 \
-v /你的目录/napcat/QQ:/app/.config/QQ \
-v /你的目录/napcat/config:/app/napcat/config \
-v /你的目录/napcat/logs:/app/napcat/logs \
--name napcat \
--mac-address=02:42:ac:11:00:99 \
mlikiowa/napcat-docker:latest

--安装完ncqq ip:6099 进入web 不知道访问密码去目录看

ncqq设置示例:

--172.17.0.1是你的宿主机或者docker容器网关＋端口

即可连接

安装koishi对接ncqq完成了 llonb同理

初始配置

按需配置

创建分组

先添加自己想用的分组比如 ChatLun插件分组

示例:

创建名为 Ai 的分组

分组添加插件

只监听白名单群聊或者白名单用户

暂时写到这里基本初始化安装结束