{"id":24491905,"url":"https://github.com/alessiobianchini/tunnelize","last_synced_at":"2026-02-25T03:33:01.488Z","repository":{"id":268395154,"uuid":"904212854","full_name":"alessiobianchini/Tunnelize","owner":"alessiobianchini","description":"Tunnelize is a command-line tool that allows you to easily forward HTTP or HTTPS requests from a remote server to a local instance. It is designed to facilitate secure, simple, and reliable tunnel connections for development environments.","archived":false,"fork":false,"pushed_at":"2025-01-21T16:23:56.000Z","size":39,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-27T14:21:54.294Z","etag":null,"topics":["local-server","proxy","tunnel","websocket"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/tunnelize","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alessiobianchini.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"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,"publiccode":null,"codemeta":null},"funding":{"github":["alessiobianchini"],"ko_fi":"alessiobianchini"}},"created_at":"2024-12-16T13:10:10.000Z","updated_at":"2025-01-21T16:23:29.000Z","dependencies_parsed_at":"2024-12-16T14:25:13.693Z","dependency_job_id":"2979dc14-e990-4d6c-b6ba-6f17fdaba31f","html_url":"https://github.com/alessiobianchini/Tunnelize","commit_stats":null,"previous_names":["alessiobianchini/tunnelize"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alessiobianchini%2FTunnelize","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alessiobianchini%2FTunnelize/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alessiobianchini%2FTunnelize/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alessiobianchini%2FTunnelize/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alessiobianchini","download_url":"https://codeload.github.com/alessiobianchini/Tunnelize/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248585248,"owners_count":21128974,"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":["local-server","proxy","tunnel","websocket"],"created_at":"2025-01-21T18:19:54.002Z","updated_at":"2026-02-25T03:33:01.440Z","avatar_url":"https://github.com/alessiobianchini.png","language":"C#","funding_links":["https://github.com/sponsors/alessiobianchini","https://ko-fi.com/alessiobianchini"],"categories":[],"sub_categories":[],"readme":"# Tunnelize\n\nTunnelize is a command-line tool that allows you to easily forward HTTP or HTTPS requests from a remote server to a local instance. It is designed to facilitate secure, simple, and reliable tunnel connections for development environments.\n\n## 🚀 Features\n- **WebSocket Connection**: Establish a persistent connection with a remote proxy server.\n- **HTTP/HTTPS Protocol**: Supports tunneling for both HTTP and HTTPS requests.\n- **Automatic Reconnection**: If the connection is dropped, Tunnelize automatically retries.\n- **Simple CLI**: Intuitive command-line interface for fast setup and usage.\n- **Configurable Log Levels**: Dynamically adjust logging levels (debug, info, log, warn, error) for better control.\n- **Persistent Log Levels**: The log level persists across sessions.\n\n## 📦 Installation\n\nTo install Tunnelize globally as an NPM package, run:\n\n```bash\nnpm install -g tunnelize\n```\n\nOnce installed, you can use the `tunnelize` command from anywhere.\n\n## 🔧 Usage\n\nTo start Tunnelize, use the following command:\n\n```bash\ntunnelize \u003cprotocol\u003e \u003cport\u003e\n```\n\n**Options:**\n\n| Parameter  | Description                     | Default |\n|------------|---------------------------------|---------|\n| `protocol` | Either `http` or `https`         | `http`  |\n| `port`     | Port number to connect on localhost | 8080   |\n\n### Examples\n\n1. **Start a tunnel for HTTP on port 8080**\n   ```bash\n   tunnelize http 8080\n   ```\n\n2. **Start a tunnel for HTTPS on port 443**\n   ```bash\n   tunnelize https 443\n   ```\n\n3. **Set log level to debug**\n   ```bash\n   tunnelize loglevel debug\n   ```\n\n4. **Show help information**\n   ```bash\n   tunnelize help\n   ```\n\n## 🔐 Environment Variables\n\nYou can customize the remote proxy server URL using environment variables.\n\n```bash\nexport DEV_TUNNEL_URL='your-proxy-url-here'\n```\n\n## 📘 Commands\n\n| Command        | Description                        |\n|----------------|-----------------------------------|\n| `tunnelize http 8080` | Start a tunnel using HTTP on port 8080 |\n| `tunnelize https 443`  | Start a tunnel using HTTPS on port 443  |\n| `tunnelize loglevel \u003clevel\u003e` | Set the log level dynamically (debug, info, log, warn, error) |\n| `tunnelize help`       | Show available commands and usage info  |\n\n## 💻 Development\n\nTo contribute or develop locally, follow these steps:\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/alessiobianchini/Tunnelize.git\n   cd Tunnelize\n   ```\n\n2. Install dependencies:\n   ```bash\n   npm install\n   ```\n\n3. Link the package locally for testing:\n   ```bash\n   npm link\n   ```\n\n4. Run the CLI locally:\n   ```bash\n   tunnelize http 8080\n   ```\n\n## 🤝 Contributing\n\nContributions are welcome! To contribute, please:\n\n1. Fork the repository.\n2. Create a new branch for your feature or bugfix.\n3. Submit a pull request with your changes.\n\n## 🔖 License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more information.\n\n## 📧 Contact\n\nFor questions, issues, or feature requests, feel free to open an issue on the [GitHub repository](https://github.com/alessiobianchini/Tunnelize) or contact the project maintainer via email: alessio.bianchini@doit.it\n\n---\n\n\u003e **Note:** This tool is intended for development purposes only and should not be used in production environments without proper security measures.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falessiobianchini%2Ftunnelize","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falessiobianchini%2Ftunnelize","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falessiobianchini%2Ftunnelize/lists"}