cooperised/bliss

bliss-docker 镜像文档

镜像概述和主要用途

本镜像为轻量级Docker容器，包含bliss音乐管理工具，基于https://github.com/romancin/bliss-docker%E5%BC%80%E5%8F%91%E3%80%82%E7%9B%B8%E6%AF%94%E5%8E%9F%E9%A1%B9%E7%9B%AE%EF%BC%8C%E6%9C%AC%E9%95%9C%E5%83%8F%E5%85%B7%E6%9C%89%E4%B8%A4%E5%A4%A7%E6%A0%B8%E5%BF%83%E5%B7%AE%E5%BC%82%EF%BC%9A%E4%BB%A5%E9%9D%9Eroot%E7%94%A8%E6%88%B7%E8%BF%90%E8%A1%8C%E5%AE%B9%E5%99%A8%E8%BF%9B%E7%A8%8B%EF%BC%8C%E4%BB%A5%E5%8F%8A%E4%BC%98%E5%8C%96%E7%9A%84%E4%BF%A1%E5%8F%B7%E5%A4%84%E7%90%86%E6%9C%BA%E5%88%B6%EF%BC%8C%E5%90%8C%E6%97%B6%E4%BD%93%E7%A7%AF%E5%87%8F%E5%B0%8F%E8%BF%9130%25%E3%80%82bliss%E6%96%B0%E7%89%88%E6%9C%AC%E5%8F%91%E5%B8%83%E5%90%8E%EF%BC%8C%E9%95%9C%E5%83%8F%E4%BC%9A%E5%9C%A824%E5%B0%8F%E6%97%B6%E5%86%85%E8%87%AA%E5%8A%A8%E9%87%8D%E5%BB%BA%EF%BC%8C%E6%94%AF%E6%8C%81%E4%BB%8EWeb UI升级且保留配置设置。

核心功能和特性

非root用户运行

• 默认以非root用户运行，增强安全性，限制潜在容器突破漏洞的影响
• 自动调整配置卷权限，确保外部可访问配置文件
• 无需对应主机实际用户，可通过PUID/GID指定任意用户/组ID

优化的信号处理

• 运行脚本可捕获多种信号（特别是Docker停止容器时发送的SIGTERM）并传递给bliss进程，实现容器干净、快速关闭

其他特性

• 体积比原项目小近30%
• bliss新版本发布后24小时内自动重建镜像
• 支持通过bliss自身Web UI升级，升级过程中保留配置设置
• 已在Ubuntu 20.04和Debian Bullseye x86_64主机测试，其他架构可能兼容（可提交issue请求支持）

使用场景和适用范围

适用于需要管理音乐库的用户，通过bliss自动整理音乐元数据、专辑封面等信息。推荐在x86_64架构的Ubuntu或Debian系统中使用。

使用方法和配置说明

基本配置要求

• 端口映射：
  • 将主机端口映射到3220（用于Web访问）
  • 将主机端口映射到3221（bliss内部Web服务器）
• 卷映射：
  • 映射主机目录到/config（存储配置数据）
  • 映射主机音乐目录到自定义路径（如/music，用于bliss扫描音乐）
• 环境变量：
  • PUID：运行用户ID（默认65534，即nobody）
  • PGID：运行组ID（默认65534，即nogroup）
  • TZ：时区（如Europe/London）

Docker部署示例

docker run命令示例

以主机用户user身份运行：

bash
docker run -d --name=bliss \
-v /share/Container/bliss:/config \  # 配置数据卷
-v /share/MyMusic:/music \           # 音乐目录卷
-e PGID=$(id -u user) -e PUID=$(id -g user) \  # 指定用户/组ID
-e TZ=Europe/London \                # 设置时区
-p 3220:3220 \                       # Web访问端口映射
-p 3221:3221 \                       # 内部Web服务器端口映射
cooperised/bliss:latest              # 镜像名称及标签

参数说明

• 卷映射：
  • /config：必须映射，存储bliss配置数据
  • /music：建议映射，存放待扫描的音乐文件，首次启动时可在Web UI中选择此目录
• 环境变量：
  • PUID/PGID：若不指定，默认使用UID=65534（nobody）和GID=65534（nogroup）
  • TZ：设置容器时区，确保时间相关功能正常工作

镜像版本信息

• 最新版本：![Docker Image Version (latest semver)]
• 镜像大小：![docker size]
• 拉取量：![docker pulls]
• 星级：![docker stars]