To expose the Docker container port, the host needs to access the container service through port mapping. 1. Use the docker run -p [host_port]:[container_port] command to run the container, such as docker run -p 8080:3000 my-web-app; 2. Use the EXPOSE directive to mark the purpose in the Dockerfile, such as EXPOSE 3000, but the port will not be automatically published; 3. Configure the ports segment of the yml file in Docker Compose, such as ports: - "8080:3000"; 4. Use docker ps to check whether the port mapping is effective after running. The above methods ensure that the container port is correctly exposed and verified.

Exposing a port from a Docker container to the host machine is a common task when running services like web servers, APIs, or databases inside containers. The key is mapping the container's internal port to a port on your host system so you can access it from outside Docker.

1. Use the -p Flag with docker run

The most straightforward way to expose a port is by using the -p (or --publish ) flag when running a container with docker run .

Basic syntax:

 docker run -p [host_port]:[container_port] [image_name]

For example, if you're running a web app inside the container that listens on port 3000:

 docker run -p 8080:3000 my-web-app

Now you can access the service via http://localhost:8080 on your host machine.

• You can specify multiple ports by repeating the -p flag.
• If you omit the host port ( -p 3000 ), Docker will assign a random available port automatically.
• This works for TCP and UDP; use -p 53:53/udp to expose UDP ports specifically.

2. Define Ports in a Dockerfile with EXPOSE

You can document which ports your image uses by adding the EXPOSE instruction in your Dockerfile:

 EXPOSE 3000

However, this does not actually publish the port —you still need to use -p when running the container. Think of EXPOSE as metadata for whoever runs the container later.

If you're building an image others will use, including EXPOSE helps them know what ports are relevant without guessing.

3. Use Docker Compose with the ports Section

If you're using Docker Compose, define port mappings under the ports section in your docker-compose.yml file:

 services:
  webapp:
    image: my-web-app
    Ports:
      - "8080:3000"

This has the same effect as the -p flag but keeps your configuration centralized and version-controlled.

• You can also use short syntax like "3000" to let Docker assign a random host port.
• For more control, use long syntax with extra options like protocol or mode.

4. Check Open Ports with docker ps

After starting your container, verify the port mapping with:

 docker ps

Look at the "PORTS" column. It should show something like:

 0.0.0.0:8080->3000/tcp

That confirms your host's port 8080 is forwarding to port 3000 in the container.

If you don't see any port listed, double-check that you used -p or configured ports correctly.

And that's basically it. Exposing ports isn't complicated once you know how Docker maps them—but it's easy to overlook a small detail like forgetting the -p flag or assuming EXPOSE does more than it does.

The above is the detailed content of How do you expose a port from a Docker container to the host machine?. For more information, please follow other related articles on the PHP Chinese website!