{"id":16615196,"url":"https://github.com/nojhan/tunnelmon","last_synced_at":"2025-07-01T05:35:03.750Z","repository":{"id":2781828,"uuid":"3781345","full_name":"nojhan/tunnelmon","owner":"nojhan","description":"An (auto)ssh tunnel monitor. Gives an interactive CLI to monitor existing SSH tunnels, and tunnels that are managed with autossh.","archived":false,"fork":false,"pushed_at":"2023-07-20T09:18:00.000Z","size":126,"stargazers_count":33,"open_issues_count":3,"forks_count":7,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-03T21:42:53.431Z","etag":null,"topics":["autossh","autossh-tunnels","curses","ssh","ssh-tunnels"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nojhan.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2012-03-20T23:17:44.000Z","updated_at":"2025-02-15T16:37:06.000Z","dependencies_parsed_at":"2024-10-28T10:30:26.696Z","dependency_job_id":"1aa41519-41f7-4614-bf44-a351648c2a0e","html_url":"https://github.com/nojhan/tunnelmon","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/nojhan/tunnelmon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nojhan%2Ftunnelmon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nojhan%2Ftunnelmon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nojhan%2Ftunnelmon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nojhan%2Ftunnelmon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nojhan","download_url":"https://codeload.github.com/nojhan/tunnelmon/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nojhan%2Ftunnelmon/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262904513,"owners_count":23382369,"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":["autossh","autossh-tunnels","curses","ssh","ssh-tunnels"],"created_at":"2024-10-12T02:08:52.157Z","updated_at":"2025-07-01T05:35:03.721Z","avatar_url":"https://github.com/nojhan.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"tunnelmon -- Monitor and manage autoSSH tunnels\n================================================\n\n## SYNOPSIS\n\n`tunnelmon` [-h]\n\n`tunnelmon` [-c] [-n] [-u] [-l LEVEL] [-g FILE] [-s]\n\n\n## DESCRIPTION\n\n`tunnelmon` is an autossh tunnel monitor. It gives a user interface to monitor existing SSH tunnel, and tunnels managed with autossh.\n\nIt can print the current state of your tunnels or display them in an interactive text-based interface.\n\n`tunnelmon` is released under the GNU Public License v3.\n\n![Screenshot](https://raw.github.com/nojhan/tunnelmon/master/screenshot.png)\n\n\n## INSTALLATION\n\n`tunnelmon` targets Linux operating systems, and depends on:\n* `openssh-client`,\n* `python` version 3.8 at least, you may also need to install the following python modules (for example via `pip`, but you may use any other package management system going along with your installation):\n  * `psutils`\n  * `curses`\n\nYou may also want to install the recommend packages:\n* `autossh`\n\n\n## OPTIONS\n\nCalled without option,`tunnelmon` will print the current state of the autossh tunnels and exit.\n\n* `-h`, `--help`:\n  Show a help message and exit\n\n* `-c`, `--curses`:\n  Start the interactive user interface. Tunnels states will be updated regularly and you will be able to control them (see below).\n\n* `-n`, `--connections`:\n  Display only SSH connections related to a tunnel.\n\n* `-u`, `--tunnels`:\n  Only display the list of tunnels processes.\n\n* `-l LEVEL`, `--log-level LEVEL`:\n  Control the verbosity of the logging, the greater, the more verbose. Available log levels are: `error` \u003c `warning` \u003c\n  `debug`. Defaults to `error`, which only prints unrecoverable problems.\n\n* `-g FILE`, `--log-file FILE`:\n  Log messages are written to the given FILE. Useful to debug the interactive interface.\n  If not set, asking for the curses interface automatically set logging to the \"tunnelmon.log\" file.\n\n* `-s`, `--log-sensitive`:\n  Allow sensitive information (hostnames, IPs, PIDs, etc.) into the logs.\n\n\n## INTERACTIVE INTERFACE\n\nKeyboard commands:\n\n* `↑` and `↓`: Select a tunnel.\n* `R`: Reload the selected autossh instance (i.e. send a `SIGUSR1`, which is interpreted as a reload command by autossh).\n* `C`: Close the selected tunnel (i.e. send a `SIGTERM`).\n* `N`: Show the network connections related to each tunnel instances.\n* `Q`: Quit Tunnelmon.\n\n\n## DISPLAY\n\nTunnelmon displays a table where lines are [auto]ssh processes that sets up a tunnel.\nColumns of the table indicates:\n- TYPE: `auto` if the process is managed by autossh, `ssh` if it is a \"raw\" SSH tunnel;\n- FORWARD: the type of port forwarding method (either `local`, `remote` or `dynamic`, see the SSH manual for details);\n- SSHPID: the process identifier;\n- INPORT: the client port;\n- VIA: the client host;\n- TARGET: the host address;\n- OUTPORT: the host port.\n\nThe interactive interface adds a CONNECTIONS columns that displays one vertical bar for each connection set up by the tunnel.\n\nIf you ask for showing the connections list (typing `N` in the interactive interface, or not passing `-u` to the command line one),\nTunnelmon will show indented lines with the type of the connection, its status and the related address:port informations.\n\nIn the interactive interface, different colors are used for:\n- the tunnel type,\n- the port forwarding methods,\n- privileged and unprivileged ports,\n- loopback, private and regular addresses.\n\n\n## SSH Tunnels in a nutshell\n\nTo open a tunnel to port 1234 of `server` through a `host` reached on port 4567:\n```sh\nssh -N host -L4567:server:1234\n```\nYou may add `-f` to run ssh in the background.\n\nAutossh can restart tunnels for you, in case they crash:\n```\nautossh -f host -L4567:server:1234\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnojhan%2Ftunnelmon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnojhan%2Ftunnelmon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnojhan%2Ftunnelmon/lists"}