Docker 部署项目与容器管理：挂载卷、查看、启动、停止和重启

1. 使用宿主机目录挂载#

如果希望直接看到宿主机上的文件，可以使用 bind mount：

1
mkdir -p data
2

3
docker run -d \
4
  --name my-app \
5
  --restart unless-stopped \
6
  -p 8080:3000 \
7
  -v "$(pwd)/data:/app/data" \
8
  my-app:1.0

这条命令完成了几件事：

• -d：让容器在后台运行。
• --name my-app：为容器指定一个便于管理的名称。
• --restart unless-stopped：容器异常退出时自动尝试启动，手动停止后不会自动恢复。
• -p 8080:3000：把宿主机的 8080 端口映射到容器的 3000 端口。
• -v "$(pwd)/data:/app/data"：把当前项目下的 data 目录挂载到容器内的 /app/data。

端口映射的格式是 宿主机端口:容器端口。启动后，访问 http://服务器地址:8080 就会请求容器内监听的 3000 端口。

也可以使用可读性更好的 --mount 写法：

1
docker run -d \
2
  --name my-app \
3
  --mount type=bind,src="$(pwd)/data",dst=/app/data \
4
  -p 8080:3000 \
5
  my-app:1.0

如果容器只需要读取配置，不应该修改宿主机文件，可以加上只读选项：

1
docker run -d \
2
  --name my-app \
3
  --mount type=bind,src="$(pwd)/config",dst=/app/config,readonly \
4
  -p 8080:3000 \
5
  my-app:1.0

2. 使用 Docker 命名卷#

如果不需要直接通过固定路径管理文件，可以使用 Docker 命名卷。命名卷由 Docker 管理，适合数据库、缓存和应用数据：

1
docker volume create my-app-data
2

3
docker run -d \
4
  --name my-app \
5
  --restart unless-stopped \
6
  -p 8080:3000 \
7
  -v my-app-data:/app/data \
8
  my-app:1.0

查看命名卷：

1
docker volume ls
2
docker volume inspect my-app-data

宿主机目录挂载和命名卷的区别可以简单理解为：宿主机目录挂载更直观，适合配置文件和需要人工查看的文件；命名卷更容易交给 Docker 管理，适合不关心宿主机具体存储路径的数据。

如果挂载的是宿主机目录，必须先确认目录存在，并检查目录权限。容器内进程使用的用户可能不是 root，因此宿主机目录即使存在，也不一定可写。

启动已经存在但当前停止的容器#

docker start 会使用容器原本的配置重新启动它，不会创建新的容器：

1
docker start my-app

启动后确认状态：

1
docker ps --filter name=my-app

停止容器#

优先使用 docker stop，它会先向应用发送停止信号，给程序留出清理资源的机会：

1
docker stop my-app

如果程序没有在默认等待时间内退出，可以强制终止：

1
docker kill my-app

docker kill 不会等待应用完成清理，应该只作为异常情况下的处理手段。

重启容器#

1
docker restart my-app

修改了宿主机挂载目录中的配置文件后，通常可以重启容器让应用重新读取配置：

1
docker restart my-app
2
docker logs --tail 50 my-app

但如果修改了 Dockerfile、依赖或镜像内的文件，单纯重启并不会重新构建镜像。此时应重新构建镜像，并重新创建容器：

1
docker build -t my-app:1.1 .
2
docker stop my-app
3
docker rm my-app
4
docker run -d \
5
  --name my-app \
6
  --restart unless-stopped \
7
  -p 8080:3000 \
8
  -v "$(pwd)/data:/app/data" \
9
  my-app:1.1

删除容器不会自动删除命名卷，但会删除容器本身的临时文件层。删除前可以先确认卷和挂载关系：

1
docker inspect my-app --format '{{json .Mounts}}'

1. 端口已被占用#

如果出现 address already in use，说明宿主机端口已经被其他进程或容器占用。可以查看端口和容器映射：

1
docker ps --format 'table {{.Names}}\t{{.Ports}}'
2
sudo ss -lntp | grep ':8080'

确认占用者后，可以停止它，或者把项目的宿主机端口改成其他端口，例如 8081:3000。

2. 容器启动后马上退出#

先查看状态和日志：

1
docker ps -a --filter name=my-app
2
docker logs my-app

常见原因包括启动命令错误、环境变量缺失、应用没有监听正确端口，以及应用只绑定了 127.0.0.1。在容器中运行的 Web 服务通常需要监听 0.0.0.0，否则即使端口映射正确，宿主机也可能无法访问。

3. 挂载目录不可写#

确认宿主机目录权限：

1
ls -ld data
2
docker exec my-app id

如果容器内应用使用普通用户运行，需要让宿主机目录的用户或用户组与容器进程匹配，或者根据镜像文档设置正确的权限。不要为了绕过问题而长期使用 chmod -R 777。

4. 修改文件后数据看起来没有变化#

检查容器实际使用的挂载关系：

1
docker inspect my-app --format '{{range .Mounts}}{{println .Source "->" .Destination}}{{end}}'

重点确认宿主机路径、容器内路径和读写模式是否正确。还要注意，挂载卷会覆盖容器内同一目录原有的文件；如果把一个空目录挂载到包含默认配置的目录，镜像中的默认文件可能会暂时不可见。