linuxserver/quassel-core

镜像概述和主要用途

Quassel-core是现代、跨平台、分布式IRC客户端的核心组件，负责处理IRC连接。它允许一个或多个客户端连接和断开中央核心，设计为持续运行，即使客户端离线也能保持IRC身份在线。客户端重新连接时可下载历史记录，支持无限滚动回溯。

重要提示：此镜像已弃用
我们将不再为此镜像提供支持，也不会进行更新。

核心功能和特性

• 分布式架构：中央核心处理IRC连接，客户端可灵活连接/断开
• 持续在线：保持IRC身份24/7在线，不受客户端状态影响
• 历史记录支持：客户端重连后可获取完整聊天历史
• 多平台支持：适配x86-64和arm64v8架构
• LinuxServer.io特性：
  • 定期应用更新
  • 简单的用户映射（PGID、PUID）
  • 基于s6 overlay的自定义基础镜像
  • 每周基础OS更新，减少空间占用、 downtime和带宽消耗
  • 定期安全更新

支持的架构

应用设置

Quassel***文档：quassel

推荐在VPS（如DigitalOcean）上部署Quassel实例，实现24/7 IRC连接。

基本设置步骤：

1. 运行容器后，启动Quassel桌面客户端
2. 使用服务器公网IP和指定端口（默认4242）连接核心实例
3. 创建管理员用户，选择SQLite作为存储后端（Quassel限制）
4. 设置真实姓名和昵称，点击"保存并连接"
5. 添加网络（如Freenode）并加入IRC频道（如#linuxserver.io）

无状态使用

通过--config-from-environment RUN_OPTS环境变量可启用无状态模式，需通过环境参数配置：

环境变量说明

RUN_OPTS选项说明

SQLite无状态模式示例

bash
docker create \
  --name=quassel-core \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Europe/London \
  -e RUN_OPTS='--config-from-environment' \
  -e DB_BACKEND=SQLite \
  -e AUTH_AUTHENTICATOR=Database \
  -p 4242:4242 \
  -v <数据路径>:/config \
  --restart unless-stopped \
  linuxserver/quassel-core

使用方法

Docker Compose（推荐）

yaml
---
services:
  quassel-core:
    image: lscr.io/linuxserver/quassel-core:latest
    container_name: quassel-core
    environment:
      - PUID=1000  # 用户ID
      - PGID=1000  # 组ID
      - TZ=Etc/UTC  # 时区
      - RUN_OPTS=--config-from-environment  # 可选，自定义Quassel CLI选项
    volumes:
      - /path/to/quassel-core/data:/config  # 配置和数据库存储路径
    ports:
      - 4242:4242  # Quassel核心监听端口
      - 113:***  # 可选，IDENT端口
    restart: unless-stopped

Docker CLI

bash
docker run -d \
  --name=quassel-core \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e RUN_OPTS=--config-from-environment `#可选` \
  -p 4242:4242 \
  -p 113:*** `#可选` \
  -v /path/to/quassel-core/data:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/quassel-core:latest

参数说明

环境变量文件（Docker Secrets）

可通过FILE__前缀从文件加载环境变量，例如：

bash
-e FILE__MYVAR=/run/secrets/mysecretvariable

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

应用运行的Umask设置

可通过-e UMASK=022自定义容器内服务的umask值，详情参考umask说明。

用户/组ID说明

使用卷挂载时，可通过PUID（用户ID）和PGID（组ID）避免权限问题。使用id your_user命令获取当前用户的ID：

bash
id your_user

示例输出：

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

Docker Mods

我们提供多种Docker Mods以扩展容器功能，上述徽章链接可查看可用Mods。

支持信息

容器内Shell访问

bash
docker exec -it quassel-core /bin/bash

实时查看日志

bash
docker logs -f quassel-core

查看容器版本号

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

查看镜像版本号

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

更新信息

通过Docker Compose更新

• 更新所有镜像：

  bash
  docker-compose pull
  

• 更新单个镜像：

  bash
  docker-compose pull quassel-core
  

• 更新所有容器：

  bash
  docker-compose up -d
  

• 更新单个容器：

  bash
  docker-compose up -d quassel-core
  

• 清理旧镜像：

  bash
  docker image prune
  

通过Docker Run更新

• 更新镜像：

  bash
  docker pull lscr.io/linuxserver/quassel-core:latest
  

• 停止运行中的容器：

  bash
  docker stop quassel-core
  

• 删除容器：

  bash
  docker rm quassel-core
  

• 使用相同参数重新创建容器（配置将通过卷保留）

• 清理旧镜像：

  bash
  docker image prune
  

镜像更新通知 - Diun（Docker Image Update Notifier）

提示：推荐使用Diun接收更新通知，不建议使用自动更新容器的工具。

本地构建

bash
git clone [***]
cd docker-quassel-core
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/quassel-core:latest .

跨架构构建

使用lscr.io/linuxserver/qemu-static可在x86_64硬件上构建ARM变体：

bash
docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset

注册后可通过-f Dockerfile.aarch64指定架构Dockerfile。

版本历史

• 26.12.24: - 镜像弃用
• 26.08.23: - 基于Alpine 3.20重建
• 10.11.23: - 基于Alpine 3.18重建
• 03.07.23: - 移除armhf支持（如公告所述）
• 13.02.23: - 基于Alpine 3.17重建，迁移至s6v3
• 03.01.22: - 基于Alpine 3.15重建，添加新构建依赖并修复0.14版本相关问题
• 07.08.21: - 修复数据库密码变量操作符错误
• 19.12.19: - 基于Alpine 3.11重建
• 28.06.19: - 基于Alpine 3.10重建
• 23.03.19: - 切换到新基础镜像，使用arm32v7标签
• 20.03.19: - 增加无状态运行选项（基于Quassel团队建议）
• 26.01.19: - 添加流水线逻辑和多架构支持
• 08.01.19: - 基于Ubuntu Bionic重建，升级至Quassel 0.13.0（详见此处）
• 30.07.18: - 基于Alpine 3.8重建，使用构建阶段
• 03.01.18: - 移除cpu_core routine（扩展性不足）
• 09.12.17: - 基于Alpine 3.7重建
• 26.11.17: - 使用CPU核心计数加速构建
• 12.07.17: - 添加检查命令到README，迁移至Jenkins构建推送
• 27.05.17: - 基于Alpine 3.6重建
• 13.05.17: - 切换到Git源码
• 28.12.16: - 基于Alpine 3.5重建
• 23.11.16: - 基于Alpine Edge重建
• 23.09.16: - 使用QT5依赖（感谢bauerj）
• 10.09.16: - 添加层徽章到README
• 28.08.16: - 添加徽章到README
• 10.08.16: - 基于Xenial重建
• 14.10.15: - 移除WebUI（对大多数用例不稳定）
• 01.09.15: - 修复README错误
• 30.07.15: - 切换到内部基础镜像，修复Web界面更新bug
• 06.07.15: - 启用BLOWFISH加密，添加（可选）Web界面（客户端无法访问时使用）