Custom Proxy Manager

A Chrome extension that allows users to easily configure and manage custom proxy settings directly from the browser.

Features

• Easy Proxy Configuration: Set up HTTP, SOCKS4, or SOCKS5 proxies with a simple interface
• Toggle Proxy: Enable or disable proxy settings with a single checkbox
• Persistent Settings: Your proxy configuration is saved and restored between browser sessions
• Local Bypass: Automatically bypasses proxy for local addresses
• Real-time Updates: Proxy settings are applied immediately when saved

Installation

Manual Installation (Developer Mode)

1. Download or clone this repository
2. Open Chrome and navigate to chrome://extensions/
3. Enable "Developer mode" by toggling the switch in the top right corner
4. Click "Load unpacked" and select the extension directory
5. The Custom Proxy Manager extension will appear in your extensions list

Chrome Web Store

This extension is not currently available on the Chrome Web Store

Usage

1. Click the Custom Proxy Manager icon in your Chrome toolbar
2. Check the "Activar Proxy" checkbox to enable proxy functionality
3. Enter your proxy server details:
   • Host: The proxy server address (e.g., proxy.example.com or 192.168.1.100)
   • Port: The proxy server port (e.g., 8080, 1080)
   • Type: Select the proxy type (HTTP, SOCKS4, or SOCKS5)
4. Click "Desar" (Save) to apply the settings
5. To disable the proxy, simply uncheck the "Activar Proxy" checkbox and save

Configuration Options

Proxy Types

• HTTP: Standard HTTP proxy protocol
• SOCKS4: SOCKS version 4 proxy protocol
• SOCKS5: SOCKS version 5 proxy protocol (supports authentication)

Bypass Rules

The extension automatically bypasses the proxy for:

• Local addresses (<local>)
• This helps ensure local network resources remain accessible

File Structure

custom_proxy_extension/
├── manifest.json      # Extension manifest and permissions
├── background.js      # Background service worker
├── popup.html         # Extension popup interface
├── popup.js          # Popup functionality and logic
├── icon.png          # Extension icon
└── README.md         # This documentation

Permissions

The extension requires the following permissions:

• proxy: To modify browser proxy settings
• storage: To save and retrieve proxy configuration
• scripting: For extension functionality
• activeTab: To interact with the current tab
• <all_urls>: To apply proxy settings to all websites

Technical Details

Manifest Version

This extension uses Manifest V3, the latest Chrome extension platform.

Storage

• Uses Chrome's sync storage API to persist settings across devices
• Settings are automatically synchronized when signed into Chrome

Background Script

The background service worker:

• Initializes default settings on installation
• Listens for storage changes and applies proxy configuration
• Provides real-time proxy updates

Development

Prerequisites

• Chrome browser (latest version recommended)
• Basic knowledge of JavaScript, HTML, and CSS

Testing

1. Load the extension in developer mode
2. Test various proxy configurations
3. Verify proxy settings are applied correctly
4. Check that local bypass rules work as expected

Debugging

• Use Chrome DevTools to inspect the popup (right-click > Inspect)
• Check the background script logs in chrome://extensions/ (click "Inspect views")
• Monitor network requests to verify proxy usage

Language Support

The extension interface is currently in Catalan:

• "Activar Proxy" = Enable Proxy
• "Desar" = Save
• "Proxy actualitzat" = Proxy updated

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

License

This project is open source. Please check the license file for more details.

Support

For issues, questions, or contributions, please open an issue in the project repository.

Version History

• v1.0: Initial release with basic proxy configuration functionality

Security Notes

• Always use trusted proxy servers
• Be cautious when entering proxy credentials
• The extension does not store or transmit sensitive information
• Proxy settings only apply to the current browser session

---

Note: This extension modifies your browser's proxy settings. Use responsibly and only with trusted proxy servers.