{"id":13393458,"url":"https://github.com/antoniomika/sish","last_synced_at":"2026-06-05T05:01:00.207Z","repository":{"id":39224573,"uuid":"170887175","full_name":"antoniomika/sish","owner":"antoniomika","description":"HTTP(S)/WS(S)/TCP Tunnels to localhost using only SSH.","archived":false,"fork":false,"pushed_at":"2025-02-23T16:05:12.000Z","size":7580,"stargazers_count":4132,"open_issues_count":18,"forks_count":317,"subscribers_count":55,"default_branch":"main","last_synced_at":"2025-02-23T17:22:17.972Z","etag":null,"topics":["http","https","ngrok","serveo","ssh","tcp","tunnel","websockets"],"latest_commit_sha":null,"homepage":"https://ssi.sh","language":"Go","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/antoniomika.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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,"publiccode":null,"codemeta":null},"funding":{"github":"antoniomika"}},"created_at":"2019-02-15T15:36:23.000Z","updated_at":"2025-02-23T16:05:15.000Z","dependencies_parsed_at":"2023-11-25T18:27:08.966Z","dependency_job_id":"344caf83-a642-40c5-8072-883424eade95","html_url":"https://github.com/antoniomika/sish","commit_stats":{"total_commits":244,"total_committers":21,"mean_commits":"11.619047619047619","dds":"0.24180327868852458","last_synced_commit":"62dec83b1310edcdb4e86dc7b2f0a82d02741b4f"},"previous_names":[],"tags_count":60,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antoniomika%2Fsish","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antoniomika%2Fsish/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antoniomika%2Fsish/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antoniomika%2Fsish/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/antoniomika","download_url":"https://codeload.github.com/antoniomika/sish/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243469169,"owners_count":20295700,"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":["http","https","ngrok","serveo","ssh","tcp","tunnel","websockets"],"created_at":"2024-07-30T17:00:53.262Z","updated_at":"2026-06-05T05:01:00.198Z","avatar_url":"https://github.com/antoniomika.png","language":"Go","funding_links":["https://github.com/sponsors/antoniomika"],"categories":["Go","HarmonyOS","Software","http","\u003ca id=\"01e6651181d405ecdcd92a452989e7e0\"\u003e\u003c/a\u003e工具","Apps","Online tools","Proxy"],"sub_categories":["Windows Manager","Proxy","\u003ca id=\"9d6789f22a280f5bb6491d1353b02384\"\u003e\u003c/a\u003e隧道\u0026\u0026穿透","Networking","Sharing Stuff","Booking and Scheduling"],"readme":"# sish\n\nOpen source SSH tunneling for HTTP(S), WS(S), TCP, aliases, and SNI.\n\nIf you like the simplicity of serveo/ngrok-style sharing but want to use plain\nSSH and run your own infrastructure, `sish` is built for that.\n\n- No custom client required for end users\n- Public and private tunnel workflows\n- Docker and binary releases\n- Designed for production-grade self-hosting\n\n[Docs](https://docs.ssi.sh) | [Managed Service](https://tuns.sh) | [Releases](https://github.com/antoniomika/sish/releases) | [Docker Images](https://hub.docker.com/r/antoniomika/sish/tags) | [Sponsored by pico.sh](https://pico.sh)\n\n## Why sish\n\n`sish` runs an SSH server focused on forwarding and multiplexing. Users connect\nwith commands they already know, and `sish` handles the routing.\n\n### Typical use cases\n\n- Share a local web app instantly over HTTPS\n- Expose a TCP service to a fixed or random external port\n- Create private TCP aliases that are only reachable through authenticated SSH\n- Route TLS traffic by SNI to multiple backends without terminating TLS\n\n## Quick Start\n\n### 1) Try the managed service\n\nThe fastest way to validate your workflow:\n\n```bash\nssh -R 80:localhost:8080 tuns.sh\n```\n\nThis creates a public URL for your local app running on port `8080`.\n\n### 2) Self-host with Docker\n\nPull image:\n\n```bash\ndocker pull antoniomika/sish:latest\n```\n\nPrepare directories:\n\n```bash\nmkdir -p ~/sish/ssl ~/sish/keys ~/sish/pubkeys\ncp ~/.ssh/id_ed25519.pub ~/sish/pubkeys\n```\n\nRun:\n\n```bash\ndocker run -itd --name sish \\\n\t-v ~/sish/ssl:/ssl \\\n\t-v ~/sish/keys:/keys \\\n\t-v ~/sish/pubkeys:/pubkeys \\\n\t--net=host antoniomika/sish:latest \\\n\t--ssh-address=:2222 \\\n\t--http-address=:80 \\\n\t--https-address=:443 \\\n\t--https=true \\\n\t--https-certificate-directory=/ssl \\\n\t--authentication-keys-directory=/pubkeys \\\n\t--private-keys-directory=/keys \\\n\t--bind-random-ports=false \\\n\t--domain=example.com\n```\n\nThen connect:\n\n```bash\nssh -p 2222 -R 80:localhost:8080 example.com\n```\n\n## Forwarding Examples\n\n### HTTP tunnel\n\n```bash\nssh -R myapp:80:localhost:8080 tuns.sh\n```\n\nYour app at `localhost:8080` becomes available at `https://myapp.tuns.sh`.\n\n### TCP tunnel\n\n```bash\nssh -R 2222:localhost:22 tuns.sh\n```\n\n`localhost:22` is available at `tuns.sh:2222`\n\n### Private TCP alias\n\n```bash\nssh -R mylaptop:22:localhost:22 tuns.sh\n```\n\nAccess from another client:\n\n```bash\nssh -J tuns.sh mylaptop\n```\n\n## Feature Highlights\n\n- HTTP(S), WS(S), TCP forwarding, and multiplexing\n- TCP aliases for private internal-only access patterns\n- SNI proxy support for TLS-based backend routing\n- Optional load balancing modes for HTTP/TCP/SNI aliases\n- Service console support for inspecting forwarded requests\n- Key and password authentication with dynamic key reloading\n- Restrictive binding policies for safer multi-tenant setups\n\n## Local Development\n\nClone:\n\n```bash\ngit clone git@github.com:antoniomika/sish.git\ncd sish\n```\n\nStart locally:\n\n```bash\ngo run main.go --http-address localhost:3000 --domain testing.ssi.sh\n```\n\nOr use:\n\n```bash\nmake dev\n```\n\nTest a tunnel:\n\n```bash\nssh -p 2222 -R 80:localhost:8080 testing.ssi.sh\n```\n\n`testing.ssi.sh` is configured to point to localhost for development.\n\n## Learn More\n\n- [Getting Started](https://docs.ssi.sh/getting-started)\n- [Forwarding Types](https://docs.ssi.sh/forwarding-types)\n- [CLI Reference](https://docs.ssi.sh/cli)\n- [FAQ](https://docs.ssi.sh/faq)\n\n## Community\n\n- IRC: [#sish on libera](https://web.libera.chat/#sish) / [#pico.sh on libera](https://web.libera.chat/#pico.sh)\n- Email: [me@antoniomika.me](mailto:me@antoniomika.me)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fantoniomika%2Fsish","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fantoniomika%2Fsish","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fantoniomika%2Fsish/lists"}