ealen/echo-server

Echo-Server / Docker / Kubernetes / Helm

![Codecov]([] ![CodeFactor Grade]([]

文档地址 : https://ealenn.github.io/Echo-Server

回显服务器（Echo Server）是一种能够复制客户端发送的请求并将其返回的服务器。

支持的架构：

![]([] ![]([] ![]([] ![]([] ![]([] ![]([]

• 支持GET / POST / PUT / PATCH / DELETE等HTTP方法
• 可返回请求信息（查询参数、请求体、IP、主机、URL等）
• 支持请求头/响应头展示
• 环境变量展示
• 通过请求头/查询参数控制响应
• 文件夹和文件浏览
• 监控功能

!https://ealenn.github.io/Echo-Server/assets/images/docker.png

配置

使用Echo-Server

!https://ealenn.github.io/Echo-Server/assets/images/curl.png

建议使用https://stedolan.github.io/jq%E5%B7%A5%E5%85%B7%E7%BE%8E%E5%8C%96%60curl%60%E5%91%BD%E4%BB%A4%E7%9A%84%E8%BE%93%E5%87%BA%E7%BB%93%E6%9E%9C%E3%80%82

自定义响应

自定义HTTP状态码

bash
➜ curl -I --header 'X-ECHO-CODE: 404' localhost:8080
➜ curl -I localhost:8080/?echo_code=404

HTTP/1.1 404 Not Found

bash
➜ curl -I --header 'X-ECHO-CODE: 404-300' localhost:8080
➜ curl -I localhost:8080/?echo_code=404-300

HTTP/1.1 404 Not Found
HTTP/1.1 300 Multiple Choices

bash
➜ for i in {1..10}
➜ do
➜    curl -I localhost:8080/?echo_code=200-400-500
➜ done

HTTP/1.1 500 Internal Server Error
HTTP/1.1 400 Bad Request
HTTP/1.1 200 OK
HTTP/1.1 500 Internal Server Error
HTTP/1.1 200 OK
HTTP/1.1 500 Internal Server Error

自定义响应体

bash
➜ curl --header 'X-ECHO-BODY: amazing' localhost:8080
➜ curl localhost:8080/?echo_body=amazing

"amazing"

使用环境变量值作为响应体

bash
➜ curl --header 'X-ECHO-ENV-BODY: HOSTNAME' localhost:8080
➜ curl localhost:8080/?echo_env_body=HOSTNAME

"c53a9ed79fa2"

bash
➜ for i in {1..10}
➜ do
➜    curl localhost:8080/?echo_env_body=HOSTNAME
➜ done

"c53a9ed79fa2"
"f10c3af61e40"
"c53a9ed79fa2"
"f10c3af61e40"
"c53a9ed79fa2"

自定义响应头

bash
➜ curl --header 'X-ECHO-HEADER: One:1' localhost:8080
➜ curl localhost:8080/?echo_header=One:1

HTTP/1.1 200 OK
One: 1

bash
➜ curl --header 'X-ECHO-HEADER: One:1, Two:2' localhost:8080
➜ curl "localhost:8080/?echo_header=One:1,%20Two:2"

HTTP/1.1 200 OK
One: 1
Two: 2

自定义响应延迟

bash
➜ curl --header 'X-ECHO-TIME: 5000' localhost:8080
➜ curl "localhost:8080/?echo_time=5000"

⏳... 5000 ms

可通过以下参数修改延迟时间的默认限制：

(延迟时间单位为毫秒)

文件/目录浏览

bash
➜ curl --header 'X-ECHO-FILE: /' localhost:8080
➜ curl "localhost:8080/?echo_file=/"

["app", "bin", "etc", "usr", "var"]

组合自定义操作

bash
➜ curl --header 'X-ECHO-CODE: 401' --header 'X-ECHO-BODY: Oups' localhost:8080
➜ curl "localhost:8080/?echo_body=Oups&echo_code=401"

HTTP/1.1 401 Unauthorized
"Oups"

修改默认查询参数/请求命令

https://ealenn.github.io/Echo-Server/pages/configuration/commands.html

日志配置

https://ealenn.github.io/Echo-Server/pages/configuration/loggers.html

日志格式

Seq日志

https://github.com/Ealenn/Echo-Server/tree/master/docker-compose - https://ealenn.github.io/Echo-Server/pages/quick-start/docker-compose.html

ELK日志

https://github.com/Ealenn/Echo-Server/tree/master/docker-compose - https://ealenn.github.io/Echo-Server/pages/quick-start/docker-compose.html

部署指南

Docker

https://ealenn.github.io/Echo-Server/pages/quick-start/docker.html

bash
docker run -p 8080:80 ealen/echo-server

Docker Compose

https://ealenn.github.io/Echo-Server/pages/quick-start/docker-compose.html

基础示例

yaml
version: "3"
services:
  echo-server:
    image: ealen/echo-server
    ports:
      - 8080:80

结合Seq日志

yaml
version: "3"
services:
  echo:
    image: ealen/echo-server
    environment: 
      PORT: 80
      LOGS__SEQ__ENABLED: "true"
      LOGS__SEQ__SERVER: "http://seq:5341"
    ports: 
      - 8080:80

  seq:
    image: datalust/seq
    environment: 
      ACCEPT_EULA: "Y"
    ports:
      - 3010:80

Kubernetes

https://ealenn.github.io/Echo-Server/pages/quick-start/kubernetes.html

bash
curl -sL https://raw.githubusercontent.com/Ealenn/Echo-Server/master/docs/examples/echo.kube.yaml | kubectl apply -f -

Kubernetes with Helm

https://ealenn.github.io/Echo-Server/pages/quick-start/helm.html - Artifact Hub

bash
helm repo add ealenn https://ealenn.github.io/charts
helm repo update
helm install --set ingress.enable=true --name echoserver ealenn/echo-server

NodeJS

https://ealenn.github.io/Echo-Server/pages/quick-start/nodejs

bash
# 安装依赖
npm ci
# 使用node运行
node ./src/webserver --port 8080
# 使用npm脚本运行
PORT=8080 npm run start

---

版本控制

本项目采用SemVer进行版本控制。有关可用版本，请参见https://github.com/Ealenn/Echo-Server/releases%E3%80%82

许可证

本项目采用GNU Lesser General Public License许可 - 详情请参见https://github.com/Ealenn/Echo-Server/blob/master/LICENSE.txt%E6%96%87%E4%BB%B6%E3%80%82