appendix/faq/errors.md
| 错误信息 / 现象 | 可能原因 | 解决方案 |
|---|---|---|
Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running? | Docker 服务未启动 | Linux: sudo systemctl start docker |
| Mac/Win: 启动 Docker Desktop | ||
permission denied while trying to connect to the Docker daemon socket | 当前用户不在 docker 用户组 | sudo usermod -aG docker $USER (需重新登录) |
manifest for ... not found: manifest unknown | 镜像 tag 不存在 | 检查 Docker Hub 该镜像是否存在该 tag，或拼写是否正确 |
connection refused (pull image) | 网络不通或镜像源无法访问 | 检查网络，配置镜像加速器 |
Bind for 0.0.0.0:8080 failed: port is already allocated | 端口被占用 | 检查占用端口的进程 (lsof -i:8080) 并杀掉，或换个端口映射 (-p 8081:80) |
exec user process caused "exec format error" | 架构不匹配 (如在 x86 上跑 ARM 镜像) | 使用 docker buildx 构建多架构镜像，或拉取对应架构的镜像 |
standard_init_linux.go:211: exec user process caused "no such file or directory" | 找不到解释器或依赖库 | 检查 ENTRYPOINT/CMD 脚本开头的 shebang (#!/bin/sh vs #!/bin/bash)，或确认二进制文件是否依赖缺失 (Alpine 常见缺少 glibc) |
iptables: No chain/target/match by that name | 防火墙规则缺失或冲突 | 重启 Docker 服务重置 iptables 链: sudo systemctl restart docker |
| 容器内无法访问外网 | DNS 配置或转发问题 | 检查 /etc/docker/daemon.json 中的 DNS 配置 |