grichner/cntlm-tst

cntlm Docker镜像文档

镜像概述

本镜像为cntlm代理认证工具提供Docker化部署，基于opensuse/tumbleweed:latest构建，主要支持amd64架构，arm64/amd64架构需手动构建。cntlm是一款轻量级代理认证工具，可处理NTLM、NTLMv2、LM等认证协议，适用于客户端与代理服务器间的认证中介场景。

核心功能与特性

• 代理认证支持：兼容NTLM、NTLMv2、LM等多种认证协议，满足主流代理服务器认证需求
• 轻量级部署：基于opensuse/tumbleweed:latest，镜像体积小，资源占用低
• 灵活配置：支持通过挂载本地配置文件自定义代理参数、认证信息等
• 多架构兼容：基础支持amd64，arm64/amd64可通过手动构建扩展支持

使用场景与适用范围

• 企业网络环境中，客户端需通过NTLM等认证代理访问外部网络的场景
• 需要集中管理代理认证配置的多容器部署环境
• Swarm/Kubernetes等容器编排平台中的代理认证服务部署

使用方法与配置说明

构建镜像

通过本地Dockerfile构建镜像（需提前准备Dockerfile）：

bash
docker build --tag cntlm .

创建配置文件

生成或编辑cntlm配置文件（通常命名为cntlm.conf），包含代理服务器地址、端口、认证凭据等关键配置。可通过临时容器交互生成基础配置：

bash
docker run -it --rm cntlm

根据交互提示完成基础配置后，将配置内容保存至本地文件（如/etc/cntlm/config.conf）。

运行容器

基础运行命令

通过docker run启动容器，挂载本地配置文件并映射端口：

bash
docker run -d -p 3128:3128 -v /etc/cntlm/config.conf:/cntlm.conf grichner/cntlm-tst:latest

• -d：后台运行容器
• -p 3128:3128：映射容器3128端口（默认代理端口）至主机3128端口
• -v /etc/cntlm/config.conf:/cntlm.conf：挂载本地配置文件至容器内/cntlm.conf路径

Swarm集群部署

通过docker-compose.yml配置Swarm服务（适用于集群环境）：

yaml
version: '3.9'

networks:
  default:
    driver: overlay
    driver_opts:
      encrypted: "true"  # 启用网络加密（需确保内核/网络支持）

services:
  cntlm:
    user: '0'  # 使用root用户运行（根据实际需求调整）
    # ports:
    #   - '3128'  # 如需集群内独占使用，可省略端口暴露
    volumes:
      - '/data/swarm_persist_mem/.cntlm/cntlm.conf:/etc/cntlm.conf'  # 挂载持久化配置文件
    image: grichner/cntlm-tst
    
    deploy:
      # placement: 
      #   constraints:
      #     - node.hostname==DNS.name.here  # 可选：指定部署节点
      replicas: 1  # 部署1个副本
      update_config:
        parallelism: 1  # 每次更新1个实例
        delay: 10s  # 更新间隔10秒
        order: start-first  # 先启动新实例再停止旧实例
      resources:
        limits:
          memory: 128M  # 内存上限128M
        reservations:
          memory: 64M  # 内存预留64M

部署命令：

bash
docker stack deploy -c docker-compose.yml cntlm-stack

配置文件说明

配置文件需包含以下关键参数（示例）：

ini
Username    your_username    # 代理认证用户名
Domain      your_domain      # 域名（如适用）
Password    your_password    # 认证密码（建议使用哈希，通过`cntlm -H`生成）
Proxy       proxy.server.com:8080  # 代理服务器地址:端口
NoProxy     localhost, 127.0.0.*  # 无需代理的地址
Listen      3128             # 本地监听端口

详细配置参数可参考cntlm官方文档。

注意事项

• 配置文件权限：确保挂载的本地配置文件权限正确，避免容器内无法读取
• 网络加密：Swarm配置中encrypted: "true"需内核支持overlay网络加密，不支持时可移除该配置
• 资源限制：根据实际负载调整resources中的内存限制，避免资源不足或浪费