Comprehensive Guide to Docker Container Listing Commands: From Basics to Advanced Applications

Fundamentals of Docker Container Listing Commands

In Docker container management practice, viewing container status is the most basic and frequent operational requirement. Unlike the docker images command used to list images, Docker provides specialized container listing commands to meet different management scenarios.

Core Command Analysis

Docker container listing functionality is primarily implemented through two core commands: the traditional docker ps and the modern docker container ls. These two commands are functionally equivalent, but the latter better aligns with Docker's modern command organizational structure.

Basic Container Listing Operations

By default, Docker container listing commands only display currently running containers. Here are the basic command usage methods:

# Display only running containers
docker ps

# Display all containers, including stopped containers
docker ps -a

# Using modern command format
docker container ls
docker container ls -a

The output of these commands includes multiple key information fields: container ID, used image, startup command, creation time, status, port mapping, and container name. Understanding the meaning of these fields is crucial for effective container management.

Advanced Filtering Capabilities

Docker provides powerful filtering mechanisms that allow users to filter container lists based on specific criteria. Status filtering is one of the most commonly used filtering methods:

# Display only running containers
docker ps --filter "status=running"

# Display stopped containers
docker ps -a --filter "status=exited"

# Display paused containers
docker ps --filter "status=paused"

# Combine multiple filter conditions
docker ps --filter "status=running" --filter "label=environment=production"

Time-Related Container Queries

For scenarios requiring attention to recently created containers, Docker provides specialized parameters:

# Display the most recently created container
docker ps -l

# Display the 3 most recently created containers
docker ps -n 3

# Display containers created before a specified container
docker ps --filter "before=container_name"

# Display containers created after a specified container
docker ps --filter "since=container_name"

Output Format Customization

Docker allows users to customize output formats to adapt to different usage needs:

# Display only container IDs (suitable for script processing)
docker ps -q

# Display complete information (without truncating output)
docker ps --no-trunc

# Display container disk usage
docker ps -s

# Custom output format
docker ps --format "table {{.ID}}\t{{.Names}}\t{{.Status}}"

# JSON format output
docker ps --format json

Network and Port Filtering

For network-related container management, network and port filtering functions can be used:

# Display containers connected to specific networks
docker ps --filter "network=bridge"

# Display containers publishing specific ports
docker ps --filter "publish=80"

# Display containers exposing specific port ranges
docker ps --filter "expose=8000-8080"

Image-Based Filtering

Filtering can be performed based on the images used by containers, which is very useful when managing containers based on specific images:

# Display containers using specific images
docker ps --filter "ancestor=ubuntu:latest"

# Display containers using specific image IDs
docker ps --filter "ancestor=image_id"

Container Batch Operation Support

Container listing commands are often combined with other Docker commands to implement batch operations:

# Stop all running containers
docker stop $(docker ps -q)

# Remove all stopped containers
docker rm $(docker ps -aq)

# Force remove all containers
docker rm -f $(docker ps -aq)

Practical Application Scenarios

In actual container operations, these command combinations can solve various common problems: monitoring container health status, troubleshooting resource usage issues, managing container lifecycles, auditing system security, etc. By mastering these command parameters, operations personnel can significantly improve work efficiency.

Best Practice Recommendations

It is recommended to prioritize using the docker container ls command in daily work, as it better aligns with Docker's modern design philosophy. Meanwhile, reasonable use of filtering and formatting functions can reduce information overload and improve command output readability. For automated scripts, using the -q parameter to obtain container IDs is the best choice.