A WPF-based Windows application that creates a secure SOCKS5 proxy tunnel to a remote server. It's designed to be a simple, graphical alternative to the ssh -D or ssh -L command.
This project utilizes the excellent SSH.NET library.
- Profile Management: Save and manage multiple SSH server configurations.
- One-Click Connection: Easily connect or disconnect with a single button.
- Visual Status Indicator: Instantly know your connection status with color-coded feedback.
- Customizable Proxy: Configure the local SOCKS5 IP address and port.
- Light & Dark Themes: Match the app to your system's theme.
- Connection Logs: A dedicated panel for real-time logs to troubleshoot connection issues.
Follow these steps to get the client up and running.
- Operating System: Windows 10 (version 20H1 or newer) / Windows 11 is recommended. Feel free to test other versions.
- Display: Make sure your display resolution is high enough. (Higher than 1280*720 is recommended.)
- Navigate to the Releases page of this repository.
- Download the latest release.
- Install the software.
- Run Desktop shortcut of SSH-Direct Client.
The application interface is designed to be intuitive, with sections arranged from top to bottom.
Before connecting, you need to add a server profile.
- Click Edit Configurations.
- In the new window, provide the following details:
- Name: A friendly name for your configuration (e.g., "Work Server").
- Host Address: The IP address or domain of the SSH server (e.g.,
123.123.123.123). - Host Port: The SSH port on the server. The default is
22. - Username & Password: Your credentials for the SSH server.
- Click Add to save the new profile. You can also select a profile from the list to Edit or Delete it.
The main button serves to connect/disconnect and shows the current status:
- 🟢 Spinning: Connecting to the host.
- 🟢 Solid: Successfully connected.
- 🟡 Spinning: An error occurred; attempting to reconnect.
- 🔴 Solid: Disconnected due to an unrecoverable error.
NOTE: Make sure to select a profile from the list, before clicking on connect!
This section controls the local proxy created by the tunnel. Other applications on your PC can be configured to use this proxy.
- SOCKS5 IP Address: Defaults to
127.0.0.1(localhost). - SOCKS5 Port: Defaults to
1080.
You can change these values if the default address is already in use or if you have specific networking needs.
Here you can adjust advanced SSH parameters like the Keep-Alive interval. It is recommended to leave these at their default values unless you are an advanced user and know why you need to change them.
This panel displays real-time output from the SSH connection. It is essential for debugging any connectivity problems. If you encounter an issue, the information here will be very helpful.
If you encounter a bug or have a suggestion, please open an issue on the repository.
When reporting a connection problem, please include the relevant output from the Logs panel to help us diagnose the issue faster.
This work is under an MIT License. Visit License for more info.