ukwa/solr-proxy

solr-proxy

镜像概述

solr-proxy是一个基于NGINX的轻量级代理配置，旨在控制对SOLR API的访问权限。该镜像基于开源项目https://github.com/o19s/solr_nginx%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%8F%90%E4%BE%9B%E5%9F%BA%E7%A1%80%E7%9A%84SOLR%E6%9C%8D%E5%8A%A1%E8%AE%BF%E9%97%AE%E6%8E%A7%E5%88%B6%E8%83%BD%E5%8A%9B%E3%80%82

核心功能与特性

• 请求类型限制：默认配置仅允许GET请求访问SOLR API，有效阻止POST、PUT、DELETE等可能修改数据的请求
• 轻量级实现：基于标准NGINX构建，配置简单，资源占用低
• 扩展性：提供实验性OpenResty版本（需额外配置），支持更复杂的POST请求过滤功能，但配置复杂度较高

使用场景

• 保护SOLR服务免受非授权写操作，适用于公开或半公开环境中的SOLR部署
• 作为SOLR服务的前置代理，控制客户端对API的访问方式
• 适用于对SOLR访问控制有基础需求，且希望保持配置简单的场景

使用方法

基本部署

使用以下命令启动solr-proxy容器，将代理服务暴露在本地8080端口，并指向后端SOLR服务：

bash
docker run -d -p 8080:80 --name solr-proxy \
  --link solr:backend \
  solr-proxy

配置说明

环境变量

自定义配置

如需修改代理规则，可通过挂载自定义NGINX配置文件覆盖默认配置：

bash
docker run -d -p 8080:80 --name solr-proxy \
  -v /path/to/your/nginx.conf:/etc/nginx/nginx.conf \
  --link solr:backend \
  solr-proxy

docker-compose示例

yaml
version: '3'
services:
  solr:
    image: solr:latest
    ports:
      - "8983:8983"
    volumes:
      - solr-data:/var/solr

  solr-proxy:
    image: solr-proxy
    ports:
      - "8080:80"
    environment:
      - SOLR_BACKEND_HOST=solr
      - SOLR_BACKEND_PORT=8983
    depends_on:
      - solr

volumes:
  solr-data:

验证访问控制

启动后可通过以下命令验证GET请求是否被允许，非GET请求是否被拒绝：

bash
# 测试GET请求（应成功）
curl http://localhost:8080/solr/admin/info/system

# 测试POST请求（应被拒绝）
curl -X POST http://localhost:8080/solr/update -d '{}'

注意事项

• 实验性OpenResty版本需单独构建，具体方法参见https://github.com/o19s/solr_nginx%E9%A1%B9%E7%9B%AE%E6%96%87%E6%A1%A3
• 生产环境中建议结合其他安全措施（如IP白名单、认证机制）使用
• 默认配置仅限制请求方法，不提供身份验证功能，需根据实际需求扩展