cogstacksystems/medcat-trainer-nginx

MedCAT Trainer NGINX镜像

镜像概述

MedCAT Trainer NGINX镜像是为MedCAT Trainer应用提供Web服务支持的官方镜像。MedCAT Trainer是一个用于构建、改进和定制生物医学领域文本命名实体识别与链接（NER+L）模型（MedCAT）的界面工具。本NGINX镜像主要负责处理HTTP请求、反向代理至应用服务器以及托管静态资源，确保MedCAT Trainer应用的稳定访问和高效运行。

核心功能与特性

• 反向代理：将客户端请求转发至MedCAT Trainer应用服务器（如Django后端），实现前后端分离架构
• 静态资源服务：托管应用所需的CSS、JavaScript、图片等静态资源，提升加载速度
• 端口映射：支持自定义端口配置，灵活适配不同部署环境
• 配置灵活性：支持通过环境变量或挂载配置文件自定义NGINX行为
• 兼容性：与MedCAT Trainer的Docker Compose部署方案无缝集成

使用场景

• MedCAT Trainer应用的开发环境部署
• 生产环境中为MedCAT Trainer提供稳定的Web服务支持
• 需要通过NGINX实现负载均衡或SSL终止的多实例部署场景

使用方法

基本使用（Docker Run）

bash
docker run -d \
  --name medcattrainer-nginx \
  -p 80:80 \
  -v /path/to/nginx.conf:/etc/nginx/nginx.conf \
  -v /path/to/static:/usr/share/nginx/html \
  --link medcattrainer-app:app \
  cogstack/medcattrainer-nginx

Docker Compose配置示例

yaml
version: '3'

services:
  nginx:
    image: cogstack/medcattrainer-nginx
    ports:
      - "8001:80"  # 映射至主机8001端口，对应MedCAT Trainer默认访问端口
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
      - ./static:/usr/share/nginx/html:ro
    depends_on:
      - app
    restart: always

  app:
    image: cogstack/medcattrainer-app
    # 应用服务配置...

配置参数说明

环境变量

配置文件挂载

推荐通过挂载自定义nginx.conf文件进行高级配置，示例配置片段：

nginx
server {
    listen ${NGINX_PORT};
    server_name localhost;

    location /static/ {
        alias /usr/share/nginx/html/;
        expires 1d;
    }

    location / {
        proxy_pass http://${APP_HOST}:${APP_PORT};
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

注意事项

• 确保应用服务器（如Django后端）与NGINX容器网络互通（可通过--link或Docker Compose网络实现）
• 生产环境中建议配置SSL/TLS证书，可通过挂载证书文件并修改NGINX配置实现
• 静态资源需提前构建并挂载至/usr/share/nginx/html目录
• 若部署在反向代理（RP）后，需设置BEHIND_RP=1环境变量（通过应用服务器传递）

相关链接

• https://github.com/CogStack/MedCATtrainer
• https://github.com/CogStack/MedCAT