:::tip{title="修改 Linux 命令行主机名"}
主机名（Hostname）：服务器的唯一标识符，通常由系统管理员或云服务商自动分配。
可是有时候觉得这样的`[root@hcss-ecs-15f5 ~]# `名字不好看.如何修改？本文将讲述修改 Linux 命令行主机名的方法
:::



## 方法 1：在 Linux 中使用 hostnamectl 来改变主机名
`hostnamectl` 可被用来查询和改变系统的主机名，以及相关设定。只需运行 `hostnamectl` 便可以查看系统的主机名了。

```bash
# 查看系统的主机名
[root@hcss-ecs-15f5 ~]# hcss-ecs-15f5 
   Static hostname: hcss-ecs-15f5 
         Icon name: computer-vm
           Chassis: vm
        Machine ID: 97b723b5369b4ce186c047e1cfd82f88
           Boot ID: 349e9db95a9a4f329b91a8f0940e71d2
    Virtualization: kvm
  Operating System: CentOS Linux 8 (Core)
       CPE OS Name: cpe:/o:centos:centos:8
            Kernel: Linux 4.18.0-348.7.1.el8_5.x86_64
      Architecture: x86-64
```
假如你想改变主机名，可以使用下面的命令格式：
```bash
hostnamectl set-hostname [YOUR NEW HOSTNAME]
```
使用下面的命令来使用 hostnamectl 更改主机名。在这个例子中，我将把主机名从 `hcss-ecs-15f50` 改为 `lmk`。
```bash
# 修改主机名
hostnamectl set-hostname lmk

#重启
reboot
```
你可以使用下面的命令来查看更新后的主机名。
```bash
[root@lmk ~]# hostnamectl
   Static hostname: lmk
         Icon name: computer-vm
           Chassis: vm
        Machine ID: 97b723b5369b4ce186c047e1cfd82f88
           Boot ID: 349e9db95a9a4f329b91a8f0940e71d2
    Virtualization: kvm
  Operating System: CentOS Linux 8 (Core)
       CPE OS Name: cpe:/o:centos:centos:8
            Kernel: Linux 4.18.0-348.7.1.el8_5.x86_64
      Architecture: x86-64
```

## 方法 2：在 Linux 中使用 nmcli 命令来更改主机名
`nmcli `是一个命令行工具，旨在控制 NetworkManager 并报告网络状态。

`nmcli `被用来创建、展示、编辑、删除、激活和注销网络连接，同时还可以用来控制和展示网络设备的状态。另外，它也允许我们更改主机名。

使用下面的命令来利用 `nmcli`查看当前的主机名。
```bash
nmcli general hostname

#输出结果
lmk
```
语法格式：
```bash
nmcli general hostname [YOUR NEW HOSTNAME]
```
使用下面的命令来借助 nmcli 命令可以更改主机名。在这个例子中，我将把主机名从 `hostnamectl` 变成 `lmk`。
```bash
nmcli general hostname lmk
```
它可以在不重启下设备的情况下生效，但为了安全目的，只需要重启 `systemd-hostnamed` 服务来使得更改生效。
```bash
sudo systemctl restart systemd-hostnamed
```

## 方法 3：在 Linux 中使用 nmtui 来更改主机名

`nmtui` 是一个基于 `curses` 库的 TUI 应用，被用来和 NetworkManager 交互。当启动` nmtui` 后，如果没有指定 nmtui 的第一个命令行参数，它将提醒用户选择执行某项活动。

在终端中运行下面的命令来开启文本用户界面。

```bash
nmtui
```
使用向下箭头按键来选择 “Set system hostname” 这个选项，然后敲击回车键。

下面的截图展示的是原来的主机名。

我们需要做的就是删除原来的主机名，再输入新的主机名，然后选中 “OK” 敲击回车确认就可以了。

然后它将在屏幕中向你展示更新后的主机名，再次选中 “OK” 敲击回车确认就完成更改了。

最后，选中 “Quit” 按钮来从 `nmtui` 终端界面离开。

它可以在不重启设备的情况下生效，但为了安全目的，需要重启 `systemd-hostnamed` 服务来使得更改生效。
```bash
sudo systemctl restart systemd-hostnamed
```
你可以运行下面的命令来查看更新后的主机名。
```bash
[root@lmk ~]# hostnamectl
   Static hostname: lmk
         Icon name: computer-vm
           Chassis: vm
        Machine ID: 97b723b5369b4ce186c047e1cfd82f88
           Boot ID: 349e9db95a9a4f329b91a8f0940e71d2
    Virtualization: kvm
  Operating System: CentOS Linux 8 (Core)
       CPE OS Name: cpe:/o:centos:centos:8
            Kernel: Linux 4.18.0-348.7.1.el8_5.x86_64
      Architecture: x86-64
```

## 方法 4：在 Linux 中使用 /etc/hostname 来更改主机名
除了上面的方法外，我们还可以通过修改 `/etc/hostname` 文件来达到修改主机名的目的。但这个方法需要服务器重启才能生效。

使用下面的命令来检查 `/etc/hostname` 文件以查看当前的主机名：


```js
cat /etc/hostname

# 输出结果
lmk
```
要改变主机名，只需覆写这个文件就行了，因为这个文件只包含主机名这一项内容。

```bash
sudo echo "lmk" > /etc/hostname
$ cat /etc/hostname
lmk
```
然后使用下面的命令重启系统：
```bash
 sudo init 6
```
最后查看 /etc/hostname 文件的内容来验证主机名是否被更改了。

```bash
cat /etc/hostname
lmk
```

修改 Linux 命令行主机名

:::tip{title="提示"} 
**我有2台云服务器（一台华为云和一台腾讯云）和一个域名。我希望可以解决如下问题：** 
- **主域名解析**：由腾讯云DNS服务器（示例IP：`12.34.56.78`）权威管理，承载核心业务入口（如官网`www.example.com`）。  
- **子域名解析**：由华为云DNS服务器（示例IP：`23.45.67.89`）独立托管，支持分支机构或专项业务（如商城`shop.sub.example.com`）。  
**本文解决的核心问题**：  
1. **权限切割**：通过DNS委派技术（NS记录），实现子域解析权从主域剥离。  
2. **解析协同**：配置粘合记录（Glue Record）避免跨厂商解析失效。  
3. **双向验证**：正向解析（A记录）与反向解析（PTR记录）的完整闭环。

**注：本文中所有IP地址均为示例，实际配置请替换为您的环境信息**
:::



## 一、核心概念与原理  
### 1. 场景说明  
- **主域名**：`example.com`，由腾讯云DNS（示例IP：`12.34.56.78`）管理。  
- **子域名**：`sub.example.com`，由华为云DNS（示例IP：`23.45.67.89`）独立解析。  

### 2. 技术原理  
- **DNS委派**：通过NS记录将子域解析权移交副厂商DNS服务器。  
- **粘合记录（Glue Record）**：绑定DNS服务器名称与IP，防止解析环路。  
- **正反向解析协同**：  
  - **正向解析（A记录）**：域名 → IP。  
  - **反向解析（PTR记录）**：IP → 域名，需厂商支持。  

---

## 二、腾讯云配置步骤（主厂商）  
### 1. 添加子域NS记录  
**路径**：腾讯云控制台 → 云解析DNS → 选择域名`example.com` → 添加记录  
| 参数         | 值                                  |  
|--------------|-------------------------------------|  
| 主机记录     | `sub`                               |  
| 记录类型     | `NS`                                |  
| 记录值       | 华为云DNS服务器名称（如`ns1.huaweicloud-dns.com`） |  
| TTL          | 300（建议值，加速生效）              |  

**操作要点**：  
- 需添加华为云全部DNS服务器（共4个）。  
- 记录值**仅填名称**，不可包含IP地址。  

### 2. 配置粘合记录  
**路径**：同上，继续添加A记录  
| 参数         | 值                                  |  
|--------------|-------------------------------------|  
| 主机记录     | `ns1.huaweicloud-dns`（名称前缀）   |  
| 记录类型     | `A`                                 |  
| 记录值       | `23.45.67.89`（华为云DNS服务器IP）  |  

---

## 三、华为云配置步骤（副厂商）  
### 1. 创建子域托管区域  
**路径**：华为云控制台 → 云解析服务 → 创建公网域名 → 输入`sub.example.com`  
- **系统自动生成**：4个DNS服务器名称（如`ns1.huaweicloud-dns.com`）。  

### 2. 添加正向解析记录  
**示例：Web服务器A记录**  
| 参数         | 值                                  |  
|--------------|-------------------------------------|  
| 主机记录     | `www`                               |  
| 记录类型     | `A`                                 |  
| 记录值       | `23.45.67.89`（子域业务服务器IP）   |  

### 3. 配置反向解析（PTR记录）  
**操作流程**：  
1. **提交工单**：华为云控制台 → 工单系统 → 申请反向解析。  
2. **提供信息**：IP地址`23.45.67.89`，对应域名`www.sub.example.com`。  
3. **验证命令**：  
   ```bash  
   dig -x 23.45.67.89 +short  # 预期输出：www.sub.example.com.  
   ```  

---

## 四、验证与排障指南  
### 1. 正向解析验证  
```bash  
# 检查子域NS记录是否生效  
dig +trace sub.example.com  
# 预期结果：权威服务器显示华为云DNS名称  

# 直接查询子域解析  
dig www.sub.example.com @23.45.67.89 +short  
# 预期结果：23.45.67.89  
```  

### 2. 常见问题处理  
| 问题现象                 | 排查步骤                               |  
|--------------------------|---------------------------------------|  
| 子域解析超时             | 检查华为云安全组是否开放UDP/TCP 53端口 |  
| 反向解析未生效           | 确认工单状态并联系华为云技术支持       |  
| 主域记录被覆盖           | 核对腾讯云仅修改`sub`的NS记录          |  

---

## 五、隐私与安全实践  
1. **IP脱敏处理**：公开文档使用示例IP（如`12.34.56.78`），真实IP通过控制台获取。  
2. **访问控制**：  
   - 腾讯云：开启RAM子账号权限隔离。  
   - 华为云：启用操作审计日志（云审计服务）。  
3. **敏感操作**：反向解析需工单审批，避免误操作。  

---

## 六、总结  
通过本文步骤，你已成功实现以下目标：  

### **1. 解析权分离**  
- **主域名**（如`example.com`）由腾讯云DNS全权管理，确保核心业务稳定性。  
- **子域名**（如`sub.example.com`）委派至华为云DNS，赋予独立运维能力。  

### **2. 关键配置验证**  
- **正向解析链路**：用户访问子域名时，请求直达华为云服务器（IP `23.45.67.89`）。  
- **反向解析信任**：通过PTR记录验证服务器身份，提升业务可信度（如邮件防垃圾）。  

### **3. 安全与效率兼顾**  
- **隐私保护**：示例IP仅用于演示，真实IP通过控制台安全获取。  
- **操作可控**：敏感操作（如反向解析）需工单审批，规避误操作风险。

腾讯云与华为云DNS跨厂商委派配置指南

:::tip{title="HTTP状态码那些事"}
当我们浏览网页、调用API或进行网络开发时，总会遇到像404 Not Found、500 Internal Server Error这样的提示。这些3位数字代码就像互联网世界的"摩尔斯电码"。本文将讲述这个知识点。
:::



## 一、HTTP状态码全景图

### 1. 状态码的「语言规则」
- **3位数字编码**：XYZ结构（X定义大类，Y和Z细化具体状态）
- **分类逻辑**：通过首位数字快速判断问题类型
- **隐藏含义**：比如4开头总与客户端相关，5开头必是服务器问题

### 2. 状态码五大家族
| 状态码 | 类别说明             | 常见场景                     |
|--------|----------------------|------------------------------|
| 1xx    | 信息响应             | 协议切换、大文件上传确认     |
| 2xx    | 成功操作             | 页面加载成功、API调用成功     |
| 3xx    | 重定向               | 网页跳转、缓存控制           |
| 4xx    | 客户端错误           | 权限不足、请求格式错误        |
| 5xx    | 服务器错误           | 代码异常、服务过载           |

## **二、完整状态码分类与详解（完整版）**

### **1xx（信息响应）**
表示请求已被接收，需要继续处理（通常由服务器或代理返回，用户无感知）。

- **100 Continue**  
  - **场景**：客户端发送大文件前，先询问服务器是否接受。  
  - **过程**：客户端发送`Expect: 100-continue`头 → 服务器返回`100`表示允许继续上传。

- **101 Switching Protocols**  
  - **场景**：协议切换（如从HTTP升级到WebSocket）。  
  - **示例**：网页游戏使用WebSocket时，服务器返回`101`表示协议已切换。

- **102 Processing** (WebDAV)  
  - **场景**：服务器已接收请求但需要长时间处理（避免客户端超时）。  
  - **示例**：上传大型文件时服务器返回`102`，表示处理中。

- **103 Early Hints**  
  - **场景**：服务器提前返回部分响应头（优化性能，需HTTP/3支持）。  
  - **示例**：浏览器预加载资源前，服务器先返回`103`提示可能需要的资源。

---

#### **2xx（成功）**
请求已被服务器成功接收、理解并处理。

- **200 OK**  
  - **标准成功响应**，GET请求返回资源，POST请求返回操作结果。  
  - **示例**：访问网页时返回HTML内容。

- **201 Created**  
  - **资源已创建**，常用于POST或PUT请求。  
  - **响应头**：需包含`Location`字段指向新资源URL。  
  - **示例**：提交表单创建新用户，服务器返回`201`和新用户URL。

- **202 Accepted**  
  - **请求已接收但未处理完成**（异步任务）。  
  - **示例**：提交视频转码任务，服务器返回`202`表示任务排队中。

- **204 No Content**  
  - **成功但无内容返回**，适用于无需刷新页面的操作。  
  - **示例**：删除资源或提交表单后无需跳转。

- **205 Reset Content**  
  - **成功并要求客户端重置视图**（如清空表单）。  
  - **示例**：提交表单后，服务器返回`205`让浏览器清空输入框。

- **206 Partial Content**  
  - **部分内容响应**（用于分片下载或断点续传）。  
  - **响应头**：`Content-Range`指定返回的数据范围。  
  - **示例**：视频播放器请求视频的某一段数据。

---

#### **3xx（重定向）**
需要客户端进一步操作（通常是跳转到其他URL）。

- **300 Multiple Choices**  
  - **多个可选资源**（需客户端选择，极少使用）。

- **301 Moved Permanently**  
  - **资源永久重定向**（浏览器会缓存此跳转，SEO权重转移）。  
  - **示例**：网站更换域名后，旧链接永久跳转到新地址。

- **302 Found**  
  - **资源临时重定向**（浏览器不缓存，下次仍请求原URL）。  
  - **示例**：未登录用户访问个人中心，临时跳转到登录页。

- **303 See Other**  
  - **重定向到其他URL，且强制使用GET方法**（POST提交后防止重复提交）。  
  - **示例**：表单提交后返回`303`，跳转到结果页。

- **304 Not Modified**  
  - **资源未修改**（浏览器直接使用本地缓存）。  
  - **触发条件**：客户端发送`If-Modified-Since`或`If-None-Match`头，服务器比对后返回`304`。

- **307 Temporary Redirect**  
  - **临时重定向，且保持原请求方法**（与302类似，但更严格）。  
  - **示例**：POST请求临时重定向时，必须保持POST方法。

- **308 Permanent Redirect**  
  - **永久重定向，且保持原请求方法**（与301类似，但更严格）。  
  - **示例**：API的旧端点永久迁移到新URL，并保持请求方法。

---

#### **4xx（客户端错误）**
客户端请求有误，服务器无法处理。

- **400 Bad Request**  
  - **请求格式错误**（如JSON语法错误、缺少必要参数）。  
  - **排查**：检查请求头、请求体是否符合API文档。

- **401 Unauthorized**  
  - **需要身份认证**（未提供有效凭证）。  
  - **响应头**：`WWW-Authenticate`定义认证方式（如Bearer Token）。  
  - **示例**：访问需要登录的API未携带Token。

- **403 Forbidden**  
  - **权限不足**（认证成功但无权访问）。  
  - **示例**：普通用户试图访问管理员后台。

- **404 Not Found**  
  - **资源不存在**（URL错误或资源已删除）。  
  - **常见原因**：拼写错误、路由配置错误。

- **405 Method Not Allowed**  
  - **请求方法不被允许**（如用GET访问只支持POST的接口）。  
  - **响应头**：`Allow`列出允许的方法（如GET, POST）。

- **406 Not Acceptable**  
  - **服务器无法提供客户端要求的格式**（如请求XML但只支持JSON）。  
  - **请求头**：`Accept`指定了不支持的媒体类型。

- **408 Request Timeout**  
  - **请求超时**（服务器未在指定时间内收到完整请求）。  
  - **示例**：上传大文件时网络中断。

- **409 Conflict**  
  - **资源冲突**（如重复创建同名用户）。  
  - **示例**：Git提交时遇到版本冲突。

- **410 Gone**  
  - **资源永久删除**（比404更明确，表示资源曾存在但已被移除）。  
  - **示例**：临时促销页面过期后返回`410`。

- **413 Payload Too Large**  
  - **请求体过大**（超过服务器限制）。  
  - **解决方案**：压缩数据或分片上传。

- **414 URI Too Long**  
  - **URL过长**（超过服务器限制，通常由过多查询参数导致）。  
  - **示例**：GET请求将大量数据放在URL中而非请求体。

- **415 Unsupported Media Type**  
  - **不支持的媒体类型**（如上传文件格式不符合要求）。  
  - **请求头**：`Content-Type`不被服务器支持。

- **429 Too Many Requests**  
  - **请求过于频繁**（触发限流）。  
  - **响应头**：`Retry-After`提示重试时间。  
  - **示例**：API调用超过每分钟100次限制。

---

#### **5xx（服务器错误）**
服务器处理请求时发生错误。

- **500 Internal Server Error**  
  - **通用服务器错误**（代码异常、配置错误）。  
  - **排查**：查看服务器日志（如Nginx的`error.log`）。

- **501 Not Implemented**  
  - **服务器不支持请求的功能**（如请求未实现的HTTP方法）。  
  - **示例**：请求`PATCH`方法但服务器未实现。

- **502 Bad Gateway**  
  - **网关或代理服务器从上游服务器收到无效响应**。  
  - **常见场景**：反向代理（如Nginx）连接的后端服务崩溃。

- **503 Service Unavailable**  
  - **服务不可用**（服务器过载或维护中）。  
  - **响应头**：`Retry-After`提示服务恢复时间。

- **504 Gateway Timeout**  
  - **网关超时**（代理服务器未及时收到上游响应）。  
  - **示例**：数据库查询耗时过长，导致API网关超时。

- **505 HTTP Version Not Supported**  
  - **服务器不支持请求的HTTP协议版本**。  
  - **示例**：客户端使用HTTP/3但服务器只支持HTTP/1.1。

- **507 Insufficient Storage** (WebDAV)  
  - **服务器存储空间不足**（无法完成请求）。  
  - **示例**：网盘服务上传文件时存储配额已满。

---

## 三、深度解读高频状态码
:::info{title="注意"}
刚刚巴拉巴拉一大堆文字，可能有点难记忆。如果直接记忆的话，建议直接看下面的
:::
### 🟢 成功家族（2xx）
#### 200 OK
- **经典场景**：网页加载成功
- **技术细节**：GET请求返回资源，POST返回操作结果
- **陷阱提示**：某些API错误会伪装成200返回错误JSON

#### 204 No Content
- **适用场景**：DELETE操作成功但无需返回数据
- **开发技巧**：适合需要保持页面不刷新的操作

#### 206 Partial Content
- **黑科技应用**：视频分段加载、断点续传
- **响应头示例**：
  ```http
  HTTP/1.1 206 Partial Content
  Content-Range: bytes 0-999/4580
  ```

### 🔵 跳转家族（3xx）
#### 301 vs 302 终极对决
| 状态码 | 缓存行为      | SEO影响           | 典型场景               |
|--------|-------------|-------------------|------------------------|
| 301    | 永久缓存      | 权重转移          | 网站域名永久变更       |
| 302    | 不缓存        | 不传递权重        | 临时维护跳转           |

#### 304 Not Modified
- **缓存机制**：通过If-Modified-Since/If-None-Match验证
- **性能优化**：减少30%以上的重复资源加载

### 🔴 客户端错误（4xx）
#### 403 Forbidden 三连问
1. 文件权限设置正确吗？
2. 服务器配置是否禁止访问？
3. 是否触发WAF防护规则？

#### 404 Not Found 排查指南
```mermaid
graph TD
    A[出现404] --> B{资源是否存在?}
    B -->|是| C[检查Nginx配置]
    B -->|否| D[检查路由逻辑]
    C --> E[确认location匹配规则]
    D --> F[验证API端点是否存在]
```

#### 429 Too Many Requests
- **限流策略**：令牌桶算法 vs 漏桶算法
- **最佳实践**：配合Retry-After头实现优雅降级

### 🟠 服务器错误（5xx）
#### 500 Internal Server Error
- **死亡现场分析**：
  - 查看服务器错误日志
  - 检查数据库连接
  - 验证环境变量配置

#### 502 Bad Gateway 故障树
```
请求 → Nginx → 后端服务
            ↓
502产生原因：
1. 后端进程崩溃（检查pm2日志）
2. 防火墙拦截（确认端口开放）
3. 请求超时（调整proxy_timeout）
```

---

## 三、开发者必备调试工具

### 1. 浏览器Network面板高级技巧
- **过滤搜索**：按状态码类型过滤请求
- **瀑布流分析**：定位耗时过长的请求
- **重放请求**：右键选择"Replay XHR"调试

### 2. 命令行专家模式
```bash
# 详细追踪请求过程
curl -v https://api.example.com/users

# 仅显示状态码（自动化脚本专用）
curl -s -o /dev/null -w "%{http_code}" https://example.com

# 模拟不同HTTP方法
http PUT https://api.example.com/data name=John
```

### 3. 服务器日志分析黄金法则
```log
# Nginx错误日志典型条目
2023/10/20 14:22:33 [error] 668#668: *179 upstream timed out 
(110: Connection timed out) while reading response header from upstream

# 解决方案：
1. 增加proxy_read_timeout值
2. 检查后端服务健康状况
3. 添加负载均衡
```

---

## 四、最佳实践指南

### 1. API设计黄金法则
- **语义明确**：DELETE成功返回204而非200
- **安全优先**：对敏感资源返回403而非404
- **结果一致**：错误响应统一格式：
  ```json
  {
    "error": {
      "code": "AUTH_401",
      "message": "需要登录令牌"
    }
  }
  ```

### 2. 前端处理规范
```javascript
// Axios全局错误处理
axios.interceptors.response.use(
  response => response,
  error => {
    const status = error.response?.status;
    
    switch(status) {
      case 401:
        redirectToLogin();
        break;
      case 429:
        showRetryNotification();
        break;
      default:
        showErrorToast(error.message);
    }
    return Promise.reject(error);
  }
);
```

### 3. 服务器配置优化
```nginx
# 自定义错误页面
error_page 404 /custom_404.html;
error_page 500 502 503 504 /maintenance.html;

# 智能重试配置
proxy_next_upstream error timeout http_500;
proxy_connect_timeout 5s;
```

## 五、趣味冷知识

### 1. 状态码彩蛋
- **418 I'm a teapot**：来自1998年愚人节RFC协议
- **451 Unavailable For Legal Reasons**：致敬《华氏451》

### 2. 历史小故事
- HTTP/1.0 只有16个状态码
- 302 Found 最初叫 "Moved Temporarily"

## **六、总结**
- **客户端错误（4xx）**：检查请求格式、权限、参数。
- **服务器错误（5xx）**：排查代码、依赖服务、服务器配置。
- **重定向（3xx）**：区分永久（301）和临时（302），避免循环跳转。
- **工具使用**：善用开发者工具和日志快速定位问题。

- **状态码设计最佳实践【小建议】**
    1. **准确使用**  
       - 避免用`200`返回错误（如用`200 { "error": "..." }`代替`4xx`）。

    2. **安全性**  
       - 对未授权访问返回`401`或`403`，而非`404`（避免暴露资源是否存在）。

    3. **用户体验**  
       - 对`404`页面设计友好提示，引导用户返回首页。

    4. **API设计**  
       - RESTful API严格遵循状态码语义（如`201`用于创建，`204`用于删除）。

HTTP状态码那些事

:::tip{title="CentOS 8 完整 Docker 安装与镜像加速配置教程"}
Docker容器化技术越发重要，本教程详解 CentOS 8 安装与配置Docker 
:::



## **一、系统要求**
- **操作系统**：CentOS 8 64位（最小化安装或带 GUI 的版本均可）。
- **内核版本**：建议 4.18 及以上（通过 `uname -r` 查看）。
- **权限要求**：以 `root` 用户或具有 `sudo` 权限的用户操作。

---

## **二、彻底卸载旧版本（关键步骤）**
```bash
# 卸载 Docker 及相关组件
sudo dnf remove docker \
               docker-client \
               docker-client-latest \
               docker-common \
               docker-latest \
               docker-latest-logrotate \
               docker-logrotate \
               docker-engine

# 删除残留文件和目录
sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd
sudo rm -rf /etc/docker
```

---

## **三、安装依赖工具包**
```bash
sudo dnf install -y yum-utils device-mapper-persistent-data lvm2
```

---

## **四、添加 Docker 官方仓库**
### **方案1：使用阿里云镜像加速（推荐国内用户）**
```bash
sudo yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
```

### **方案2：官方仓库（默认）**
```bash
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
```

---

#### **五、安装 Docker 引擎**
```bash
sudo dnf install -y docker-ce docker-ce-cli containerd.io
```

---

## **六、配置镜像加速器（核心步骤）**
### **1. 生成纯净的 `daemon.json` 文件**
```bash
# 使用无注释、纯 JSON 格式
sudo tee /etc/docker/daemon.json <<EOF
{
    "registry-mirrors": [
       "https://hub-mirror.c.163.com"
    ]
}
EOF
```
- **注意**：  
  - **仅保留一个镜像源**（测试用）。  
  - **无注释、无中文符号**。  
  - 使用 `https://hub-mirror.c.163.com`

### **2. 检查 JSON 语法**
```bash
# 安装 JSON 校验工具（若未安装）
sudo dnf install -y jq

# 验证语法（无报错表示成功）
sudo jq . /etc/docker/daemon.json
```

### **3. 重启 Docker 服务**
```bash
# 重载配置并重启服务
sudo systemctl daemon-reload
sudo systemctl restart docker

# 查看服务状态
sudo systemctl status docker
```
- **正常状态**：`Active: active (running)`。

---

## **七、验证镜像加速是否生效**
```bash
# 强制刷新镜像元数据
docker info --format '{{json .RegistryMirrors}}'

# 输出应为：
# ["https://hub-mirror.c.163.com/"]
```

---

## **八、配置非 root 用户权限（可选）**
```bash
# 将当前用户加入 docker 组
sudo usermod -aG docker $USER

# 立即生效（或注销后重新登录）
newgrp docker
```

---

## **九、防火墙与 SELinux 配置**
### **1. 允许 Docker 通过防火墙**
```bash
sudo firewall-cmd --permanent --zone=public --add-interface=docker0
sudo firewall-cmd --reload
```

### **2. 临时禁用 SELinux（测试用）**
```bash
sudo setenforce 0  # 临时关闭
# 永久关闭需编辑 /etc/selinux/config，设置 SELINUX=disabled
```

---

## **十、最终验证**
```bash
# 拉取 Nginx 镜像测试速度
time docker pull nginx

# 正常情况：下载速度应在 10MB/s 以上
```

---

## **常见问题终极解决方案**

## **1. 服务启动失败（错误日志：Failed to start Docker）**
- **原因**：残留进程或配置冲突。  
- **解决**：  
  ```bash
  sudo systemctl stop docker
  sudo pkill dockerd  # 强制终止残留进程
  sudo systemctl start docker
  ```

## **2. 镜像加速未生效**
- **原因**：配置未被加载或镜像源失效。  
- **解决**：  
  ```bash
  # 检查文件权限
  sudo ls -l /etc/docker/daemon.json  # 必须为 root:root，权限 644

  # 测试镜像源连通性
  curl -I https://mirror.ccs.tencentyun.com
  ```
  - 如果返回 `HTTP 200`，表示镜像源可用。

## **3. 权限问题（提示 Permission denied）**
- **解决**：  
  ```bash
  # 确保用户已加入 docker 组
  groups $USER  # 输出应包含 docker

  # 重启会话
  su - $USER
  ```

---

## **附：Docker 常用命令速查表**
| 命令                     | 说明                     |
|--------------------------|--------------------------|
| `docker run hello-world` | 测试 Docker 是否正常运行 |
| `docker ps -a`           | 查看所有容器             |
| `docker images`          | 查看本地镜像             |
| `docker pull nginx`      | 拉取 Nginx 镜像          |
| `docker stop <容器ID>`   | 停止容器                 |

---

## **总结**
1. **核心步骤**：卸载旧版 → 安装依赖 → 添加仓库 → 安装 Docker → 配置镜像加速 → 验证。  
2. **关键点**：  
   - `daemon.json` **必须为纯 JSON 格式**（无注释、英文符号）。  
   - 国内用户**必须配置镜像源**，推荐腾讯云镜像。  
3. **故障排查**：  
   - 优先检查日志：`journalctl -u docker`。  
   - 验证镜像源连通性：`curl -I <镜像地址>`。  

按此教程操作后，Docker 应能正常运行并加载镜像加速配置。如仍遇到问题，请提供 `docker info` 和 `journalctl -xe` 输出以便进一步诊断。

CentOS 8 完整 Docker 安装与镜像加速配置教程

:::tip{title="如何完整的删除Docker镜像和容器"}
Docker在长期使用后会产生大量无用的镜像、容器和卷，占用宝贵的磁盘空间。
本文将系统讲解如何安全高效地清理 Docker 环境，包含基础操作、进阶技巧和注意事项。还有以在实际环境操作举例完整说明
:::



## 一、基础清理操作
### 1. 清理停止的容器
```bash
# 查看所有容器（包括已停止的）
docker ps -a

# 删除单个停止的容器
docker rm <container_id>

# 批量删除所有停止的容器
docker container prune
```

### 2. 清理无用镜像
```bash
# 查看所有镜像列表
docker images

# 删除单个镜像
docker rmi <image_id>

# 强制删除镜像（当有容器依赖时）
docker rmi -f <image_id>

# 删除所有悬空镜像（未被任何容器引用的中间层）
docker image prune

# 删除指定仓库的所有标签
docker rmi $(docker images <repository> --format "{{.ID}}")
```

---

## 二、进阶清理技巧

### 1. 按时间过滤清理
```bash
# 删除 7 天前的镜像
docker image prune -a --filter "until=168h"

# 删除 30 天前的卷
docker volume prune --filter "until=720h"
```

### 2. 精准清理策略
```bash
# 删除指定镜像的所有标签
docker rmi $(docker images --filter=reference='<repository>:*' -q)

# 结合 grep 过滤特定镜像
docker images | grep 'nginx' | awk '{print $3}' | xargs docker rmi

# 删除所有未被使用的资源（镜像/容器/网络）
docker system prune
```

### 3. 自动清理脚本
```bash
#!/bin/bash
# 一键清理脚本（慎用！）

echo "清理停止的容器..."
docker container prune -f

echo "清理无用镜像..."
docker image prune -a -f

echo "清理未使用卷..."
docker volume prune -f

echo "清理网络..."
docker network prune -f

echo "清理完成！"
```

---

## 三、安全注意事项

### 1. 防误删策略
- **确认容器状态**：删除前务必检查 `docker ps -a`
- **标签关联**：删除镜像前确保没有运行的容器依赖
- **备份重要数据**：清理前导出重要容器数据 `docker save`
- **使用 --dry-run**：通过 `docker system prune --dry-run` 预览删除内容

### 2. 关键概念区分
| 资源类型       | 生命周期                  | 清理命令              |
|----------------|---------------------------|-----------------------|
| 容器           | 运行时存在，停止后仍保留 | `docker rm`           |
| 镜像           | 由多个层组成，需手动清理 | `docker rmi`          |
| 数据卷         | 持久化存储               | `docker volume prune` |
| 网络           | 自定义网络需手动管理     | `docker network prune`|

### 3. 高级场景处理
#### 镜像依赖冲突
当出现 `Error response from daemon: conflict` 错误时：
```bash
# 查找依赖该镜像的容器
docker ps -a --filter "ancestor=<image_id>"

# 先删除相关容器
docker rm <container_id>
```

#### 分层缓存清理
Docker 镜像由多层构成，可通过以下命令优化：
```bash
# 删除所有中间层镜像
docker builder prune
```

---

## 四、最佳实践建议

1. **开发环境**：使用 `--rm` 参数自动清理临时容器
   ```bash
   docker run --rm -it ubuntu /bin/bash
   ```

2. **生产环境**：
   - 为关键镜像打版本标签
   - 设置定期清理任务（cron job）
   - 使用镜像仓库管理长期存储

3. **监控磁盘使用**：
   ```bash
   docker system df  # 查看 Docker 磁盘使用情况
   ```

---
## 五、实战案例
![](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/docker-delete1.png)

假设我要删除第一项服务。以下是删除镜像 `henrygd/beszel-agent:latest` 的详细实战步骤，包含安全验证和容错机制

---

### **步骤 1：检查是否有容器依赖此镜像**
```bash
# 列出所有容器（包括已停止的），过滤出使用该镜像的实例
docker ps -a --filter "ancestor=henrygd/beszel-agent:latest"
```

#### 可能的输出结果：
- **情况一**（无容器依赖）：
  ```
  CONTAINER ID   IMAGE                          COMMAND   CREATED   STATUS    PORTS     NAMES
  ```
  **解释**：没有容器使用此镜像，可直接删除。

- **情况二**（存在容器依赖）：
  ```
  CONTAINER ID   IMAGE                          COMMAND   CREATED    STATUS      PORTS     NAMES
  a1b2c3d4e5f6   henrygd/beszel-agent:latest    ...      5 days ago Exited (0)  2 days ago   web-server
  ```
  **解读**：有容器依赖，需先处理容器。

---

### **步骤 2：处理依赖容器**
#### 如果存在依赖容器（情况二）：
```bash
# 停止容器（如果容器仍在运行）
docker stop a1b2c3d4e5f6

# 删除容器（替换为实际的 CONTAINER ID）
docker rm a1b2c3d4e5f6
```

#### 批量删除所有关联容器（更高效）：
```bash
# 通过镜像名直接删除所有关联容器（慎用！确保无重要数据）
docker rm $(docker ps -aq --filter "ancestor=henrygd/beszel-agent:latest")
```

---

### **步骤 3：删除镜像**
```bash
# 执行删除命令
docker rmi henrygd/beszel-agent:latest
```

#### 成功输出：
```
Untagged: henrygd/beszel-agent:latest
Deleted: sha256:25c207be20b7...
```

#### 若报错 `Error response from daemon: conflict`：
- **原因**：仍有容器依赖（即使已停止）
- **解决方案**：强制删除镜像（⚠️ 确保无重要容器！）
  ```bash
  docker rmi -f henrygd/beszel-agent:latest
  ```

---

### **步骤 4：验证删除结果**
```bash
# 再次查看镜像列表
docker images | grep "henrygd/beszel-agent"

# 预期输出：无相关镜像记录
```

---

### **完整操作流程示例**
```bash
# 1. 检查容器依赖
$ docker ps -a --filter "ancestor=henrygd/beszel-agent:latest"
CONTAINER ID   IMAGE                          COMMAND   CREATED    STATUS      PORTS     NAMES
a1b2c3d4e5f6   henrygd/beszel-agent:latest    ...      5 days ago Exited (0)  2 days ago   web-server

# 2. 删除关联容器
$ docker rm a1b2c3d4e5f6
a1b2c3d4e5f6

# 3. 删除镜像
$ docker rmi henrygd/beszel-agent:latest
Untagged: henrygd/beszel-agent:latest
Deleted: sha256:25c207be20b7...

# 4. 验证删除
$ docker images | grep "henrygd/beszel-agent"
# 无输出
```

---

### **关键注意事项**
1. **数据安全**：  
   - 如果镜像关联数据库或存储卷，删除前请确认数据已备份或迁移。
   - 使用 `docker inspect <container>` 检查容器挂载的卷（`Mounts` 字段）。

2. **镜像别名冲突**：  
   如果同一镜像有多个标签（如 `dev`/`prod`），需删除所有标签：
   ```bash
   docker rmi $(docker images --filter=reference='henrygd/beszel-agent:*' -q)
   ```

3. **强制删除场景**：  
   当容器处于 `Exited` 状态但无法删除时，使用：
   ```bash
   docker container prune --filter "until=72h"  # 清理72小时前的停止容器
   ```

---
## 六、实战问题补充
![](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/docker-delete2.png)
如果遇到这种情况，理论上不大可能，但是也会有可能遇到。
### **核心概念解释**

#### 1. 什么是悬空镜像（Dangling Image）？
- **定义**：没有关联任何仓库名（Repository）和标签（Tag）的镜像。
- **表现形式**：在 `docker images` 输出中显示为 `<none>:<none>`。
- **产生原因**：
  - **重复构建镜像**：使用相同标签（如 `latest`）多次构建镜像，旧镜像会被覆盖标签，变成无主状态。
  - **手动删除标签**：删除某个标签后，原镜像失去引用。

#### 2. 为什么用 `dangling=true`？
- **作用**：这是 Docker 的过滤器语法，用于精准筛选出悬空镜像。
- **技术原理**：  
  Docker 会为每个镜像层生成唯一标识（IMAGE ID）。当镜像的标签被删除或覆盖时，该镜像层不再被任何标签引用，此时 Docker 会将其标记为 `dangling`（悬空状态）。

---

### **通俗比喻**
- **悬空镜像**：就像你手机里一张照片被删除后，相册里留下的“空白占位图”，它不再有名字，也没人引用，但占据存储空间。
- **`dangling=true`**：相当于用过滤器快速找到这些“空白占位图”，方便你一键清理。

### **实战问题解决**
从实战输出可以看到，原本的镜像 `henrygd/beszel-agent:latest` 已经变成 `<none>:<none>`，这说明它已经成为 **悬空镜像**（Dangling Image）。这种情况通常发生在以下场景：
- 同一镜像被重复构建并覆盖标签（例如多次执行 `docker build -t henrygd/beszel-agent:latest .`）
- 镜像被其他标签引用后，原标签被移除

以下是针对悬空镜像的  **完整清理方案**：

### **步骤 1：确认镜像状态**
```bash
# 查看所有悬空镜像（无仓库名和标签）
docker images -f "dangling=true"

# 输出示例：
REPOSITORY          TAG                 IMAGE ID       CREATED         SIZE
<none>              <none>              25c207be20b7   9 days ago      7.85MB
```

---

### **步骤 2：删除单个悬空镜像**
```bash
# 通过 IMAGE ID 直接删除
docker rmi 25c207be20b7
```

#### 可能遇到的错误：
- **错误提示**：`Error response from daemon: conflict: unable to delete 25c207be20b7 (must be forced) - image is referenced in multiple repositories`
  - **原因**：该镜像被多个仓库引用（例如被其他标签或别名关联）
  - **解决方案**：强制删除（⚠️ 确保无重要容器依赖！）
    ```bash
    docker rmi -f 25c207be20b7
    ```

---

### **步骤 3：批量删除所有悬空镜像**
```bash
# 删除所有悬空镜像（推荐）
docker image prune

# 输入 y 确认删除
# 输出示例：
Deleted Images:
deleted: sha256:25c207be20b7...
Total deleted: 7.85MB
```

---

### **步骤 4：深度清理（含中间层缓存）**
如果上述操作后仍有残留，使用以下命令清理 **所有未被使用的镜像层**：
```bash
# 删除所有未被容器或新镜像引用的镜像层
docker builder prune --all

# 或者结合强制删除
docker system prune -a --volumes
```

---

### **关键原理说明**
| 概念                | 说明                                                                 |
|---------------------|----------------------------------------------------------------------|
| 悬空镜像            | 被其他镜像覆盖标签后遗留的中间层镜像，无实际仓库名和标签             |
| 中间层镜像          | Docker 镜像由多层文件系统组成，构建新镜像时会生成新的中间层         |
| 镜像引用关系        | 一个镜像可能被多个标签或容器引用，只有所有引用解除后才能彻底删除     |

---

### **完整操作示例**
```bash
# 1. 查看悬空镜像
$ docker images -f "dangling=true"
REPOSITORY          TAG                 IMAGE ID       CREATED         SIZE
<none>              <none>              25c207be20b7   9 days ago      7.85MB

# 2. 删除单个悬空镜像
$ docker rmi 25c207be20b7
Error response from daemon: conflict: unable to delete 25c207be20b7 (must be forced) - image is referenced in multiple repositories

# 3. 强制删除（如果普通删除失败）
$ docker rmi -f 25c207be20b7
Untagged: 25c207be20b7...

# 4. 批量清理验证
$ docker image prune
Deleted Images:
deleted: sha256:25c207be20b7...
Total deleted: 7.85MB
```

---

### **预防悬空镜像的建议**
1. **避免重复覆盖标签**：  
   为不同版本的镜像使用唯一标签（例如 `v1.0`、`v1.1`），不要重复使用 `latest`
   ```bash
   docker build -t henrygd/beszel-agent:v1.0 .
   ```

2. **定期清理**：  
   将以下命令加入定时任务（cron）：
   ```bash
   # 每天凌晨清理悬空镜像
   0 3 * * * docker image prune -f
   ```

3. **使用镜像管理工具**：  
   推荐使用 `dive` 工具分析镜像层：
   ```bash
   dive henrygd/beszel-agent:latest
   ```
---
## 七、还有问题，彻底解决
有时候你跟着步骤做的操作步骤是对的。但还是删除镜像 `25c207be20b7`失败。

失败的原因是：**该镜像被一个名为 `ba698fd40eb0` 的容器引用**，但该容器可能已被删除或处于异常状态。以下是具体原因和解决方案：

---

### **根本原因**
1. **容器与镜像的依赖关系**  
   镜像 `25c207be20b7` 被容器 `ba698fd40eb0` 使用，但：
   - 你尝试停止容器时误用了 **镜像ID**（`25c207be20b7`）作为容器ID，导致操作失败。
   - 实际容器ID是 `ba698fd40eb0`，需要针对该容器操作。

2. **镜像被中间层引用**  
   该镜像可能是其他镜像的构建中间层，即使没有显式容器依赖，也可能被 Docker 内部引用。

---

### **解决方案**
#### 1. 精准删除关联容器
```bash
# 1. 查找使用该镜像的容器（包括已停止的）
docker ps -a --filter "ancestor=25c207be20b7"

# 2. 删除关联容器（替换为实际的 CONTAINER ID）
docker rm -f ba698fd40eb0  # 强制删除容器（即使已停止）

# 3. 再次删除镜像
docker rmi 25c207be20b7
```

#### 2. 强制清理悬空镜像（绕过依赖）
如果确认无重要容器依赖，可直接清理所有悬空镜像：
```bash
# 1. 批量删除所有悬空镜像
docker image prune -f

# 2. 深度清理（含中间层缓存）
docker builder prune --all
```

#### 3. 检查镜像引用链
如果仍报错，检查镜像是否被其他标签或构建缓存引用：
```bash
# 查看镜像的引用关系
docker image inspect 25c207be20b7 --format='{{.RootFS.DiffIDs}}'

# 清理所有未被引用的镜像层
docker system prune -a --volumes
```
---

### **操作验证**
```bash
# 1. 确认容器已删除
docker ps -a | grep "ba698fd40eb0"

# 2. 确认镜像已删除
docker images | grep "25c207be20b7"
```
---
## 八、总结：  
**清理 Docker 镜像和容器的核心命令与注意事项** 
1. **停容器**：`docker container prune`（批量删停止的容器）；  
2. **删镜像**：`docker image prune`（删悬空镜像），`docker rmi <image_id>`（指定镜像）；  
3. **悬空镜像**：用 `dangling=true` 过滤，普通删除或强制 `docker rmi -f`；  
4. **安全提示**：删前检查依赖（`docker ps -a`），避免强制误删，生产环境慎用 `docker system prune`。
5. **容器ID ≠ 镜像ID**：操作时需严格区分两者。
6. **强制删除风险**：`-f` 参数会跳过依赖检查，确保无重要数据后再使用。
7. **中间层缓存**：Docker 构建过程中生成的中间层镜像可能长期残留，需定期清理。