Linux Docker的环境配置与简单使用

参考资料

1. Windows Docker Desktop设置中文
2. 【Docker 】Docker Desktop for Windows（WSL 2）安装
3. WSL 2 上的 Docker 远程容器入门

一. 环境配置

1.1 安装WSL

⏹详情请参考下面这篇博客
Linux Windows之wsl安装使用简介

1.2 安装配置 Docker Desktop

⏹从官网下载安装Docker Desktop

• ※因为Docker Desktop依赖于wsl，所以需要先安装wsl
• https://www.docker.com/products/docker-desktop/

⏹安装完成之后，进行如下配置

• 指定Docker镜像的磁盘存储位置
• 指定对应的wsl

⏹当我们的wsl和docker都配置完成之后，使用下面的命令应该能看到docker的版本和wsl的挂载目录

apluser@FengYeHong-HP:~$ docker --version
Docker version 28.1.1, build 4eba377
apluser@FengYeHong-HP:~$
apluser@FengYeHong-HP:~$ ls -l /mnt/wsl/
drwxr-xr-x 4 root root 100 Jun 11 20:06 docker-desktop
drwxr-xr-x 3 root root  60 Jun 11 20:06 docker-desktop-bind-mounts
-rw-r--r-- 1 root root 198 Jun 11 20:06 resolv.conf

1.3 VS Code 插件安装

⏹Docker扩展

• 提供对Dockerfile的语法检测，代码高亮，自动补全
• 可以通过菜单运行各种Docker命令
• 可以在左侧面板中看到我们创建的所有镜像，容器等

⏹Dev Containers扩展

• 支持在容器中打开代码项目
• 自动配置开发环境，通过 .devcontainer 目录定义语言版本、依赖、插件等
• 调试支持，支持容器内调试（Node.js、Python、C++ 等）

1.4 下载项目，配置Dockerfile

⏹执行下面的git命令，下载示例项目

• git clone https://github.com/mattwojo/helloworld-django.git

⏹下载完成之后，移动到示例项目的根目录，应该会看到这样的目录

apluser@FengYeHong-HP:helloworld-django$ ls -l
total 148
-rw-r--r-- 1 apluser apluser    483 Jun 11 20:48 Dockerfile
-rw-r--r-- 1 apluser apluser 131072 Jun  7 16:56 db.sqlite3
drwxr-xr-x 4 apluser apluser   4096 Jun  7 09:38 hello
-rwxr-xr-x 1 apluser apluser    667 Jun  7 09:38 manage.py
-rw-r--r-- 1 apluser apluser     16 Jun  7 09:38 requirements.txt
drwxr-xr-x 3 apluser apluser   4096 Jun  7 09:38 web_project

二. 常用Docker命令简介

⏹所有的命令都可以通过docker --help查看

2.1 Dockerfile打包镜像

⏹在项目的根目录下手动创建一个Dockerfile文件，创建之后的目录如下

apluser@FengYeHong-HP:helloworld-django$ ls -l
total 148
-rw-r--r-- 1 apluser apluser    196 Jun  7 16:54 Dockerfile
-rw-r--r-- 1 apluser apluser 131072 Jun  7 16:56 db.sqlite3
drwxr-xr-x 4 apluser apluser   4096 Jun  7 09:38 hello
-rwxr-xr-x 1 apluser apluser    667 Jun  7 09:38 manage.py
-rw-r--r-- 1 apluser apluser     16 Jun  7 09:38 requirements.txt
drwxr-xr-x 3 apluser apluser   4096 Jun  7 09:38 web_project
apluser@FengYeHong-HP:helloworld-django$
apluser@FengYeHong-HP:helloworld-django$ cat Dockerfile
# 安装python环境, 指定基础镜像
FROM python:3.11-slim
# 创建一个名为 app 的工作目录
WORKDIR /app
# 将当前目录下的 requirements.txt 复制到app工作目录中
COPY requirements.txt .

# 运行pip命令, 安装python项目所需的依赖
RUN pip install --no-cache-dir -r requirements.txt
# 将当前目录下的所有内容都复制到app工作目录中
COPY . /app

# 指定8000端口
EXPOSE 8000
# 启动python项目
CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]

• -t参数用来指定 image 文件的名字，后面还可以用冒号指定标签。如果不指定，默认的标签就是latest。
• 最后的那个.表示Dockerfile文件所在的路径，因为当前路径在Dockerfile文件所在的目录，所示是一个.。

docker image build -t helloworld-django .
# 或者
docker image build -t helloworld-django:0.0.1 .

2.2 image镜像

2.2.1 docker image ls 查看所有镜像

apluser@FengYeHong-HP:~$ docker image ls
REPOSITORY          TAG       IMAGE ID       CREATED        SIZE
helloworld-django   latest    51fedeaf85ff   2 days ago     363MB
hello-world         latest    0b6a027b5cf3   4 months ago   20.4kB

2.2.2 docker image rm 镜像ID 删除指定镜像

apluser@FengYeHong-HP:~$ docker image rm 51fedeaf85ff
Untagged: helloworld-django:latest
Deleted: sha256:51fedeaf85ffdc569edae785cce00602eb90b4a7a12766c6f671a517f0c4f199
apluser@FengYeHong-HP:~$
apluser@FengYeHong-HP:~$ docker image ls
REPOSITORY    TAG       IMAGE ID       CREATED        SIZE
hello-world   latest    0b6a027b5cf3   4 months ago   20.4kB

2.3 container容器

2.3.1 docker run 创建并启动容器

• -it：容器的 Shell 映射到当前的 Shell，然后你在本机窗口输入的命令，就会传入容器
• --rm：容器一旦停止就会自动删除(仅在临时测试时使用)
• -p：容器的 8000 端口映射到本机的 8100 端口
• helloworld-django:latest：指定要启动的容器

apluser@FengYeHong-HP:~$ docker run -it --rm -p 8100:8000 helloworld-django:latest
Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).

You have 18 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them.
June 14, 2025 - 00:12:19
Django version 3.2.25, using settings 'web_project.settings'
Starting development server at http://0.0.0.0:8000/
Quit the server with CONTROL-C.

⏹容器启动之后，在浏览器中就可以看到如下所示的界面

2.3.2 docker container ls --all 查看所有容器

• docker container ls：查看正在运行的容器
• docker container ls --all：查看正在所有容器，包括已经停止运行的容器

⏹docker ps 的作用和docker container相同，只不过从语义化上看来，docker container更好。

2.3.3 容器的停止

2.3.3.1 docker stop

⏹docker stop 容器ID：停止正在运行的容器。注意：停止运行的容器并不会被删除。

• docker stop <容器ID或名称> 会向容器发送 SIGTERM 信号，让其优雅退出，如果在默认的 10 秒内还没退出，则发送 SIGKILL 强制终止。
• docker kill <容器ID或名称> 会立即强制终止容器（不等待）

apluser@FengYeHong-HP:~$ docker container ls
CONTAINER ID   IMAGE                      COMMAND                  CREATED          STATUS          PORTS                    NAMES
d32995d7a305   helloworld-django:latest   "python manage.py ru…"   22 minutes ago   Up 22 minutes   0.0.0.0:8100->8000/tcp   kind_bassi
apluser@FengYeHong-HP:~$
apluser@FengYeHong-HP:~$ docker stop d32995d7a305
d32995d7a305

2.3.3.2 docker container stop

apluser@FengYeHong-HP:~$ docker container ls
CONTAINER ID   IMAGE                      COMMAND                  CREATED          STATUS          PORTS                    NAMES
783e1ad29407   helloworld-django:latest   "python manage.py ru…"   16 minutes ago   Up 16 minutes   0.0.0.0:8100->8000/tcp   reverent_lalande
apluser@FengYeHong-HP:~$
apluser@FengYeHong-HP:~$ docker container stop 783e1ad29407
783e1ad29407

2.3.4 容器的删除

2.3.4.1 docker rm

⏹如果你不只是要停止容器，还想连容器一起删除（比如临时容器），可以用docker rm -f， -f 相当于先 stop 再 rm

apluser@FengYeHong-HP:~$ docker container ls
CONTAINER ID   IMAGE                      COMMAND                  CREATED          STATUS         PORTS                    NAMES
4c07319bbebc   helloworld-django:latest   "python manage.py ru…"   11 seconds ago   Up 9 seconds   0.0.0.0:8100->8000/tcp   infallible_sammet
apluser@FengYeHong-HP:~$
apluser@FengYeHong-HP:~$ docker rm -f 4c07319bbebc
4c07319bbebc

2.3.4.2 docker container rm

⏹语义化更好

apluser@FengYeHong-HP:~$ docker container ls --all
CONTAINER ID   IMAGE                      COMMAND                  CREATED          STATUS                      PORTS                    NAMES
6380b917ff0c   helloworld-django:latest   "python manage.py ru…"   44 seconds ago   Up 42 seconds               0.0.0.0:8100->8000/tcp   determined_boyd
f0e58479ba3d   helloworld-django          "python manage.py ru…"   54 minutes ago   Exited (0) 54 minutes ago                            vigorous_leavitt
cca37d72e4ba   helloworld-django          "python manage.py ru…"   54 minutes ago   Exited (0) 54 minutes ago                            musing_franklin
f51614fe80d9   helloworld-django:latest   "python manage.py ru…"   55 minutes ago   Exited (0) 54 minutes ago                            unruffled_franklin
bb11c3bbaf5f   helloworld-django          "python manage.py ru…"   56 minutes ago   Exited (0) 56 minutes ago                            relaxed_banach
apluser@FengYeHong-HP:~$
apluser@FengYeHong-HP:~$ docker container rm bb11c3bbaf5f
bb11c3bbaf5f
apluser@FengYeHong-HP:~$

2.3.5 docker exec进入容器内部

apluser@FengYeHong-HP:~$ docker container ls
CONTAINER ID   IMAGE                      COMMAND                  CREATED          STATUS          PORTS                    NAMES
783e1ad29407   helloworld-django:latest   "python manage.py ru…"   12 seconds ago   Up 11 seconds   0.0.0.0:8100->8000/tcp   reverent_lalande
apluser@FengYeHong-HP:~$
apluser@FengYeHong-HP:~$ docker exec -it 783e1ad29407 bash
root@783e1ad29407:/app# ls -l
total 20
-rw-r--r-- 1 root root  483 Jun 11 11:48 Dockerfile
-rw-r--r-- 1 root root    0 Jun 13 23:58 db.sqlite3
drwxr-xr-x 4 root root 4096 Jun  7 00:38 hello
-rwxr-xr-x 1 root root  667 Jun  7 00:38 manage.py
-rw-r--r-- 1 root root   16 Jun  7 00:38 requirements.txt
drwxr-xr-x 3 root root 4096 Jun  7 00:38 web_project

2.3.6 docker container start 启动一个既存的容器

⏹docker run的方式会创建并启动一个容器，同样的命令运行两次，就会生成两个一模一样的容器文件。
如果希望重复使用容器，就要使用docker container start命令，它用来启动已经生成、已经停止运行的容器文件。

2.3.7 docker container logs 查看 docker 容器的输出

⏹docker 容器的输出，即容器里面 Shell 的标准输出。如果

• docker run 命令运行容器的时候，没有使用-it参数
• docker container start 直接启动既存容器时

就要用这个命令查看输出。

2.3.8 docker container cp 复制容器内的文件到本地

⏹将容器内的requirements.txt文件复制到本地的指定路径中

apluser@FengYeHong-HP:~$ docker exec -it f0e58479ba3d bash
root@f0e58479ba3d:/app#
root@f0e58479ba3d:/app# ls -l
total 20
-rw-r--r-- 1 root root  483 Jun 11 11:48 Dockerfile
-rw-r--r-- 1 root root    0 Jun 13 23:58 db.sqlite3
drwxr-xr-x 4 root root 4096 Jun  7 00:38 hello
-rwxr-xr-x 1 root root  667 Jun  7 00:38 manage.py
-rw-r--r-- 1 root root   16 Jun  7 00:38 requirements.txt
drwxr-xr-x 3 root root 4096 Jun  7 00:38 web_project
root@f0e58479ba3d:/app#
root@f0e58479ba3d:/app# exit
exit
apluser@FengYeHong-HP:~$ docker container cp f0e58479ba3d:/app/requirements.txt /home/apluser/work/
Successfully copied 2.05kB to /home/apluser/work/
apluser@FengYeHong-HP:~$
apluser@FengYeHong-HP:~$ ls -l /home/apluser/work/requirements.txt
-rw-r--r-- 1 apluser apluser 16 Jun  7 09:38 /home/apluser/work/requirements.txt

2.4 registry仓库

⏹Docker Registry 是 Docker 提供的镜像仓库服务，用于 存储、分发和管理 Docker 镜像。可使用 Docker Registry 来：

• 上传（push）镜像
• 下载（pull）镜像
• 搭建私有镜像仓库

Docker Registry 常与 docker login, docker push, docker pull 命令配合使用。

2.4.1 docker pull 镜像拉取

⏹镜像拉取语法：docker pull <registry>/<仓库>:<标签>

# 从docker的官网仓库拉取nginx镜像
docker pull nginx:latest
# 从私人仓库拉取镜像
docker pull myregistry.com:5000/myimage:latest

2.4.2 docker push 镜像推送

⏹在推送镜像之前，你需要为镜像添加仓库地址和标签。

# docker tag <本地镜像ID或名称> <registry>/<镜像名称>:<标签>
docker tag myapp:latest myregistry.com:5000/myapp:latest

⏹向指定的仓库推送镜像

# docker push <registry>/<镜像名称>:<标签>
docker push myregistry.com:5000/myapp:latest

三. docker-compose

3.1 遇到的问题

💦当我们直接使用docker run -it --rm -p 8100:8000 helloworld-django:latest命令创建并运行容器的时候，django工程会出现下面的提示，原因就在于我们在并没有进行数据迁移。

You have 18 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them.

⏹我们可以通过下面的方式进行数据迁移

docker run -it \
-v $(pwd)/db.sqlite3:/app/db.sqlite3 \
-w /app \
helloworld-django \
python manage.py migrate

💥注意，在此案例中数据迁移之后的有数据的db.sqlite3文件并不在容器中，而是在本地的路径下。
因此，之后真正启动容器的时候，必须要将本地目录下的db.sqlite3文件挂载到容器中才行，也就是说容器中的程序读取的是本地目录中的db.sqlite3文件

⏹使用挂载的数据的同时，启动容器

• -v /主机路径文件:/容器路径文件 这会让容器内部使用主机上的文件，从而让 db.sqlite3 的内容得以持久保存。
• -w /app 设置容器内的工作目录是 /app，这个要与你 Dockerfile 中 WORKDIR 设置一致（通常也是 /app）

docker run -it -p 8100:8000 \
-v $(pwd)/db.sqlite3:/app/db.sqlite3 \
-w /app \
helloworld-django

💦但是输入这么长的命令，不仅繁琐，还很容器出错，有没有什么更好的办法？

3.2 docker-compose.yml 配置文件

⏹将命令行中的配置命令，通过yml文件的方式简化到配置文件中

apluser@FengYeHong-HP:helloworld-django$ ls -l
total 152
-rw-r--r-- 1 apluser apluser    483 Jun 11 20:48 Dockerfile
-rw-r--r-- 1 apluser apluser 131072 Jun 14 14:49 db.sqlite3
-rw-r--r-- 1 apluser apluser    259 Jun 14 15:14 docker-compose.yml
drwxr-xr-x 4 apluser apluser   4096 Jun  7 09:38 hello
-rwxr-xr-x 1 apluser apluser    667 Jun  7 09:38 manage.py
-rw-r--r-- 1 apluser apluser     16 Jun  7 09:38 requirements.txt
drwxr-xr-x 3 apluser apluser   4096 Jun  7 09:38 web_project
apluser@FengYeHong-HP:helloworld-django$
apluser@FengYeHong-HP:helloworld-django$ cat docker-compose.yml
services:
  web:
    image: helloworld-django
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "8100:8000"
    volumes:
      - ./db.sqlite3:/app/db.sqlite3
    working_dir: /app
    command: python manage.py runserver 0.0.0.0:8000

3.3 docker-compose build 构建镜像

3.4 数据迁移

⏹docker-compose run web python manage.py migrate

• 执行命令进行数据迁移
• 此处的web应当和docker-compose.yml文件中的services对应的名称相同

💥需要注意的是，这种 docker-compose run 会启动一个一次性容器，它不会被 docker-compose up 管理到。

3.5 docker-compose up 运行容器

# --remove-orphans 在启动的时候，删除被遗漏的容器
docker-compose up --remove-orphans
# 在后台启动容器
docker-compose up -d

⏹如下图所示，容器启动成功，页面也能正常访问。