| 用途 | 指定运行用户与工作目录 |
|---|---|
| 语法 | -u UID[:GID]（或用户名） / -w 容器内路径 |
| 默认 | root 用户、镜像 WORKDIR |
示例
示例
docker run --rm -u 1000:1000 -v $PWD:/work -w /work alpine:3.20 touch out.txt
docker run --rm -u www-data php:8.3-fpm id容器内不存在同名用户时可以直接用数字 UID:GID，Docker 支持数值形式，不要求账号已创建。
本包目录（366 条）
基础命令50 条
- docker run 创建并启动容器
- docker ps 查看容器列表
- docker logs 查看容器日志
- docker exec 进入容器执行命令
- docker inspect 查看对象详情
- docker run -d 后台运行容器
- docker stats 实时资源占用
- docker run -it 交互式运行
- docker system df 磁盘占用总览
- docker run 环境变量 -e 与 --env-file
- docker stop 优雅停止容器
- docker rm 删除容器
- docker run --restart 重启策略
- docker run --name 与 --rm
- docker inspect -f 模板取值
- docker start 启动已停止容器
- docker cp 宿主与容器之间复制文件
- docker restart 重启容器
- docker system prune 综合清理
- docker run -u 与 -w 指定用户和目录
- docker ps --filter 筛选容器
- docker info 查看守护进程信息
- docker run --entrypoint 覆盖入口点
- docker logs 时间过滤 --since/--until
- docker kill 发送信号终止容器
- 每容器日志驱动与轮转参数
- docker ps --format 定制输出
- docker top 查看容器内进程
- docker version 查看客户端与引擎版本
- docker run --platform 指定架构
- docker run 运行时健康检查参数
- docker exec 常用选项 -u/-w/-e/-d
- 查询容器 IP 地址
- docker container prune 清理停止容器
- docker run --label 打标签
- docker run 停止信号与超时
- docker events 观察 daemon 事件流
- docker run --pull 拉取策略
- docker run --init 处理信号与僵尸进程
- docker port 查看端口映射
- 命令分组语法 container/image/network
- docker run --gpus 使用 GPU
- docker attach 附着到容器主进程
- docker pause 挂起容器
- docker commit 容器保存为镜像
- docker diff 查看容器文件改动
- docker export 导出容器文件系统
- docker wait 等待容器结束
- docker import 从 tar 导入镜像
- docker rename 重命名容器
docker run -u 与 -w 指定用户和目录
以指定 UID/GID 和初始工作目录运行容器进程，常用于让容器以非 root 身份写挂载目录，避免产出文件属主是 root。
易错点
- 宿主目录权限按 UID 数字匹配，用户名相同不代表权限一致；跨机器时要统一 UID
- 以非 root 运行后无法再写仅 root 可写的挂载目录，报 Permission denied 先核对目录属主
数据来源与参考
- Docker 官方 CLI 参考：docker run --user / --workdir（docs.docker.com）