lichessbotdevs/lichess-bot

如何启动你的机器人

下载Docker镜像

该镜像可通过https://hub.docker.com/r/lichessbotdevs/lichess-bot%E5%92%8Chttps://github.com/lichess-bot-devs/lichess-bot/pkgs/container/lichess-bot%E8%8E%B7%E5%8F%96%E3%80%82 运行docker pull lichessbotdevs/lichess-bot从Docker Hub下载，或者运行docker pull ghcr.io/lichess-bot-devs/lichess-bot从Github容器注册表下载。

注意：在Docker Hub上，组织名称是lichessbotdevs（不带连字符），而在Github容器注册表上是lichess-bot-devs。两种情况下的包名称都是lichess-bot（带连字符）。

在下面的步骤中，如果你通过Github容器注册表下载了镜像，请将lichessbotdevs替换为ghcr.io/lichess-bot-devs。

准备部署

创建一个文件夹，用于存放配置文件、运行引擎的UCI/XBoard程序（该程序将在容器内的Linux操作系统中运行）或你自己的https://github.com/lichess-bot-devs/lichess-bot/wiki/Create-a-homemade-engine%EF%BC%8C%E5%A6%82%E6%9E%9C%E9%9C%80%E8%A6%81%EF%BC%8C%E8%BF%98%E5%8F%AF%E4%BB%A5%E5%AD%98%E6%94%BE%E4%BD%A0%E8%87%AA%E5%B7%B1%E7%9A%84https://github.com/lichess-bot-devs/lichess-bot/wiki/Extra-customizations%E3%80%82

配置文件必须命名为config.yml。

你可以使用以下命令查看配置文件示例： docker run --rm --entrypoint=cat lichessbotdevs/lichess-bot config.yml.default

配置文档可参考https://github.com/lichess-bot-devs/lichess-bot/wiki/Configure-lichess-bot%E3%80%82

运行机器人

当配置文件准备就绪（假设存放在/home/me/myEngine文件夹），运行以下命令： docker run -d -v /home/me/myEngine:/lichess-bot/config --name myBot lichessbotdevs/lichess-bot

注意：建议使用绝对路径而非相对路径，因为相对路径可能会导致问题。

警告：

• 确保已将config.yml中的dir和working_dir属性设置为正确路径（引擎在容器内运行，路径应从/lichess-bot/config/开始）。
• **如果使用https://github.com/lichess-bot-devs/lichess-bot/wiki/Configure-lichess-bot#other-options%E9%85%8D%E7%BD%AE%E4%BA%86%E4%BF%9D%E5%AD%98pgn%E6%96%87%E4%BB%B6%E7%9A%84%E6%96%87%E4%BB%B6%E5%A4%B9**%E4%B8%94%E8%AF%A5%E6%96%87%E4%BB%B6%E5%A4%B9%E4%B8%8D%E5%9C%A8%60/lichess-bot/config%60%E7%9B%AE%E5%BD%95%E4%B8%AD%EF%BC%8C%E5%8A%A1%E5%BF%85%E4%B8%BA%E8%AF%A5%E6%96%87%E4%BB%B6%E5%A4%B9%E6%8C%82%E8%BD%BD%E5%8D%B7%E3%80%82%E5%90%A6%E5%88%99%EF%BC%8C%E4%BF%9D%E5%AD%98%E7%9A%84%E6%B8%B8%E6%88%8F%E5%B0%86%E6%97%A0%E6%B3%95%E4%BB%8E%E5%AE%B9%E5%99%A8%E5%A4%96%E9%83%A8%E8%AE%BF%E9%97%AE%EF%BC%8C%E4%B8%94%E5%9C%A8%E5%AE%B9%E5%99%A8%E6%96%87%E4%BB%B6%E7%B3%BB%E7%BB%9F%E4%B8%AD%E5%AD%98%E5%82%A8%E5%A4%A7%E9%87%8F%E6%B8%B8%E6%88%8F%E5%8F%AF%E8%83%BD%E5%AF%BC%E8%87%B4%E7%A3%81%E7%9B%98%E9%A5%B1%E5%92%8C%E3%80%82
• 容器使用标准Docker日志系统，机器人始终以--disable_auto_logging选项启动。使用docker logs myBot命令访问机器人日志。

停止和删除机器人

使用标准Docker命令： docker stop myBot 和 docker rm myBot

镜像变体

lichess-bot镜像提供两种版本，适用于不同使用场景。

lichess-bot:<version>

默认镜像，基于https://hub.docker.com/_/python%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%E3%80%82%E5%A6%82%E6%9E%9C%E4%BD%A0%E4%B8%8D%E7%A1%AE%E5%AE%9A%E9%9C%80%E6%B1%82%EF%BC%8C%E5%BB%BA%E8%AE%AE%E4%BD%BF%E7%94%A8%E6%AD%A4%E7%89%88%E6%9C%AC%E3%80%82

使用lichess-bot:latest获取最新版本。

lichess-bot:<version>-alpine

基于Alpine Linux构建，比默认镜像体积小得多（80MB vs 1GB）。当镜像大小是主要考虑因素时适用。

注意：该版本使用musl libc而非glibc，某些软件可能需要额外依赖。例如，运行Stockfish需要安装额外库。

使用lichess-bot:alpine获取最新Alpine版本。

使用提示

引擎需要安装额外软件时

需创建自定义Docker镜像并在Dockerfile中安装所需软件。例如安装Java 17：

dockerfile
FROM lichessbotdevs/lichess-bot:alpine

RUN apk add --no-cache openjdk17-jre

注意：Alpine版本需使用apk命令安装软件。

向lichess-bot.py添加选项

通过OPTIONS环境变量传递选项。例如以 verbose 模式启动： docker run -d -v /home/me/myEngine:/lichess-bot/config --env OPTIONS=-v lichessbotdevs/lichess-bot

查看lichess-bot版本

运行以下命令：

docker