amd64/eggdrop

** 注意 **：这是https://hub.docker.com/_/eggdrop%E7%9A%84%60amd64%60%E6%9E%B6%E6%9E%84%E6%9E%84%E5%BB%BA%E7%9A%84%E2%80%9C%E6%AF%8F%E4%B8%AA%E6%9E%B6%E6%9E%84%E2%80%9D%E4%BB%93%E5%BA%93%E2%80%94%E2%80%94%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%A7%81%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%E6%96%87%E6%A1%A3%E4%B8%AD%E7%9A%84%E2%80%9Chttps://github.com/docker-library/official-images#architectures-other-than-amd64%E2%80%9D%E5%92%8C%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8FFAQ%E4%B8%AD%E7%9A%84%E2%80%9Chttps://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E2%80%9D%E3%80%82

快速参考

-** 维护者 **：
https://github.com/eggheads/eggdrop-docker

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

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

• https://github.com/eggheads/eggdrop-docker/blob/037d27fee1499a17a1062efcba0213801d82c405/develop/Dockerfile

• https://github.com/eggheads/eggdrop-docker/blob/57fb1652a***b12e9f51775f173ecde24285/1.9/Dockerfile

• https://github.com/eggheads/eggdrop-docker/blob/2861815d67478e41667b8ed2cf9d3f13a5e755c1/1.10/Dockerfile

• https://github.com/eggheads/eggdrop-docker/blob/fa9fab693902545745642c75650b56379d17b16b/1.10.1rc1/Dockerfile

快速参考（续）

-** 问题提交地址 **：
https://github.com/eggheads/eggdrop-docker/issues?q=

-** 支持的架构 **：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
https://hub.docker.com/r/amd64/eggdrop/%E3%80%81https://hub.docker.com/r/arm32v6/eggdrop/%E3%80%81https://hub.docker.com/r/arm64v8/eggdrop/

-** 已发布镜像制品详情 **：
https://github.com/docker-library/repo-info/blob/master/repos/eggdrop%EF%BC%88https://github.com/docker-library/repo-info/commits/master/repos/eggdrop%EF%BC%89
（镜像元数据、传输大小等）

-** 镜像更新 **：
https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Feggdrop
https://github.com/docker-library/official-images/blob/master/library/eggdrop%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/eggdrop%EF%BC%89

-** 本描述的来源 **：
https://github.com/docker-library/docs/tree/master/eggdrop%EF%BC%88https://github.com/docker-library/docs/commits/master/eggdrop%EF%BC%89

什么是Eggdrop？

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

!https://raw.githubusercontent.com/docker-library/docs/c***a160e73a879916f2d88762cc7a01ec/eggdrop/logo.png

如何使用此镜像

首次运行

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

console
$ docker run -ti -e NICK=FooBot -e SERVER=irc.libera.chat -v /path/for/host/data:/home/eggdrop/eggdrop/data amd64/eggdrop

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

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

环境变量

SERVER

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

console
  -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镜像过程中（有意或无意）更换容器，需创建持久化数据存储。

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

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

启动命令示例：

console
$ docker run -i -e NICK=FooBot -e SERVER=irc.libera.chat -v /path/to/eggdrop/files:/home/eggdrop/eggdrop/data -d amd64/eggdrop

若提供自定义配置文件，将其放入数据目录并作为容器参数指定：

console
$ docker run -i -v /path/to/eggdrop/files:/home/eggdrop/eggdrop/data -d amd64/eggdrop mybot.conf

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

添加脚本

添加脚本的简便方法是在主机创建脚本目录，并挂载到/home/eggdrop/eggdrop/scripts（或自定义路径）。通过在docker run命令中添加类似以下选项实现：

console
	-v /path/to/host/scripts:/home/eggdrop/eggdrop/scripts

（然后编辑配置文件从挂载的脚本目录加载脚本）。不建议将脚本目录挂载到默认的eggdrop/scripts路径，这会导致镜像自带脚本无法被Eggdrop访问，启动时可能报错。作为替代，可挂载到/home/eggdrop/eggdrop/scripts2（或其他名称），并更新配置文件中的source命令路径。

添加脚本所需的包

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

console
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示例托管于https://github.com/eggheads/eggdrop-docker/blob/master/docker-compose.yml%E3%80%82%E6%89%8B%E5%8A%A8%E5%88%9B%E5%BB%BADocker Compose文件时的常见错误是未添加：

stdin_open: true

缺少此配置会导致Eggdrop报“END OF FILE ON TERMINAL”错误并无法启动。

故障排除/支持

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

Dockerfile的Git仓库维护于https://github.com/eggheads/eggdrop-docker%E3%80%82

许可

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

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

部分可自动检测的额外许可信息可能位于https://github.com/docker-library/repo-info/tree/master/repos/eggdrop%E3%80%82

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