Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/1zun4/socks2http
Connect to HTTP proxy through SOCKS5 protocol with forwarding credentials
https://github.com/1zun4/socks2http
Last synced: about 1 month ago
JSON representation
Connect to HTTP proxy through SOCKS5 protocol with forwarding credentials
- Host: GitHub
- URL: https://github.com/1zun4/socks2http
- Owner: 1zun4
- License: gpl-3.0
- Created: 2024-05-08T16:05:41.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2024-09-22T22:00:58.000Z (3 months ago)
- Last Synced: 2024-10-14T06:12:50.503Z (3 months ago)
- Language: Rust
- Homepage:
- Size: 20.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## SOCKS2HTTP
This project is a SOCKS5 to HTTP proxy server written in Rust. It allows clients to connect to the internet through an HTTP proxy server using SOCKS5 protocol.
### Features
* SOCKS5 server with user/password authentication (always succeeds - see note below)
* Forwards traffic to a configured HTTP proxy server
* Logs connection details and timings (connection establishment, authentication, data transfer)
**Note:** Currently, authentication on the SOCKS5 server always succeeds. This is to make forwarding credentials to HTTP proxy possible.
### Usage
**Requirements:**
* Rust compiler ([https://www.rust-lang.org/tools/install](https://www.rust-lang.org/tools/install))
**Building:**
1. Clone the repository:
```bash
git clone https://github.com/1zun4/socks2http.git
```
2. Navigate to the project directory:
```bash
cd socks2http
```
3. Build the project:
```bash
cargo build
```
**Running:**
1. Run the server:
```bash
cargo run
```
**Client Usage:**
You can use any SOCKS5 client to connect to the server. Here's an example using `curl`:
```bash
curl -x socks5://127.0.0.1:42000 -U "username_of_http:password_of_http" https://ipinfo.io/json
```
This command will connect to `https://ipinfo.io/json` through the SOCKS5 server running on `localhost:42000`, using the provided username and password for HTTP proxy authentication.
**Configuration**
* The SOCKS5 server listens on `127.0.0.1:42000` by default. You can change this by modifying the `PROXY_SOCKS5_ADDR` constant in the source code.
* The HTTP proxy server address is configured in the `PROXY_HTTP_ADDR` constant. You need to replace it with the actual address of your HTTP proxy server.
**Logging**
The project uses the `env_logger` crate for logging. You can adjust the verbosity level by setting the `RUST_LOG` environment variable before running the server. For example:
```bash
RUST_LOG=info cargo run
```
This will only log informational messages.
### Contributing
We welcome contributions to this project! Please use common sense when contributing.
### License
This project is licensed under the GNU General Public License v3.0. A copy of the license is available in the LICENSE: LICENSE file.