digrouz/joal

docker-joal

镜像概述和主要用途

docker-joal是一个将Joal应用程序部署到Linux容器中的Docker镜像。Joal是一个开源的命令行RatioMaster工具，提供可选的WebUI界面，用于管理和监控相关网络活动。

标签

提供以下标签版本：

• latest：等同于alpine标签
• alpine：基于Alpine Linux构建，https://github.com/digrouz/docker-joal/blob/master/Dockerfile_alpine

核心功能和特性

• 开源命令行RatioMaster功能
• 可选WebUI界面支持
• 灵活的环境变量配置
• 持久化数据存储
• 容器内时区自定义
• 可选的自动更新功能
• 基于s6-overlay实现的进程管理

使用场景和适用范围

适用于需要部署和运行Joal应用程序的用户，特别是希望通过容器化方式简化部署、隔离环境并实现灵活配置的场景。

使用方法和配置说明

基本部署命令

bash
docker create --name=joal  \
  -v <持久化数据路径>:/config \
  -e UID=<用户ID，默认：12345> \
  -e GID=<组ID，默认：12345> \
  -e AUTOUPGRADE=<0|1> \
  -e TZ=<时区，默认：Europe/Brussels> \
  -e JOAL_PORT=<端口，默认：1234> \
  -e JOAL_SECRET_OBFUSCATION_PATH=<路径字符串，默认：joaleeS8efie> \
  -e JOAL_SECRET_TOKEN=<密钥字符串，默认：eikoogei8yohphaph6eiza3EraaChav2jee8lood9iegaing> \
  -p 1234:1234 \
  digrouz/joal

环境变量配置

UID

• 非必填
• 说明：指定运行应用程序的用户ID
• 默认值：12345

GID

• 非必填
• 说明：指定运行应用程序的组ID
• 默认值：12345

AUTOUPGRADE

• 非必填
• 说明：指定容器是否在启动时执行软件更新
• 有效值：0（禁用）或1（启用）
• 默认值：0

TZ

• 非必填
• 说明：配置容器内的时区
• 默认值：Europe/Brussels

JOAL_PORT

• 非必填
• 说明：指定Joal应用监听的端口
• 默认值：1234

JOAL_SECRET_OBFUSCATION_PATH

• 非必填但强烈建议自定义
• 说明：WebUI访问路径的一部分，访问地址格式为http://localhost:端口/SECRET_OBFUSCATION_PATH/ui/
• 默认值：joaleeS8efie
• 限制：仅允许包含字母数字字符（不允许斜杠、反斜杠或其他非字母数字字符）

JOAL_SECRET_TOKEN

• 非必填但强烈建议自定义
• 说明：用于安全访问的密钥（类似于密码，建议设置复杂值）
• 默认值：eikoogei8yohphaph6eiza3EraaChav2jee8lood9iegaing

注意事项

• 此容器使用https://github.com/just-containers/s6-overlay%E6%9E%84%E5%BB%BA
• 容器入口点支持在每次启动时升级操作系统，添加-e AUTOUPGRADE=1即可启用此功能
• Helm chart可用，位于https://github.com/digrouz/docker-joal/tree/master/chart%EF%BC%8C%E5%B9%B6%E6%8F%90%E4%BE%9B%E7%A4%BA%E4%BE%8Bhttps://github.com/digrouz/docker-joal/tree/master/chart/values.yaml

问题反馈

如遇到问题，请在https://github.com/digrouz/docker-joal/issues%E6%8F%90%E4%BA%A4%E5%B7%A5%E5%8D%95%E3%80%82