eexit/mirror-http-server

Mirror HTTP Server ![Firebase function]([***]

镜像概述和主要用途

Mirror HTTP Server 是一个虚拟HTTP服务器，旨在用于HTTP测试和API调试。通过向服务器发送包含特定请求头的HTTP请求，可灵活控制服务器的响应内容，包括状态码、响应头、延迟时间等。测试URL：<[***]>

核心功能和特性

• 支持任意HTTP方法（GET、POST、PUT等）、路径、请求体和请求头
• 通过X-Mirror-*系列请求头自定义响应行为：
  • X-Mirror-Code：指定响应状态码
  • X-Mirror-Delay：设置响应延迟时间（毫秒）
  • X-Mirror-Request：返回请求详情（JSON格式）
  • X-Mirror-Body：返回请求体内容
• 支持通过X-Mirror-前缀自定义任意响应头，覆盖默认响应头

使用场景和适用范围

• API客户端调试：验证请求方法、路径和参数处理
• HTTP状态码测试：模拟各类状态码（如301重定向、503服务不可用等）
• 超时和错误处理测试：通过延迟响应验证客户端超时机制
• 响应头配置测试：自定义响应头验证客户端处理逻辑

使用方法和配置说明

镜像拉取

bash
docker pull eexit/mirror-http-server

启动容器

bash
docker run -itp 8080:8080 eexit/mirror-http-server

启动后输出日志示例：

2015-11-05T20:59:57.353Z]  INFO: mirror-http-server/17 on ccc867df5980: Listening on http://0.0.0.0:8080

基本请求示例

使用HTTPie工具发送请求（也可使用curl等工具）：

bash
http :8080

响应示例：

http
HTTP/1.1 200 OK
Connection: keep-alive
Content-Length: 0
Date: Wed, 13 Mar 2019 12:38:07 GMT
X-Powered-By: Express

服务器行为控制请求头

X-Mirror-Code：自定义响应状态码

通过该头指定HTTP响应状态码，可配合其他X-Mirror-*头设置响应头。

示例：模拟301重定向并修改Content-Type

bash
http :8080 \
    X-Mirror-Code:301 \
    X-Mirror-Location:http://www.eexit.net \
    X-Mirror-Content-Type:"text/plain; charset=ISO-8859-1"

响应示例：

http
HTTP/1.1 301 Moved Permanently
Connection: keep-alive
Content-Length: 0
Content-Type: text/plain; charset=ISO-8859-1
Date: Wed, 13 Mar 2019 12:41:35 GMT
Location: http://www.eexit.net
X-Powered-By: Express

容器日志输出（JSON格式请求详情）：

json
[2019-03-13T12:41:35.567Z]  INFO: mirror-http-server/18 on f9c1a773d75a:
    request: {
      "ip": "172.17.0.1",
      "ips": [],
      "method": "GET",
      "url": "/",
      "headers": {
        "host": "localhost",
        "user-agent": "HTTPie/1.0.2",
        "accept-encoding": "gzip, deflate",
        "accept": "*/*",
        "connection": "keep-alive",
        "x-mirror-code": "301",
        "x-mirror-location": "http://www.eexit.net",
        "x-mirror-content-type": "text/plain; charset=ISO-8859-1"
      },
      "body": {}
    }

X-Mirror-Delay：设置响应延迟

指定服务器响应前的延迟时间（毫秒），用于测试超时处理。

示例：模拟503状态码并延迟2秒响应

bash
time http :8080 X-Mirror-Code:503 X-Mirror-Delay:2000

响应示例：

http
HTTP/1.1 503 Service Unavailable
Connection: keep-alive
Content-Length: 0
Date: Fri, 20 May 2022 09:52:04 GMT
Keep-Alive: timeout=5
X-Powered-By: Express

命令执行时间输出（约2秒）：

http :8080 X-Mirror-Code:503 X-Mirror-Delay:2000  0.12s user 0.03s system 7% cpu 2.163 total

X-Mirror-Request：返回请求详情

设置该头为true时，服务器将以JSON格式返回请求的详细信息（包含IP、方法、URL、 headers和body）。

示例：POST请求并返回请求详情

bash
http POST :80/resource \
    X-Mirror-Code:201 \
    X-Mirror-Request:true \
    key1=value1 key2=value2

响应示例：

http
HTTP/1.1 201 Created
Connection: keep-alive
Content-Length: 371
Content-Type: application/json; charset=utf-8
Date: Wed, 13 Mar 2019 12:43:02 GMT
ETag: W/"173-rgXpQ/N7aKeAq+URc1y3vQypNZk"
X-Powered-By: Express

{
    "request": {
        "body": {
            "key1": "value1",
            "key2": "value2"
        },
        "headers": {
            "accept": "application/json, */*",
            "accept-encoding": "gzip, deflate",
            "connection": "keep-alive",
            "content-length": "36",
            "content-type": "application/json",
            "host": "localhost",
            "user-agent": "HTTPie/1.0.2",
            "x-mirror-code": "201",
            "x-mirror-request": "true"
        },
        "ip": "172.17.0.1",
        "ips": [],
        "method": "POST",
        "url": "/resource"
    }
}

注意：仅当值为true时生效，其他值将被忽略。

X-Mirror-Body：返回请求体

设置该头为true时，服务器将返回请求体内容。若同时设置X-Mirror-Request，则X-Mirror-Request优先。

示例：PUT请求并返回请求体

bash
http PUT :80/resource \
    X-Mirror-Code:400 \
    X-Mirror-Body:true \
    key1=value1 key2=value2

响应示例：

http
HTTP/1.1 400 Bad Request
Connection: keep-alive
Content-Length: 33
Content-Type: application/json; charset=utf-8
Date: Wed, 13 Mar 2019 12:43:45 GMT
ETag: W/"21-SWsq4vawbQc/koBuf3CC1L6ssws"
X-Powered-By: Express

{
    "key1": "value1",
    "key2": "value2"
}

注意：仅当值为true时生效，其他值将被忽略。

自定义响应头

通过X-Mirror-前缀可自定义任意响应头，覆盖默认响应头。

示例：自定义Content-Type和X-Powered-By 请求头：

http
Content-Type: application/json
X-Mirror-Content-Type: text/html
X-Mirror-X-Powered-By: eexit-engine
X-Mirror-Date: some date

响应头：

http
Content-Type: text/html
X-Powered-By: eexit-engine
Date: some date