https://github.com/jiacai2050/edgebin
Edgebin is a minimalist HTTP utility designed to test your networking stack.
https://github.com/jiacai2050/edgebin
cloudflare cloudflare-workers httpbin restapi worker
Last synced: 3 months ago
JSON representation
Edgebin is a minimalist HTTP utility designed to test your networking stack.
- Host: GitHub
- URL: https://github.com/jiacai2050/edgebin
- Owner: jiacai2050
- License: mit
- Created: 2025-10-04T06:38:20.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-10-06T08:47:15.000Z (3 months ago)
- Last Synced: 2025-10-06T10:12:15.095Z (3 months ago)
- Topics: cloudflare, cloudflare-workers, httpbin, restapi, worker
- Language: JavaScript
- Homepage: https://edgebin.liujiacai.net/
- Size: 99.6 KB
- Stars: 6
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## [Edgebin](https://github.com/jiacai2050/edgebin)
[Edgebin](https://edgebin.liujiacai.net) is a HTTP testing service, with a focus on edge deployment.
Inspired by the [httpbin.org](https://httpbin.org), it leverages the power of edge computing (Cloudflare Workers) to deliver fast, reliable testing capabilities tailored for modern distributed networks.
## Features
Supports most of the endpoints from the original [httpbin.org](https://httpbin.org), including:
- HTTP methods
- Authentication
- Request inspection
- Response inspection
- Dynamic data
- Status codes
- Redirects
- Cookies
- Cache
- Anything
All endpoints accept any HTTP method. Additionally, it includes features not found in the original httpbin:
- [/ip](https://edgebin.liujiacai.net/ip) returns the requester's IP address along with geolocation information such as country, region, city, ASN, and more.
```json
{
"origin": "2408:8240:e10:947c:2806:6bb2:c222:343c",
"continent": "AS",
"latitude": "30.29365",
"longitude": "120.16142",
"country": "CN",
"region": "Zhejiang",
"regionCode": "ZJ",
"city": "Hangzhou",
"postalCode": "310000",
"timezone": "Asia/Shanghai",
"asn": 4837,
"asOrganization": "China Unicom",
"colo": "LAX"
}
```
- `/ws` echoes back any message sent to it over a WebSocket connection. You can test it using [wscat](https://github.com/websockets/wscat):
```bash
wscat -c wss://edgebin.liujiacai.net/ws
```
- [/qrcode](https://edgebin.liujiacai.net/qrcode?text=https://edgebin.liujiacai.net) generates QR codes(svg) for any text or URL. Use query parameters to [customize](https://github.com/soldair/node-qrcode#renderers-options) the output:
- `text`: The text or URL to encode (required)
- `errorCorrectionLevel`: Error correction level, one of `L`, `M`, `Q`, `H`. Default is `H`.
- `width`: Width of the QR code in pixels. Default is `350`.
- `margin`: Define how much wide the quiet zone should be. Default is `4`.
- `scale`: Scale factor. A value of 1 means 1px per modules (black dots). Default is `4`.
- `/md2html`, `/html2md` converts between html and markdown. Use following methods to pass data:
- `POST` request with raw body
- `url` query parameter to convert a webpage
- `text` query parameter to convert a short text.
```bash
curl "https://edgebin.liujiacai.net/md2html" --data "# Hello, World"
curl "https://edgebin.liujiacai.net/html2md" --data "
Hello, World
"
```
- [/page-meta](https://edgebin.liujiacai.net/page-meta?url=https://edgebin.liujiacai.net): Fetches a webpage and extracts its metadata (title, description, image, etc.). Use the `url` query parameter to specify the target webpage.
- [/date](https://edgebin.liujiacai.net/date): Returns current date and time.
Supports the following query parameters to control output:
- `format`: Output format. One of `iso`, `locale`, `ts`, `timestamp`, `utc`. Default is `iso`.
- `locale`: [BCP47 locale](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) string, e.g., `en-US`, `zh-CN`. Used when `format=locale`.
- `timeZone`: [IANA time zone](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), e.g., `Asia/Shanghai`.
- `/mix` returns what you send in the request body, and supports specific query strings as directives to construct a custom response.
- `s=code`, sets the status code, e.g. `s=418`
- `h=key:value`, adds a response header, e.g. `h=Content-Type:text/plain`
- `d=delay`, delays the response by `delay` seconds, e.g. `d=3`
### Frequently Used Endpoints
- `/get`: Returns GET data
- `/ip`: Returns the requester's IP address
- `/ipgeo`: Returns the requester's IP address and geolocation information
- `/user-agent`: Returns the requester's User-Agent
- `/headers`: Returns the requester's HTTP headers
- `/status/:code`: Returns a response with the given status code
- `/anything`: Returns anything that was sent in the request
- `/delay/:n`: Delays responding for `n` seconds
- `/redirect/:n`: Redirects `n` times
- `/basic-auth/:user/:passwd`: Challenges HTTP Basic Auth
- `/bearer`: Challenges HTTP Bearer Auth
- `/cache/:max-age`: Returns a response with `Cache-Control: public, max-age=60`
- `/response-headers?key=value`: Returns a response with the given headers
- `/bytes/:n`: Returns `n` random bytes
- `/xml`: Returns a sample XML document
- `/html`: Returns a sample HTML document
- `/json`: Returns a sample JSON document
- `/gzip`: Returns a gzip-encoded response
- `/brotli`: Returns a brotli-encoded response
- `/deflate`: Returns a deflate-encoded response
- `/anything/:anything`: Returns anything that was sent in the request
- `/cookies`: Returns the requester's cookies
- `/cookies/set?name=value`: Sets cookies and redirects to `/cookies`
- `/cookies/delete?name=value`: Deletes cookies and redirects to `/cookies`
- `/image/:type`: Returns a random image of the given type (png, jpeg, webp, svg)
If you find an endpoint is missing or notice any unexpected behavior, we welcome you to [open an issue](https://github.com/jiacai2050/edgebin/issues) or [submit a pull request](https://github.com/jiacai2050/edgebin/pulls).
## Deploy
Feel free to deploy your own instance of httpbin. The free tier of Cloudflare Workers is sufficient for most use cases.
[](https://deploy.workers.cloudflare.com/?url=https://github.com/jiacai2050/edgebin)
If you'd like to share your public instance, please [let us know](https://github.com/jiacai2050/edgebin/discussions/4) and we'll add it to the list.
We have a Telegram group for discussion: [https://t.me/edgebin](https://t.me/edgebin).
### Public Instances
| Instance | Maintainer |
| ------------------------------- | -------------------------------------------- |
| | [@jiacai2050](https://github.com/jiacai2050) |
## Development
```bash
# clone the repo and install dependencies
git clone https://github.com/jiacai2050/edgebin.git && cd edgebin
npm install
# start development server, listen on http://localhost:8787
npm run dev
# Deploy to Cloudflare Workers
# Make sure to set up your Cloudflare Workers environment first
# https://developers.cloudflare.com/workers/get-started/guide/
npm run deploy
```
In the future, we may support other edge platforms like Vercel Edge Functions and Deno Deploy.
## License
[MIT License](https://github.com/jiacai2050/edgebin/blob/main/LICENSE)