imtpot/parallels-docker-port-forwarding

Parallels Docker Port Forwarding

Parallels Docker Port Forwarding is a service that automatically manages port forwarding for Docker containers running inside a Parallels VM.

Features

• Automatically detects running Docker containers and their exposed ports.
• Sets up port forwarding rules from the host to the Parallels VM.
• Monitors Docker events and updates port forwarding rules dynamically.

Requirements

• Python 3.8+
• Poetry
• Docker SDK for Python
• Parallels Desktop with prlctl and prlsrvctl command-line tools
• Docker configured to accept TCP connections on the VM

Setting up Docker to accept TCP connections on the VM

1. Edit the Docker service configuration file:

   Open the Docker service configuration file in your VM. This is usually located at /lib/systemd/system/docker.service.

   sudo nano /lib/systemd/system/docker.service

2. Modify the ExecStart line:

   Find the line that starts with ExecStart and modify it to include the -H tcp://0.0.0.0:2375 option. It should look something like this:

   ExecStart=/usr/bin/dockerd -H fd:// -H tcp://0.0.0.0:2375

3. Reload the systemd configuration and restart Docker:

   sudo systemctl daemon-reload
   sudo systemctl restart docker

4. Verify that Docker is listening on TCP port 2375:

   sudo netstat -tlpn | grep dockerd

Installation

You can install the package using pip:

pip install parallels-docker-port-forwarding

Usage

To start the port forwarding service, run:

parallels-docker-port-forwarding --vm-name "Your VM Name"

If the VM name is not provided, the default VM name 'Ubuntu 22.04.2 (x86_64 emulation)' will be used.

Development

To set up the development environment:

1. Clone the repository:

git clone https://github.com/imtpot/parallels-docker-port-forwarding.git
cd parallels-docker-port-forwarding

2. Install dependencies using Poetry:

poetry install

3. Run the service:

poetry run parallels-docker-port-forwarding --vm-name "Your VM Name"

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.