[{"_1":2,"_185":-5,"_186":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_159":160},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_85":-5,"_86":87,"_152":-5,"_153":11,"_154":17,"_155":11,"_156":-5,"_157":158},"canonicalUrl","https://hub.docker.com/r/igops/ngrok-skip-browser-warning/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","igops","reponame","ngrok-skip-browser-warning","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":65,"_66":67,"_68":11,"_69":29,"_70":71,"_76":11,"_77":78,"_82":29,"_83":84},"categories",[],"content_types",[40],"image","date_registered","2023-01-03T13:01:34.247435Z","description","A simple HTTPS forward proxy for bypassing browser warning of Ngrok","is_private","last_updated","2023-07-09T11:32:53.04764Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.oci.image.index.v1+json","name","pull_count",6787,"repository_type","star_count",5,"status",1,"status_description","active","source","collaborator_count",0,"full_description","A simple HTTPS forward proxy for bypassing browser warning of Ngrok. Full support of SSL (free certificates included!), WebSocket, SSE and CORS.\n\n**Prerequisites:**\n- Somebody has sent you a link to an Ngrok endpoint, but it returns a warning page instead of the expected content\n- You might be a web developer who is trying to use that endpoint in your code and curious how to bypass the warning page without rewriting the logic\n- You have a Docker installed on your machine\n\nOK, take me to the good part: [Usage](#usage)\n\n## Preface\nFrom the ngrok [docs](https://ngrok.com/abuse):\n\n> _To block phishing attacks using our platform, ngrok has added an interstitial page for free accounts receiving requests from browsers. When a user visits an endpoint for the first time, ngrok will serve an interstitial page letting the user know that the content is served via ngrok and that they should not enter sensitive information unless they trust the person that sent them the link. Users should only see this page once per endpoint and it can be completely bypassed by adding the `ngrok-skip-browser-warning` header to your request._\n\nIt's tedious to add this header while developing a client for the API, which is exposed behind ngrok. In some cases, e.g. using [EventSource](https://developer.mozilla.org/en-US/docs/Web/API/EventSource), affecting the request headers seems to be impossible.\n\n## Solution\n\nAdd a **forward proxy** which will add the `ngrok-skip-browser-warning` header to all HTTP requests:\n\n![proxy](https://raw.githubusercontent.com/igops/ngrok-skip-browser-warning/main/img/ngrok-skip-browser-warning-3.png)\n\n## Disclaimer\n⚠️ The purpose of this docker image is to ease your development process. Running a proxy locally does not facilitate phishing attacks until you expose your local network to the public. This image is provided \"as is\", without warranty of any kind, no matter what.\n\nFor more features, consider getting the [ngrok subscription](https://ngrok.com/pricing).\n\n## Usage\n\n### Relay over HTTPS (recommended)\n\nStarting from 2023 July 9th, this image includes setup of a valid public CA signed SSL certificate and supports HTTPS (thanks to [localhost.direct](https://get.localhost.direct) project).\n\nRun this **on the machine from where you are calling the ngrok endpoints**:\n\n```shell\n$ docker run -d --rm \\\n -p 8443:443 \\\n -p 8080:80 \\\n -e NGROK_HOST=https://your-ngrok-domain.ngrok.io \\\n igops/ngrok-skip-browser-warning:latest\n```\n\nFrom now, use `https://ngrok.localhost.direct:8443` as your API webroot.\n\nE.g., you were told to call `GET https://your-ngrok-domain.ngrok.io/api/v1/whatever`. Now you just call `GET https://ngrok.localhost.direct:8443/api/v1/whatever` instead, and get the response **without the warning page!**\n\n`*.localhost.direct` is a wildcard record of the public DNS pointing to `127.0.0.1`. You might want to customize the domain name to bind the proxy to, as well as the SSL certificates (see [ENV Variables](#env-variables) below).\n\n### Relay over HTTP (not recommended)\n\nIf for some reason you don't want to use HTTPS relay, you can continue using `http://ngrok.localhost.direct:8080` or `http://localhost:8080` as your API webroot.\n\nYou can disable all SSL-related features by passing `PROXY_USE_SSL=false` environment variable:\n```shell\n$ docker run -d --rm \\\n -p 8080:80 \\\n -e NGROK_HOST=https://your-ngrok-domain.ngrok.io \\\n -e PROXY_USE_SSL=false \\\n igops/ngrok-skip-browser-warning:latest\n```\n\n### WebSocket and SSE Support\n\nWebSocket and SSE protocols require a special handling of the `Upgrade` and `Connection` headers. This image supports both protocols out of the box.\n\nHowever, to distinguish WebSocket and SSE requests from regular HTTP requests, I have implemented the conditional routing based on the request domain names:\n\n| Protocol | Over HTTPS | Over HTTP |\n|---------------------|-------------------------------------------|------------------------------------------|\n| REST, GraphQL, etc. | `https://ngrok.localhost.direct:8443` | `http://ngrok.localhost.direct:8080` |\n| WebSocket | `wss://ngrok-ws.localhost.direct:8443` | `ws://ngrok-ws.localhost.direct:8080` |\n| SSE | `https://ngrok-sse.localhost.direct:8443` | `http://ngrok-sse.localhost.direct:8080` |\n\nYou can customize the domain names on your own (see [ENV Variables](#env-variables)) or even the entire routing model (check out the [Customization](#customization) section).\n\nIf you're developing a web client which communicates with the HTTP server via multiple protocols, it's worth introducing some configurable constants, such as:\n[![js-client](https://raw.githubusercontent.com/igops/ngrok-skip-browser-warning/main/img/js-client.png)](https://github.com/igops/ngrok-skip-browser-warning/blob/main/examples/js-client.js)\n

_{Click on the image to show the text version}

\n\n\nSupport of WebSocket and SSE was tested by running the [Echo Server](https://github.com/jmalloc/echo-server) behind a free ngrok tunnel. Consider reporting an issue if you find any problems.\n\n### CORS Support\n\nYou can configure the proxy to add the `Access-Control-Allow-Origin` header to all responses by setting the `ADD_HEADER_ACCESS_CONTROL_ALLOW_ORIGIN` environment variable:\n```shell\n$ docker run -d --rm \\\n -p 8443:443 \\\n -p 8080:80 \\\n -e NGROK_HOST=https://your-ngrok-domain.ngrok.io \\\n -e ADD_HEADER_ACCESS_CONTROL_ALLOW_ORIGIN='*' \\\n igops/ngrok-skip-browser-warning:latest\n```\n\n## Customization\n\n### Setup\n\nThis image uses [Nginx](https://www.nginx.com/) as a proxy server, as well as [Jinja](https://jinja.palletsprojects.com/en/3.1.x/) template engine to generate the Nginx config on the fly.\n\nFeel free to replace `/etc/nginx/j2/default.j2.conf` with your own implementation, or use [my config](https://github.com/igops/ngrok-skip-browser-warning/blob/main/nginx/default.j2.conf) as a basis.\n\nFor instance, you might create `custom.j2.conf` with a very bare minimum for your experiments:\n\n[![nginx-bare-minimum](https://raw.githubusercontent.com/igops/ngrok-skip-browser-warning/main/img/nginx-bare-minimum.png)](https://github.com/igops/ngrok-skip-browser-warning/blob/main/examples/nginx-bare-minimum.conf)\n

_{Click on the image to show the text version}

\n\nMount it as follows:\n```shell\n$ docker run -d --rm \\\n -p 8443:443 \\\n -p 8080:80 \\\n -e NGROK_HOST=https://your-ngrok-domain.ngrok.io \\\n -v $PWD/custom.j2.conf:/etc/nginx/j2/default.j2.conf \\\n igops/ngrok-skip-browser-warning:latest\n```\n\n### Jinja Template Variables\n\nJinja template variables refer to the [ENV variables](#env-variables) with the same names in SNAKE_UPPER_CASE.\n\n| Jinja Variable | Environment Variable |\n|-----------------------------------|--------------------------------------------------------|\n| ProxyHostREST | `PROXY_HOST_REST` |\n| ProxyHostWSSupport | `PROXY_HOST_WS_SUPPORT` |\n| ProxyHostSSESupport | `PROXY_HOST_SSE_SUPPORT` |\n| ProxyUseSSL | `PROXY_USE_SSL` |\n| ProxySSLCertName | `PROXY_SSL_CERT_NAME` |\n| ProxySSLKeyName | `PROXY_SSL_KEY_NAME` |\n| ProxyForceHTTPS | `PROXY_FORCE_HTTPS` |\n| TargetScheme | Scheme of `NGROK_HOST` (typically equals to `https`) |\n| TargetHost | Domain name of `NGROK_HOST` | \n| AddHeaderAccessControlAllowOrigin | `ADD_HEADER_ACCESS_CONTROL_ALLOW_ORIGIN` |\n\n\n### Custom routes\n\nThe simplest way to add a custom endpoint is to bind an additional `*.localhost.direct` subdomain with your own proxying rules:\n[![nginx-custom-block](https://raw.githubusercontent.com/igops/ngrok-skip-browser-warning/main/img/nginx-custom-block.png)](https://github.com/igops/ngrok-skip-browser-warning/blob/main/examples/nginx-custom-block.j2.conf)\n

_{Click on the image to show the text version}

\n\nA custom location block might be as follows:\n[![nginx-custom-location](https://raw.githubusercontent.com/igops/ngrok-skip-browser-warning/main/img/nginx-custom-location.png)](https://github.com/igops/ngrok-skip-browser-warning/blob/main/examples/nginx-custom-location.j2.conf)\n

_{Click on the image to show the text version}

\n\n## ENV Variables\n| Variable | Default value | Description |\n|-----------------------------------------|------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| NGROK_HOST | - | **Mandatory**. Your ngrok host, e.g. `https://your-ngrok-domain.ngrok.io`.
Specifying a protocol is optional, `https` will be used by default.
Any url parts after a domain name will be trimmed. |\n| PROXY_HOST_REST | `ngrok.localhost.direct` | Optional. A domain name to listen on REST API calls. |\n| PROXY_HOST_WS_SUPPORT | `ngrok-ws.localhost.direct` | Optional. A domain name to listen on WebSocket API calls. |\n| PROXY_HOST_SSE_SUPPORT | `ngrok-sse.localhost.direct` | Optional. A domain name to listen on SSE API calls. |\n| PROXY_USE_SSL | `true` | Optional. Enables relay over HTTPS. You can mount your own certificates to `/etc/nginx/certs`. If the directory is not mounted, `localhost.direct` certificate will be downloaded on container bootstrap. |\n| PROXY_FORCE_HTTPS | `false` | Optional. Forcibly redirect HTTP calls to HTTPS. |\n| PROXY_SSL_CERT_NAME | `localhost.direct.crt` | Optional. Override the name of the certificate file. Mount the file to `/etc/nginx/certs/my-custom-cert.crt`. |\n| PROXY_SSL_KEY_NAME | `localhost.direct.key` | Optional. Override the name of the certificate key. Mount the file to `/etc/nginx/certs/my-custom-cert.key`. |\n| ADD_HEADER_ACCESS_CONTROL_ALLOW_ORIGIN | (empty string) | Optional. Add custom [Access-Control-Allow-Origin](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin) to all responses. |\n\n\n## Source code\nhttps://github.com/igops/ngrok-skip-browser-warning\n\nFeel free to [contribute](https://github.com/igops/ngrok-skip-browser-warning).\n\n## Credits\n[@igops](https://github.com/igops)\n[@muratx10](https://github.com/muratx10)\n","has_starred","hub_user","immutable_tags_settings",{"_72":11,"_73":74},"enabled","rules",[75],".*","is_automated","permissions",{"_79":17,"_80":11,"_81":11},"read","write","admin","user","storage_size",321427167,"orgData","recentTags",[88],{"_89":40,"_90":91,"_92":93,"_94":95,"_96":97,"_98":99,"_46":141,"_142":91,"_143":29,"_144":52,"_53":145,"_146":147,"_148":134,"_149":141,"_150":62,"_151":17},"content_type","creator",21093727,"digest","sha256:59c0d556c40d3a54565e76a50f96f9b40f102677a5c0074866c470ac3e7a52dc","full_size",39767001,"id",360405157,"images",[100,117,122,127,132,137],{"_101":102,"_92":103,"_104":105,"_106":107,"_108":109,"_110":111,"_112":105,"_113":-5,"_114":115,"_59":62,"_116":-5},"architecture","amd64","sha256:90511106acab469ec552a68c394ef13c08e29560a2f0c5c0f116887961f338da","features","","last_pulled","2026-09-19T18:56:20.215640462Z","last_pushed","2023-07-09T11:32:52Z","os","linux","os_features","os_version","size",43423252,"variant",{"_101":118,"_92":119,"_104":105,"_106":120,"_108":109,"_110":111,"_112":105,"_113":-5,"_114":121,"_59":62,"_116":-5},"arm64","sha256:146940bc8a81a4ac2be6561f296841a7382086defc22f694b5b07d10b4895fe2","2026-09-19T18:56:20.219598449Z",42723828,{"_101":123,"_92":124,"_104":105,"_106":125,"_108":109,"_110":111,"_112":105,"_113":-5,"_114":95,"_59":62,"_116":126},"arm","sha256:0af5e9914b8fbba175b99659ee0364e3f7b33fc872d1f58220f7f4e5150a7e51","2026-09-19T18:56:20.241245447Z","v7",{"_101":128,"_92":129,"_104":105,"_106":130,"_108":109,"_110":128,"_112":105,"_113":-5,"_114":131,"_59":62,"_116":-5},"unknown","sha256:76bb589bd1cbc0322edc179028bc43a60955c6a9b054eb8ef958c0db64e1bb4d","2026-09-19T18:56:20.225257861Z",1149,{"_101":128,"_92":133,"_104":105,"_106":134,"_108":135,"_110":128,"_112":105,"_113":-5,"_114":136,"_59":62,"_116":-5},"sha256:1cb2c96554de56180154c8f07fb39996396b770ec97feadb63581cf85ceb394b","2026-09-19T18:56:20.366954644Z","2023-07-09T11:32:51Z",1143,{"_101":128,"_92":138,"_104":105,"_106":139,"_108":140,"_110":128,"_112":105,"_113":-5,"_114":136,"_59":62,"_116":-5},"sha256:95a9f66b532607e6abce71e2fd0a893194a9540259a06b0f7931206ba40204ea","2026-09-19T18:56:20.364272099Z","2023-07-09T11:32:53Z","2023-07-09T11:32:52.722085Z","last_updater","last_updater_username","media_type","latest","repository",18908021,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":161,"_168":169,"_157":183,"_184":11},{"_36":162,"_38":163,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":164,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":65,"_66":67,"_68":11,"_69":29,"_70":165,"_76":11,"_77":167,"_82":29,"_83":84},[],[40],[52],{"_72":11,"_73":166},[75],{"_79":17,"_80":11,"_81":11},"tags",{"_170":60,"_171":-5,"_172":-5,"_173":174},"count","next","previous","results",[175],{"_89":40,"_90":91,"_92":93,"_94":95,"_96":97,"_98":176,"_46":141,"_142":91,"_143":29,"_144":52,"_53":145,"_146":147,"_148":134,"_149":141,"_150":62,"_151":17},[177,178,179,180,181,182],{"_101":102,"_92":103,"_104":105,"_106":107,"_108":109,"_110":111,"_112":105,"_113":-5,"_114":115,"_59":62,"_116":-5},{"_101":118,"_92":119,"_104":105,"_106":120,"_108":109,"_110":111,"_112":105,"_113":-5,"_114":121,"_59":62,"_116":-5},{"_101":123,"_92":124,"_104":105,"_106":125,"_108":109,"_110":111,"_112":105,"_113":-5,"_114":95,"_59":62,"_116":126},{"_101":128,"_92":129,"_104":105,"_106":130,"_108":109,"_110":128,"_112":105,"_113":-5,"_114":131,"_59":62,"_116":-5},{"_101":128,"_92":133,"_104":105,"_106":134,"_108":135,"_110":128,"_112":105,"_113":-5,"_114":136,"_59":62,"_116":-5},{"_101":128,"_92":138,"_104":105,"_106":139,"_108":140,"_110":128,"_112":105,"_113":-5,"_114":136,"_59":62,"_116":-5},[],"canDeleteTags","actionData","errors"]

Digest	OS/ARCH	Compressed size
90511106acab	linux/amd64	41.41 MB
0af5e9914b8f	linux/arm/v7	37.92 MB
146940bc8a81	linux/arm64	40.74 MB

igops/ngrok-skip-browser-warning

Tags for igops/ngrok-skip-browser-warning