adamus1red/sopel Docker Image Overview

adamus1red/sopel

adamus1red

Sopel（Python IRC机器人）的Docker容器，提供便捷部署和运行方式，支持配置持久化、第三方模块扩展及环境变量自定义，适用于快速搭建IRC机器人实例。

下载次数: 0状态：社区镜像维护者：adamus1red仓库类型：镜像最近更新：4 个月前

轩辕镜像，让镜像更快，让人生更轻。点击查看

中文简介版本下载

轩辕镜像，让镜像更快，让人生更轻。点击查看

Sopel Docker镜像

![Docker Stars]([] ![Docker Pulls]([] ![Docker Image Size (latest)]([] ![Docker Image Size (nightly)]([] ![GitHub Workflow Status (branch)]([***]

🐋 官方非官方™ Docker容器，用于Sopel——一个Python IRC机器人

相关链接：

Sopel官网 @ Sopel，Python IRC机器人
Sopel GitHub @ sopel-irc/sopel
Docker GitHub @ sopel-irc/docker-sopel
Docker仓库 @ sopelirc/sopel

快速开始

首次运行

拉取最新Sopel版本（v7.0.5）的Docker镜像

console
$ docker pull sopelirc/sopel:latest

启动机器人。为容器指定一个名称（例如my_first_sopel），以便后续启动和关闭更方便。
```
console
$ docker run --name=my_first_sopel -ti sopelirc/sopel
```
首次运行时，将进入设置向导以创建机器人的配置文件。更多详情参见Sopel Wiki的“首次运行”条目。

停止和启动机器人

可以通过简单的键盘中断（Ctrl-C）停止上述命令启动的机器人，或使用docker stop命令：docker stop my_first_sopel
可以使用docker start命令重启机器人：docker start -ia my_first_sopel。

注意：使用docker start ...启动的容器需要用docker stop ...停止（Ctrl-C无效），如上例所示。

如何使用此镜像

Sopel机器人的最低要求是有效的配置文件。您可以通过启动新机器人创建配置文件，或接入已有的配置文件！虽然Sopel已内置多种模块，但您可以轻松向容器添加第三方和自定义模块。

保存新配置

按照快速开始步骤将在容器文件系统中生成配置目录。您可能需要将其提取到主机，以便更容易修改和持久化。可以使用docker cp ...命令将.cfg文件或整个配置文件夹复制到指定目录：

将default.cfg文件复制到主机的/some/path/on/the/host目录

console
$ docker cp my_first_sopel:/home/sopel/.sopel/default.cfg /some/path/on/the/host/

将整个~/.sopel配置目录复制到主机的/some/path/on/the/host目录

console
$ docker cp my_first_sopel:/home/sopel/.sopel /some/path/on/the/host/

提取的配置文件/文件夹可传输或复制，用作其他机器人的配置模板。

使用现有配置

可将配置文件或文件夹挂载到/home/sopel/.sopel供机器人使用。应使用默认配置文件名（default.cfg），或在docker run ...命令后附加-c correct_file_name.cfg来指定正确的文件名。

挂载配置文件

console
$ docker run -v "/path/to/my/default.cfg:/home/sopel/.sopel/default.cfg" ...

挂载配置文件夹

console
$ docker run -v "/path/to/config/folder:/home/sopel/.sopel" ...

如果遇到权限问题，可使用PUID和PGID环境变量使容器内用户ID与主机匹配。或者，可将配置文件/文件夹的所有权修改为容器用户（uid=***，gid=***）。

添加第三方包

Python包

PyPI可用模块

参见EXTRA_PYPI_PACKAGES环境变量。

您也可以将pip requirements.txt格式的文件挂载到/pypi_packages.txt，以在启动时安装列出的包。

源码模块

将模块源码目录挂载到/home/sopel/.sopel/modules，Sopel将自动识别并加载该模块。

Alpine Linux包

参见EXTRA_APK_PACKAGES环境变量。

您也可以将文本文件挂载到/apk_packages.txt，以在启动时安装列出的系统包。

环境变量

启动机器人时，可通过在docker run ...命令行传递一个或多个环境变量来调整机器人进程的环境设置。

`PUID` 和 `PGID`

默认情况下，sopel进程以UID和GID为***运行，以防止意外访问主机资源。这意味着挂载的卷需要允许该用户读写。您可以通过设置这些变量在启动时修改sopel用户的ID。例如：

console
$ docker run -e PUID=1000 ...
Setting UID for user sopel to 1000... Done.
...
...
Welcome to Sopel. Loading modules...
...

通常，您会将PUID/PGID设置为与挂载卷所有者ID匹配的值。

`EXTRA_PYPI_PACKAGES`

可通过提供空格分隔的包名列表，在启动时安装PyPI包。由于底层调用pip install ...，任何pip支持的包名都可使用。例如：

console
$ docker run -e EXTRA_PYPI_PACKAGES="sopel-modules.weather google-api-python-client sopel-modules.***" ...
Installing package "sopel-modules.weather" with pip...
...
Installing package "google-api-python-client" with pip...
...
Installing package "sopel-modules.***" with pip...
...
...
Welcome to Sopel. Loading modules...
...

这将安装sopel天气模块、sopel ***模块及其依赖google-api-python-client。

`EXTRA_APK_PACKAGES`

有时可能需要安装系统包以满足Python包的依赖。这些包可通过空格分隔的列表指定，使用apk add --no-cache ...安装。例如，可能需要数据库客户端、编译源码所需的工具，以及允许pip从仓库安装的git：

console
$ docker run -e EXTRA_APK_PACKAGES="mysql-client build-base git" ...
Installing apk packages: mysql-client build-base git...
...
...
Welcome to Sopel. Loading modules...
...

这将安装所需的系统包。===SHORT_DESC=== Sopel（Python IRC机器人）的Docker容器，提供便捷部署和运行方式，支持配置持久化、第三方模块扩展及环境变量自定义，适用于快速搭建IRC机器人实例。 ===FULL_DESC===# Sopel Docker镜像

![Docker Stars]([] ![Docker Pulls]([] ![Docker Image Size (latest)]([] ![Docker Image Size (nightly)]([] ![GitHub Workflow Status (branch)]([***]

🐋 官方非官方™ Docker容器，用于Sopel——一个Python IRC机器人

相关链接：

Sopel官网 @ Sopel，Python IRC机器人
Sopel GitHub @ sopel-irc/sopel
Docker GitHub @ sopel-irc/docker-sopel
Docker仓库 @ sopelirc/sopel

快速开始

首次运行

拉取最新Sopel版本（v7.0.5）的Docker镜像

console
$ docker pull sopelirc/sopel:latest

启动机器人。为容器指定名称（例如my_first_sopel），便于后续操作：
```
console
$ docker run --name=my_first_sopel -ti sopelirc/sopel
```
首次运行将进入设置向导创建配置文件，详情参见Sopel Wiki“首次运行”条目。

停止和启动机器人

停止：使用Ctrl-C或docker stop my_first_sopel
重启：docker start -ia my_first_sopel

注意：docker start启动的容器需用docker stop停止（Ctrl-C无效）。

如何使用此镜像

Sopel需有效配置文件，可通过快速开始创建或接入现有配置。支持添加第三方/自定义模块扩展功能。

保存新配置

首次运行生成的配置文件需提取至主机以持久化：

复制单个配置文件：

console
$ docker cp my_first_sopel:/home/sopel/.sopel/default.cfg /主机路径/

复制整个配置目录：

console
$ docker cp my_first_sopel:/home/sopel/.sopel /主机路径/

提取的配置可作为其他机器人的模板。

使用现有配置

将配置文件/目录挂载至/home/sopel/.sopel：

挂载单个文件：

console
$ docker run -v "/主机路径/default.cfg:/home/sopel/.sopel/default.cfg" ...

挂载目录：

console
$ docker run -v "/主机路径/config:/home/sopel/.sopel" ...

权限问题可通过PUID/PGID调整，或修改文件所有权为容器用户（uid=***，gid=***）。

添加第三方包

Python包

PyPI模块：通过EXTRA_PYPI_PACKAGES或挂载requirements.txt至/pypi_packages.txt
源码模块：挂载源码目录至/home/sopel/.sopel/modules，Sopel自动加载

Alpine系统包

通过EXTRA_APK_PACKAGES或挂载文本文件至/apk_packages.txt安装系统依赖。

环境变量

`PUID` 和 `PGID`

调整容器内用户ID以匹配主机卷权限：

console
$ docker run -e PUID=1000 -e PGID=1000 ...

通常设为挂载卷所有者ID。

`EXTRA_PYPI_PACKAGES`

启动时安装PyPI包（空格分隔列表）：

console
$ docker run -e EXTRA_PYPI_PACKAGES="sopel-modules.weather sopel-modules.***" ...

`EXTRA_APK_PACKAGES`

安装Alpine系统包（空格分隔列表）：

console
$ docker run -e EXTRA_APK_PACKAGES="mysql-client build-base git" ...

查看更多 sopel 相关镜像 →

adamus1red/ouroboros

adamus1red

Ouroboros是一款Docker容器自动更新工具，能够监控运行中的容器并将其更新到远程 registry 中的最新可用镜像，保留原容器的所有配置参数（如卷挂载、网络连接、环境变量等），支持多种通知方式和指标收集（Prometheus/Influxdb）。

Docker上的HOPM（混合开放代理监控器）是一个开放代理监控机器人，用于监控服务器连接并扫描不安全代理，通过检测代理回连行为识别风险连接，适用于需要监控IRC服务器等场景的单个服务器。

IRPG Website Docker镜像，基于IRPG Website v0.5，提供Idle RPG游戏的网站界面，用于展示玩家状态、任务等游戏信息，支持通过Docker快速部署与配置。

1万+ 次下载

11 天前更新

轩辕镜像配置手册

探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式

Docker 配置

登录仓库拉取

通过 Docker 登录认证访问私有仓库

专属域名拉取

无需登录使用专属域名

K8s Containerd

Kubernetes 集群配置 Containerd

K3s

K3s 轻量级 Kubernetes 镜像加速

Dev Containers

VS Code Dev Containers 配置

Podman

Podman 容器引擎配置

Singularity/Apptainer

HPC 科学计算容器配置

其他仓库配置

ghcr、Quay、nvcr 等镜像仓库

系统配置

Linux

在 Linux 系统配置镜像服务

Windows/Mac

在 Docker Desktop 配置镜像

MacOS OrbStack

MacOS OrbStack 容器配置

Docker Compose

Docker Compose 项目配置

NAS 设备

群晖

Synology 群晖 NAS 配置

飞牛

飞牛 fnOS 系统配置镜像

绿联

绿联 NAS 系统配置镜像

威联通

QNAP 威联通 NAS 配置

极空间

极空间 NAS 系统配置服务

网络设备

爱快路由

爱快 iKuai 路由系统配置

宝塔面板

在宝塔面板一键配置镜像

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

使用与功能问题

docker search 报错：专属域名下仅支持 Docker Hub 查询

docker search 报错问题

网页搜不到镜像：Docker Hub 有但轩辕镜像搜索无结果

镜像搜索不到

离线传输镜像：无法直连时用 docker save/load 迁移

离线传输镜像

Docker 插件安装错误：application/vnd.docker.plugin.v1+json

Docker 插件安装错误

WSL 下 Docker 拉取慢：网络与挂载目录影响及优化

WSL 拉取镜像慢

轩辕镜像是否安全？镜像完整性校验（digest）说明

镜像安全性

如何用轩辕镜像拉取镜像？登录方式与专属域名配置

如何拉取镜像

错误码与失败问题

manifest unknown 错误：镜像不存在或标签错误

manifest unknown 错误

TLS/SSL 证书验证失败：Docker pull 时 HTTPS 证书错误

TLS 证书验证失败

DNS 解析超时：无法解析镜像仓库地址或连接超时

DNS 解析超时

410 Gone 错误：Docker 版本过低导致协议不兼容

410 错误：版本过低

402 Payment Required 错误：流量耗尽错误提示

402 错误：流量耗尽

401 UNAUTHORIZED 错误：身份认证失败或登录信息错误

身份认证失败错误

429 Too Many Requests 错误：请求频率超出专业版限制

429 限流错误

Docker login 凭证保存错误：Cannot autolaunch D-Bus（不影响登录）

凭证保存错误

账号 / 计费 / 权限

免费版与专业版区别：功能、限额与使用场景对比

免费版与专业版区别

支持的镜像仓库：Docker Hub、GCR、GHCR、K8s 等列表

轩辕镜像支持的镜像仓库

拉取失败是否扣流量？计费规则说明

拉取失败流量计费

KYSEC 权限不够：麒麟 V10/统信 UOS 下脚本执行被拦截

KYSEC 权限错误

如何申请开具发票？（增值税普票/专票）

开具发票

如何修改网站与仓库登录密码？

修改网站和仓库密码

配置与原理类

registry-mirrors 未生效：仍访问官方仓库或报错的原因

registry-mirrors 未生效

如何去掉镜像名称中的轩辕域名前缀？（docker tag）

去掉域名前缀

如何拉取指定架构镜像？（ARM64/AMD64 等多架构）

拉取指定架构镜像

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"

adamus1red/sopel Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Sopel Docker镜像

快速开始

首次运行

停止和启动机器人

如何使用此镜像

保存新配置

使用现有配置

添加第三方包

Python包

Alpine Linux包

环境变量

PUID 和 PGID

EXTRA_PYPI_PACKAGES

EXTRA_APK_PACKAGES

快速开始

首次运行

停止和启动机器人

如何使用此镜像

保存新配置

使用现有配置

添加第三方包

Python包

Alpine系统包

环境变量

PUID 和 PGID

EXTRA_PYPI_PACKAGES

EXTRA_APK_PACKAGES

轩辕镜像配置手册

Docker 配置

登录仓库拉取

专属域名拉取

K8s Containerd

K3s

Dev Containers

Podman

Singularity/Apptainer

其他仓库配置

系统配置

Linux

Windows/Mac

MacOS OrbStack

Docker Compose

NAS 设备

群晖

飞牛

绿联

威联通

极空间

网络设备

爱快路由

宝塔面板

镜像拉取常见问题

使用与功能问题

docker search 报错：专属域名下仅支持 Docker Hub 查询

网页搜不到镜像：Docker Hub 有但轩辕镜像搜索无结果

离线传输镜像：无法直连时用 docker save/load 迁移

Docker 插件安装错误：application/vnd.docker.plugin.v1+json

WSL 下 Docker 拉取慢：网络与挂载目录影响及优化

轩辕镜像是否安全？镜像完整性校验（digest）说明

如何用轩辕镜像拉取镜像？登录方式与专属域名配置

错误码与失败问题

manifest unknown 错误：镜像不存在或标签错误

TLS/SSL 证书验证失败：Docker pull 时 HTTPS 证书错误

DNS 解析超时：无法解析镜像仓库地址或连接超时

410 Gone 错误：Docker 版本过低导致协议不兼容

402 Payment Required 错误：流量耗尽错误提示

401 UNAUTHORIZED 错误：身份认证失败或登录信息错误

429 Too Many Requests 错误：请求频率超出专业版限制

Docker login 凭证保存错误：Cannot autolaunch D-Bus（不影响登录）

账号 / 计费 / 权限

免费版与专业版区别：功能、限额与使用场景对比

支持的镜像仓库：Docker Hub、GCR、GHCR、K8s 等列表

拉取失败是否扣流量？计费规则说明

KYSEC 权限不够：麒麟 V10/统信 UOS 下脚本执行被拦截

如何申请开具发票？（增值税普票/专票）

如何修改网站与仓库登录密码？

配置与原理类

registry-mirrors 未生效：仍访问官方仓库或报错的原因

如何去掉镜像名称中的轩辕域名前缀？（docker tag）

`PUID` 和 `PGID`

`EXTRA_PYPI_PACKAGES`

`EXTRA_APK_PACKAGES`

`PUID` 和 `PGID`

`EXTRA_PYPI_PACKAGES`

`EXTRA_APK_PACKAGES`