{"id":18400461,"url":"https://github.com/docksal/service-ssh-proxy","last_synced_at":"2025-04-12T16:57:13.618Z","repository":{"id":73903508,"uuid":"167049748","full_name":"docksal/service-ssh-proxy","owner":"docksal","description":"SSH Proxy service image for Docksal","archived":false,"fork":false,"pushed_at":"2019-12-19T08:41:57.000Z","size":23,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":5,"default_branch":"develop","last_synced_at":"2024-05-22T15:27:30.571Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","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/docksal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null},"funding":{"github":"docksal","open_collective":"docksal"}},"created_at":"2019-01-22T18:58:55.000Z","updated_at":"2019-11-15T12:25:41.000Z","dependencies_parsed_at":"2023-02-24T21:30:14.099Z","dependency_job_id":null,"html_url":"https://github.com/docksal/service-ssh-proxy","commit_stats":{"total_commits":19,"total_committers":2,"mean_commits":9.5,"dds":"0.052631578947368474","last_synced_commit":"53ff6324da31a9b0283c4b8d100c59346c31b2bf"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docksal%2Fservice-ssh-proxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docksal%2Fservice-ssh-proxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docksal%2Fservice-ssh-proxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docksal%2Fservice-ssh-proxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/docksal","download_url":"https://codeload.github.com/docksal/service-ssh-proxy/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247953847,"owners_count":21024100,"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-11-06T02:33:35.449Z","updated_at":"2025-04-12T16:57:13.598Z","avatar_url":"https://github.com/docksal.png","language":"Shell","funding_links":["https://github.com/sponsors/docksal","https://opencollective.com/docksal"],"categories":[],"sub_categories":[],"readme":"# SSH proxy Docker image for Docksal\n\nAutomated SSH proxy for Docksal.\n\nDocksal SSH Proxy is proxy-like ware, and route connections by project\nname to the appropriate `cli` container.\n\n```\n+---------+                        +---------------+  +------------+\n|         |                        |               |  |            |\n|   Bob   +-- ssh -l project1 --+  |             +-----\u003e project1  |\n|         |                     |  | SSH Proxy   | |  |            |\n+---------+                     |  |             | |  +------------+\n                                +-------------\u003e--+ |\n+---------+                     |  |             | |  +------------+\n|         |                     |  |             | |  |            |\n|  Alice  +-- ssh -l project2 --+  |             +-----\u003e project2  |\n|         |                        |               |  |            |\n+---------+                        +---------------+  +------------+\n\n\n Developers                         Docksal SSH Proxy   Project Network\n\n```\n\nThis image(s) is part of the [Docksal](http://docksal.io) image library.\n\n## Features\n\n* Project name routing\n* Global keys that should be added to all projects.\n* Project specific keys for added security\n* Automatic connecting to Docksal Projects\n\n## Usage\n\nGenerating the Volume for persistent storage:\n\n```\ndocker volume create docksal_projects_ssh\n```\n\nStart the proxy container:\n\n```\ndocker run -d \\\n    --name=docksal-vhost-proxy \\\n    --label \"io.docksal.group=system\" \\\n    --restart=always \\\n    -p \"${DOCKSAL_VHOST_PROXY_PORT_SSH:-2222}\":2222 \\\n    --mount type=volume,src=docksal_projects_ssh,dst=/ssh-proxy \\\n    --mount type=bind,src=/var/run/docker.sock,dst=/var/run/docker.sock \\\n    docksal/ssh-proxy\n```\n\n## Container configuration\n\nThe SSH Proxy reads routing settings from container labels. The following labels are used:\n\n`io.docksal.project-root`\n\nUsed for filtering out only docksal related projects.\n\n`io.docksal.virtual-host`\n\nUsed for filtering out only the containers that have this label.\n\n`com.docker.compose.project`\n\nUsed for returning the project name. This is also used for the username when ssh-ing through the\nproxy.\n\n`com.docker.compose.service`\n\nThis is used for searching for the container marked as `cli` within a project.\n\n## Logging and debugging\n\nThe following container environment variables can be used to enabled various logging options.\n\n`SSH_PROXY_LOGLEVEL` - Follow values of syslog logging. Settings values between 0 and 7 (default 3)\n\nCheck logs with `docker logs docksal-ssh-proxy`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdocksal%2Fservice-ssh-proxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdocksal%2Fservice-ssh-proxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdocksal%2Fservice-ssh-proxy/lists"}