修改Docker容器配置文件后容器丢失，如何恢复？

问题根源 #

直接修改/var/lib/docker/containers/{containerid}/下的hostconfig.json和config.v2.json会破坏Docker daemon维护的元数据一致性，导致daemon无法识别容器，即使容器文件仍存在于目录中。

解决步骤 #

1. 停止Docker服务 #

先停掉Docker daemon，避免操作过程中读取到不一致的配置文件：

sudo systemctl stop docker
# 旧版sysvinit系统执行：sudo service docker stop

2. 检查配置文件的JSON格式 #

JSON语法错误是导致容器无法被识别的常见诱因，需验证并修复：

cd /var/lib/docker/containers/e96f84691fff
# 检查hostconfig.json格式合法性
python3 -m json.tool hostconfig.json > /dev/null && echo "hostconfig.json格式正常" || echo "hostconfig.json格式错误，请修复"
# 检查config.v2.json格式合法性
python3 -m json.tool config.v2.json > /dev/null && echo "config.v2.json格式正常" || echo "config.v2.json格式错误，请修复"

若提示格式错误，手动修正文件中的语法问题（比如缺失的引号、括号）。

3. 清理Docker元数据缓存 #

Docker会缓存容器和镜像的元数据，清理后daemon会重新扫描所有容器目录：

# 清理镜像元数据缓存
sudo rm -rf /var/lib/docker/image/*/imagedb/content/sha256/*
# 清理挂载层元数据缓存
sudo rm -rf /var/lib/docker/image/*/layerdb/mounts/*
# 可选：清理容器旧日志，避免潜在干扰
sudo rm -rf /var/lib/docker/containers/e96f84691fff/*.log.*

4. 重启Docker服务 #

让daemon重新加载所有容器的配置信息：

sudo systemctl start docker
# 旧版sysvinit系统执行：sudo service docker start

5. 验证容器状态 #

检查容器是否被重新识别：

docker ps -a | grep e96f84691fff

如果能看到容器记录，尝试启动容器：

sudo docker start e96f84691fff

备选方案：手动重建容器元数据（仅当上述步骤失效时使用） #

1. 导出原容器的配置文件：

cd /var/lib/docker/containers/e96f84691fff
cp config.v2.json /tmp/e96f84691fff_config.json
cp hostconfig.json /tmp/e96f84691fff_hostconfig.json

2. 创建临时容器（使用原容器对应的镜像）：

sudo docker create --name temp_container [原容器使用的镜像名称]

3. 停止Docker服务，替换临时容器的配置文件：

sudo systemctl stop docker
TEMP_CONTAINER_ID=$(docker inspect -f '{{.Id}}' temp_container)
sudo rm -rf /var/lib/docker/containers/$TEMP_CONTAINER_ID/*
sudo cp /tmp/e96f84691fff_*.json /var/lib/docker/containers/$TEMP_CONTAINER_ID/
sudo chown -R root:docker /var/lib/docker/containers/$TEMP_CONTAINER_ID/

4. 重启Docker并重命名容器：

sudo systemctl start docker
sudo docker rename temp_container [原容器的名称（如果有）]

后续注意事项 #

• 禁止直接修改Docker底层配置文件，修改端口映射的正确方式：
  1. 停止容器：sudo docker stop {containerid}
  2. 提交容器为新镜像：sudo docker commit {containerid} custom-image
  3. 用新镜像创建带新端口映射的容器：sudo docker run -p 宿主机端口:容器内端口 --name new-container custom-image
• 推荐使用docker-compose管理容器，修改docker-compose.yml后执行docker-compose up -d即可无缝更新配置。

内容的提问来源于stack exchange，提问作者Sebin H