差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

后一修订版
前一修订版
docker [2026/10/08 17:30] – 创建 张叶安docker [2026/10/08 17:49] (当前版本) – 保护变量名中的下划线,避免被解析成斜体 张叶安
行 1: 行 1:
-新建中+====== Docker 入门与实践 ====== 
 + 
 +Docker 是目前最主流的**容器化**工具:把应用和它的运行环境一起打包成一个「盒子」,在任何装好 Docker 的机器上用同样的方式运行。 
 + 
 +本页按「是什么 → 怎么装 → 核心概念 → 常用命令 → 构建镜像 → 编排 → 实际部署 → 运维排错」的顺序组织,可以按需跳读。 
 + 
 +===== 一、Docker 是什么 ===== 
 + 
 +一句话:**Docker 把「程序和它的运行环境」打包成镜像,用容器的方式隔离运行。** 
 + 
 +传统的痛点是「在我机器上是好的」:Python 版本、系统库、环境变量、依赖版本对不上,换台机器就跑不起来。Docker 把这些东西一起固化进镜像,运行环境随程序走。 
 + 
 +==== 容器和虚拟机的区别 ==== 
 + 
 +^ 对比项 ^ 虚拟机(VM) ^ Docker 容器 ^ 
 +| 隔离方式 | 硬件虚拟化,每台跑一个完整操作系统 | 共享宿主机内核,进程级隔离 | 
 +| 启动速度 | 分钟级 | 毫秒到秒级 | 
 +| 资源开销 | 每台通常几 GB 内存 | 通常几十 MB | 
 +| 体积 | 镜像常见 GB 级 | 常见几十 MB 到几百 MB | 
 +| 隔离强度 | 强(各自独立内核) | 较弱(共用内核,安全边界不如 VM) | 
 + 
 +结论:容器**不是**轻量虚拟机,它就是一个被限制了视野的进程。 
 + 
 +==== 三个核心概念 ==== 
 + 
 +  * **镜像 image**:只读的应用模板,包含文件系统 + 启动命令 + 元数据。用 ''Dockerfile'' 构建出来,可以分层复用。 
 +  * **容器 container**:镜像的运行实例。镜像可以起无数个容器,容器内写入的数据默认随容器删除而消失。 
 +  * **仓库 registry**:镜像的分发中心,官方的叫 Docker Hub,公司内部常用 Harbor、GitLab Registry 等。 
 + 
 +配套的两个概念: 
 + 
 +  * **数据卷 volume**:把需要长期保存的数据放在容器之外,容器删掉数据还在。 
 +  * **网络 network**:容器之间、容器和外部世界互通的方式,同一自定义网络内的容器可以用容器名互相访问。 
 + 
 +==== 它一般用来做什么 ==== 
 + 
 +  * 统一开发、测试、生产环境,减少「环境不一致」类问题 
 +  * 快速部署开源软件(数据库、中间件、监控、博客系统等) 
 +  * 把自研服务打包成镜像,交给 CI/CD 自动发布 
 +  * 在一台机器上跑多个互不干扰的服务 
 + 
 +===== 二、安装与环境准备 ===== 
 + 
 +==== Linux(以 Ubuntu / Debian 为例)==== 
 + 
 +推荐用官方 apt 仓库安装,这样能跟着系统一起升级: 
 + 
 +<code bash> 
 +sudo apt update 
 +sudo apt install -y ca-certificates curl gnupg 
 +sudo install -m 0755 -d /etc/apt/keyrings 
 +curl -fsSL https://download.docker.com/linux/ubuntu/gpg \ 
 +  | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg 
 +echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \ 
 +https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo $VERSION_CODENAME) stable" \ 
 +  | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null 
 +sudo apt update 
 +sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin 
 +</code> 
 + 
 +只想在个人测试机上快速装完,也可以执行官方一键脚本(不适合生产环境): 
 + 
 +<code bash> 
 +curl -fsSL https://get.docker.com | sh 
 +</code> 
 + 
 +==== 验证安装 ==== 
 + 
 +<code bash> 
 +docker version          # 客户端 + 服务端版本 
 +docker info             # 服务端详情:存储驱动、镜像数、根目录 
 +docker run hello-world  # 跑一个最小镜像,能输出提示就说明通了 
 +</code> 
 + 
 +==== 免 sudo 使用 ==== 
 + 
 +<code bash> 
 +sudo usermod -aG docker $USER 
 +# 重新登录(或 newgrp docker)后生效 
 +</code> 
 + 
 +注意:加入 docker 组等于给了这台机器的 root 权限,生产服务器上要谨慎。 
 + 
 +==== 配置国内镜像加速与日志上限 ==== 
 + 
 +编辑 ''/etc/docker/daemon.json'' 这个文件: 
 + 
 +<code json> 
 +{ 
 +  "registry-mirrors": ["https://docker.m.daocloud.io"], 
 +  "log-driver": "json-file", 
 +  "log-opts": { "max-size": "10m", "max-file": "3" } 
 +} 
 +</code> 
 + 
 +改完用 ''sudo systemctl restart docker'' 重启服务。日志上限很重要,否则容器日志会把磁盘写满。 
 + 
 +==== Docker Desktop(Windows / macOS)==== 
 + 
 +Windows 和 macOS 没有 Linux 内核,官方给出的图形化方案是 **Docker Desktop**:它内置了 Docker Engine、CLI、Compose、Buildx,还带一个可选的单节点 Kubernetes。 
 + 
 +安装步骤(Windows 为例): 
 + 
 +  - 到 Docker 官网下载 Docker Desktop 安装包 
 +  - 安装时勾选使用 WSL2 后端(也可以在设置里切换),比旧的 Hyper-V 后端更快、更省资源 
 +  - 启动后任务栏出现鲸鱼图标,状态显示 Engine running 就绪 
 +  - 打开终端执行 ''docker version'' 验证,CLI 与 Docker Desktop 是同一套,命令和在 Linux 上完全一样 
 + 
 +界面里几个主要页面: 
 + 
 +^ 页面 ^ 用途 ^ 
 +| Containers | 查看和启停容器;点进去能看日志(Logs)、进终端(Exec)、浏览容器内文件(Files) | 
 +| Images | 本地镜像列表,可以直接 Run 成容器,也能 Pull 新镜像 | 
 +| Volumes / Builds | 管理数据卷、查看构建历史与缓存 | 
 +| Settings | 资源分配、镜像加速、文件共享、Kubernetes 开关 | 
 + 
 +常用操作: 
 + 
 +  - 在 Images 页面点 **Run**,填上端口映射(如 ''8080:80'' )和挂载卷,就起了一个容器 
 +  - 容器详情页的 Logs 是排错第一现场,Exec 相当于执行 ''docker exec -it'' 
 +  - Settings → Resources 里调整 CPU、内存、磁盘上限(默认内存偏小,跑 MySQL 建议给到 4 GB 以上) 
 +  - Settings → Docker Engine 里可以直接改 daemon.json,把镜像加速地址粘进去,Apply & restart 生效 
 +  - Settings → Resources → File sharing 里配置可以与容器共享的宿主机目录,否则绑定挂载会失败 
 +  - 出问题时用 Troubleshoot 看诊断日志,实在不行 Reset to factory defaults 重置 
 + 
 +几个容易踩的坑: 
 + 
 +  - **Windows 下的绑定挂载**:路径要用 Docker Desktop 认得的写法,或直接用 WSL2 里的路径;项目放在 WSL2 文件系统(如 ''/home/you/project'' )里比放在 C 盘快很多 
 +  - Docker Desktop 的 Linux 容器实际跑在一个小虚拟机里,所以容器里的 ''localhost'' 不是你的电脑,要访问宿主机上的服务得用 ''host.docker.internal'' 
 +  - 它只适合开发和测试;生产服务器请直接在 Linux 上安装 Docker Engine 
 +  - 公司规模较大时,Docker Desktop 的商业授权需要先确认 
 + 
 +在 Docker Desktop 的终端里,本页后面所有命令都能直接执行,用法与 Linux 完全一致。 
 + 
 +===== 三、架构与工作原理 ===== 
 + 
 +Docker 采用客户端/服务端架构: 
 + 
 +  * **docker CLI**:你敲的命令行,负责把请求发给守护进程 
 +  * **dockerd(守护进程)**:真正干活的,管理镜像、容器、网络、卷 
 +  * **containerd / runc**:底层运行时,负责实际创建和启动容器进程 
 +  * **registry**:镜像仓库,''docker pull'' 从这里下载镜像,''docker push'' 推上去 
 + 
 +镜像采用**分层**存储:Dockerfile 里每条构建指令生成一层,层可以被多个镜像共享。容器启动时在镜像最上面加一个可写层,所有修改都写在这层里,因此: 
 + 
 +  * 容器删掉,可写层的改动就没了 
 +  * 需要保留的数据必须放到数据卷或挂载目录里 
 + 
 +===== 四、常用命令速查 ===== 
 + 
 +==== 镜像 ==== 
 + 
 +<code bash> 
 +docker pull nginx:1.27-alpine     # 下载镜像,不写 tag 默认 latest(不建议) 
 +docker images                     # 列出本地镜像 
 +docker image inspect nginx:1.27   # 查看镜像详情 
 +docker rmi nginx:1.27             # 删除镜像 
 +docker tag myapp:1.0 registry.example.com/myapp:1.0 
 +docker push registry.example.com/myapp:1.0 
 +</code> 
 + 
 +==== 容器 ==== 
 + 
 +<code bash> 
 +docker run -d --name web -p 8080:80 nginx:1.27-alpine   # 后台运行并映射端口 
 +docker run -it --rm ubuntu:22.04 bash                   # 交互式临时容器,退出即删 
 +docker ps                       # 运行中的容器 
 +docker ps -a                    # 包括已停止的 
 +docker logs -f --tail 100 web   # 跟踪日志 
 +docker exec -it web sh          # 进入容器 
 +docker stop web / docker start web / docker restart web 
 +docker rm web                   # 删除容器(先 stop) 
 +docker cp web:/etc/nginx/nginx.conf ./nginx.conf 
 +docker inspect web              # 完整信息(JSON) 
 +docker stats                    # 实时资源占用 
 +</code> 
 + 
 +端口映射的写法是 ''-p 宿主机端口:容器端口'' ,比如 ''8080:80'' 表示访问宿主机 8080 就打到容器里的 80。 
 + 
 +==== 卷与网络 ==== 
 + 
 +<code bash> 
 +docker volume create app-data 
 +docker volume ls 
 +docker network create appnet 
 +docker network ls 
 +</code> 
 + 
 +==== 清理(会删数据,执行前确认)==== 
 + 
 +<code bash> 
 +docker system df                # 先看看占了多少 
 +docker system prune             # 清理停止的容器、悬空镜像、未用网络 
 +docker system prune -a --volumes  # 更彻底,慎用 
 +</code> 
 + 
 +===== 五、构建镜像:Dockerfile ===== 
 + 
 +''Dockerfile'' 是构建镜像的说明书。一个 Node.js 服务的例子: 
 + 
 +<code dockerfile> 
 +FROM node:20-alpine 
 +WORKDIR /app 
 +COPY package*.json ./ 
 +RUN npm ci --omit=dev 
 +COPY . . 
 +ENV NODE_ENV=production 
 +EXPOSE 3000 
 +USER node 
 +CMD ["node", "server.js"] 
 +</code> 
 + 
 +构建并运行: 
 + 
 +<code bash> 
 +docker build -t myapp:1.0 . 
 +docker run -d --name myapp -p 3000:3000 myapp:1.0 
 +</code> 
 + 
 +==== 常用指令 ==== 
 + 
 +^ 指令 ^ 作用 ^ 
 +| ''FROM'' | 基础镜像,必须是第一条有效指令 | 
 +| ''WORKDIR'' | 设置后续指令的工作目录 | 
 +| ''COPY'' | 从构建上下文拷贝文件进镜像 | 
 +| ''ADD'' | 类似 COPY,还能解压 tar、拉远程 URL(一般优先用 COPY) | 
 +| ''RUN'' | 构建时执行命令,结果固化进镜像层 | 
 +| ''ENV'' | 设置镜像内的环境变量(运行时可被覆盖) | 
 +| ''ARG'' | 构建期参数,只在构建时可见 | 
 +| ''EXPOSE'' | 声明监听端口,只是文档性质,不发布端口 | 
 +| ''VOLUME'' | 声明匿名数据卷挂载点 | 
 +| ''USER'' | 切换运行用户,避免用 root | 
 +| ''HEALTHCHECK'' | 定义健康检查命令 | 
 +| ''CMD'' | 容器启动的默认命令,可被 ''docker run'' 后面的参数覆盖 | 
 +| ''ENTRYPOINT'' | 容器入口,不易被覆盖,常配合 CMD 传默认参数 | 
 + 
 +==== 多阶段构建 ==== 
 + 
 +把编译环境和运行环境分开,最终镜像只留运行需要的文件: 
 + 
 +<code dockerfile> 
 +FROM golang:1.22 AS builder 
 +WORKDIR /src 
 +COPY go.mod go.sum ./ 
 +RUN go mod download 
 +COPY . . 
 +RUN CGO_ENABLED=0 go build -o /out/app ./cmd/app 
 + 
 +FROM gcr.io/distroless/static 
 +COPY --from=builder /out/app /app 
 +ENTRYPOINT ["/app"] 
 +</code> 
 + 
 +==== 利用缓存的三个技巧 ==== 
 + 
 +  - 把**变化少的**内容放前面:先拷贝依赖清单并安装依赖,最后才拷贝源码 
 +  - 写 ''.dockerignore'' 文件,排除不需要进构建上下文的文件: 
 + 
 +<code> 
 +node_modules 
 +.git 
 +.env 
 +dist 
 +*.log 
 +</code> 
 + 
 +  - 合并 ''RUN'' 里相关的命令,并及时清理包管理器缓存 
 + 
 +===== 六、数据持久化与网络 ===== 
 + 
 +==== 数据卷 vs 绑定挂载 ==== 
 + 
 +^ 方式 ^ 写法 ^ 典型场景 ^ 
 +| 具名卷 | ''-v app-data:/var/lib/postgresql/data'' | 数据库等需要长期保存的数据,由 Docker 管理 | 
 +| 绑定挂载 | ''-v /srv/app/logs:/app/logs'' | 需要直接在宿主机上查看或编辑的文件(配置、日志) | 
 +| 匿名卷 | 只写容器内路径 | 临时使用,不推荐依赖 | 
 + 
 +一句话原则:**容器里只放代码,数据一律放卷或挂载目录。** 
 + 
 +==== 网络 ==== 
 + 
 +<code bash> 
 +docker network create appnet 
 +docker run -d --name api --network appnet myapp:1.0 
 +docker run -d --name db --network appnet postgres:16-alpine 
 +</code> 
 + 
 +要点: 
 + 
 +  * 在同一个自定义网络里,容器之间可以直接用**容器名**当主机名,例如应用连数据库时,主机名直接写数据库的容器名 ''db'' 
 +  * 容器里的 ''localhost'' 指的是容器自己,不是宿主机 
 +  * 需要访问宿主机上的服务时,Linux 下用宿主机在网桥上的 IP(通常是 172.17.0.1),或者用 ''host.docker.internal'' 这个主机名(需要额外配置) 
 +  * 默认的 ''bridge'' 网络不支持用容器名互访,所以务必建自定义网络或直接用 Compose 
 + 
 +===== 七、部署 MySQL 与 Redis ===== 
 + 
 +有状态服务是最常自建的一类,套路基本一致:官方镜像 + 数据卷 + 环境变量初始化 + 只对内网暴露端口。 
 + 
 +==== MySQL ==== 
 + 
 +最小可用的启动命令: 
 + 
 +<code bash> 
 +docker run -d --name mysql \ 
 +  -e MYSQL_ROOT_PASSWORD=换成强密码 \ 
 +  -e MYSQL_DATABASE=app \ 
 +  -e MYSQL_USER=app \ 
 +  -e MYSQL_PASSWORD=换成强密码 \ 
 +  -e TZ=Asia/Shanghai \ 
 +  -p 127.0.0.1:3306:3306 \ 
 +  -v mysql-data:/var/lib/mysql \ 
 +  --restart unless-stopped \ 
 +  mysql:8.4 
 +</code> 
 + 
 +几个关键点: 
 + 
 +  * 数据必须落在 ''/var/lib/mysql'' 对应的卷里,容器删了数据还在 
 +  * 端口写成 ''127.0.0.1:3306:3306'' ,只监听本机;直接写 ''3306:3306'' 就等于对公网开放数据库 
 +  * ''%%MYSQL_ROOT_PASSWORD%%'' 是必填项,不写容器会直接退出 
 +  * 用 ''%%MYSQL_USER%%'' 和 ''%%MYSQL_PASSWORD%%'' 建业务账号,应用不要用 root 连 
 +  * 初次启动初始化要几秒到几十秒,用 ''docker logs -f mysql'' 看进度 
 + 
 +进去验证: 
 + 
 +<code bash> 
 +docker exec -it mysql mysql -uroot -p 
 +# 输入密码后 
 +SHOW DATABASES; 
 +</code> 
 + 
 +初始化建表脚本:把 sql 文件挂到镜像约定的目录,首次启动会自动执行。 
 + 
 +<code bash> 
 +docker run -d --name mysql \ 
 +  -e MYSQL_ROOT_PASSWORD=换成强密码 \ 
 +  -v mysql-data:/var/lib/mysql \ 
 +  -v /srv/mysql/init:/docker-entrypoint-initdb.d:ro \ 
 +  mysql:8.4 
 +</code> 
 + 
 +注意:init 脚本只在**数据目录为空**的第一次启动时执行,之后放进去不会跑;想重跑得换一个新卷。 
 + 
 +==== 用 Compose 管理 ==== 
 + 
 +<code yaml> 
 +services: 
 +  mysql: 
 +    image: mysql:8.4 
 +    restart: unless-stopped 
 +    environment: 
 +      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD} 
 +      MYSQL_DATABASE: app 
 +      MYSQL_USER: app 
 +      MYSQL_PASSWORD: ${MYSQL_PASSWORD} 
 +      TZ: Asia/Shanghai 
 +    command: 
 +      - --character-set-server=utf8mb4 
 +      - --collation-server=utf8mb4_unicode_ci 
 +    ports: 
 +      - "127.0.0.1:3306:3306" 
 +    volumes: 
 +      - mysql-data:/var/lib/mysql 
 +    healthcheck: 
 +      test: ["CMD", "mysqladmin", "ping", "-h", "127.0.0.1"] 
 +      interval: 10s 
 +      timeout: 5s 
 +      retries: 10 
 + 
 +volumes: 
 +  mysql-data: 
 +</code> 
 + 
 +应用连接时,主机名写服务名 ''mysql'' (在同一个 Compose 网络里),不要写 ''localhost'' 。 
 + 
 +==== 备份与恢复 ==== 
 + 
 +<code bash> 
 +# 备份 
 +docker exec mysql sh -c 'exec mysqldump -uroot -p"$MYSQL_ROOT_PASSWORD" app' \ 
 +  | gzip > /srv/backup/app-$(date +%F).sql.gz 
 + 
 +# 恢复 
 +gunzip < /srv/backup/app-2026-01-01.sql.gz \ 
 +  | docker exec -i mysql sh -c 'exec mysql -uroot -p"$MYSQL_ROOT_PASSWORD" app' 
 +</code> 
 + 
 +==== Redis ==== 
 + 
 +<code bash> 
 +docker run -d --name redis \ 
 +  -p 127.0.0.1:6379:6379 \ 
 +  -v redis-data:/data \ 
 +  --restart unless-stopped \ 
 +  redis:7-alpine \ 
 +  redis-server --appendonly yes --requirepass 换成强密码 
 +</code> 
 + 
 +几个关键点: 
 + 
 +  * Redis 默认**没有密码**,一旦暴露到公网很快会被扫到并植入挖矿程序,务必设 ''%%--%%requirepass'' 并只监听本机 
 +  * ''%%--%%appendonly yes'' 打开 AOF 持久化,数据落在 ''/data'' 卷里 
 +  * 只当缓存用、丢了也无所谓的场景,可以不挂卷,性能更好 
 +  * 生产环境要设内存上限和淘汰策略,避免把宿主机内存吃光 
 + 
 +连接测试: 
 + 
 +<code bash> 
 +docker exec -it redis redis-cli -a 换成强密码 
 +> PING 
 +PONG 
 +</code> 
 + 
 +==== 用 Compose 管理 ==== 
 + 
 +<code yaml> 
 +services: 
 +  redis: 
 +    image: redis:7-alpine 
 +    restart: unless-stopped 
 +    command: 
 +      - redis-server 
 +      - --appendonly 
 +      - "yes" 
 +      - --requirepass 
 +      - ${REDIS_PASSWORD} 
 +      - --maxmemory 
 +      - 512mb 
 +      - --maxmemory-policy 
 +      - allkeys-lru 
 +    ports: 
 +      - "127.0.0.1:6379:6379" 
 +    volumes: 
 +      - redis-data:/data 
 +    healthcheck: 
 +      test: ["CMD", "redis-cli", "-a", "${REDIS_PASSWORD}", "PING"] 
 +      interval: 10s 
 +      timeout: 3s 
 +      retries: 5 
 + 
 +volumes: 
 +  redis-data: 
 +</code> 
 + 
 +想用配置文件,可以把 ''redis.conf'' 挂到 ''/usr/local/etc/redis/redis.conf'' ,启动命令改成 ''redis-server /usr/local/etc/redis/redis.conf'' 。 
 + 
 +==== 常见问题 ==== 
 + 
 +^ 现象 ^ 处理 ^ 
 +| 应用连不上这两个服务 | 确认在同一网络里;主机名写服务名,不要写 ''localhost'' | 
 +| 容器起来就退出 | 多半缺必需的环境变量(MySQL 的 root 密码、Redis 的密码),看 ''docker logs'' | 
 +| 数据不见了 | 没挂卷,或者容器内路径写错了(MySQL 是 ''/var/lib/mysql'' ,Redis 是 ''/data'' ) | 
 +| 中文乱码 | MySQL 启动参数加上 ''utf8mb4'' 相关设置 | 
 +| 宿主机内存被打满 | Redis 设 ''maxmemory'' 和淘汰策略,容器也可加内存限制 | 
 + 
 +一点提醒:本地开发用 Docker 跑 MySQL、Redis 非常方便,但生产环境这类有状态服务,优先考虑云数据库或托管服务;自建的话,备份、监控和内存上限一个都别省。 
 + 
 +===== 八、Docker Compose 编排 ===== 
 + 
 +一个容器还好管,服务一多(应用 + 数据库 + 缓存 + 反向代理)就得用 Compose 把配置写进 ''compose.yaml'' ,一条命令起停整套。 
 + 
 +<code yaml> 
 +services: 
 +  web: 
 +    build: . 
 +    ports: 
 +      - "8080:3000" 
 +    environment: 
 +      DATABASE_URL: postgres://app:secret@db:5432/app 
 +    depends_on: 
 +      db: 
 +        condition: service_healthy 
 +    restart: unless-stopped 
 + 
 +  db: 
 +    image: postgres:16-alpine 
 +    environment: 
 +      POSTGRES_USER: app 
 +      POSTGRES_PASSWORD: secret 
 +      POSTGRES_DB: app 
 +    volumes: 
 +      - db-data:/var/lib/postgresql/data 
 +    healthcheck: 
 +      test: ["CMD-SHELL", "pg_isready -U app"] 
 +      interval: 5s 
 +      timeout: 3s 
 +      retries: 10 
 + 
 +volumes: 
 +  db-data: 
 +</code> 
 + 
 +常用命令: 
 + 
 +<code bash> 
 +docker compose up -d          # 后台启动整套 
 +docker compose up -d --build  # 重新构建镜像再启动 
 +docker compose ps             # 查看状态 
 +docker compose logs -f web    # 看某个服务的日志 
 +docker compose exec web sh    # 进某个服务 
 +docker compose restart web    # 重启单个服务 
 +docker compose down           # 停止并删除容器(卷默认保留) 
 +docker compose config         # 检查配置是否正确 
 +</code> 
 + 
 +旧的 ''docker-compose'' (带连字符)是 v1,已停止维护;现在统一用 v2 插件形式 ''docker compose'' 。 
 + 
 +''restart'' 策略值得记住:''no'' 、''always'' 、''on-failure'' 、''unless-stopped'' 。生产环境一般用 ''unless-stopped'' ,机器重启后服务能自动回来。 
 + 
 +===== 九、实战:部署一个 Web 应用 ===== 
 + 
 +下面是最常见的一套流程:一台云服务器 + 域名 + 应用容器 + 数据库容器 + Nginx 反向代理 + HTTPS。 
 + 
 +==== 1. 准备服务器 ==== 
 + 
 +  - 一台 Linux 服务器(1 核 2G 起,把域名 A 记录解析到它的公网 IP) 
 +  - 开放 80、443 端口;**不要**对公网暴露数据库端口 
 +  - 按第二章安装 Docker 并配置镜像加速、日志上限 
 + 
 +==== 2. 放置项目 ==== 
 + 
 +<code bash> 
 +sudo mkdir -p /srv/myapp && cd /srv/myapp 
 +# 上传代码,或 git clone 仓库 
 +</code> 
 + 
 +目录结构大致是: 
 + 
 +<code> 
 +/srv/myapp 
 +├── compose.yaml 
 +├── Dockerfile 
 +├── .env 
 +└── src/ 
 +</code> 
 + 
 +==== 3. 用 .env 管理密码 ==== 
 + 
 +<code> 
 +POSTGRES_PASSWORD=换成你的强密码 
 +DATABASE_URL=postgres://app:换成你的强密码@db:5432/app 
 +</code> 
 + 
 +''.env'' 要放到 ''compose.yaml'' 同级目录,并在 ''compose.yaml'' 里用 ''${POSTGRES_PASSWORD}'' 引用。**凭据绝不写进镜像,也不提交到 Git。**  
 + 
 +==== 4. 启动 ==== 
 + 
 +<code bash> 
 +docker compose up -d --build 
 +docker compose ps 
 +docker compose logs -f 
 +</code> 
 + 
 +看到服务状态正常、日志没有报错,应用就在 8080 上跑起来了。 
 + 
 +==== 5. 配置 Nginx 反向代理 ==== 
 + 
 +<code nginx> 
 +server { 
 +    listen 80; 
 +    server_name example.com; 
 + 
 +    location / { 
 +        proxy_pass http://127.0.0.1:8080; 
 +        proxy_set_header Host $host; 
 +        proxy_set_header X-Real-IP $remote_addr; 
 +        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; 
 +        proxy_set_header X-Forwarded-Proto $scheme; 
 +    } 
 +} 
 +</code> 
 + 
 +再执行 ''sudo certbot %%--%%nginx -d example.com'' 自动签发并续期 HTTPS 证书。 
 + 
 +也可以把 Nginx 本身做成一个 Compose 服务,放到同一个网络里,''proxy_pass'' 直接写应用的服务名。 
 + 
 +==== 6. 上线后的更新流程 ==== 
 + 
 +<code bash> 
 +cd /srv/myapp 
 +git pull 
 +docker compose pull        # 若基础镜像有更新 
 +docker compose up -d --build 
 +docker compose ps 
 +</code> 
 + 
 +==== 7. 备份(以 PostgreSQL 为例)==== 
 + 
 +<code bash> 
 +docker compose exec -T db pg_dump -U app app | gzip > /srv/backup/app-$(date +%F).sql.gz 
 +</code> 
 + 
 +用 ''cron'' 定时执行,并定期验证备份文件能不能恢复。 
 + 
 +===== 十、日常运维与排错 ===== 
 + 
 +==== 查问题的一般顺序 ==== 
 + 
 +  - ''docker compose ps'' 看容器是不是在跑、有没有反复重启 
 +  - ''docker compose logs %%--%%tail 200 服务名'' 看日志,90% 的问题在这里 
 +  - ''docker inspect 容器名'' 看退出码、挂载、环境变量、网络 
 +  - ''docker exec -it 容器名 sh'' 进去手工验证(能不能连数据库、文件在不在) 
 + 
 +==== 常见问题 ==== 
 + 
 +^ 现象 ^ 原因与处理 ^ 
 +| 容器起来几秒就退出 | 主进程执行完或报错,先看 ''docker logs'' ;容器需要一个前台进程撑着 | 
 +| 端口被占用 | ''ss -lntp'' 找到占用者,或换一个宿主机端口 | 
 +| 容器里连不上宿主机服务 | 容器内的 ''localhost'' 是自己,用服务名或网桥 IP | 
 +| 容器之间互相访问失败 | 不在同一自定义网络里,用 Compose 或 ''docker network connect'' | 
 +| 挂载目录没有权限 | 容器内用户 uid/gid 与宿主机目录属主不匹配,''chown'' 或指定 ''user'' | 
 +| 时区不对 | 加参数 ''-e TZ=Asia/Shanghai'' ,或挂载 ''/etc/localtime'' | 
 +| 磁盘被占满 | ''docker system df'' 定位,限制日志大小,用 ''docker system prune'' 清理 | 
 +| 拉取镜像超时 | 配置 registry 镜像加速,或给 dockerd 设置 HTTP 代理 | 
 +| ''.env'' 改了不生效 | 环境变量在容器创建时注入,需要 ''docker compose up -d'' 重建容器 | 
 + 
 +==== 几个好用的小命令 ==== 
 + 
 +<code bash> 
 +docker inspect -f '{{.State.Status}}' web        # 只看状态 
 +docker inspect -f '{{json .NetworkSettings.Networks}}' web 
 +docker compose top                                # 看容器里的进程 
 +docker compose down && docker compose up -d       # 配置改动后的干净重启 
 +</code> 
 + 
 +===== 十一、最佳实践与进阶方向 ===== 
 + 
 +==== 最佳实践清单 ==== 
 + 
 +  * 一个容器只跑一个主进程,别把应用和数据库塞进同一个镜像 
 +  * 基础镜像选精简版(''alpine'' 、''slim'' 、''distroless'' ),并**固定版本 tag**,不要用 ''latest'' 
 +  * 用多阶段构建缩小产物体积 
 +  * 用非 root 用户运行(''USER'' ),只读挂载不需要写入的目录 
 +  * 敏感信息用环境变量、secret 或外部配置中心,不进镜像、不进 Git 
 +  * 数据一律放卷,容器本身当作可随时丢弃的 
 +  * 给关键服务配 ''healthcheck'' 和 ''restart'' 策略 
 +  * 限制日志大小与容器资源(''%%--%%memory'' 、''%%--%%cpus'' ) 
 +  * 定期清理与更新镜像,扫描漏洞(如 ''trivy image'' ) 
 + 
 +==== 进阶方向 ==== 
 + 
 +  - **编排**:单机用 Compose,多机再上 Kubernetes(Docker Swarm 已较少用于新项目) 
 +  - **CI/CD**:GitHub Actions / GitLab CI 里 build 并 push 镜像,服务器上只做 pull + up 
 +  - **镜像仓库**:自建 Harbor,做镜像签名、复制和权限管理 
 +  - **可观测性**:cAdvisor + Prometheus + Grafana 看资源,Loki 收日志 
 +  - **构建优化**:BuildKit、Buildx 多平台构建(''%%--%%platform linux/amd64,linux/arm64'' ),构建缓存 
 +  - **安全**:Rootless 模式、镜像漏洞扫描、最小权限运行 
 + 
 +===== 小结 ===== 
 + 
 +  - Docker 的核心是**镜像—容器—仓库**三件套,加上**卷**和**网络** 
 +  - 日常操作记牢几条:''docker run -d -p'' 、''docker ps'' 、''docker logs -f'' 、''docker exec -it'' 、''docker build -t'' 
 +  - 多服务用 ''compose.yaml'' 描述,''docker compose up -d'' 一条命令起停 
 +  - 上线要做的三件事:数据放卷、凭据放 ''.env'' 、日志设上限 
 +  - 出问题先看日志,再 inspect,最后进容器手工验证 

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • docker.1791451817.txt.gz
  • 最后更改: 2026/10/08 17:30
  • 由 张叶安