feat: default to ports 8080/8443 in server mode

- Server mode now defaults to standard proxy ports (8080 for HTTP, 8443 for HTTPS)
- Avoids random port selection, making it easier to configure applications
- Custom ports still available via HTTPJAIL_HTTP_BIND and HTTPJAIL_HTTPS_BIND
- Updated documentation to reflect the new defaults

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: ammario

README.md

@@ -46,9 +46,9 @@ httpjail --config rules.txt -- python script.py
 
 # Run as standalone proxy server (no command execution)
 httpjail --server -r "allow: .*"
-# Proxy auto-selects available ports (shown in output)
-# Configure your application with the displayed ports, e.g.:
-# HTTP_PROXY=http://localhost:8852 HTTPS_PROXY=http://localhost:8160
+# Server defaults to ports 8080 (HTTP) and 8443 (HTTPS)
+# Configure your application:
+# HTTP_PROXY=http://localhost:8080 HTTPS_PROXY=http://localhost:8443
 ```
 
 ## Architecture Overview
@@ -180,7 +180,7 @@ httpjail -vvv -r "allow: .*" -- curl https://example.com
 
 # Server mode - run as standalone proxy without executing commands
 httpjail --server -r "allow: github\.com" -r "deny: .*"
-# Proxy auto-selects available ports in 8000-8999 range (shown in output)
+# Server defaults to ports 8080 (HTTP) and 8443 (HTTPS)
 
 # Server mode with custom ports
 HTTPJAIL_HTTP_BIND=3128 HTTPJAIL_HTTPS_BIND=3129 httpjail --server -r "allow: .*"
@@ -193,17 +193,17 @@ HTTPJAIL_HTTP_BIND=3128 HTTPJAIL_HTTPS_BIND=3129 httpjail --server -r "allow: .*
 httpjail can run as a standalone proxy server without executing any commands. This is useful when you want to proxy multiple applications through the same httpjail instance.
 
 ```bash
-# Start server with automatic port selection (8000-8999 range)
+# Start server with default ports (8080 for HTTP, 8443 for HTTPS)
 httpjail --server -r "allow: github\.com" -r "deny: .*"
-# Output: Server running on ports 8852 (HTTP) and 8160 (HTTPS). Press Ctrl+C to stop.
+# Output: Server running on ports 8080 (HTTP) and 8443 (HTTPS). Press Ctrl+C to stop.
 
-# Start server with specific ports using environment variables
+# Start server with custom ports using environment variables
 HTTPJAIL_HTTP_BIND=3128 HTTPJAIL_HTTPS_BIND=3129 httpjail --server -r "allow: .*"
 # Output: Server running on ports 3128 (HTTP) and 3129 (HTTPS). Press Ctrl+C to stop.
 
 # Configure your applications to use the proxy:
-export HTTP_PROXY=http://localhost:8852
-export HTTPS_PROXY=http://localhost:8160
+export HTTP_PROXY=http://localhost:8080
+export HTTPS_PROXY=http://localhost:8443
 curl https://github.com  # This request will go through httpjail
 ```
 

src/main.rs

@@ -325,13 +325,16 @@ async fn main() -> Result<()> {
     let rule_engine = RuleEngine::new(rules, args.dry_run, args.log_only);
 
     // Get ports from env vars (optional)
+    // In server mode, default to 8080/8443 if not specified
     let http_port = std::env::var("HTTPJAIL_HTTP_BIND")
         .ok()
-        .and_then(|s| s.parse::<u16>().ok());
+        .and_then(|s| s.parse::<u16>().ok())
+        .or_else(|| if args.server { Some(8080) } else { None });
 
     let https_port = std::env::var("HTTPJAIL_HTTPS_BIND")
         .ok()
-        .and_then(|s| s.parse::<u16>().ok());
+        .and_then(|s| s.parse::<u16>().ok())
+        .or_else(|| if args.server { Some(8443) } else { None });
 
     // Determine bind address based on platform and mode
     let bind_address = if args.weak {