Linux command
winpodx 命令
文件
复制后可按需替换文件名、目录或参数。
常用示例
Start the Windows pod
winpodx pod start --wait
List available Windows applications
winpodx app list
Launch a registered application
winpodx app run [app_name]
Open a local file
winpodx app run [app_name] [path/to/file]
Launch the full Windows desktop
winpodx app run desktop
Open the Qt6 graphical interface
winpodx gui
Stop the pod
winpodx pod stop
Run the interactive setup wizard
winpodx setup
说明
winpodx runs a Windows guest inside a Podman or Docker container and presents individual Windows applications as native Linux windows through FreeRDP RemoteApp. Each app gets its own pinnable, alt-tabbable window with the original icon and file association, without exposing the underlying Windows desktop. A small HTTP agent inside the guest receives bearer-authenticated commands from the host so app launches do not flash a PowerShell window. Application discovery, password rotation, multi-session, and health checks are all driven from the winpodx CLI; a Qt6 GUI provides the same actions plus an allowlisted in-app terminal. winpodx targets Linux only. The first run downloads a Windows ISO, runs Sysprep, and applies an OEM customisation pass; expect five to ten minutes before the pod is usable.
参数
- app list
- Show every Windows application detected inside the pod.
- app run _name_ _file_
- Launch the named application as a RemoteApp window. An optional file is opened with that application.
- app install _name_
- Register a custom application in the desktop launcher menu.
- app install-all
- Register every detected application as a desktop launcher entry.
- app sessions
- List active RemoteApp sessions.
- app kill _name_
- Terminate a running RemoteApp session.
- app refresh
- Rescan the Windows guest for newly installed applications.
- pod start --wait
- Start the Windows container. --wait blocks until RDP is reachable.
- pod stop
- Stop the Windows container.
- pod restart
- Restart the Windows container.
- pod status
- Print container, RDP, and agent state.
- pod wait-ready --logs
- Block until the first-boot Sysprep / OEM phase finishes. --logs streams progress.
- pod apply-fixes
- Reapply Windows-side configuration tweaks (registry, services, defaults).
- pod sync-password
- Synchronise the RDP password between winpodx.toml and the Windows guest.
- pod multi-session {_on_|_off_|_status_}
- Toggle bundled rdprrap multi-session support.
- power --suspend
- Pause the running container.
- power --resume
- Resume a paused container.
- rotate-password
- Generate and apply a new RDP password.
- setup
- Run the interactive first-time configuration wizard.
- check --json
- Run health probes (pod, RDP, agent, round-trip, disk) and print results.
- info
- Print system diagnostics (versions, paths, dependencies).
- cleanup
- Remove stale Office lock files in the guest.
- timesync
- Force a time synchronisation in the Windows guest.
- debloat
- Disable telemetry and unneeded services in the guest.
FAQ
What is the winpodx command used for?
winpodx runs a Windows guest inside a Podman or Docker container and presents individual Windows applications as native Linux windows through FreeRDP RemoteApp. Each app gets its own pinnable, alt-tabbable window with the original icon and file association, without exposing the underlying Windows desktop. A small HTTP agent inside the guest receives bearer-authenticated commands from the host so app launches do not flash a PowerShell window. Application discovery, password rotation, multi-session, and health checks are all driven from the winpodx CLI; a Qt6 GUI provides the same actions plus an allowlisted in-app terminal. winpodx targets Linux only. The first run downloads a Windows ISO, runs Sysprep, and applies an OEM customisation pass; expect five to ten minutes before the pod is usable.
How do I run a basic winpodx example?
Run `winpodx pod start --wait` in a terminal, then adjust file names, paths, flags, or remote targets for your system.
What does app list do in winpodx?
Show every Windows application detected inside the pod.