linuxserver/qdirstatQDirStat 是一个基于Qt的目录统计工具:没有任何KDE依赖的KDirStat——来自原始KDirStat的作者。
!qdirstat
我们利用Docker manifest实现多平台支持。只需拉取 lscr.io/linuxserver/qdirstat:latest 即可获取适合您架构的正确镜像,也可通过标签拉取特定架构的镜像。
支持的架构:
| 架构 | 可用 | 标签 |
|---|---|---|
| x86-64 | ✅ | amd64-<version tag> |
| arm64 | ✅ | arm64v8-<version tag> |
应用可通过以下地址访问:
此镜像默认使用自签名证书(协议为https)。如果使用验证证书的反向代理,需要为容器禁用此检查。
现代GUI桌面应用可能与最新的Docker系统调用限制存在兼容性问题。可使用--security-opt seccomp=unconfined设置解决旧内核或libseccomp版本主机的兼容性问题。
[!WARNING] 此容器提供对主机系统的特权访问。除非已正确保护,否则不要将其暴露到互联网。
完整功能需要HTTPS,现代浏览器功能(如WebCodecs)不会在不安全的HTTP连接上运行。
默认无身份验证。可选的CUSTOM_USER和PASSWORD环境变量启用基本HTTP身份验证(仅适用于受信任的本地网络)。对于互联网暴露,强烈建议使用反向代理(如SWAG)并配合强大的身份验证机制。
Web界面包含具有无密码sudo访问权限的终端,任何有权访问GUI的用户都可在容器内获得root控制权。
此容器基于Docker Baseimage Selkies,提供以下环境变量和配置选项:
| 变量 | 描述 |
|---|---|
CUSTOM_PORT | 内部HTTP端口,默认3000 |
CUSTOM_HTTPS_PORT | 内部HTTPS端口,默认3001 |
CUSTOM_WS_PORT | WebSocket内部端口,默认8082 |
CUSTOM_USER | HTTP基本认证用户名,默认abc |
PASSWORD | HTTP基本认证密码,未设置则禁用认证 |
SUBFOLDER | 反向代理子文件夹,需包含前后斜杠,如/subfolder/ |
TITLE | 网页标题,默认"Selkies" |
START_DOCKER | 设置为false禁用Docker-in-Docker自动启动 |
DISABLE_IPV6 | 设置为true禁用IPv6支持 |
LC_ALL | 设置容器区域设置,如fr_FR.UTF-8 |
DRINODE | 指定DRI设备节点,如/dev/dri/renderD128 |
NO_DECOR | 设置后应用无窗口边框,适合PWA使用 |
NO_FULL | 设置后应用不会自动全屏 |
DISABLE_ZINK | 设置后禁用Zink相关环境变量配置 |
WATERMARK_PNG | 水印图片路径,如/usr/share/selkies/www/icon.png |
WATERMARK_LOCATION | 水印位置: 1(左上)、2(右上)、3(左下)、4(右下)、5(居中)、6(动画) |
| 参数 | 描述 |
|---|---|
--privileged | 启动Docker-in-Docker环境 |
-v /var/run/docker.sock:/var/run/docker.sock | 挂载主机Docker套接字 |
--device /dev/dri:/dev/dri | 挂载GPU设备,仅支持开源驱动(Intel、AMDGPU、Radeon等) |
通过设置LC_ALL环境变量可更改桌面会话语言:
-e LC_ALL=zh_CN.UTF-8 - 中文-e LC_ALL=ja_JP.UTF-8 - 日语-e LC_ALL=ko_KR.UTF-8 - 韩语-e LC_ALL=ar_AE.UTF-8 - 阿拉伯语-e LC_ALL=ru_RU.UTF-8 - 俄语-e LC_ALL=es_MX.UTF-8 - 西班牙语(拉丁美洲)-e LC_ALL=de_DE.UTF-8 - 德语-e LC_ALL=fr_FR.UTF-8 - 法语-e LC_ALL=nl_NL.UTF-8 - 荷兰语-e LC_ALL=it_IT.UTF-8 - 意大利语添加以下参数可启用GPU加速:
--device /dev/dri:/dev/dri
支持的开源GPU驱动:
| 驱动 | 描述 |
|---|---|
| Intel | i965和i915驱动(Intel iGPU) |
| AMD | AMDGPU、Radeon和ATI驱动(AMD显卡/APU) |
| NVIDIA | 仅nouveau2驱动(不支持闭源NVIDIA驱动) |
注意: 基于Alpine的镜像不支持Nvidia
通过Zink for OpenGL提供Nvidia支持,启用后可自动用于硬件加速视频编码,显著降低CPU负载。
启用Nvidia支持的运行时标志:
| 标志 | 描述 |
|---|---|
--gpus all | 传递所有主机GPU到容器 |
--runtime nvidia | 指定Nvidia运行时 |
Docker Compose配置:
yamlservices: qdirstat: image: lscr.io/linuxserver/qdirstat:latest deploy: resources: reservations: devices: - driver: nvidia count: 1 capabilities: [compute,video,graphics,utility]
使用proot-apps安装持久化应用:
bashproot-apps install filezilla
支持的应用列表见此处。
使用universal-package-install mod安装系统包:
yamlenvironment: - DOCKER_MODS=linuxserver/mods:universal-package-install - INSTALL_PACKAGES=libfuse2|git|gdb
yaml--- services: qdirstat: image: lscr.io/linuxserver/qdirstat:latest container_name: qdirstat environment: - PUID=1000 - PGID=1000 - TZ=Etc/UTC volumes: - /path/to/qdirstat/config:/config - /path/to/data:/data ports: - 3000:3000 - 3001:3001 shm_size: "1gb" restart: unless-stopped
bashdocker run -d \ --name=qdirstat \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Etc/UTC \ -p 3000:3000 \ -p 3001:3001 \ -v /path/to/qdirstat/config:/config \ -v /path/to/data:/data \ --shm-size="1gb" \ --restart unless-stopped \ lscr.io/linuxserver/qdirstat:latest
| 参数 | 功能 |
|---|---|
-p 3000:3000 | HTTP端口 |
-p 3001:3001 | HTTPS端口 |
-e PUID=1000 | 用户ID |
-e PGID=1000 | 组ID |
-e TZ=Etc/UTC | 时区设置 |
-v /config | 配置目录(存储设置和扫描结果) |
-v /data | 要分析的数据源目录 |
--shm-size= | 共享内存大小(所有桌面镜像推荐设置) |
使用FILE__前缀从文件加载环境变量:
bash-e FILE__MYVAR=/run/secrets/mysecretvariable
使用-e UMASK=022自定义umask值。
使用id your_user命令获取PUID和PGID:
bashid your_user
示例输出:
textuid=1000(your_user) gid=1000(your_user) groups=1000(your_user)
![Docker Mods]([] ![Docker Universal Mods]([]
容器内Shell访问:
bashdocker exec -it qdirstat /bin/bash
实时日志监控:
bashdocker logs -f qdirstat
容器版本:
bashdocker inspect -f '{{ index .Config.Labels "build_version" }}' qdirstat
镜像版本:
bashdocker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/qdirstat:latest
bashdocker-compose pull qdirstat docker-compose up -d qdirstat
bashdocker pull lscr.io/linuxserver/qdirstat:latest docker stop qdirstat docker rm qdirstat # 使用初始运行命令重新创建容器
manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务