注意：这是eggdrop官方镜像的“按架构”仓库，用于arm32v6架构构建——更多信息，请参见官方镜像文档中的“非amd64架构？”和官方镜像FAQ中的“Git中镜像的源代码已更改，该怎么办？”。

快速参考

• 维护者：
  Eggheads（Eggdrop社区）

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应的Dockerfile链接

• develop

• 1.9, 1.9.5

• 1.10, 1.10.0, stable, latest

• 1.10.1rc1

快速参考（续）

• 问题反馈地址：
  [***]

• 支持的架构：(更多信息)
  amd64、arm32v6、arm64v8

• 已发布镜像制品详情：
  repo-info仓库的repos/eggdrop/目录（历史记录）
  （镜像元数据、传输大小等）

• 镜像更新：
  official-images仓库的library/eggdrop标签
  official-images仓库的library/eggdrop文件（历史记录）

• 本描述的来源：
  docs仓库的eggdrop/目录（历史记录）

什么是Eggdrop？

Eggdrop是全球最流行的开源IRC机器人，设计注重灵活性和易用性，根据GNU通用公共许可证（GPL）自由分发。它支持Linux、BSD、SunOs、Windows和Mac OS X等多种系统。核心代码库可通过TCL脚本或C模块扩展，机器人可链接形成机器人网络，实现跨多个机器人共享用户文件和派对线。

!logo

如何使用此镜像

首次运行

首次运行此容器时，至少需要通过环境变量传入昵称和服务器。至少使用类似以下的docker run命令：

$ docker run -ti -e NICK=FooBot -e SERVER=irc.libera.chat -v /主机数据路径:/home/eggdrop/eggdrop/data arm32v6/eggdrop

这将修改配置文件中的相应值，然后启动机器人，昵称为FooBot并连接到irc.libera.chat。这些变量仅在首次运行时需要——首次使用后，可直接编辑配置文件。其他配置选项如下节所述。

请注意，即使在守护进程模式下，docker run的-i标志也是必需的。

环境变量

SERVER

此变量设置Eggdrop将连接的IRC服务器。示例：

  -e SERVER=just.a.normal.server
  -e SERVER="you.need.to.change.this 6667"
  -e SERVER="another.example.com 7000 password"
  -e SERVER="[2001:db8:618:5c0:263::] 6669 password"
  -e SERVER="ssl.example.net +6697"

注意，指定端口或密码时需将整个参数用引号括起来。通过环境变量只能指定一个服务器。+表示SSL启用端口。首次运行后，建议直接编辑Eggdrop配置添加其他服务器（见下文“长期持久化”）。

NICK

此变量设置Eggdrop使用的昵称。首次使用后，应通过直接编辑Eggdrop配置修改（见下文“长期持久化”）。

LISTEN

此变量设置Eggdrop监听传入连接的TCP端口（相当于配置中的listen XXXX all）。如果设置此变量，可能需要调整docker run命令中的-p标志以匹配。

EGGOWNER（仅develop标签支持测试）

此变量创建Eggdrop的第一个账户句柄。这是您将登录的句柄，拥有完全的所有者权限。如果使用此环境变量，还必须设置EGGOWNER_PASS环境变量，否则容器将无法启动。仅在Eggdrop首次运行时可用。如果提供自己的配置文件（不使用docker首次运行生成的配置文件），必须在配置文件末尾添加“source scripts/docker.tcl”以启用此功能。此变量可在容器首次运行后移除。

EGGOWNER_PASS（仅develop标签支持测试）

此变量设置EGGOWNER句柄的密码。未设置EGGOWNER环境变量时，设置此变量无效。此变量可在容器首次运行后移除。

CHANNELS（仅develop标签支持测试）

此变量包含容器运行时Eggdrop将尝试创建的频道列表（如果不存在）。格式为逗号分隔列表（CHANNELS=#chan1,chan2,#chan3）。频道添加后，此变量可移除。

长期持久化

首次运行Eggdrop容器后，配置文件、用户文件和频道文件将位于容器内的/home/eggdrop/eggdrop/data/目录。但！这些文件的持久性仅与它们所在的容器相同。如果您希望在使用Eggdrop docker镜像期间（有意或无意）使用不同的容器，需要创建持久化数据存储。

最简单的方法是将主机目录挂载到/home/eggdrop/eggdrop/data。如果在首次运行前执行此操作，可轻松编辑docker镜像在主机目录中生成的Eggdrop配置文件。此外，也可将现有配置、用户或频道文件放入挂载的数据目录，供Eggdrop容器使用。

如果使用先前Eggdrop安装的配置文件（即不使用此镜像生成的配置文件），请务必修改用户文件和频道文件的路径以使用data目录——即编辑配置文件，设置set userfile data/<userfile>和set channelfile data/<channelfile>。否则，数据将不持久。您可能还希望将Eggdrop设为守护进程（在后台运行）。

为此，使用类似以下命令启动容器：

$ docker run -i -e NICK=FooBot -e SERVER=irc.libera.chat -v /eggdrop文件路径:/home/eggdrop/eggdrop/data -d arm32v6/eggdrop

如果提供自己的配置文件，将其放入数据目录，并将其指定为docker容器的参数：

$ docker run -i -v /eggdrop文件路径:/home/eggdrop/eggdrop/data -d arm32v6/eggdrop mybot.conf

与docker一起使用的任何配置文件必须以.conf结尾，如eggdrop.conf或mybot.conf。

添加脚本

添加脚本的简便方法是在主机上创建脚本目录，并将其挂载到/home/eggdrop/eggdrop/scripts（或您选择的路径）。这可通过在docker run命令行添加类似以下选项实现：

	-v /主机脚本路径:/home/eggdrop/eggdrop/scripts

（然后编辑配置文件，从挂载脚本目录的路径加载脚本）。不建议将脚本目录挂载到默认的eggdrop/scripts路径，因为这会阻止Eggdrop访问镜像包含的脚本，并可能在启动时出错。作为替代方案，可挂载到/home/eggdrop/eggdrop/scripts2（或类似路径），并确保使用新路径更新source命令。

添加脚本所需的包

许多脚本需要安装额外的OS包才能运行，如tcl-tls、tcl-lib和libsqlite3-tcl。遵循Docker理念，基础Eggdrop包仅包含基础功能所需的最小依赖。但用户可在启动容器时轻松添加包：

docker run -i eggdrop sh -c 'apk add tcl-lib tcl-tls && exec /home/eggdrop/eggdrop/entrypoint.sh eggdrop.conf'

暴露网络端口

如果要为机器人暴露网络连接，还需使用-p标志暴露配置中指定的监听端口（默认3333）。例如，要暴露3333端口，添加：

-p 3333:3333

到docker run命令行。

常见错误

compose.yaml

docker-compose.yml示例托管于[***] Compose文件时，常见错误是未添加：

stdin_open: true

没有此配置，Eggdrop将显示“END OF FILE ON TERMINAL”错误且无法启动。

故障排除/支持

如需更多帮助，可加入Libera的#eggdrop频道。

Dockerfile的git仓库维护于[***]

许可证

查看此镜像包含软件的许可证信息。

与所有Docker镜像一样，这些镜像可能还包含其他软件，可能受其他许可证约束（如基础发行版中的Bash等，以及主要软件的任何直接或间接依赖）。

一些可自动检测的额外许可证信息可能位于repo-info仓库的eggdrop/目录。

对于任何预构建镜像的使用，镜像用户有责任确保对本镜像的任何使用符合其中包含的所有软件的相关许可证。