📚 Update Docker documentation and improve clarity

- Revised installation instructions for Windows, Mac, and Linux, enhancing readability.
- Updated core configuration examples and commands for building Docker images.
- Improved formatting and consistency throughout the documentation, including command syntax and comments.
- Added practical insights on resource usage and troubleshooting for Docker containers.
- Included a new section on setting up a Synology server with Docker, providing a comprehensive guide for users.

Author: jiangyangcreate

docs/docs/云原生开发/容器化.md

@@ -12,31 +12,31 @@ title: 容器化
 
 ### 安装
 
-#### win和mac安装
+#### win 和 mac 安装
 
 [https://www.docker.com/get-started](https://www.docker.com/get-started)
 
-#### Linux-Ubuntu安装
+#### Linux-Ubuntu 安装
 
 ```language
 curl -sSL https://get.daocloud.io/docker | sh
 ```
 
 ### 检查安装版本确认是否安装成功
 
-win检查是否安装成功的命令：
+win 检查是否安装成功的命令：
 
 ```language
 docker version
 ```
 
-Linux检查是否安装成功的命令：
+Linux 检查是否安装成功的命令：
 
 ```language
 docker -v
 ```
 
-### 核心配置
+### 基本命令示例
 
 ```bash showLineNumbers
 # 构建镜像
@@ -67,22 +67,25 @@ docker stop {container_id}
 docker rm {container_id}
 ```
 
-
 #### build
 
-build一个镜像的时候，如下关键字必不可少：
+build 一个镜像的时候，如下关键字必不可少：
 
-```language
-FROM mcr.microsoft.com/playwright/python:v1.22.0-focal
-RUN mkdir -p /opt/yueji/spiderCore && mkdir -p /opt/dervice
-ADD spiderCore.tar.gz /opt/yueji/spiderCore
-RUN pip3 install --upgrade pip -i https://mirrors.aliyun.com/pypi/simple/ && pip install -r /opt/yueji/spiderCore/requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/ && rm -rf /root/.cache/pip/
-RUN playwright install chromium
-RUN apt-get update 
-RUN apt-get install wget  
-RUN apt-get install vim
-WORKDIR /opt/yueji/spiderCore
-ENTRYPOINT ["python3","main.py"]
+```yaml showLineNumbers
+# 设置基础镜像
+FROM python:3.12.8
+
+# 设置工作目录
+WORKDIR /app
+
+# 复制项目文件
+COPY . .
+
+# 安装依赖(可以在任意位置执行多个RUN命令)
+RUN pip install -r requirements.txt
+
+# 启动服务
+CMD ["python", "chat_routers.py"]
 ```
 
 #### FROM
@@ -132,7 +135,7 @@ Docker run -p 8080:80 -d {name}
 Docker run -p 8080:80 -d nginx
 ```
 
-拷贝文件至image(类似git里的add暂存)
+拷贝文件至 image(类似 git 里的 add 暂存)
 
 ```language
 docker cp {path} {id}{id_path}
@@ -141,7 +144,7 @@ docker cp {path} {id}{id_path}
 docker cp C:/Users/SY/Desktop/docktest/index.html {id}://usr/share/nginx/html
 ```
 
-保存(类似git里的commit)
+保存(类似 git 里的 commit)
 
 ```language
 Docker commit -m 'fun' {id} 'name'
@@ -150,14 +153,14 @@ Docker commit -m 'fun' {id} 'name'
 Docker commit(固定语法) -m（主分支） 'fun'（注释） 'name'(image的名字)
 ```
 
-删除多余的image
+删除多余的 image
 
 ```language
-Docker rmi {id} 
+Docker rmi {id}
 Docker rmi（删除）
 ```
 
-如果是在自己的电脑上操作，可以在vscode内下载docker插件，即可查看对应容器状态。选中容器可以右键进行：删除、启动、停止等操作。也可以在Docker可视化界面进行操作。
+如果是在自己的电脑上操作，可以在 vscode 内下载 docker 插件，即可查看对应容器状态。选中容器可以右键进行：删除、启动、停止等操作。也可以在 Docker 可视化界面进行操作。
 
 可以通过如下命令进入到容器内部的命令窗口：
 
@@ -194,16 +197,14 @@ docker stats --no-stream
 docker stats
 ```
 
-CPU资源占用升到了280%，持续了30分钟，比较离谱。
-内存占了8个G，这个程序需要模拟诸多浏览器且要保持缓存以便通信，所以8个G也不算离谱。
+CPU 资源占用升到了 280%，持续了 30 分钟，比较离谱。
+内存占了 8 个 G，这个程序需要模拟诸多浏览器且要保持缓存以便通信，所以 8 个 G 也不算离谱。
 
-> docker显示的cpu占用是可以超100%的，表示使用了多个核，200%表示用了2个核。合理的飙升：大数运算环节。异常的飙升：死循环、报错后日志不停歇的高速打印。
+> docker 显示的 cpu 占用是可以超 100%的，表示使用了多个核，200%表示用了 2 个核。合理的飙升：大数运算环节。异常的飙升：死循环、报错后日志不停歇的高速打印。
 
 #### 分析并思考
 
-2个可能：
-1.因为CPU异常，所以可能是阻塞导致的，要查下阻塞的原因，因为代码里写了很多线程。
-2.但是我等了30分钟，也可能是阻塞导致死锁了，这个可能性我觉得更大，内存一直被占着可以解释为死锁后资源无法释放，也合理。
+2 个可能： 1.因为 CPU 异常，所以可能是阻塞导致的，要查下阻塞的原因，因为代码里写了很多线程。 2.但是我等了 30 分钟，也可能是阻塞导致死锁了，这个可能性我觉得更大，内存一直被占着可以解释为死锁后资源无法释放，也合理。
 
 > （1）阻塞是由于资源不足引起的排队等待现象。
 > （2）死锁是由于两个对象在拥有一份资源的情况下申请另一份资源，而另一份资源恰好又是这两对象正持有的，导致两对象无法完成操作，且所持资源无法释放。
@@ -225,51 +226,6 @@ exit
 # 复制日志
 docker cp 容器id:文件路径 本机路径
 ```
-
-## 实战案例：群晖服务器搭建
-
-首先确保自己对每个环节的设备都拥有绝对控制权，在常见的家庭网络环节下，
-
-网络从运营商总部接入小区/园区的控制中心，由控制中心完成基本过滤
-用户通过光猫完成光电转换，完成与互联网的信息交换
-用户通过路由器链接光猫，完成内网与外网的信息交换
-用户通过交换机链接路由器，完成内网设备间的信息交换（中型公司会有）
-用户将购买的服务器连接到交换机/路由器，最后一步信息交换
-
-你可能会遇到如下问题：
-
-1.你所居住的小区/园区存在网络控制中心，限制家庭宽带的使用，例如我园区的网络控制中心：限制端口，限制设备数量，限制设备类。可以通过打电话沟通与钞能力解决。
-
-2.运营商提供的设备，例如：光猫，路由器，存在限制，例如我司的光猫仅开启上网功能，不允许端口对外开放，不允许端口映射。可以通过打电话沟通与钞能力解决。
-
-3.路由器、服务器不提供端口映射、仅暴露指定端口。我用的是华为+群晖，总价4K。
-
-那么如果你的服务比较复杂，譬如我司曾经采购一个很古老的系统，我不负责迭代它，但需要维护他，那么打包成一个容器很显然是个不错的主意。
-
-由于群晖有很多版本，路由器也有很多版本，我这里只是提供一个思路，不保证一定能成功。
-
-### 群晖
-
-在群晖套件中心找到 Container Manager
-
-下载宝塔镜像 btpanel-baota
-
-映射端口前请确认端口没有在使用，可以通过群晖官网查询
-
-推荐端口号在4000-5000之间，因为这个端的端口未被使用。
-
-映射需要用到的端口与需要挂载的文件夹
-
-关于映射：如果你把宝塔的登录端口8888映射为群晖服务器的4444，那么此时你就可以通过群晖的4444端口访问宝塔了。
-
-### 路由器
-
-开启设备映射，将群晖设为固定的IP地址，将群晖的端口映射到路由器的端口。
-
-如果你把群晖的4444端口映射为80，并且把域名绑定到公网IP上时
-
-那么当你访问这个域名会跳转到路由器80端口，再跳到群晖的4444端口，再跳到群晖宝塔容器的8888端口。
-
 ## docker-compose
 
 docker-compose 是一个用于定义和运行多容器 Docker 应用程序的工具。它通过一个 YAML 文件来配置应用程序的服务、网络和卷，并使用一个命令来启动、停止和重新启动这些服务。当你需要启动多个容器时，docker-compose 可以简化这个过程。
@@ -295,36 +251,32 @@ docker-compose 是一个用于定义和运行多容器 Docker 应用程序的工
 ### 文件示例
 
 ```yaml showLineNumbers
-version: '3.8'  # 指定 Docker Compose 文件的版本
+version: "3.8" # 指定 Docker Compose 文件的版本
 
-services:  # 定义服务
-  python-app-frontend:  # 新增的 Python 应用服务
-    build:  # 使用 Dockerfile 构建镜像
-      context: ./frontend  # 前端上下文目录
-      dockerfile: Dockerfile  # Dockerfile 文件
+services: # 定义服务
+  python-app-frontend: # 新增的 Python 应用服务
+    build: # 使用 Dockerfile 构建镜像
+      context: ./frontend # 前端上下文目录
+      dockerfile: Dockerfile # Dockerfile 文件
     image: jiangmiemie/llmchatf:0.1.0
     ports:
-      - "8501:8501"  # 映射 Streamlit 默认端口
-    command: ["streamlit", "run", "_streamlit/streamlit_app.py"]  # 启动命令
+      - "8501:8501" # 映射 Streamlit 默认端口
+    command: ["streamlit", "run", "_streamlit/streamlit_app.py"] # 启动命令
     depends_on:
       - python-app-backend
 
-  python-app-backend:  # 新增的后端服务
-    build:  # 使用 Dockerfile 构建镜像
-      context: ./backend  # 后端上下文目录
-      dockerfile: Dockerfile  # 后端 Dockerfile 文件
+  python-app-backend: # 新增的后端服务
+    build: # 使用 Dockerfile 构建镜像
+      context: ./backend # 后端上下文目录
+      dockerfile: Dockerfile # 后端 Dockerfile 文件
     image: jiangmiemie/llmchatb:0.1.0
     ports:
-      - "8010:8010"  # 映射后端服务端口
-    command: ["python", "chat_routers.py"]  # 启动后端服务的命令
+      - "8010:8010" # 映射后端服务端口
+    command: ["python", "chat_routers.py"] # 启动后端服务的命令
     volumes:
-      - ./backend/.env:/app/.env:ro  # 添加 .env 文件挂载，ro表示只读
+      - ./backend/.env:/app/.env:ro # 添加 .env 文件挂载，ro表示只读
 ```
 
-
-
-
-
 ### 启动说明
 
 1. 首先确保你在包含 `docker-compose.yml` 文件的目录下，然后执行以下命令来构建和启动服务：
@@ -346,7 +298,7 @@ docker-compose up
 
 3. 其他常用命令：
 
-```bash
+````bash
 # 停止所有服务
 docker-compose down
 
@@ -368,9 +320,10 @@ docker-compose logs -f python-app-backend
 3. 查看容器日志排查问题：
 ```bash
 docker-compose logs -f
-```
+````
 
 4. 如果需要重置环境：
+
 ```bash
 # 停止并删除所有容器、网络
 docker-compose down
@@ -380,6 +333,7 @@ docker-compose down --rmi all
 ```
 
 记住，任何修改 Dockerfile 或代码后，都需要重新构建镜像：
+
 ```bash
 docker-compose up -d --build
 ```
@@ -396,7 +350,6 @@ docker-compose push
 
 ### 拉取和运行多个容器
 
-
 目录结构
 
 ```bash showLineNumbers
@@ -407,21 +360,21 @@ docker-compose push
 
 1. 在目标环境创建 docker-compose.yml:
 
-````yaml:docker-compose.yml
+```yaml:docker-compose.yml
 version: '3.8'
 services:
   python-app-frontend:
     image: jiangmiemie/llmchatf:0.1.0
     ports:
       - "8501:8501"
-      
+
   python-app-backend:
     image: jiangmiemie/llmchatb:0.1.0
     ports:
       - "8010:8010"
     volumes:
       - ./backend/.env:/app/.env:ro
-````
+```
 
 2. 拉取和运行:
 
@@ -436,18 +389,21 @@ docker-compose up -d
 ### 补充说明
 
 1. 如果使用私有仓库,需要先登录:
+
 ```bash
 docker login your-registry
 ```
 
 2. 可以使用环境变量控制版本:
-````yaml:docker-compose.yml
+
+```yaml:docker-compose.yml
 services:
   frontend:
     image: your-registry/frontend:${TAG:-latest}
-````
+```
 
 3. 可以只操作特定服务:
+
 ```bash
 # 只推送前端
 docker-compose push frontend
@@ -456,6 +412,51 @@ docker-compose push frontend
 docker-compose pull backend
 ```
 
+## 实战案例：群晖服务器搭建
+
+首先确保自己对每个环节的设备都拥有绝对控制权，在常见的家庭网络环节下，
+
+网络从运营商总部接入小区/园区的控制中心，由控制中心完成基本过滤
+用户通过光猫完成光电转换，完成与互联网的信息交换
+用户通过路由器链接光猫，完成内网与外网的信息交换
+用户通过交换机链接路由器，完成内网设备间的信息交换（中型公司会有）
+用户将购买的服务器连接到交换机/路由器，最后一步信息交换
+
+你可能会遇到如下问题：
+
+1.你所居住的小区/园区存在网络控制中心，限制家庭宽带的使用，例如我园区的网络控制中心：限制端口，限制设备数量，限制设备类。可以通过打电话沟通与钞能力解决。
+
+2.运营商提供的设备，例如：光猫，路由器，存在限制，例如我司的光猫仅开启上网功能，不允许端口对外开放，不允许端口映射。可以通过打电话沟通与钞能力解决。
+
+3.路由器、服务器不提供端口映射、仅暴露指定端口。我用的是华为+群晖，总价 4K。
+
+那么如果你的服务比较复杂，譬如我司曾经采购一个很古老的系统，我不负责迭代它，但需要维护他，那么打包成一个容器很显然是个不错的主意。
+
+由于群晖有很多版本，路由器也有很多版本，我这里只是提供一个思路，不保证一定能成功。
+
+### 群晖
+
+在群晖套件中心找到 Container Manager
+
+下载宝塔镜像 btpanel-baota
+
+映射端口前请确认端口没有在使用，可以通过群晖官网查询
+
+推荐端口号在 4000-5000 之间，因为这个端的端口未被使用。
+
+映射需要用到的端口与需要挂载的文件夹
+
+关于映射：如果你把宝塔的登录端口 8888 映射为群晖服务器的 4444，那么此时你就可以通过群晖的 4444 端口访问宝塔了。
+
+### 路由器
+
+开启设备映射，将群晖设为固定的 IP 地址，将群晖的端口映射到路由器的端口。
+
+如果你把群晖的 4444 端口映射为 80，并且把域名绑定到公网 IP 上时
+
+那么当你访问这个域名会跳转到路由器 80 端口，再跳到群晖的 4444 端口，再跳到群晖宝塔容器的 8888 端口。
+
+
 ## k8s
 
-Kubernetes 是一个开源的容器编排引擎，用来对容器化应用进行自动化部署、 扩缩和管理。
+Kubernetes 是一个开源的容器编排引擎，用来对容器化应用进行自动化部署、 扩缩和管理。