lsiodev/quassel-core

linuxserver/quassel-core

镜像概述和主要用途

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

该镜像由LinuxServer.io团队维护，具备定期应用更新、简单用户映射（PGID/PUID）、基于s6 overlay的自定义基础镜像、每周基础OS更新及常规安全更新等特性。

核心功能和特性

• 分布式架构：核心与客户端分离，支持多客户端连接
• 持续在线：保持IRC连接状态，不受客户端离线影响
• 历史记录：存储聊天记录，客户端重连后可访问完整历史
• 多平台支持：适配x86-64和arm64架构
• 灵活配置：支持SQLite和PostgreSQL数据库后端，可选LDAP认证
• 安全特性：支持SSL加密连接，可配置证书和密钥

支持的架构

应用设置

Quassel官方文档：quassel

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

容器运行后，使用Quassel桌面客户端连接到核心实例：

1. 使用服务器公网IP和指定端口（默认4242）连接
2. 创建管理员用户，选择SQLite作为存储后端（Quassel限制）
3. 设置真实姓名和昵称，点击"保存并连接"
4. 配置网络：文件 > 网络 > 配置网络 > 添加（网络部分）> 使用预设 > 选择Freenode
5. 连接Freenode后，输入#join并加入#linuxserver.io频道

无状态使用

通过环境参数配置Quassel，需设置RUN_OPTS=--config-from-environment。

环境变量

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
---
version: "2.1"
services:
  quassel-core:
    image: lscr.io/linuxserver/quassel-core:latest
    container_name: quassel-core
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - RUN_OPTS=--config-from-environment # 可选
    volumes:
      - /path/to/data:/config
    ports:
      - 4242:4242
      - 113:10113 # 可选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:10113 `# 可选ident端口` \
  -v /path/to/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基于其值减去权限，而非添加权限，详情请参考umask说明。

用户/组ID

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

使用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://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=quassel-core&query=%24.mods%5B%27quassel-core%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([] "查看此容器可用的mods") https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=universal&query=%24.mods%5B%27universal%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([] "查看可用的通用mods")

LinuxServer.io提供多种https://github.com/linuxserver/docker-mods%E4%BB%A5%E6%89%A9%E5%B1%95%E5%AE%B9%E5%99%A8%E5%8A%9F%E8%83%BD%E3%80%82%E4%B8%8A%E8%BF%B0%E5%BE%BD%E7%AB%A0%E9%93%BE%E6%8E%A5%E5%8F%AF%E6%9F%A5%E7%9C%8B%E6%AD%A4%E9%95%9C%E5%83%8F%E4%B8%93%E7%94%A8mods%E5%8F%8A%E9%80%82%E7%94%A8%E4%BA%8E%E6%89%80%E6%9C%89LinuxServer.io%E9%95%9C%E5%83%8F%E7%9A%84%E9%80%9A%E7%94%A8mods%E3%80%82

支持信息

容器运行时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
  

• 使用相同参数重建容器（若卷映射正确，/config文件夹和设置将保留）

• 清理旧镜像：

  bash
  docker image prune
  

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

bash
docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --run-once quassel-core

警告：不推荐使用Watchtower作为自动化更新容器的解决方案，建议长期使用Docker Compose。

镜像更新通知 - Diun（Docker镜像更新通知器）

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

本地构建

如需本地修改镜像进行开发或自定义：

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

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

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

注册后，使用-f Dockerfile.aarch64指定ARM64构建文件。

版本历史

• 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重建，升级至Quassel0.13.0，详见说明
• 30.07.18: - 基于alpine:3.8重建并使用构建阶段
• 03.01.18: - 弃用cpu_core例程，因其缺乏扩展性
• 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界面，方便无客户端访问时使用