How zzjin/portproxy works
portproxy assigns stable local URLs to development servers and routes requests arriving from an existing TLS-terminating reverse proxy. The main workflow infers a name, chooses or accepts an app port, starts the command, registers its route, and ensures the on-demand proxy is available. Workspace fleets, worktree-aware naming, static aliases, route cleanup, and URL lookup/listing are separate capabilities. The sampled excerpts show proxy forwarding and route persistence; some CLI command wiring and proxy lifecycle details are documented in the README but not fully sampled.
Main entry points: main.rs Run applications · proxy.rs HTTP proxy · routes.rs Route store · naming.rs Name inference
Components 20
CLI and process launch
- CLI dispatch
src/main.rs - Run applications
src/main.rs - Port selection
src/ports.rs - Proxy lifecycle
src/main.rs - Route commands
src/main.rs - URL lookup and listing
src/main.rs - npm installer
npm/install.js
Names and workspaces
- Name inference
src/naming.rs - Workspace discovery
src/workspace.rs - Worktree suffix
src/worktree.rs
Routes and proxy
- Route store
src/routes.rs - Route record
src/types.rs - HTTP proxy
src/proxy.rs - WebSocket tunnel
src/proxy.rs
Configuration and utilities
- Project configuration
src/config.rs - Global configuration
src/config.rs - Shared utilities
src/utils.rs
Other components
- Developer
- Caddy / Nginx
- Development server
Connections 24
- Developer → CLI dispatch: runs commands
README.md - CLI dispatch → Run applications: dispatches run
src/main.rs - Run applications → Name inference: infers name
README.md - Name inference → Workspace discovery: checks workspace
src/naming.rs - Name inference → Worktree suffix: adds suffix
- Run applications → Project configuration: loads overrides
README.md - Run applications → Port selection: chooses port
README.md - Run applications → Route store: registers route
README.md - Run applications → Proxy lifecycle: ensures proxy
README.md - Run applications → Development server: starts command
README.md - Workspace discovery → Run applications: enumerates packages
README.md - Proxy lifecycle → Global configuration: loads listen settings
README.md - Proxy lifecycle → HTTP proxy: starts proxy
README.md - Route commands → Route store: adds or prunes
src/main.rs - Route store → Route record: persists routes
src/routes.rs - Route store → Shared utilities: checks process liveness
src/routes.rs - HTTP proxy → Route store: loads route table
src/proxy.rs - Caddy / Nginx → HTTP proxy: forwards HTTP
README.md - HTTP proxy → Development server: forwards requests
src/proxy.rs - HTTP proxy → WebSocket tunnel: dispatches upgrades
src/proxy.rs - WebSocket tunnel → Development server: tunnels connection
src/proxy.rs - CLI dispatch → URL lookup and listing: handles get and list
README.md - URL lookup and listing → Global configuration: formats URLs
src/config.rs - Developer → npm installer: installs package
README.md