Configuration
CLI Options
The proxy has three subcommands: run (default), init, and generate.
run - Start the proxy
Starts the debug proxy server. This is the default command when no subcommand is specified.
./wincc-unified-debug-proxy.exe run [OPTIONS]Options
Prop
Type
Examples
# Default: WinCC running locally
./wincc-unified-debug-proxy.exe run# WinCC running on another machine
./wincc-unified-debug-proxy.exe run -t 192.168.1.100# Custom ports with verbose logging
./wincc-unified-debug-proxy.exe run -d 9240 -e 9241 -vPath shortening
By default, long WinCC script paths are shortened so you can see the relevant part (screen and faceplate name) when browsing loaded scripts via Debug: Open Loaded Script... in the command palette:
# Long path (original)
/screen_modules/Screen_Content/HMI_RT_1::HMI_Screen/faceplate_modules/FaceplateName/Events.js
# Short path (default)
HMI_Screen/FaceplateName/Events.jsUse --long-paths if you need the full paths:
./wincc-unified-debug-proxy.exe run --long-pathsinit - Generate VS Code configuration
Generates a .vscode/launch.json with debug configurations.
./wincc-unified-debug-proxy.exe init [OPTIONS]Options
Prop
Type
Examples
# In the current directory
./wincc-unified-debug-proxy.exe init
# In a specific project
./wincc-unified-debug-proxy.exe init -o /path/to/project
# With custom ports
./wincc-unified-debug-proxy.exe init -d 9240 -e 9241If the ports in init differ from the defaults, make sure to use the same ports when running the proxy.
generate - Generate netsh scripts
Generates .bat scripts for setting up port forwarding and firewall rules on a remote WinCC machine. See Remote Debugging for the full setup guide.
./wincc-unified-debug-proxy.exe generate [OPTIONS] --address <ADDRESS>Options
Prop
Type
Generated files
| File | Purpose |
|---|---|
wincc-debug-setup-<ip>.bat | First-time setup: port proxy + firewall rules (idempotent) |
wincc-debug-restart-<ip>.bat | Re-apply port proxy after a Windows restart |
wincc-debug-cleanup-<ip>.bat | Remove all rules |
Examples
# Default port (9222)
./wincc-unified-debug-proxy.exe generate -a 192.168.1.100
# Custom port
./wincc-unified-debug-proxy.exe generate -a 192.168.1.100 -p 9333
# Output to a specific directory
./wincc-unified-debug-proxy.exe generate -a 192.168.1.100 -o ./scripts