{ "componentChunkName": "component---src-templates-issues-tsx", "path": "/issues/146", "result": {"data":{"issuesJson":{"id":"fd3e4243-3016-556d-9b76-66ceee61a4cb","title":"Ealenn/Echo-Server: 一个简便的请求调试工具。通过请求参数，配置返回的内容。","number":146,"bodyHTML":"
\n



\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ReposEalenn/Echo-Server
Views\"views\"
Stars\"stars\"
Forks\"forks\"
License\"license\"
UpdatedAt\"last-commit\"
CreatedAt\"create-at\"
\n\n

\"\"

\n\n
\n

Echo-Server / Docker / Kubernetes / Helm

\n

\"Codecov\"
\n\"CodeFactor
\n\"GitHub
\n\"GitHub
\n\"DockerHub\"
\n\"DockerHub\"

\n
\n

Read the docs : https://ealenn.github.io/Echo-Server

\n
\n

An echo server is a server that replicates the request sent by the client and sends it back.

\n

Available:

\n

\"\"
\n\"\"
\n\"\"
\n\"\"
\n\"\"
\n\"\"

\n\n

\"docker\"

\n

Table of contents

\n\n\n\n\n

Configuration

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
EnvironmentHelmCLIDefault
PORTservice.port--port80
LOGS__IGNORE__PINGapplication.logs.ignore.ping--logs:ignore:pingfalse
ENABLE__HOSTapplication.enable.host--enable:hosttrue
ENABLE__HTTPapplication.enable.http--enable:httptrue
ENABLE__REQUESTapplication.enable.request--enable:requesttrue
ENABLE__COOKIESapplication.enable.cookies--enable:cookiestrue
ENABLE__HEADERapplication.enable.header--enable:headertrue
ENABLE__ENVIRONMENTapplication.enable.environment--enable:environmenttrue
ENABLE__FILEapplication.enable.file--enable:filetrue
\n

Use Echo-Server

\n

\"curl\"

\n

I use jq for nice curl results ;)

\n

Custom responses

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
QueryHeaderContentConditions
?echo_code=X-ECHO-CODEHTTP code 200, 404200 <= CODE <= 599
404-401 or 200-500-301
?echo_body=X-ECHO-BODYBody message
?echo_env_body=X-ECHO-ENV-BODYThe key of environment variableEnable environment true
?echo_header=X-ECHO-HEADERResponse Header Lang: en-USEnable header true
?echo_time=X-ECHO-TIMEWait time in ms0 <= TIME <= 30.000
?echo_file=X-ECHO-FILEPath of Directory or FileEnable file true
\n

Custom HTTP Status Code

\n
➜ curl -I --header 'X-ECHO-CODE: 404' localhost:8080\n➜ curl -I localhost:8080/?echo_code=404\n\nHTTP/1.1 404 Not Found
\n
➜ curl -I --header 'X-ECHO-CODE: 404-300' localhost:8080\n➜ curl -I localhost:8080/?echo_code=404-300\n\nHTTP/1.1 404 Not Found\nHTTP/1.1 300 Multiple Choices
\n
➜ for i in {1..10}\n➜ do\n➜    curl -I localhost:8080/?echo_code=200-400-500\n➜ done\n\nHTTP/1.1 500 Internal Server Error\nHTTP/1.1 400 Bad Request\nHTTP/1.1 200 OK\nHTTP/1.1 500 Internal Server Error\nHTTP/1.1 200 OK\nHTTP/1.1 500 Internal Server Error
\n

Custom Body

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

Custom Body with Environment variable value

\n
➜ curl --header 'X-ECHO-ENV-BODY: HOSTNAME' localhost:8080\n➜ curl localhost:8080/?echo_env_body=HOSTNAME\n\n\"c53a9ed79fa2\"
\n
➜ for i in {1..10}\n➜ do\n➜    curl localhost:8080/?echo_env_body=HOSTNAME\n➜ done\n\n\"c53a9ed79fa2\"\n\"f10c3af61e40\"\n\"c53a9ed79fa2\"\n\"f10c3af61e40\"\n\"c53a9ed79fa2\"
\n

Custom Headers

\n
➜ curl --header 'X-ECHO-HEADER: One:1' localhost:8080\n➜ curl localhost:8080/?echo_header=One:1\n\nHTTP/1.1 200 OK\nOne: 1
\n
➜ curl --header 'X-ECHO-HEADER: One:1, Two:2' localhost:8080\n➜ curl \"localhost:8080/?echo_header=One:1,%20Two:2\"\n\nHTTP/1.1 200 OK\nOne: 1\nTwo: 2
\n

Custom response latency

\n
➜ curl --header 'X-ECHO-TIME: 5000' localhost:8080\n➜ curl \"localhost:8080/?echo_time=5000\"\n\n⏳... 5000 ms
\n

You can change default validations with

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ENVIRONMENTCLIDefault
CONTROLS__TIMES__MIN--controls:times:min0
CONTROLS__TIMES__MAX--controls:times:max60000
\n

(Latency is defined in milliseconds)

\n

File/Folder explorer

\n
➜ curl --header 'X-ECHO-FILE: /' localhost:8080\n➜ curl \"localhost:8080/?echo_file=/\"\n\n[\"app\", \"bin\", \"etc\", \"usr\", \"var\"]
\n

Combine custom actions

\n
➜ curl --header 'X-ECHO-CODE: 401' --header 'X-ECHO-BODY: Oups' localhost:8080\n➜ curl \"localhost:8080/?echo_body=Oups&echo_code=401\"\n\nHTTP/1.1 401 Unauthorized\n\"Oups\"
\n

Change default Queries/Request commands

\n

Read the docs

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
EnvironmentCLIDefault
COMMANDS__HTTPBODY__QUERY--commands:httpBody:queryecho_body
COMMANDS__HTTPBODY__HEADER--commands:httpBody:headerx-echo-body
COMMANDS__HTTPENVBODY__QUERY--commands:httpEnvBody:queryecho_env_body
COMMANDS__HTTPENVBODY__HEADER--commands:httpEnvBody:headerx-echo-env-body
COMMANDS__HTTPCODE__QUERY--commands:httpCode:queryecho_code
COMMANDS__HTTPCODE__HEADER--commands:httpCode:headerx-echo-code
COMMANDS__HTTPHEADERS__QUERY--commands:httpHeaders:queryecho_header
COMMANDS__HTTPHEADERS__HEADER--commands:httpHeaders:headerx-echo-header
COMMANDS__TIME__QUERY--commands:time:queryecho_time
COMMANDS__TIME__HEADER--commands:time:headerx-echo-time
COMMANDS__FILE__QUERY--commands:file:queryecho_file
COMMANDS__FILE__HEADER--commands:file:headerx-echo-file
\n

Loggers

\n

Read the docs

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
EnvironmentCLIDefault
LOGS__APP--logs:appecho-server
LOGS__LEVEL--logs:leveldebug
LOGS__FORMAT--logs:formatdefault
\n

Format

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
LOG FORMATDESCRIPTION
defaultCombine line & object
lineSimple `Fri, 22 Jan 2021 10:45:20 GMT
objectJSON { \"host\": {}, http: {}, request: {}}
\n

Seq

\n

Full example - Documentation

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
EnvironmentCLIDefault
LOGS__SEQ__ENABLED--logs:seq:enabledfalse
LOGS__SEQ__SERVER--logs:seq:server
LOGS__SEQ__KEY--logs:seq:key
LOGS__SEQ__LEVEL--logs:seq:levelinfo
\n

ELK

\n

Full example - Documentation

\n

Setting up

\n

Docker

\n

Read the docs

\n
docker run -p 8080:80 ealen/echo-server
\n

Docker-Compose

\n

Read the docs

\n

Sample

\n
version: \"3\"\nservices:\n  echo-server:\n    image: ealen/echo-server\n    ports:\n      - 8080:80
\n

With Seq

\n
version: \"3\"\nservices:\n  echo:\n    image: ealen/echo-server\n    environment: \n      PORT: 80\n      LOGS__SEQ__ENABLED: \"true\"\n      LOGS__SEQ__SERVER: \"http://seq:5341\"\n    ports: \n      - 8080:80\n\n  seq:\n    image: datalust/seq\n    environment: \n      ACCEPT_EULA: \"Y\"\n    ports:\n      - 3010:80
\n

Kubernetes

\n

Read the docs

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

Kubernetes with Helm

\n

Read the docs - Artifact Hub

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

NodeJS

\n

Read the docs

\n
# Dependencies\nnpm ci\n# Run with node\nnode ./src/webserver --port 8080\n# Run with npm script\nPORT=8080 npm run start
\n
\n

Contributing

\n

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

\n

Versioning

\n

We use SemVer for versioning.
\nFor the versions available, see the tags on this repository.

\n

License

\n

This project is licensed under the GNU Lesser General Public License - see the LICENSE.txt file for details.

\n
\n

Development

\n

Documentation

\n

Docker-Compose is available on ./docs folder.

\n
docker compose up -d
\n

The documentation is here localhost:4000

\n

Tests

\n
npm ci\n# Without code coverage\nnpm run test\n# With code coverage\nnpm run test-with-coverage
\n

Release notes

\n
git log --pretty=oneline
\n

Update Helm Chart

\n

=> https://github.com/Ealenn/charts/tree/master/charts/echo-server

","updatedAt":"2025-05-21T15:56:21Z","upvoteCount":null,"author":{"login":"eryajf","avatarUrl":"https://avatars.githubusercontent.com/u/33259379?u=e4a4090a38ac2473aaed4ef9945233636776c6c3&v=4","url":"https://github.com/eryajf"},"category":null,"labels":{"edges":[{"node":{"name":"更多","color":"25B472"}},{"node":{"name":"Dev-Tools","color":"48310b"}},{"node":{"name":"Ealenn","color":"f6380c"}}]},"comments":{"edges":[]}}},"pageContext":{"number":146,"previous":{"title":"danger-dream/ebpf-firewall: 基于 eBPF 技术的高性能网络防火墙系统，具有实时入站流量监控、规则过滤和黑名单管理等功能。","number":145},"next":{"title":"Duke1616/ecmdb: 一个现代化思路开发的 CMDB 和工单系统，功能还在早期开发中。","number":147}}}, "staticQueryHashes": ["151096407","2861350382"]}