samply/bridgehead-forward-proxy

镜像概述

本镜像为ubuntu/squid官方镜像的扩展版本，基于Ubuntu操作系统构建，提供功能增强的Squid代理服务器。继承了ubuntu/squid的核心代理功能，并包含额外的配置选项与优化，适用于需要定制化Squid部署的场景。

核心功能和特性

• 基础功能继承：完全兼容ubuntu/squid的标准功能，包括HTTP/HTTPS代理、Web缓存、访问控制列表（ACL）、带宽管理等。
• 扩展配置能力：支持自定义配置模板、增强日志格式、额外协议支持（如FTP代理）及第三方模块集成（具体扩展功能需参考镜像维护者文档）。
• 系统稳定性：基于Ubuntu操作系统，确保系统级稳定性、安全更新支持及广泛的软件兼容性。

使用场景和适用范围

• 企业内部网络代理服务器部署；
• Web缓存加速（减少重复资源下载，提升访问速度）；
• 内容过滤与访问控制（基于IP、用户或URL的访问限制）；
• 需要定制化Squid配置的复杂网络环境（如多网段代理、认证集成等）。

使用方法和配置说明

基本运行命令

bash
docker run -d \
  --name squid-extension \
  -p 3128:3128 \  # 默认代理端口映射
  -v /host/path/squid.conf:/etc/squid/squid.conf \  # 挂载自定义配置文件
  -v /host/path/cache:/var/spool/squid \  # 持久化缓存数据
  [镜像名称]

环境变量（示例）

根据扩展功能可能支持以下环境变量（具体以镜像文档为准）：

• SQUID_CACHE_SIZE：缓存目录大小，如"10GB"；
• LOG_LEVEL：日志级别，可选"info"（默认）、"debug"、"warn"；
• MAX_CLIENT_CONN：最大客户端连接数，如"1000"。

配置文件说明

Squid核心配置文件为/etc/squid/squid.conf，建议通过宿主机挂载自定义配置覆盖默认配置。配置项需符合Squid语法，例如：

conf
# 允许所有客户端访问
http_access allow all
# 设置缓存大小为10GB
cache_dir ufs /var/spool/squid 10000 16 256

数据持久化

• 缓存数据：默认存储路径为/var/spool/squid，通过-v挂载宿主机目录实现持久化，避免容器重启后缓存丢失。
• 日志文件：日志默认输出至/var/log/squid，可挂载该目录以持久化日志（需确保宿主机目录权限正确）。

docker-compose配置示例

yaml
version: '3'
services:
  squid:
    image: [镜像名称]
    ports:
      - "3128:3128"
    volumes:
      - ./squid.conf:/etc/squid/squid.conf:ro  # 只读挂载配置文件
      - ./cache:/var/spool/squid  # 缓存数据持久化
      - ./logs:/var/log/squid  # 日志持久化
    environment:
      - SQUID_CACHE_SIZE=10GB
      - LOG_LEVEL=info
    restart: unless-stopped

注：实际使用时请参考该扩展镜像的官方文档，以获取准确的配置选项、环境变量及扩展功能说明。