Scrutiny项目反向代理配置指南

Scrutiny项目反向代理配置指南

scrutiny Hard Drive S.M.A.R.T Monitoring, Historical Trends & Real World Failure Thresholds 项目地址: https://gitcode.com/gh_mirrors/sc/scrutiny

前言

Scrutiny是一款优秀的硬盘健康监控工具，在实际部署时，我们经常需要通过反向代理来提供更灵活的访问方式和安全保护。本文将详细介绍如何为Scrutiny配置反向代理，涵盖不同场景下的配置方法。

反向代理基础概念

反向代理是位于用户与后端服务之间的中间层，它可以提供负载均衡、SSL终止、路径重写等功能。对于Scrutiny来说，配置反向代理主要有三种方式：

1. 基于域名的路由（如http://scrutiny.example.com）
2. 基于端口的路由（如http://localhost:54321）
3. 基于路径的路由（如http://example.com/scrutiny/）

前两种方式配置较为简单，而基于路径的路由需要额外配置。

基础配置

Scrutiny默认监听配置如下：

web:
  listen:
    port: 8080  # 服务监听端口
    host: 0.0.0.0  # 监听所有网络接口

对于简单的域名或端口路由，只需在反向代理中将请求转发到Scrutiny的后端地址（默认是0.0.0.0:8080）即可。

路径路由配置

当需要通过子路径访问Scrutiny时（如http://example.com/scrutiny/），需要修改两个关键配置：

1. Web服务器基础路径配置

在Scrutiny的web配置中设置web.listen.basepath：

web:
  listen:
    port: 8080
    host: 0.0.0.0
    basepath: '/custombasepath'  # 必须以斜杠开头

这个配置告诉Scrutiny所有请求都应该在指定基础路径下处理。

2. 收集器API端点配置

收集器需要知道如何访问Web界面，因此需要更新API端点：

api:
  endpoint: 'http://localhost:8080/custombasepath'

注意：这两个配置中的路径必须一致。

环境变量配置

除了配置文件，也可以通过环境变量设置：

COLLECTOR_API_ENDPOINT=http://localhost:8080/custombasepath
SCRUTINY_WEB_LISTEN_BASEPATH=/custombasepath

实际配置示例

使用Caddy作为反向代理

1. 创建Caddyfile配置文件：

:9090
reverse_proxy /custom/* scrutiny:8080

2. 创建docker-compose.yml文件：

version: '3.5'
services:
  scrutiny:
    image: scrutiny:latest
    environment:
      - SCRUTINY_WEB_LISTEN_BASEPATH=/custom
      - COLLECTOR_API_ENDPOINT=http://localhost:8080/custom
    # 其他配置...
  caddy:
    image: caddy
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
    ports:
      - "9090:9090"

3. 启动服务后，可通过http://localhost:9090/custom/web访问

使用Traefik作为反向代理

version: '3.5'
services:
  scrutiny:
    image: scrutiny:latest
    labels:
      - traefik.enable=true
      - traefik.http.routers.scrutiny.rule=Host(`example.com`)
      - traefik.http.services.scrutiny.loadbalancer.server.port=8080
      # 可选的基础认证配置
      - traefik.http.routers.scrutiny.middlewares=auth
      - "traefik.http.middlewares.auth.basicauth.users=user:加密密码"
    # 其他配置...

常见问题解决

1. 404错误：确保基础路径配置一致，且以斜杠开头
2. API连接失败：检查收集器配置的API端点是否正确
3. 静态资源加载失败：确认反向代理正确处理了路径重写

最佳实践建议

1. 生产环境建议启用HTTPS
2. 考虑添加基础认证等安全措施
3. 测试时先使用简单配置，确认基础功能正常后再添加复杂路由

通过以上配置，您可以在各种反向代理环境下灵活部署Scrutiny，满足不同的网络架构需求。

scrutiny Hard Drive S.M.A.R.T Monitoring, Historical Trends & Real World Failure Thresholds 项目地址: https://gitcode.com/gh_mirrors/sc/scrutiny