Quick Start

This guide will help you set up a basic Juicity proxy server and connect to it with a client.

1. Server Setup

Prerequisites

A server with a public IP.
A valid TLS certificate and private key (Let's Encrypt is recommended) or a self-signed certificate.

Configuration

Create a file named server.json:

{
    "listen": ":23182",
    "users": {
        "00000000-0000-0000-0000-000000000000": "my_secure_password"
    },
    "certificate": "/path/to/fullchain.cer",
    "private_key": "/path/to/private.key",
    "congestion_control": "bbr",
    "log_level": "info"
}

Replace the UUID keys in users with your own generated UUIDs.
Update paths to your certificates.

Run Server

./juicity-server run -c server.json

2. Client Setup

Configuration

Create a file named client.json on your local machine:

{
    "listen": ":1080",
    "server": "your.server.ip.or.domain:23182",
    "uuid": "00000000-0000-0000-0000-000000000000",
    "password": "my_secure_password",
    "sni": "example.com",
    "allow_insecure": false,
    "congestion_control": "bbr",
    "log_level": "info"
}

listen: The address the local SOCKS5/HTTP proxy will listen on.
server: The public address of your Juicity server.
sni: The domain name matching your server's certificate.

Run Client

./juicity-client run -c client.json

3. Verify

Configure your browser or system proxy to use SOCKS5 127.0.0.1:1080. You should now be browsing through your Juicity server.

« Previous Next »