yzob/xyna-modeller

镜像概述

本镜像基于官方 nginx:mainline-alpine 构建，集成了 Xyna Factory Modeller，主要用于提供 Modeller 服务，并通过环境变量配置 NGINX 及转发至 Xyna Factory Server 的 GuiHttp 触发器。

核心功能与特性

• 基于轻量级 NGINX (mainline-alpine 版本)，资源占用低
• 集成 Xyna Factory Modeller，可直接提供 Modeller 服务
• 支持通过环境变量灵活配置 NGINX 转发规则及相关参数
• 提供 Cookie 标志配置功能，适配不同部署环境（如 HTTPS 后端）
• 可自定义 DNS 解析器，确保转发目标域名正确解析

使用场景

适用于需要部署 Xyna Factory Modeller 的环境，特别是需要通过 NGINX 进行反向代理、配置 GuiHttp 触发器转发及 Cookie 安全策略的场景。

使用方法与配置说明

环境变量配置

通过以下环境变量配置 NGINX 及转发至 GuiHttp 触发器：

MODELLER_PORT=8000
MODELLER_HOSTNAME="xyna"
GUIHTTP_URL="http://127.0.0.1:4245"
GUIHTTP_COOKIE_FLAGS="off"
RESOLVER="127.0.0.11"

环境变量说明

• MODELLER_PORT: Modeller 服务监听端口，默认 8000
• MODELLER_HOSTNAME: Modeller 主机名，默认 "xyna"
• GUIHTTP_URL: 转发至 Xyna Factory Server 的 GuiHttp 触发器 URL，必须不以斜杠 / 结尾
• GUIHTTP_COOKIE_FLAGS: 用于添加或移除 Cookie 头属性，参考 NGINX proxy_cookie_flags。若容器运行在 HTTPS 后端，可使用 "~ secure httponly" 添加安全标志
• RESOLVER: 用于解析 GUIHTTP_URL 的 DNS 服务器，默认 "127.0.0.11"（Docker 内置 DNS）

部署示例

Docker Run 命令示例

bash
docker run -d \
  -p 8000:8000 \
  -e MODELLER_PORT=8000 \
  -e MODELLER_HOSTNAME="xyna-modeller" \
  -e GUIHTTP_URL="http://xyna-server:4245" \
  -e GUIHTTP_COOKIE_FLAGS="~ secure httponly" \
  -e RESOLVER="127.0.0.11" \
  --name xyna-modeller-nginx \
  [镜像名称]

注意事项

• 确保 GUIHTTP_URL 配置正确且不以斜杠结尾
• 根据部署环境（如是否使用 HTTPS）调整 GUIHTTP_COOKIE_FLAGS 以增强安全性
• 若 GUIHTTP_URL 中的主机名需要动态解析，确保 RESOLVER 配置正确的 DNS 服务器