alexandreteles/jmusicbot

JMusicBot Docker镜像

概述

本镜像为***音乐机器人JMusicBot提供容器化部署方案，基于eclipse-temurin Java运行时构建，旨在确保安全补丁能够快速更新，避免因Java组件漏洞（如log4j问题）导致的安全风险。所有镜像构建均通过GitHub Actions自动完成，可通过项目仓库验证镜像内容。

核心功能与特性

• 安全优先：基于eclipse-temurin Java运行时，确保安全补丁快速更新，减少安全漏洞响应时间
• 配置依赖：必须提供config.txt配置文件，否则机器人无法启动，需挂载至容器内/app/config.txt路径
• 播放列表支持：通过配置playlistsFolder并挂载本地目录，可实现播放列表功能
• 透明构建：所有Docker Hub镜像均来自GitHub仓库，通过GitHub Actions自动构建，可查看Dockerfile和构建流程验证镜像内容
• 安全扫描：使用Trivy和Dependabot进行镜像漏洞扫描，安全状态可在GitHub项目的Security和Issues标签查看

使用场景

适用于需要在Docker环境中部署音乐机器人JMusicBot的用户，特别是关注安全更新、容器化部署便捷性和配置灵活性的场景，如个人服务器或小型社区服务器的音乐机器人部署。

使用方法

前提条件

• 已准备JMusicBot的config.txt配置文件（必填）
• （可选）serversettings.json文件
• （可选）播放列表目录（若使用播放列表功能）

基本部署命令

通过docker run命令部署，需挂载config.txt（及可选的serversettings.json）：

bash
docker run --name jmusicbot -d \
  -v /path/to/config.txt:/app/config.txt:ro \
  -v /path/to/serversettings.json:/app/serversettings.json:ro \
  --restart=always \
  docker.xuanyuan.run/alexandreteles/jmusicbot

播放列表配置

1. 在config.txt中设置playlistsFolder路径（相对于/app），例如：
   playlistsFolder = "/app/playlists"
2. 挂载本地播放列表目录至容器内对应路径：

bash
docker run --name jmusicbot -d \
  -v /path/to/config.txt:/app/config.txt:ro \
  -v /path/to/serversettings.json:/app/serversettings.json:ro \
  -v /path/to/playlists:/app/playlists:ro \
  --restart=always \
  docker.xuanyuan.run/alexandreteles/jmusicbot

安全与验证

• 构建透明度：建议使用前检查项目的https://github.com/alexandreteles/jmusicbot_docker/blob/master/Dockerfile%E5%92%8Chttps://github.com/alexandreteles/jmusicbot_docker/blob/master/.github/workflows/main.yml
• 漏洞监控：通过GitHub项目的Security和Issues标签可查看漏洞扫描结果，发现问题可提交issue或自行修复并贡献上游

注意事项

• 配置文件必填：未提供config.txt将导致机器人无法启动
• 环境变量支持：当前镜像不支持通过环境变量配置，未来可能不会添加此功能
• OpenJ9版本：提供基于IBM Semeru Runtimes（OpenJ9）的构建版本，当前用于生产环境，但JMusicBot未针对该JVM进行测试，使用时需自行承担风险