https://github.com/bannsec/cosmosocks

Socks server written in Cosmopolitan libc
https://github.com/bannsec/cosmosocks

Last synced: 3 months ago
JSON representation

Socks server written in Cosmopolitan libc

• Host: GitHub
• URL: https://github.com/bannsec/cosmosocks
• Owner: bannsec
• License: gpl-3.0
• Created: 2022-08-18T03:06:58.000Z (about 2 years ago)
• Default Branch: master
• Last Pushed: 2022-09-09T03:32:40.000Z (about 2 years ago)
• Last Synced: 2024-05-20T08:33:32.657Z (6 months ago)
• Language: C
• Size: 6.72 MB
• Stars: 20
• Watchers: 3
• Forks: 2
• Open Issues: 15
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

• awesome-cosmopolitan - cosmosocks - Socks server written in Cosmopolitan libc (Cosmopolitan / Projects)

README

        
[![Build and test](https://github.com/bannsec/cosmosocks/actions/workflows/build.yml/badge.svg)](https://github.com/bannsec/cosmosocks/actions/workflows/build.yml)

![Windows](https://github.com/bannsec/cosmosocks/raw/master/icons/windows.png)

![Apple](https://github.com/bannsec/cosmosocks/raw/master/icons/apple.png)

![Ubuntu](https://github.com/bannsec/cosmosocks/raw/master/icons/ubuntu.png)

![Android](https://github.com/bannsec/cosmosocks/raw/master/icons/android.png)

![OpenBSD](https://github.com/bannsec/cosmosocks/raw/master/icons/openbsd.png)

![NetBSD](https://github.com/bannsec/cosmosocks/raw/master/icons/netbsd.png)

![FreeBSD](https://github.com/bannsec/cosmosocks/raw/master/icons/freebsd.png)

# Overview

`Cosmosocks` is a socks server written entirely in [Cosmopolitian libc](https://justine.lol/cosmopolitan). This allows the socks program to run across any platform cosmopolitan can run on, which includes Windows, Linux, MacOS and more.

# Running

The two binaries that are built are `cosmosocks_server` and `cosmosocks_server_ape`. The two binaries are functionally the same, but the former will unpack itself into a temporary directory while the later will dynamically overwrite itself.

```bash

# Basic run with no arguments will bind global on port 1080

cosmosocks_server

# Specify a port to bind to

cosmosocks_server -p 8080

# Specify a username/password for authentication

cosmosocks_server -U user -P password

```

# Downloading

Release binaries are available on [GitHub](https://github.com/bannsec/cosmosocks/releases/latest).

# Building

All dependencies are provided in this repository. Building the program is simple as running `make`.

If you want to use a different cosmopolitan amalgamation, you can specify it with `COSMO`:

```bash

make COSMO=amalgamation-dbg

make COSMO=amalgamation-tiny

```