linuxserver/quassel-web

linuxserver/quassel-web

镜像概述和主要用途

【弃用通知】 该镜像已被弃用，不再提供技术支持和更新。

https://github.com/magne4000/quassel-webserver 是Quassel的Web客户端，需配合Quassel-Core实例使用（可使用 https://hub.docker.com/r/linuxserver/quassel-core/ 容器）。LinuxServer.io团队提供的该镜像曾包含定期应用更新、用户映射（PGID/PUID）、自定义基础镜像等特性，但目前已停止维护。

核心功能和特性

• 多架构支持：适配x86-64、arm64v8架构（armhf已不支持）
• 灵活配置：通过环境变量或配置文件自定义Quassel-Core连接参数
• Web访问：默认提供HTTPS访问，支持反向代理设置
• 数据持久化：配置文件存储在宿主机卷中，便于管理

支持的架构

应用设置

默认情况下，Web界面可通过 https://$SERVER_IP:64443 访问。配置方式有两种：

1. 环境变量配置：通过设置 QUASSEL_CORE 等环境变量自动生成配置
2. 手动配置：不设置核心环境变量时，配置文件位于 /config/settings-user.js

严格反向代理注意事项

镜像默认使用自签名证书（协议为HTTPS）。若反向代理验证证书，需禁用对该容器的证书检查。

使用方法

Docker Compose（推荐）

yaml
---
services:
  quassel-web:
    image: lscr.io/linuxserver/quassel-web:latest
    container_name: quassel-web
    environment:
      - PUID=1000               # 用户ID（使用 `id your_user` 获取）
      - PGID=1000               # 组ID（使用 `id your_user` 获取）
      - TZ=Etc/UTC              # 时区（如 Asia/Shanghai）
      - QUASSEL_CORE=192.168.1.10 # Quassel-Core实例IP/URL（可选）
      - QUASSEL_PORT=4242       # Quassel-Core端口（可选，默认4242）
      - QUASSEL_HTTPS=          # 设置为true启用HTTPS（默认启用）
      - URL_BASE=/quassel       # 反向代理路径前缀（可选）
    volumes:
      - /path/to/quassel-web/data:/config # 配置文件存储路径
    ports:
      - 64080:64080             # HTTP端口（可选，需禁用HTTPS）
      - 64443:64443             # HTTPS端口（可选）
    restart: unless-stopped

Docker CLI

bash
docker run -d \
  --name=quassel-web \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e QUASSEL_CORE=192.168.1.10 `# 可选` \
  -e QUASSEL_PORT=4242 `# 可选` \
  -e QUASSEL_HTTPS= `# 可选` \
  -e URL_BASE=/quassel `# 可选` \
  -p 64080:64080 `# 可选` \
  -p 64443:64443 `# 可选` \
  -v /path/to/quassel-web/data:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/quassel-web:latest

参数说明

环境变量从文件读取（Docker secrets）

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

bash
-e FILE__QUASSEL_CORE=/run/secrets/quassel_core_ip

Umask设置

通过 -e UMASK=022 覆盖默认umask值，控制文件权限（默认值022）。

用户/组标识符（PUID/PGID）

使用 id your_user 命令获取当前用户的PUID和PGID，确保宿主机卷目录与容器内权限一致，避免权限错误。

示例输出：

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

支持信息

• 进入容器Shell：

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

• 查看实时日志：

  bash
  docker logs -f quassel-web
  

• 查看容器版本：

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

• 查看镜像版本：

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

更新信息

【注意】 该镜像已弃用，不再更新。以下为历史更新方法仅供参考：

通过Docker Compose更新

bash
# 拉取最新镜像
docker-compose pull quassel-web
# 重启容器
docker-compose up -d quassel-web

通过Docker CLI更新

bash
# 拉取最新镜像
docker pull lscr.io/linuxserver/quassel-web:latest
# 停止并删除旧容器
docker stop quassel-web && docker rm quassel-web
# 重新创建容器（保留/config卷则配置不会丢失）
docker run -d [相同参数] lscr.io/linuxserver/quassel-web:latest

本地构建

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

版本历史

• 26.12.24: 标记为弃用
• 25.05.24: 基于Alpine 3.20重构
• 10.11.23: 基于Alpine 3.18重构，配置文件重命名为settings-user.cjs
• 06.07.23: 移除armhf支持
• 13.02.23: 基于Alpine 3.17重构，迁移至s6v3
• 12.02.22: 基于Alpine 3.15重构
• 01.06.20: 基于Alpine 3.12重构
• 19.12.19: 基于Alpine 3.11重构
• 28.06.19: 基于Alpine 3.10重构
• 18.05.19: 调整环境变量配置逻辑
• 28.04.19: 初始发布