Skip to content

在容器中使用

WARNING

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

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

启动容器

使用以下命令启动容器:

podmandocker
podman
podman run -p 5140:5140 koishijs/koishi

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

podmandocker
podman
podman run -p 5140:5140 koishijs/koishi:latest-lite

启动后将会绑定 Koishi 控制台到 5140 端口。

如果你需要持久化,请使用 -v /some/place:/koishi 来映射 Koishi 的文件。

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

TIP

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

安装插件

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