lsiodev/limnoria

linuxserver/limnoria

https://github.com/ProgVal/limnoria 是一个健壮、功能全面且用户/程序员友好的Python IRC机器人，拥有众多现有插件，是知名Supybot的继任者。

支持的架构

该镜像利用Docker manifest实现多平台支持。直接拉取 lscr.io/linuxserver/limnoria:latest 即可获取适合您架构的正确镜像，也可通过标签拉取特定架构镜像。

支持的架构如下：

应用设置

新配置

若没有现有配置，需先启动容器，然后运行以下向导命令：

bash
docker exec -it -w /config -u abc limnoria limnoria-wizard

现有配置

若有现有配置，需在配置文件中调整目录设置如下：

conf
supybot.directories.backup: /config/backup
supybot.directories.conf: /config/conf
supybot.directories.data: /config/data
supybot.directories.data.tmp: /config/data/tmp
supybot.directories.data.web: /config/web
supybot.directories.log: /config/logs
supybot.directories.plugins: /config/plugins

注意：这些变量在文件中并非分组排列，需在配置文件中搜索相应变量进行修改。然后将配置文件及所有现有目录放入 /config 并启动容器。

插件需求

容器启动时会自动pip安装 /config/plugins 文件夹中找到的任何 requirements.txt。若使用PluginDownloader安装包含 requirements.txt 的插件，可进入容器执行 pip install /config/plugins/ThePlugin/requirements.txt 或重启容器以安装依赖。

使用方法

docker-compose（推荐）

yaml
---
version: "2.1"
services:
  limnoria:
    image: docker.xuanyuan.run/linuxserver/limnoria:latest
    container_name: limnoria
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - path/to/config:/config
    ports:
      - 8080:8080
    restart: unless-stopped

docker cli

bash
docker run -d \
  --name=limnoria \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 8080:8080 \
  -v path/to/config:/config \
  --restart unless-stopped \
  docker.xuanyuan.run/linuxserver/limnoria:latest

参数

来自文件的环境变量（Docker secrets）

可通过特殊前缀 FILE__ 从文件设置环境变量，例如：

bash
-e FILE__MYVAR=/run/secrets/mysecretvariable

这将根据 /run/secrets/mysecretvariable 文件内容设置环境变量 MYVAR。

应用运行的Umask

所有镜像支持通过可选参数 -e UMASK=022 覆盖容器内服务的默认umask设置。请注意，umask是权限减法而非加法，详情参考umask说明。

用户/组标识符

使用卷（-v 标志）时，主机OS与容器间可能出现权限问题。通过指定用户 PUID 和组 PGID 可避免此问题。确保主机上的卷目录归指定用户所有，权限问题将迎刃而解。

使用 id your_user 命令可获取您的PUID和PGID：

bash
id your_user

示例输出：

text
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

Docker Mods

https://github.com/linuxserver/docker-mods 可扩展容器功能。该镜像可用的Mods及通用Mods可通过相关链接查看。

支持信息

• 容器运行时的Shell访问：

  bash
  docker exec -it limnoria /bin/bash
  

• 实时监控容器日志：

  bash
  docker logs -f limnoria
  

• 容器版本号：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' limnoria
  

• 镜像版本号：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/limnoria:latest
  

更新信息

通过Docker Compose

• 更新镜像：

  • 所有镜像：

    bash
    docker-compose pull
    

  • 单个镜像：

    bash
    docker-compose pull limnoria
    

• 更新容器：

  • 所有容器：

    bash
    docker-compose up -d
    

  • 单个容器：

    bash
    docker-compose up -d limnoria
    

• 清理旧镜像：

  bash
  docker image prune
  

通过Docker Run

• 更新镜像：

  bash
  docker pull docker.xuanyuan.run/linuxserver/limnoria:latest
  

• 停止运行中的容器：

  bash
  docker stop limnoria
  

• 删除容器：

  bash
  docker rm limnoria
  

• 使用相同参数重新创建容器（若正确映射到主机文件夹，/config 及设置将保留）

通过Watchtower自动更新（仅在忘记原始参数时使用）

bash
docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/containrrr/watchtower \
  --run-once limnoria

警告：不建议将Watchtower用作现有Docker容器的自动更新解决方案，通常不鼓励自动更新。

本地构建

bash
git clone https://github.com/linuxserver/docker-limnoria.git
cd docker-limnoria
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/limnoria:latest .

在x86_64硬件上构建ARM变体需使用 multiarch/qemu-user-static：

bash
docker run --rm --privileged docker.xuanyuan.run/multiarch/qemu-user-static:register --reset

注册后，可使用 -f Dockerfile.aarch64 指定Dockerfile。

版本历史

• 25.05.23：- 基于Alpine 3.18重新构建，弃用armhf架构。
• 22.12.22：- 基于Alpine 3.17重新构建。
• 19.09.22：- 基于Alpine 3.15重新构建。
• 25.05.21：- 容器初始化时安装插件依赖。
• 17.05.21：- 添加linuxserver wheel索引。
• 13.02.21：- 基于Alpine 3.13重新构建。
• 01.06.20：- 基于Alpine 3.12重新构建。
• 13.01.20：- 初始发布。