{"id":16419153,"url":"https://github.com/cameronhunter/local-ssl-proxy","last_synced_at":"2025-05-15T08:06:09.166Z","repository":{"id":6820993,"uuid":"8069108","full_name":"cameronhunter/local-ssl-proxy","owner":"cameronhunter","description":"Simple SSL HTTP proxy using a self-signed certificate. Intended for local development only.","archived":false,"fork":false,"pushed_at":"2023-10-02T23:05:35.000Z","size":1780,"stargazers_count":660,"open_issues_count":8,"forks_count":64,"subscribers_count":9,"default_branch":"main","last_synced_at":"2024-05-17T07:02:18.603Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cameronhunter.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2013-02-07T08:26:32.000Z","updated_at":"2024-05-13T08:03:26.000Z","dependencies_parsed_at":"2024-02-17T10:44:54.832Z","dependency_job_id":null,"html_url":"https://github.com/cameronhunter/local-ssl-proxy","commit_stats":{"total_commits":65,"total_committers":8,"mean_commits":8.125,"dds":"0.41538461538461535","last_synced_commit":"dd8ab09d6320cbb1e92dba0488901fea6fa0445c"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cameronhunter%2Flocal-ssl-proxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cameronhunter%2Flocal-ssl-proxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cameronhunter%2Flocal-ssl-proxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cameronhunter%2Flocal-ssl-proxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cameronhunter","download_url":"https://codeload.github.com/cameronhunter/local-ssl-proxy/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248870098,"owners_count":21174982,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-11T07:16:05.678Z","updated_at":"2025-04-14T11:25:01.509Z","avatar_url":"https://github.com/cameronhunter.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# local-ssl-proxy\n\n[![CI](https://github.com/cameronhunter/prettier-package-json/actions/workflows/ci.yml/badge.svg)](https://github.com/cameronhunter/prettier-package-json/actions/workflows/ci.yml) [![NPM Version](https://img.shields.io/npm/v/local-ssl-proxy.svg)](https://npmjs.org/package/local-ssl-proxy) [![License](https://img.shields.io/npm/l/local-ssl-proxy.svg)](https://github.com/cameronhunter/local-ssl-proxy/blob/master/LICENSE.md)\n\nSimple SSL HTTP proxy using a self-signed certificate. Intended for local development only.\n\n## Quick Start\n\nThe package supports immediate use via [`npx`](https://docs.npmjs.com/cli/v7/commands/npx) or you can install it\nglobally.\n\nUse via `npx`:\n\n```sh\nnpx local-ssl-proxy\n```\n\nInstall globally:\n\n```sh\nnpm install -g local-ssl-proxy\n```\n\n## Usage\n\nTo start a proxy from port `9001` to `9000` run:\n\n```sh\nlocal-ssl-proxy --source 9001 --target 9000\n```\n\nStart your web server on the target port (`9000` in the example) and navigate to `https://localhost:\u003csource-port\u003e` ([https://localhost:9001](https://localhost:9001) in the example). You'll get a warning because the certificate is self-signed, this is safe to ignore during development.\n\nUsing a dynamic DNS provider such as [noip](http://www.noip.com/personal/) or [DynDNS](http://dyn.com/dns/) or a static IP (if you have one) you can open a port in your firewall to allow external sites to call into your web server. This is great for developing applications using [OAuth](http://oauth.net/) without having to deploy externally.\n\n## Advanced\n\nYou can also pass a configuration file, this helps share setups with team members. These can contain multiple proxies that `local-ssl-proxy` will open concurrently.\n\nExample config:\n\n```json\n{\n  \"My proxy\": {\n    \"source\": 3001,\n    \"target\": 3000,\n    \"key\": \"localhost-key.pem\",\n    \"cert\": \"localhost.pem\",\n    \"hostname\": \"localhost\"\n  },\n  \"Another proxy\": {\n    \"source\": 9999,\n    \"target\": 9000,\n    \"key\": \"localhost-key.pem\",\n    \"cert\": \"localhost.pem\",\n    \"hostname\": \"localhost\"\n  }\n}\n```\n\nAnd run the proxy with the configuration file:\n\n```sh\nlocal-ssl-proxy --config config.json\n```\n\n## Run SSL proxy with a self-signed trusted certificate\n\nYou can use it to host any domain, just change localhost to anything you like, wildcards are also supported.\n\n1. Install [mkcert](https://github.com/FiloSottile/mkcert) (`choco install mkcert` / `brew install mkcert`)\n1. Run `mkcert -install`\n1. Run `mkcert localhost`\n1. Run\n\n```sh\nlocal-ssl-proxy --key localhost-key.pem --cert localhost.pem --source 9001 --target 9000\n```\n\n1. You're all set! Just go to https://localhost:9001 and see your project working!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcameronhunter%2Flocal-ssl-proxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcameronhunter%2Flocal-ssl-proxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcameronhunter%2Flocal-ssl-proxy/lists"}