docker run 命令需严格遵循“运行参数→挂载与网络→镜像名→启动命令”顺序，镜像名必须置尾；-v 主机路径须真实存在且有权限，-p 端口映射方向勿反，-e 环境变量须逐个指定；五类高频报错（权限、端口占用、空间不足、路径错误、网络异常）均有对应秒级排查法；持久化推荐命名卷，绑定挂载需预置目录并修正属主；调试时用 -it 替代 -d、--entrypoint 覆盖启动命令、docker logs 查日志。
写对 docker run 命令是用好 docker 的第一步，但新手常因参数顺序、挂载路径、端口映射或环境变量漏设而失败。真正卡住人的往往不是概念，而是命令写错后报的那几行红字——比如“port is already allocated”“no such file or directory”“permission denied”。这篇指南不讲原理堆砌，只聚焦怎么写出一条能跑通的启动命令，以及遇到报错时最快定位和修复的方法。
基础命令结构要记牢
一条典型的容器启动命令由四部分组成：镜像名、运行参数、挂载与网络配置、启动命令（可选）。顺序不能乱，否则 Docker 会解析失败。
-
镜像名必须放在最后：如
docker run -d -p 8080:80 nginx:alpine，把nginx:alpine写在最前会报错 “unknown shorthand flag”。 -
-v 挂载路径注意方向：格式是
-v 主机路径:容器路径，主机路径必须真实存在且有读写权限；容器路径是应用期望的路径，比如 MySQL 要求/var/lib/mysql。 -
-p 端口映射别写反：
-p 3306:3306表示把宿主机 3306 映射到容器 3306；如果写成-p 3306:3307，而容器内服务实际监听的是 3306，就无法访问。 -
环境变量用 -e 逐个传：多个变量要重复写
-e，例如-e MYSQL_ROOT_PASSWORD=123 -e MYSQL_DATABASE=test；不能合并成-e "MYSQL_ROOT_PASSWORD=123 MYSQL_DATABASE=test"。
五类高频报错及秒级排查法
报错信息里藏着线索，别急着重装 Docker。先看日志、再查资源、最后动配置。
-
“Permission denied while trying to connect to the Docker daemon socket”：说明当前用户没权限调用 Docker 服务。执行
sudo usermod -aG docker $USER，然后退出终端重进，或运行newgrp docker切换组生效。 -
“port is already allocated”：宿主机端口被占。用
sudo lsof -i :端口号或sudo netstat -tuln | grep :端口号查进程，杀掉或换端口即可。 -
“No space left on device”：不是磁盘满，而是 Docker 存储空间（通常是
/var/lib/docker）满了。运行docker system prune -a清理未用镜像和构建缓存；长期可用docker builder prune单独清构建层。 -
“OCI runtime create failed: … no such file or directory”：常见于挂载了不存在的主机目录，或容器内路径写错。检查
-v后面的主机路径是否存在（ls -l /your/host/path），并确认容器内程序是否真需要那个路径。 -
“failed to create endpoint … network sandbox join failed”：多出现在重启 Docker 后或网络配置异常时。直接重启 Docker 服务：
sudo systemctl restart docker，再重新docker run。
带数据持久化的安全启动写法
很多容器一重启数据就丢，问题出在没做持久化。正确做法是用命名卷或绑定挂载，同时避免权限错配。
-
优先用命名卷（推荐）：Docker 自动管理权限和生命周期。例如启动 MySQL：
docker run -d --name mysql-db -e MYSQL_ROOT_PASSWORD=123 -v mysql-data:/var/lib/mysql -p 3306:3306 mysql:8.0。其中mysql-data是卷名，首次运行自动创建。 -
绑定挂载需手动准备目录：如
-v ./conf:/etc/nginx/conf.d，先确保当前目录下有conf文件夹，且执行命令的用户对该文件夹有读写权（chmod 755 conf）。 -
避免 root 权限陷阱：某些镜像（如官方 PostgreSQL）要求容器内非 root 用户写数据。若挂载目录属主是 root，容器会启动失败。解决方法是提前改属主：
sudo chown -R 999:999 ./pgdata（999 是 postgres 用户 ID）。
调试技巧：让容器“不闪退”
刚启动就退出？不是崩溃，是前台进程结束了。用下面方法留住它，看清到底发生了什么。
-
去掉 -d，加 -it 进交互模式：例如
docker run -it --rm nginx:alpine sh，直接进 shell，手动执行nginx -g "daemon off;"看是否报错。 -
用 --entrypoint 覆盖启动命令：想查某个容器里有没有某个命令，比如确认 Python 版本：
docker run -it --entrypoint python my-python-app --version。 -
查日志比猜快得多：容器退出后立即执行
docker logs 容器名；如果已删，加--since "10m"查最近十分钟日志。
