差别

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

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版
前一修订版
docker [2026/10/08 17:31] – 修正一处 code 标签折行 张叶安docker [2026/10/08 17:49] (当前版本) – 保护变量名中的下划线,避免被解析成斜体 张叶安
行 59: 行 59:
 </code> </code>
  
-只想在个人测试机上快速装完,也可以用官方一键脚本 `curl -fsSL https://get.docker.com | sh`,但它不适合生产环境。+只想在个人测试机上快速装完,也可以执行官方一键脚本(不适合生产环境): 
 + 
 +<code bash> 
 +curl -fsSL https://get.docker.com | sh 
 +</code>
  
 ==== 验证安装 ==== ==== 验证安装 ====
行 80: 行 84:
 ==== 配置国内镜像加速与日志上限 ==== ==== 配置国内镜像加速与日志上限 ====
  
-编辑 ''/etc/docker/daemon.json'':+编辑 ''/etc/docker/daemon.json'' 这个文件:
  
 <code json> <code json>
行 90: 行 94:
 </code> </code>
  
-改完重启:''sudo systemctl restart docker''。日志上限很重要,否则容器日志会把磁盘写满。+改完用 ''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 完全一致。
  
 ===== 三、架构与工作原理 ===== ===== 三、架构与工作原理 =====
行 135: 行 176:
 </code> </code>
  
-端口映射写法是 ''-p 宿主机端口:容器端口'',''8080:80'' 表示访问宿主机 8080 就打到容器里的 80。+端口映射的写法是 ''-p 宿主机端口:容器端口'' ,比如 ''8080:80'' 表示访问宿主机 8080 就打到容器里的 80。
  
 ==== 卷与网络 ==== ==== 卷与网络 ====
行 214: 行 255:
  
   - 把**变化少的**内容放前面:先拷贝依赖清单并安装依赖,最后才拷贝源码   - 把**变化少的**内容放前面:先拷贝依赖清单并安装依赖,最后才拷贝源码
-  - 写 ''.dockerignore'',排除不需要进构建上下文的文件:+  - 写 ''.dockerignore'' 文件,排除不需要进构建上下文的文件:
  
 <code> <code>
行 242: 行 283:
 docker network create appnet docker network create appnet
 docker run -d --name api --network appnet myapp:1.0 docker run -d --name api --network appnet myapp:1.0
-docker run -d --name db  --network appnet postgres:16-alpine+docker run -d --name db --network appnet postgres:16-alpine
 </code> </code>
  
 要点: 要点:
  
-  * 在同一个自定义网络里,容器之间可以直接用**容器名**当主机名,例如 ''postgres://app@db:5432/app''+  * 在同一个自定义网络里,容器之间可以直接用**容器名**当主机名,例如应用连数据库时,主机名直接写数据库的容器名 ''db''
   * 容器里的 ''localhost'' 指的是容器自己,不是宿主机   * 容器里的 ''localhost'' 指的是容器自己,不是宿主机
-  * 需要访问宿主机服务时,Linux 上用宿主机在网桥上的 IP(通常是 172.17.0.1),或用 ''host.docker.internal''(需额外配置)+  * 需要访问宿主机上的服务时,Linux 下用宿主机在网桥上的 IP(通常是 172.17.0.1),或者用 ''host.docker.internal'' 这个主机名(需要额外配置)
   * 默认的 ''bridge'' 网络不支持用容器名互访,所以务必建自定义网络或直接用 Compose   * 默认的 ''bridge'' 网络不支持用容器名互访,所以务必建自定义网络或直接用 Compose
  
-===== 七、Docker 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'',一条命令起停整套。+一个容器还好管,服务一多(应用 + 数据库 + 缓存 + 反向代理)就得用 Compose 把配置写进 ''compose.yaml'' ,一条命令起停整套。
  
 <code yaml> <code yaml>
行 300: 行 504:
 </code> </code>
  
-旧的 ''docker-compose''(带连字符)是 v1,已停止维护;现在统一用 v2 插件形式 ''docker compose''。+旧的 ''docker-compose'' (带连字符)是 v1,已停止维护;现在统一用 v2 插件形式 ''docker compose'' 。
  
-''restart'' 策略值得记住:''no''、''always''、''on-failure''、''unless-stopped''。生产环境一般用 ''unless-stopped'',机器重启后服务能自动回来。+''restart'' 策略值得记住:''no'' 、''always'' 、''on-failure'' 、''unless-stopped'' 。生产环境一般用 ''unless-stopped'' ,机器重启后服务能自动回来。
  
-===== 八、实战:部署一个 Web 应用 =====+===== 九、实战:部署一个 Web 应用 =====
  
 下面是最常见的一套流程:一台云服务器 + 域名 + 应用容器 + 数据库容器 + Nginx 反向代理 + HTTPS。 下面是最常见的一套流程:一台云服务器 + 域名 + 应用容器 + 数据库容器 + Nginx 反向代理 + HTTPS。
行 338: 行 542:
 </code> </code>
  
-''.env'' 要加到 ''compose.yaml'' 同级目录,并在 ''compose.yaml'' 里用 ''${POSTGRES_PASSWORD}'' 引用。**凭据绝不写进镜像,也不提交到 Git。**+''.env'' 要放到 ''compose.yaml'' 同级目录,并在 ''compose.yaml'' 里用 ''${POSTGRES_PASSWORD}'' 引用。**凭据绝不写进镜像,也不提交到 Git。** 
  
 ==== 4. 启动 ==== ==== 4. 启动 ====
行 367: 行 571:
 </code> </code>
  
-再执行 ''sudo certbot --nginx -d example.com'' 自动签发并续期 HTTPS 证书。+再执行 ''sudo certbot %%--%%nginx -d example.com'' 自动签发并续期 HTTPS 证书。
  
 也可以把 Nginx 本身做成一个 Compose 服务,放到同一个网络里,''proxy_pass'' 直接写应用的服务名。 也可以把 Nginx 本身做成一个 Compose 服务,放到同一个网络里,''proxy_pass'' 直接写应用的服务名。
行 389: 行 593:
 用 ''cron'' 定时执行,并定期验证备份文件能不能恢复。 用 ''cron'' 定时执行,并定期验证备份文件能不能恢复。
  
-===== 九、日常运维与排错 =====+===== 十、日常运维与排错 =====
  
 ==== 查问题的一般顺序 ==== ==== 查问题的一般顺序 ====
  
   - ''docker compose ps'' 看容器是不是在跑、有没有反复重启   - ''docker compose ps'' 看容器是不是在跑、有没有反复重启
-  - ''docker compose logs --tail 200 服务名'' 看日志,90% 的问题在这里+  - ''docker compose logs %%--%%tail 200 服务名'' 看日志,90% 的问题在这里
   - ''docker inspect 容器名'' 看退出码、挂载、环境变量、网络   - ''docker inspect 容器名'' 看退出码、挂载、环境变量、网络
   - ''docker exec -it 容器名 sh'' 进去手工验证(能不能连数据库、文件在不在)   - ''docker exec -it 容器名 sh'' 进去手工验证(能不能连数据库、文件在不在)
行 401: 行 605:
  
 ^ 现象 ^ 原因与处理 ^ ^ 现象 ^ 原因与处理 ^
-| 容器起来几秒就退出 | 主进程执行完或报错,先看 ''docker logs'';容器需要一个前台进程撑着 |+| 容器起来几秒就退出 | 主进程执行完或报错,先看 ''docker logs'' ;容器需要一个前台进程撑着 |
 | 端口被占用 | ''ss -lntp'' 找到占用者,或换一个宿主机端口 | | 端口被占用 | ''ss -lntp'' 找到占用者,或换一个宿主机端口 |
 | 容器里连不上宿主机服务 | 容器内的 ''localhost'' 是自己,用服务名或网桥 IP | | 容器里连不上宿主机服务 | 容器内的 ''localhost'' 是自己,用服务名或网桥 IP |
 | 容器之间互相访问失败 | 不在同一自定义网络里,用 Compose 或 ''docker network connect'' | | 容器之间互相访问失败 | 不在同一自定义网络里,用 Compose 或 ''docker network connect'' |
 | 挂载目录没有权限 | 容器内用户 uid/gid 与宿主机目录属主不匹配,''chown'' 或指定 ''user'' | | 挂载目录没有权限 | 容器内用户 uid/gid 与宿主机目录属主不匹配,''chown'' 或指定 ''user'' |
-| 时区不对 | 加 ''-e TZ=Asia/Shanghai'',或挂载 ''/etc/localtime'' | +| 时区不对 | 加参数 ''-e TZ=Asia/Shanghai'' ,或挂载 ''/etc/localtime'' | 
-| 磁盘被占满 | ''docker system df'' 定位,限制日志大小,''docker system prune'' 清理 |+| 磁盘被占满 | ''docker system df'' 定位,限制日志大小,用 ''docker system prune'' 清理 |
 | 拉取镜像超时 | 配置 registry 镜像加速,或给 dockerd 设置 HTTP 代理 | | 拉取镜像超时 | 配置 registry 镜像加速,或给 dockerd 设置 HTTP 代理 |
 | ''.env'' 改了不生效 | 环境变量在容器创建时注入,需要 ''docker compose up -d'' 重建容器 | | ''.env'' 改了不生效 | 环境变量在容器创建时注入,需要 ''docker compose up -d'' 重建容器 |
行 420: 行 624:
 </code> </code>
  
-===== 十、最佳实践与进阶方向 =====+===== 十一、最佳实践与进阶方向 =====
  
 ==== 最佳实践清单 ==== ==== 最佳实践清单 ====
  
   * 一个容器只跑一个主进程,别把应用和数据库塞进同一个镜像   * 一个容器只跑一个主进程,别把应用和数据库塞进同一个镜像
-  * 基础镜像选精简版(''alpine''、''slim''、''distroless''),并**固定版本 tag**,不要用 ''latest''+  * 基础镜像选精简版(''alpine'' 、''slim'' 、''distroless'' ),并**固定版本 tag**,不要用 ''latest''
   * 用多阶段构建缩小产物体积   * 用多阶段构建缩小产物体积
-  * 用非 root 用户运行(''USER''),只读挂载不需要写入的目录+  * 用非 root 用户运行(''USER'' ),只读挂载不需要写入的目录
   * 敏感信息用环境变量、secret 或外部配置中心,不进镜像、不进 Git   * 敏感信息用环境变量、secret 或外部配置中心,不进镜像、不进 Git
   * 数据一律放卷,容器本身当作可随时丢弃的   * 数据一律放卷,容器本身当作可随时丢弃的
   * 给关键服务配 ''healthcheck'' 和 ''restart'' 策略   * 给关键服务配 ''healthcheck'' 和 ''restart'' 策略
-  * 限制日志大小与容器资源(''--memory''、''--cpus'') +  * 限制日志大小与容器资源(''%%--%%memory'' 、''%%--%%cpus'' ) 
-  * 定期清理与更新镜像,扫描漏洞(如 ''trivy image'')+  * 定期清理与更新镜像,扫描漏洞(如 ''trivy image'' )
  
 ==== 进阶方向 ==== ==== 进阶方向 ====
行 440: 行 644:
   - **镜像仓库**:自建 Harbor,做镜像签名、复制和权限管理   - **镜像仓库**:自建 Harbor,做镜像签名、复制和权限管理
   - **可观测性**:cAdvisor + Prometheus + Grafana 看资源,Loki 收日志   - **可观测性**:cAdvisor + Prometheus + Grafana 看资源,Loki 收日志
-  - **构建优化**:BuildKit、Buildx 多平台构建(''--platform linux/amd64,linux/arm64'')、构建缓存+  - **构建优化**:BuildKit、Buildx 多平台构建(''%%--%%platform linux/amd64,linux/arm64'' ),构建缓存
   - **安全**:Rootless 模式、镜像漏洞扫描、最小权限运行   - **安全**:Rootless 模式、镜像漏洞扫描、最小权限运行
  
行 446: 行 650:
  
   - Docker 的核心是**镜像—容器—仓库**三件套,加上**卷**和**网络**   - Docker 的核心是**镜像—容器—仓库**三件套,加上**卷**和**网络**
-  - 日常操作记牢几条:''docker run -d -p''、''docker ps''、''docker logs -f''、''docker exec -it''、''docker build -t''+  - 日常操作记牢几条:''docker run -d -p'' 、''docker ps'' 、''docker logs -f'' 、''docker exec -it'' 、''docker build -t''
   - 多服务用 ''compose.yaml'' 描述,''docker compose up -d'' 一条命令起停   - 多服务用 ''compose.yaml'' 描述,''docker compose up -d'' 一条命令起停
-  - 上线要做的三件事:数据放卷、凭据放 ''.env''、日志设上限+  - 上线要做的三件事:数据放卷、凭据放 ''.env'' 、日志设上限
   - 出问题先看日志,再 inspect,最后进容器手工验证   - 出问题先看日志,再 inspect,最后进容器手工验证
  

该主题尚不存在

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

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