> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reach.raysium.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Proxy System

> Configure proxy servers for your Telegram accounts

# Proxy System

The Proxy System allows you to route your Telegram traffic through proxy servers, providing additional privacy, IP management, and enabling advanced configurations for enterprise organizations.

## Overview

Proxies can help:

* Hide your actual IP address
* Manage IP reputation
* Enable geographic targeting
* Provide dedicated IPs for enterprise plans

<img src="https://mintlify.s3.us-west-1.amazonaws.com/raysium/accounts/placeholder-proxy-system.png" alt="Proxy Configuration" />

## Proxy Types

### Shared Proxy

Shared proxies are used by multiple users simultaneously.

**Features:**

* Lower cost option
* Available to all plans
* Good for basic privacy
* IP shared with other users

**Use Cases:**

* General privacy protection
* Basic IP rotation
* Cost-effective scaling

**Limitations:**

* Shared IP reputation
* Potential throttling
* Less control

### Dedicated Proxy (Enterprise)

Dedicated proxies are exclusively assigned to your organization.

**Features:**

* Exclusive IP address
* Full control over IP reputation
* Higher limits
* Priority support
* Custom configuration

**Use Cases:**

* Enterprise organizations
* High-volume sending
* IP reputation management
* Compliance requirements

**Requirements:**

* Enterprise plan subscription
* Organization-level configuration
* Additional monthly fee

## Configuring Proxies

### Organization-Level Settings

1. Navigate to **Settings** → **Organizations**
2. Select your organization
3. Go to **Addons** tab
4. Enable **Custom Proxies**

### Adding Proxy Regions

After enabling:

1. Go to **Accounts** → **Proxy Settings**
2. View available regions
3. Select regions for your organization
4. Slots are allocated based on plan

### Available Regions

| Region       | Status      | Slots Available |
| ------------ | ----------- | --------------- |
| US-East      | Available   | Limited         |
| US-West      | Available   | Limited         |
| EU-Central   | Available   | Limited         |
| EU-West      | Available   | Limited         |
| Asia-Pacific | Coming Soon | -               |

## Per-Account Proxy Configuration

### Enabling Proxy for Account

1. Navigate to **Accounts**
2. Select account to configure
3. Click **Settings** → **Proxy**
4. Enable proxy toggle
5. Select region

### Proxy Settings per Account

| Setting      | Description              |
| ------------ | ------------------------ |
| Use Proxy    | Enable/disable proxy     |
| Proxy Region | Select geographic region |
| Dedicated IP | Enterprise only          |

### Dedicated IP Assignment

For Enterprise plans:

1. Enable **Dedicated IP** toggle
2. System assigns exclusive IP
3. IP is reserved for your organization
4. Full reputation control

## Proxy Configuration Options

### Basic Configuration

For shared proxies:

* Enable/disable toggle
* Region selection
* Automatic rotation

### Advanced Configuration (Enterprise)

For dedicated proxies:

* Fixed IP address
* Custom hostname
* Port configuration
* Authentication credentials

## Monitoring Proxy Usage

### Usage Statistics

Track proxy performance:

* Messages sent via proxy
* Connection success rate
* Latency metrics
* Error rates

### Region Performance

Monitor each region's performance:

* Success rates
* Average latency
* Error breakdown
* Recommended regions

## Best Practices

### Proxy Selection

1. **Start with Shared**: Test with shared proxy first
2. **Monitor Performance**: Track success rates
3. **Upgrade as Needed**: Move to dedicated for better control

### Enterprise Organizations

1. **Request Dedicated**: Contact sales for dedicated IP
2. **Configure Properly**: Set up with IT support
3. **Monitor Closely**: Track IP reputation

### Troubleshooting

#### Connection Issues

If proxy connection fails:

1. Check region availability
2. Verify credentials
3. Try different region
4. Contact support

#### Performance Issues

If experiencing slow performance:

1. Try different region
2. Check usage limits
3. Consider dedicated proxy
4. Monitor error rates

## Limits and Pricing

### Shared Proxy Limits

Included with all plans:

* Message limits apply
* Region selection limited
* No guaranteed throughput

### Dedicated Proxy (Enterprise)

Additional cost:

* Custom pricing based on organization
* Includes dedicated IP
* Priority support
* Higher limits available

## Security Considerations

### Privacy

* Proxy hides your actual IP
* Telegram sees proxy IP
* Adds layer of anonymity

### Authentication

Enterprise proxies may require:

* Username/password
* API keys
* Certificate authentication

### Compliance

* Maintain records of proxy usage
* Document IP assignments
* Regular audits recommended

## Integration with Rate Limiting

Proxies work with rate limiting:

* Per-account limits still apply
* Proxy doesn't bypass rate limits
* Additional layer of protection

## FAQ

### Can I use my own proxy?

Currently, we provide managed proxies only. Custom proxy support is on the roadmap.

### How do I know if I need dedicated proxy?

Consider dedicated proxy if:

* You need full IP control
* You're on enterprise plan
* You have high volume needs
* IP reputation is critical

### What happens if proxy region is down?

System automatically:

* Shows region as unavailable
* Suggests alternative regions
* May fall back to no proxy

### Can I change proxy region?

Yes, you can:

1. Go to account settings
2. Disable current proxy
3. Select new region
4. Enable proxy

Changes take effect on next connection.