MIutopia's Blog 2026-07-08T08:02:15.040Z https://www.cloudetopia.top/ MIutopia Hexo 别学 Git 命令了——直接用自然语言让 Claude Code 帮你回滚 https://www.cloudetopia.top/2026/07/01/2026-07-01-%E8%87%AA%E7%84%B6%E8%AF%AD%E8%A8%80%E5%9B%9E%E6%BB%9A/ 2026-07-01T08:00:00.000Z 2026-07-08T08:02:15.040Z 前言

上一篇我们讲了 Git 回滚的五种方法——checkout、reset、revert、stash、重新克隆。如果你认真学了，应该能应对大部分翻车场景。

但说实话，对很多新手来说，记住这些命令的区别还是挺头疼的。什么时候用 --soft，什么时候用 --hard？revert 和 reset 到底该选哪个？

如果不用记这些命令呢？

如果你能直接用中文告诉 Claude Code：”把刚才那次改动撤掉”、”回到十分钟前的状态”、”先存个档再继续改”——它自己去执行对应的 Git 命令，你只需要看结果对不对。

这篇文章就讲怎么做到这件事。

核心思路：让 Claude 当你的 Git 翻译官

Git 命令是给人看的操作界面，但本质上它做的事情很简单：保存快照、对比差异、恢复状态。这些逻辑 Claude Code 完全理解。

你要做的只有两件事：

  1. 在 CLAUDE.md 里定好规则，让 Claude 在干活时自动做好安全防护
  2. 用自然语言指挥回滚，不需要记任何 Git 命令

第一步：在 CLAUDE.md 里写好”安全规范”

打开你项目根目录的 CLAUDE.md，加上这样一段规则：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
## 安全规范

### 操作前自动存档
- 每次修改文件前，先 git add + git commit 当前状态，提交信息格式：
  "checkpoint: 操作前的安全存档 - [简要描述即将执行的操作]"
- 这样每次改动都有一个可以回退的节点

### 批量操作前额外保护
- 批量修改超过 3 个文件前，先创建一个新的 Git 分支
- 在分支上完成操作，确认无误后再合并回 main

### 回滚响应
- 当我说"撤回"、"回滚"、"撤销"、"回到之前"时，
  自动执行 git revert 或 git reset（根据是否已推送判断）
- 当我说"存档"时，执行 git stash
- 当我说"恢复存档"时，执行 git stash pop

有了这段规则，Claude Code 每次启动都会读到它，然后按照这个规范来工作。

实际效果：用自然语言完成整个流程

下面模拟一个完整的工作场景，看看实际用起来是什么样的。

场景：批量改写博客文章格式

1
2
3
4
5
你：帮我把 source/_posts/ 下所有旧文章统一改写成最新那篇的风格。

Claude：好的，我先存档当前状态，然后开始逐篇改写。
       [自动执行 git commit -m "checkpoint: 操作前的安全存档 - 批量改写文章格式"]
       开始改写第 1 篇...

注意这里 Claude 自动先做了存档，不需要你提醒。

1
2
3
4
5
你：等一下，第 2 篇改得不对，把第 2 篇恢复成原来的。

Claude：好的，我把 article2.md 恢复到上次存档的状态。
       [自动执行 git checkout HEAD~1 -- source/_posts/article2.md]
       已恢复，你看一下对不对。

你不需要知道 git checkout HEAD~1 -- 这个命令，只需要说”恢复成原来的”。

1
2
3
4
5
你：其他文章改得没问题，继续改剩下的。

Claude：好的，继续改写第 3 篇到第 15 篇...
       [改完后自动 commit]
       全部改完了，要我直接推送到 GitHub 吗？
1
2
3
你：先别推，我本地看看效果。

Claude：好的，暂不推送。你可以在本地预览，有问题随时告诉我。
1
2
3
4
5
你：看了下效果不太好，把刚才的批量改动全部撤掉。

Claude：好的，我撤销最近那次批量改写的 commit。
       [自动执行 git revert HEAD 或 git reset --soft HEAD~1]
       已撤销，所有文章恢复到改写前的状态。

整个过程你没有输入过一条 Git 命令。

常用的自然语言回滚指令

整理一些你在实际工作中会用到的自然语言指令，直接对 Claude Code 说就行：

你说的话Claude 会做的事
“撤回上一步”git reset --soft HEAD~1（还没 push）或 git revert HEAD（已 push）
“把刚才改的 XX 文件恢复原样”git checkout HEAD~1 -- 文件名
“全部撤掉，回到改之前”git reset --hard HEAD~N（会先跟你确认）
“先存个档”git stash
“恢复存档”git stash pop
“看看之前改了什么”git diff 或 git log --oneline
“回到昨天下午的状态”根据 git log 的时间戳找到对应 commit，执行 reset 或 revert
“这个改动太危险，开个新分支做”git checkout -b 新分支名

你不需要记住这些命令，只需要用你习惯的方式描述你想做什么。

进阶：让 Claude 自己判断风险

在 CLAUDE.md 里可以加更智能的规则，让 Claude 自己判断哪些操作需要额外保护：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
## 风险判断规则

### 高风险操作（必须自动存档 + 通知用户）
- 删除文件
- 批量修改超过 5 个文件
- 修改配置文件（_config.yml、vercel.json 等）
- 修改主题文件

### 中风险操作（自动存档，静默执行）
- 修改单篇文章内容
- 添加新文件
- 修改 frontmatter

### 低风险操作（直接执行）
- 读取文件
- 查看 git 状态
- 查看部署日志

这样 Claude 在删除文件之前会自动先 commit 存档，你不用担心它”静默删库”。

一个完整的实战演示

用我的博客项目做个真实演示。

任务：给所有文章加 SEO 描述

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
你：给 source/_posts/ 下每篇文章的 frontmatter 加一个 description 字段，
    用一句话概括文章内容。

Claude：收到。我先存档当前状态。
       [git commit -m "checkpoint: 操作前的安全存档 - 批量添加 SEO 描述"]
       
       开始处理第 1 篇：2023-10-17-Docker.md
       description: "Docker 入门教程，涵盖核心概念、安装配置和常用命令"
       
       第 2 篇：2023-10-20-Dockerfile.md
       description: "Dockerfile 编写指南，从基础语法到最佳实践"
       ...
       
       全部处理完毕，共修改 15 个文件。要我提交吗？

你：提交吧。

Claude：[git add . && git commit -m "feat: 为所有文章添加 SEO description"]
       已提交。需要推送到 GitHub 吗？

你：推吧。

Claude：[git push origin main]
       已推送，Vercel 会自动部署。

发现问题，需要回滚

1
2
3
4
5
6
7
8
你：等下，我看到有篇文章的 description 写得不准确，
    把所有改动都撤掉，我重新给你更准确的概括。

Claude：好的，已经推送到远程了，我用 git revert 来撤销。
       [git revert HEAD --no-edit]
       [git push origin main]
       已撤销并推送，所有文章的 description 字段已移除，
       恢复到添加前的状态。你可以重新给我更准确的概括。

看，从发现问题到完成回滚，你只说了一句话。

对比：传统方式 vs 自然语言方式

操作传统方式（你需要记的命令）自然语言方式
撤销未提交的改动git checkout -- 文件名“把 XX 恢复原样”
撤回一次 commitgit reset --soft HEAD~1“撤回上一步”
撤销已推送的改动git revert HEAD + git push“把刚才推送的撤掉”
临时保存现场git stash“先存个档”
查看改了什么git diff / git log“看看之前改了什么”
回到某个时间点git log → 找 hash → git reset“回到昨天下午的状态”

传统方式你需要记住命令、理解参数、判断用哪个。自然语言方式你只需要描述你想达到的效果。

注意事项

虽然自然语言回滚很方便，但有几点还是要了解：

Claude 会先确认再执行危险操作。 如果你在 CLAUDE.md 里写了”高风险操作前通知用户”，Claude 在执行 git reset --hard 这种不可逆操作前会先问你确认。这是好事——给 AI 加一道人工审核。

推送后的回滚比推送前复杂。 没推送的改动，Claude 可以直接 reset；已经推送的，需要用 revert 生成新 commit。你不需要理解这个区别，但知道”推出去的东西撤回来会多一步”有助于你养成”改完先看再推”的习惯。

频繁存档会产生很多 commit。 如果你介意 git 历史太乱，可以让 Claude 在任务完成后把多个 checkpoint commit 合并成一个（用 git rebase -i，但这个操作比较复杂，建议让 Claude 自己处理）。

总结

回到这篇文章的核心观点：你不需要成为 Git 专家，也能安全地使用 AI 写代码。

通过在 CLAUDE.md 里设定好安全规范，Claude Code 会在每次操作前自动存档，在你需要回滚时理解你的自然语言指令，然后替你执行正确的 Git 命令。

你要做的只是：

  1. 写清楚 CLAUDE.md 里的安全规则
  2. 用中文告诉 Claude 你想做什么
  3. 在 Claude 执行后检查结果

剩下的，交给 AI。

这是 Claude Code + GitHub + Vercel 系列文章的第四篇。从环境搭建到项目管理，从故障恢复到自然语言回滚，你已经掌握了一套完整的 AI 协作开发工作流。现在，去实践吧。

]]> 用自然语言指令让 AI 执行 Git 回滚操作，无需记住任何 Git 命令。 Claude Code 写代码翻车了？Git 回滚与故障恢复实战 https://www.cloudetopia.top/2026/07/01/2026-07-01-Git%E5%9B%9E%E6%BB%9A%E4%B8%8E%E6%95%85%E9%9A%9C%E6%81%A2%E5%A4%8D/ 2026-07-01T06:00:00.000Z 2026-07-08T08:02:15.040Z 前言

前两篇文章里，我们搭好了 Claude Code + GitHub + Vercel 的协作环境，也学会了用 Claude Code 自动化管理项目。但你迟早会遇到一个问题——AI 翻车了。

可能是 Claude Code 批量改文件时误删了几篇博客，可能是改错了配置文件导致 Vercel 部署失败，也可能是推送了一段有 bug 的代码把线上页面搞崩了。

别慌。这就是 Git 存在的意义——它是你的时间机器，让你随时可以回到”还没出问题”的那个时刻。

这篇文章专门讲：当 Claude Code 搞砸事情的时候，怎么用 Git 把局面救回来。

AI 翻车的常见场景

先看看 Claude Code 可能怎么”翻车”，心里有个数：

翻车类型具体表现严重程度
误删文件批量操作时删掉了不该删的文件🔴 高
改错配置修改了 _config.yml 导致构建失败🟡 中
推送 bug推送了有语法错误的代码，Vercel 部署失败🟡 中
覆盖内容用错误内容覆盖了重要文件🔴 高
批量改坏批量替换时正则写错，所有文件都被改错🔴 高

好消息是：只要这些改动已经提交到了 Git，就都能救回来。哪怕文件被删了、内容被覆盖了，Git 都有办法恢复。

Git 核心概念速补

在学回滚之前，需要先理解 Git 的几个关键区域。不用背，理解意思就行：

1
2
3
4
5
6
7
工作区（Working Directory）  →  你电脑上看到的文件
       ↓  git add
暂存区（Staging Area）      →  准备好要提交的改动
       ↓  git commit
本地仓库（Repository）      →  提交历史，每个 commit 是一个快照
       ↓  git push
远程仓库（Remote）          →  GitHub 上的备份

关键认知：每次 git commit 都是给项目拍了一张”快照”。 回滚的本质就是”把文件恢复到之前某张快照的状态”。

记住这个概念，后面的操作就很好理解了。

回滚实战：五招救命

第一招：git checkout — 撤销工作区的修改

场景：Claude Code 刚改了几个文件，你还没 git add，一看改得不对，想撤回。

1
2
3
4
5
6
7
8
# 查看当前状态，看哪些文件被改了
git status

# 撤销某个文件的修改（还没 add 的）
git checkout -- source/_posts/某篇文章.md

# 撤销所有文件的修改（还没 add 的）
git checkout -- .

这是最轻量的一招，相当于告诉 Git：”工作区里这些改动我不要了，恢复到上次 commit 的状态。”

⚠️ 注意：这个操作不可逆。撤销后，未暂存的改动就彻底丢了。如果不确定，可以先用 git stash 暂存（后面会讲）。

第二招：git reset — 撤回暂存区或提交

场景一：Claude Code 已经 git add 了，但还没 git commit。

1
2
3
4
5
# 把暂存区的改动撤回到工作区（不会丢代码）
git reset HEAD

# 或者只撤回某个文件
git reset HEAD source/_posts/某篇文章.md

场景二：Claude Code 已经 git commit 了，但还没 git push。

1
2
3
4
5
# 撤回最近一次 commit，改动回到暂存区
git reset --soft HEAD~1

# 撤回最近一次 commit，改动回到工作区
git reset HEAD~1

HEAD~1 表示”往回退一个 commit”。如果是退两个就是 HEAD~2，以此类推。

--soft 和默认的区别：

参数commit 撤回后，改动在哪
--soft留在暂存区（相当于还没 commit）
默认（--mixed）回到工作区（相当于还没 add）
--hard直接丢弃，什么都不剩

⚠️ --hard 是最危险的选项，它会彻底丢弃所有改动。除非你确定那些改动完全不需要，否则不要用。

第三招：git revert — 安全地撤销已推送的提交

场景：Claude Code 改完代码已经 git push 到 GitHub 了，Vercel 也部署了，结果发现问题。

这时候不能直接 reset——因为远程仓库已经有了那个 commit，你本地 reset 后 push 会冲突。

正确做法是用 git revert：

1
2
3
4
5
6
7
8
# 查看最近的 commit 记录
git log --oneline

# 撤销最近一次 commit（生成一个新的"反向 commit"）
git revert HEAD

# 撤销指定的某次 commit
git revert abc1234

git revert 的原理是：生成一个新的 commit，内容恰好是目标 commit 的”反面”——它加了什么就删什么，它删了什么就加什么。

这样做的好处是不会改写历史，其他协作者不会受到影响。

1
2
# revert 完成后推送到远程
git push origin main

第四招：git stash — 临时保存现场

场景：你正在让 Claude Code 改一篇文章，改到一半发现另一个文件有更紧急的问题要处理。但当前改动还没完成，不想提交也不想丢掉。

1
2
3
4
5
6
7
8
# 把当前改动暂存起来
git stash

# 现在工作区是干净的，可以去处理紧急问题了
# ...处理完毕...

# 恢复之前暂存的改动
git stash pop

git stash 就像一个临时抽屉——把改动先放进去，等你忙完了再拿出来继续。

1
2
3
4
5
# 查看暂存了几个抽屉
git stash list

# 恢复指定的暂存
git stash pop stash@{1}

第五招：重新克隆 — 终极方案

场景：本地仓库搞得一团乱，reset 来 reset 去已经分不清状态了。

最简单粗暴的办法——删掉本地仓库，重新从 GitHub 克隆一份干净的：

1
2
3
4
5
6
7
8
# 回到上级目录
cd ..

# 删掉搞乱的本地仓库
rm -rf hexo-blog-source

# 重新克隆
git clone https://github.com/MIutopia/hexo-blog-source.git

只要 GitHub 上的代码是对的，重新克隆就能拿到一份完全干净的环境。之前的所有本地操作（stash、reset、checkout 搞乱的）统统不存在了。

💡 这不是”认输”，这是务实。当 Git 状态复杂到理不清的时候，花 5 分钟重新克隆比花 2 小时排查状态高效得多。

真实案例复盘

讲一个我实际遇到的情况，完整演示一遍恢复流程。

事故经过

我让 Claude Code 批量改写博客文章的格式。它读了几篇参考文章后，开始逐篇修改。改到一半时，我发现它把几篇文章的 frontmatter 删掉了，而且还 git add 了。

1
2
3
4
git status 输出：
modified:   source/_posts/article1.md    ← frontmatter 被删了
modified:   source/_posts/article2.md    ← 内容被覆盖了
modified:   source/_posts/article3.md    ← 正常

第一步：冷静，先别提交

看到问题后最重要的是——不要慌，不要急着 commit 或 push。只要还没 commit，一切都好办。

第二步：查看具体改了什么

1
git diff source/_posts/article1.md

git diff 会显示详细的改动对比，帮你判断哪些改动是好的、哪些是坏的。

第三步：选择性恢复

1
2
3
4
5
# article1 和 article2 改坏了，恢复到上次 commit 的状态
git checkout -- source/_posts/article1.md
git checkout -- source/_posts/article2.md

# article3 改得没问题，保留改动

第四步：确认状态

1
2
git status
# 现在只有 article3 是 modified 状态，其他都恢复了

第五步：重新让 Claude Code 修复

1
2
你：article1.md 和 article2.md 的 frontmatter 被你删掉了，
    请重新加上，格式参考 article3.md。注意不要动正文内容。

这次加了更明确的指令，Claude Code 正确修复了两篇文章。

第六步：检查后提交

1
2
3
4
5
6
7
8
# 再 diff 一次确认改动正确
git diff source/_posts/article1.md
git diff source/_posts/article2.md

# 确认没问题后提交
git add .
git commit -m "fix: 修复批量改写导致的 frontmatter 丢失"
git push origin main

整个过程大约 5 分钟。如果没有 Git，这两篇文章就彻底丢了。

防御性习惯：让翻车代价降到最低

与其事后救火，不如事前预防。以下是几个实用的防御策略：

1. 频繁提交，小步快跑

不要攒了一大堆改动才 commit。每完成一个小任务就提交一次，这样回滚的粒度更细，不会”一滚滚一大片”。

1
2
3
4
5
6
7
# 好的习惯
git commit -m "feat: 更新 article1 的 frontmatter"
git commit -m "feat: 更新 article2 的 frontmatter"
git commit -m "feat: 更新 article3 的 frontmatter"

# 坏的习惯
# 改了 15 个文件后才 commit 一次

2. 让 Claude Code 在提交前先确认

在 CLAUDE.md 里加一条规则：

1
2
3
4
## 注意事项
- 批量修改文件前，先改一个文件让我确认
- 确认通过后再批量执行
- 每次 commit 前，先 git diff 让我检查

这样 Claude Code 就不会”闷头大干”了。

3. 善用分支

对于不确定的大改动，先在新分支上操作：

1
2
3
4
5
6
7
8
9
# 创建并切换到新分支
git checkout -b refactor/article-format

# 在这个分支上随便改，改坏了也不影响 main
# ...Claude Code 在这里操作...

# 确认没问题后合并回 main
git checkout main
git merge refactor/article-format

如果分支上的改动彻底搞砸了？直接切回 main 分支，那个分支不要就行了。

4. 利用 Vercel Preview 部署

Vercel 对每个 Git 分支都会生成一个 Preview URL。你可以在推送前先在 Preview 环境验证效果，确认没问题了再合并到 main 分支触发正式部署。

1
2
main 分支 → 正式部署（production）
feature 分支 → Preview 部署（预览环境）

5. 定期备份关键配置

把 _config.yml、vercel.json 这类关键配置文件单独备份一份。即使 Git 出了问题，至少还有本地备份可以恢复。

常见问题与踩坑记录

❌ git reset –hard 后文件丢了，能恢复吗？

能，但稍微麻烦。git reflog 可以看到所有 HEAD 移动的记录，包括 reset 操作：

1
2
3
git reflog
# 找到 reset 之前的 commit hash
git reset --hard HEAD@{3}  # 回到那个状态

只要还没有被 Git 的垃圾回收清理掉（默认 30 天），就能找回来。

❌ 已经 push 到 GitHub 的错误 commit，revert 后需要 force push 吗？

不需要。git revert 生成的是新 commit，正常 git push 就行。只有 git reset 改写了历史才需要 force push（而且不推荐在公共分支上 force push）。

❌ Claude Code 执行 git push 后 Vercel 部署失败了，怎么办？

先查看 Vercel 的构建日志定位错误。如果是代码问题，修复后重新 push 即可——Vercel 会自动重新部署。如果急需回滚到上一个正常版本，可以用 git revert 撤销那次有问题的 commit 再 push。

❌ 多人协作时回滚会不会影响其他人？

会。如果你在公共分支上用了 git reset --hard 然后 force push，其他人的本地仓库会和远程不一致。所以公共分支上优先用 git revert，它不改写历史，对所有人都安全。

❌ git stash pop 后出现冲突怎么办？

stash 的内容和当前文件有冲突时，Git 会标记冲突区域。手动解决冲突后，运行 git add 和 git commit 完成合并。如果冲突太多不想处理，可以 git checkout -- . 放弃 stash 的改动。

总结：回滚速查表

最后整理一张速查表，遇到问题直接对照操作：

情况命令说明
改了文件，还没 addgit checkout -- 文件名撤销工作区改动
已经 add，还没 commitgit reset HEAD 文件名撤回到工作区
已经 commit，还没 pushgit reset --soft HEAD~1撤回 commit，保留改动
已经 push 到远程git revert HEAD生成反向 commit
想临时保存现场git stash → git stash pop暂存 → 恢复
彻底搞乱了重新 git clone从头来过

记住一个核心原则：只要代码在 Git 里，就丢不了。每次 commit 都是一个存档点，随时可以读档重来。

四篇文章到这里就结束了。从环境搭建到自动化管理，再到故障恢复，你已经有了一套完整的 AI 协作开发工作流。剩下的就是动手实践——打开终端，输入 claude，开始你的第一次 AI 协作吧。

]]> AI 写代码翻车怎么办？Git 回滚与故障恢复实战指南，附带速查表。 用 Claude Code 实现项目自动化与管理 https://www.cloudetopia.top/2026/07/01/2026-07-01-ClaudeCode%E8%87%AA%E5%8A%A8%E5%8C%96%E7%AE%A1%E7%90%86/ 2026-07-01T04:00:00.000Z 2026-07-08T08:02:15.040Z 前言

搭好 Claude Code + GitHub + Vercel 的环境后，你可能已经体验过”说句话就能写代码”的快感了。但这只是冰山一角。

Claude Code 真正的威力在于自动化——它不只是帮你写一段代码，而是能理解整个项目、批量执行操作、按你的规范自动管理文件。这篇文章会带你从”让 AI 写代码”进阶到”让 AI 管理项目”。

Claude Code 能做什么，不能做什么

先搞清楚能力边界，避免期望过高或过低。

擅长不擅长
读写项目文件、修改配置需要图形界面操作的任务（如拖拽 UI）
执行命令行操作（git、npm、docker 等）实时交互类操作（如调试断点）
理解项目上下文，按规范生成代码超出训练数据范围的极新框架
批量处理重复性任务需要人类审美判断的设计工作
多步骤复杂流程的编排需要实时网络浏览的场景（部分受限）

简单说：凡是能在终端里完成的事，Claude Code 基本都能帮你做。

项目指令文件：给 AI 队友写”入职手册”

Claude Code 有一个核心特性——它会自动读取项目根目录的 CLAUDE.md 文件。这个文件就是你的项目规范，告诉 Claude Code 你的项目是什么、该怎么干活。

一个完整的 CLAUDE.md 示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
# CLAUDE.md

## 项目信息
Hexo 个人博客项目，部署在 Vercel 上。
源码仓库：MIutopia/hexo-blog-source

## 目录结构
- source/_posts/    文章目录（Markdown 格式）
- source/images/    图片资源
- themes/fluid/     主题文件

## 文章规范
- 每篇文章必须包含 YAML frontmatter：title、date、categories、tags
- 日期格式：YYYY-MM-DD HH:MM:SS
- 代码块必须标注语言类型（如 ```bash）
- 使用中文写作，技术术语保留英文原文

## 工作流
- 修改完成后用 git add . && git commit && git push 推送
- 提交信息格式：type: description
  - feat: 新功能/新文章
  - fix: 修复问题
  - docs: 文档更新
  - refactor: 重构

## 注意事项
- 不要修改 _config.yml 除非明确要求
- 不要删除任何已有文件
- 图片文件不要通过 Git 管理（太大）

有了这份”入职手册”，Claude Code 就知道：

  • 文章该写在哪里、什么格式
  • 改完代码该怎么提交
  • 哪些文件不能碰

让指令文件生效

不需要任何额外配置，只要文件放在项目根目录，Claude Code 每次启动时会自动读取。你可以随时修改它，下次对话就会生效。

⚠️ 如果你的项目比较复杂，还可以创建 AGENTS.md（多 Agent 协作规范）或 SOUL.md（语气和风格定义），Claude Code 同样会自动识别。

实战：用 Claude Code 管理 Hexo 博客

下面用我的博客项目做例子，展示 Claude Code 在实际项目管理中的几种用法。

场景一：批量改写文章风格

博客里有十几篇从旧网站迁移过来的文章，格式混乱、代码块没有语言标记、还混着 HTML 实体。手动改太痛苦了。

1
2
3
4
你：source/_posts/ 目录下除了 2026-06-30 那篇，其他文章都是从旧网站
    迁移过来的，格式有问题。请帮我逐篇改写，统一成最新那篇的风格：
    YAML frontmatter → 前言 → 正文分节 → 常见问题 → 结尾。
    代码块加上语言标记，HTML 实体转回正常字符。

Claude Code 会：

  1. 先读取参考文章（2026-06-30 那篇）学习风格
  2. 逐篇读取旧文章
  3. 按新风格重写
  4. 保存回原文件

十几篇文章，几分钟就改完了。

场景二：批量分类和打标签

1
2
3
你：帮我看一下 source/_posts/ 下所有文章的 categories 和 tags，
    如果分类不合理就调整一下。Docker 相关的文章 categories 改成"容器"，
    Kubernetes 和 OpenStack 的改成"云原生"。

Claude Code 会读取每篇文章的 frontmatter，判断内容主题，然后批量修改。

场景三：生成文章摘要和 SEO 优化

1
2
你：给每篇文章在 frontmatter 里加一个 description 字段，
    用一句话概括文章内容，控制在 150 字以内，用于 SEO。

场景四：检查部署状态

1
你：帮我检查一下 Vercel 上最新的部署状态，有没有报错。

Claude Code 可以调用 Vercel 的 API 或 CLI 来检查部署日志。

自动化工作流设计

把上面的场景串起来，就是一个完整的自动化工作流：

1
2
3
4
5
6
7
8
9
10
11
12
13
你描述需求（自然语言）
       ↓
Claude Code 读取 CLAUDE.md 了解项目规范
       ↓
Claude Code 执行操作（写代码/改文件/跑命令）
       ↓
Claude Code 本地验证（检查语法、运行测试）
       ↓
git add → git commit → git push
       ↓
Vercel 检测到推送，自动构建部署
       ↓
部署完成，你收到通知

整个过程你只需要做第一步和最后一步的确认，中间全是自动的。

关键：让 Claude Code 自己决定提交时机

在 CLAUDE.md 里写清楚规则后，你可以直接说：

1
你：改完这篇文章后直接推送到 GitHub。

Claude Code 会自己执行 git add、git commit、git push，不需要你一步步教。

进阶玩法

定时任务自动巡检

Claude Code 支持定时任务功能。比如你可以设置每天早上自动检查：

1
每天早上 9 点，检查 Vercel 部署状态，如果有失败的就通知我。

多项目并行管理

如果你同时维护多个项目，每个项目根目录放一份 CLAUDE.md，Claude Code 切换到不同目录时会自动加载对应的规范。

1
2
你：切到 my-blog 项目，帮我检查一下有没有待推送的改动。
你：切到 portfolio 项目，把首页的联系方式更新一下。

用 Memory 保持上下文连贯

Claude Code 的 Memory 功能可以记住跨会话的信息。比如你告诉它：

1
你：记住一下，我的博客域名是 cloudetopia.top，部署在 Vercel 上。

以后每次对话它都知道这个信息，不需要你重复说明。

效率对比

同样一批任务，手动操作和 Claude Code 操作的对比：

任务手动操作Claude Code
改写 14 篇文章格式2-3 小时10 分钟
批量调整分类标签30 分钟2 分钟
检查部署状态打开网页 → 登录 → 查看一句话
新增一篇博客文章写内容 + 手动加 frontmatter + git 操作描述需求，全自动
修复一个配置错误查文档 + 改文件 + 测试 + 提交描述问题，自动完成

效率提升不是线性的——越重复、越机械的任务，AI 的优势越明显。

常见问题与踩坑记录

❌ Claude Code 不遵守 CLAUDE.md 里的规范

检查文件是否在项目根目录（和 .git 同级），文件名必须是大写的 CLAUDE.md。如果项目结构复杂，可以在子目录也放一份。

❌ 批量操作时 Claude Code 改错了文件

这是 AI 的常见问题。建议先让它在一个文件上试改，确认效果满意后再说”其他文件也按这个方式改”。Git 的存在就是为了防止这种意外——改错了可以回滚（下一篇详细讲）。

❌ Claude Code 执行 git push 失败

通常是认证问题。确认 Git 的 remote URL 正确（git remote -v 检查），以及你已经配置了 Personal Access Token 或 SSH Key。

❌ Vercel 部署成功但页面没更新

可能是浏览器缓存。尝试强制刷新（Ctrl+Shift+R），或者在 Vercel 控制台手动触发一次 Redeploy。

❌ Claude Code 响应变慢或卡住

可能是上下文太长了。试试开启新会话，或者把复杂任务拆成几个小任务分步执行。

下一步

现在你已经能用 Claude Code 高效管理项目了。但 AI 写代码难免会出错——删错文件、改坏配置、推送了有 bug 的版本。下一篇我们会讲：当 Claude Code 翻车时，如何用 Git 快速回滚，把损失降到最低。

下一篇：Claude Code 写代码翻车了？Git 回滚与故障恢复实战

]]> 用 Claude Code 实现项目管理自动化，涵盖批量操作、配置管理、部署检查等场景。 从零搭建 AI 协作开发环境：Claude Code + GitHub + Vercel https://www.cloudetopia.top/2026/07/01/2026-07-01-AI%E5%8D%8F%E4%BD%9C%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E6%90%AD%E5%BB%BA/ 2026-07-01T02:00:00.000Z 2026-07-08T08:02:15.040Z 前言

2025 年，AI 编程工具迎来了一次爆发。从 GitHub Copilot 到 Cursor，再到 Anthropic 推出的 Claude Code，开发者第一次可以真正意义上”让 AI 帮你写代码、跑命令、管项目”。

但这套工具链搭起来并不容易——尤其是对于零基础的新手来说，Claude Code 是什么、GitHub 怎么用、Vercel 怎么连，每一个概念都是新的。

这篇文章的目标很简单：带你从零开始，把 Claude Code + GitHub + Vercel 这套 AI 协作开发环境跑通。搭好之后，你只需要用自然语言告诉 Claude Code 你想做什么，它就能帮你写代码、提交到 GitHub、自动部署到 Vercel。

先搞清楚四个概念

在动手之前，先用最直白的话解释一下这四个工具各自是干什么的。

工具一句话解释生活类比
Git代码的版本管理工具，每次修改都有记录游戏的存档系统
GitHub云端的代码仓库，存代码的地方云盘，但专门存代码
Vercel自动部署平台，代码推上去就能变成网站自动售货机，投币（推代码）就出货（网站）
Claude CodeAI 编程助手，用命令行跟你协作写代码一个坐在你旁边的程序员队友

它们之间的关系是这样的：

1
2
3
4
5
6
7
8
9
你用自然语言描述需求
       ↓
Claude Code 帮你写代码、改文件
       ↓
git push 推送到 GitHub
       ↓
Vercel 检测到更新，自动构建部署
       ↓
你的网站上线了

整个过程你只需要做两件事：描述需求 和 确认结果。中间的脏活累活全是 Claude Code 和自动化流程帮你干。

环境搭建

第一步：注册 GitHub 并创建仓库

去 github.com 注册一个账号（免费），然后创建一个新仓库。

比如我们要做一个博客项目，就叫 my-blog：

1
2
3
4
# 在 GitHub 网页上点 "New Repository"
# 仓库名：my-blog
# 勾选 "Add a README file"
# 点 "Create repository"

⚠️ 仓库名建议用英文小写 + 短横线，比如 my-blog、portfolio-site，不要用中文或空格。

第二步：安装 Git 并配置身份

Windows 用户：去 git-scm.com 下载安装，一路默认即可。

macOS 用户：打开终端输入：

1
xcode-select --install

安装完成后，配置你的身份信息：

1
2
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

这里的邮箱建议和 GitHub 注册邮箱保持一致，后面推送代码时会用到。

验证安装是否成功：

1
2
git --version
# 输出类似：git version 2.43.0

第三步：把 GitHub 仓库克隆到本地

1
2
3
# 克隆仓库到你电脑上
git clone https://github.com/你的用户名/my-blog.git
cd my-blog

现在你的电脑上就有了一个和 GitHub 同步的文件夹，后面所有的代码改动都会在这里进行。

第四步：安装 Node.js

Claude Code 和 Vercel 都依赖 Node.js 环境。去 nodejs.org 下载 LTS 版本安装。

1
2
3
4
5
node --version
# 输出类似：v20.11.0

npm --version
# 输出类似：10.2.0

第五步：安装 Claude Code

Claude Code 是 Anthropic 推出的命令行 AI 编程工具，通过 npm 安装：

1
npm install -g @anthropic-ai/claude-code

安装完成后，首次运行需要登录认证：

1
2
3
claude
# 首次启动会引导你登录 Anthropic 账号
# 按提示在浏览器中完成授权即可

⚠️ Claude Code 需要 Anthropic API 账号或订阅（Claude Pro/Max）。如果还没有，先去 console.anthropic.com 注册。

国内用户：使用 cc-switch 接入国产大模型

由于网络环境限制，国内用户直接访问 Anthropic API 可能会遇到连接超时或认证失败的问题。社区开发了一个实用工具 cc-switch，可以帮你快速切换 Claude Code 的配置，接入国内的大模型服务（如通义千问、DeepSeek、Moonshot 等），无需科学上网即可使用。

安装 cc-switch：

1
npm install -g cc-switch

基本用法：

1
2
3
4
5
6
7
8
# 查看当前配置
cc-switch list

# 切换到国内模型（以 DeepSeek 为例）
cc-switch use deepseek

# 手动配置自定义 API 端点
cc-switch config --api-url https://api.deepseek.com/v1 --api-key sk-你的密钥

cc-switch 本质上是一个配置管理工具，它帮你修改 Claude Code 的环境变量（ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY 等），让请求指向你指定的 API 地址。这样即使无法直连 Anthropic，也能用国产大模型获得类似的 Agent 体验。

模型API 地址特点
DeepSeekhttps://api.deepseek.com/v1性价比高，代码能力强
通义千问https://dashscope.aliyuncs.com/compatible-mode/v1阿里出品，中文理解好
Moonshot (Kimi)https://api.moonshot.cn/v1长上下文支持好

⚠️ 使用国产大模型时，Claude Code 的部分高级特性（如某些工具调用格式）可能不完全兼容。建议先用 DeepSeek 或通义千问测试基础功能，确认稳定后再用于正式项目。

第六步：连接 Vercel

去 vercel.com 注册账号，建议直接用 GitHub 账号登录，省去绑定步骤。

然后在项目根目录安装 Vercel CLI：

1
npm install -g vercel

登录 Vercel：

1
2
vercel login
# 选择通过 GitHub 登录，浏览器会弹出授权页面

第一次协作实战

环境搭好了，现在来走一遍完整流程。我们用 Claude Code 创建一个简单的网页项目，然后推送到 GitHub，让 Vercel 自动部署。

1. 让 Claude Code 帮你写代码

在项目目录下启动 Claude Code：

1
2
cd my-blog
claude

进入对话界面后，直接用自然语言描述你的需求：

1
2
你：帮我创建一个简单的个人主页，包含一个标题、一段自我介绍、
    和一个项目展示区域。用 HTML + CSS，风格简洁现代。

Claude Code 会帮你生成文件、写入代码。你可以继续对话调整：

1
你：标题改成深蓝色，卡片加个圆角和阴影效果。
1
你：再加一个底部 footer，显示 "© 2026 My Blog"。

这就是 Claude Code 的核心用法——你描述需求，它写代码。不需要你手动编辑任何文件。

2. 推送到 GitHub

代码写好后，让 Claude Code 帮你提交：

1
你：把所有改动提交到 Git，提交信息写 "feat: 初始化个人主页"。

Claude Code 会执行：

1
2
git add .
git commit -m "feat: 初始化个人主页"

然后推送到 GitHub：

1
你：推送到 GitHub。
1
git push origin main

3. Vercel 自动部署

去 Vercel 控制台，点 **”Add New” → “Project”**，导入你刚才创建的 my-blog 仓库。

Vercel 会自动识别项目类型，大部分情况下默认配置就能用。对于纯 HTML 项目，几乎不需要额外配置，直接点 Deploy。

几秒后，Vercel 会给你一个在线访问地址：

1
2
✅ Congratulations! Your project has been deployed.
https://my-blog.vercel.app

从此以后，每次你让 Claude Code 改完代码并 git push，Vercel 就会自动重新部署。你甚至不需要打开 Vercel 的网页。

项目指令文件：让 Claude Code 更懂你的项目

Claude Code 有一个很强大的特性——项目指令文件。在项目根目录创建一个 CLAUDE.md，写入项目的背景信息和规范，Claude Code 每次启动时都会读取它。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# CLAUDE.md

## 项目信息
这是一个基于 Hexo 的个人博客项目，部署在 Vercel 上。

## 代码规范
- 文章使用 Markdown 格式，存放在 source/_posts/ 目录
- 每篇文章必须包含 YAML frontmatter（title、date、categories、tags）
- 代码块必须标注语言类型

## 工作流
- 修改完成后用 git push 推送到 main 分支
- Vercel 会自动构建部署
- 提交信息格式：type: description（如 feat: 新文章、fix: 修复排版）

有了这个文件，Claude Code 就知道你的项目是什么、该怎么写代码、该怎么提交。相当于给 AI 队友写了一份”入职手册”。

工具对比：Claude Code vs 其他 AI 编程工具

市面上有不少 AI 编程工具，简单对比一下各自的定位：

工具形态擅长场景价格
Claude Code命令行 Agent全栈开发、项目管理、自动化操作Claude Pro $20/月 或 API 按量
Cursor代码编辑器日常写代码、补全、重构Pro $20/月
GitHub CopilotIDE 插件代码补全、行级建议$10/月
QoderWork桌面助手文件处理、多工具协作、日常办公积分制

Claude Code 最大的优势在于它是一个 Agent——不只是补全代码，而是能理解整个项目上下文、执行命令、操作 Git、管理文件。你可以把它理解为一个”能动手干活的 AI 程序员”，而不只是一个”打字快的代码助手”。

当然，这些工具并不冲突。很多人会同时用 Cursor 写日常代码、用 Claude Code 做复杂任务和项目管理。

常见问题与踩坑记录

❌ Claude Code 安装报错 EACCES permission denied

Windows 用户需要用管理员权限运行终端，macOS/Linux 用户不要加 sudo，改用修复 npm 全局目录权限的方式：

1
2
3
4
5
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @anthropic-ai/claude-code

❌ cc-switch 切换后 Claude Code 无响应或报错

通常是 API Key 无效或端点地址不对。用 cc-switch list 检查当前配置，确认 API Key 没有过期、端点地址拼写正确。部分国产模型的 API 路径需要带 /v1 后缀。

❌ git push 要求输入密码，但输入 GitHub 密码不对

GitHub 已经不支持密码认证了，需要用 Personal Access Token：

1
2
3
# 去 GitHub → Settings → Developer settings → Personal access tokens → Generate new token
# 勾选 repo 权限，生成后复制 token
# push 时密码栏粘贴这个 token

❌ Vercel 部署后页面空白

通常是构建命令或输出目录配置不对。检查 vercel.json 中的 buildCommand 和 outputDirectory 是否和你的项目匹配。

❌ Claude Code 不认识我的项目结构

第一次使用时，建议先让它”读一下项目”：

1
你：帮我分析一下这个项目的目录结构和主要技术栈。

或者确保项目根目录有 CLAUDE.md 指令文件，Claude Code 会自动读取。

❌ Vercel 没有自动触发部署

检查 Vercel 项目 Settings → Git，确认仓库已正确连接，Production Branch 设为 main。

这套工作流的核心思路

回顾一下，整套环境的核心逻辑其实就三句话：

GitHub 存代码，Vercel 跑网站，Claude Code 帮你干活。

你不需要记住复杂的命令，不需要手动构建部署，甚至不需要精通编程。你只需要清楚地描述”我想要什么”，剩下的交给 AI 和自动化。

这也是 2026 年开发方式的一个趋势——**从”人写代码”到”人描述需求，AI 写代码，自动化流程上线”**。

下一篇我们会深入讲解如何用 Claude Code 实现项目的自动化管理，包括批量操作、定时任务、多项目协作等进阶玩法。

]]> 从零搭建 Claude Code + GitHub + Vercel AI 协作开发环境，适合零基础入门。 Hexo 博客迁移全记录：从 GitHub Pages 到 Vercel https://www.cloudetopia.top/2026/06/30/2026-06-30-Hexo-to-Vercel/ 2026-06-30T02:00:00.000Z 2026-07-08T08:02:15.040Z 前言

我的个人博客（cloudetopia.top）原本部署在 GitHub Pages 上，一直存在几个痛点：部署流程繁琐、国内访问慢、图片缓存难控制等。最近趁着本地源文件丢失的机会，干脆做了一次彻底的技术栈升级——从 GitHub Pages 迁移到 Vercel。

这篇文章完整记录了迁移过程、踩坑和解决方案，供有同样需求的朋友参考。

旧架构的问题

迁移前的架构：

1
本地写 Markdown → hexo generate → hexo deploy → GitHub Pages

这个流程有几个明显的问题：

  • 部署依赖本地环境：换台电脑就得重新装 Node.js、Hexo CLI
  • 国内访问慢：GitHub Pages 服务器在海外
  • 主题文件丢失：本地源文件丢了，LiveForCode 主题只剩残片
  • 无 CI/CD：每次更新都要手动构建、推送

新架构：Vercel 方案

迁移后的架构：

1
本地写 Markdown → git push → Vercel 自动构建 → 全球 CDN 分发

一步到位，自动部署。

对比优势

维度GitHub PagesVercel
部署方式本地手动git push 自动
国内访问慢Edge Network
CI/CD无内置
Serverless不支持支持
成本免费免费

迁移过程

花了几个小时完成了整个迁移，核心步骤如下：

1. 配置 Vercel 部署

在项目根目录创建 vercel.json：

1
2
3
4
5
6
{
  "buildCommand": "npx hexo generate",
  "outputDirectory": "public",
  "installCommand": "npm install",
  "framework": null
}

然后去 Vercel 导入 GitHub 仓库，绑定域名就好了。

2. 替换主题

原 LiveForCode 主题的模板文件已丢失，选了 Hexo Fluid 主题替代。安装很简单：

1
npm install --save hexo-theme-fluid hexo-renderer-ejs hexo-renderer-stylus

⚠️ 一定要装 hexo-renderer-ejs 和 hexo-renderer-stylus，否则 Fluid 主题会生成空白页面。

然后在 _config.yml 里设置 theme: fluid，再写一份 _config.fluid.yml 自定义配置。

3. 迁移图片

旧博客的头图存在 hexo-blog 仓库里，选了几张迁移过来：

1
2
mkdir -p source/images/hero
# 下载 01~09.jpg

在主题配置里指向新路径即可。

踩坑记录

❌ 部署后空白页面

Vercel 返回 HTTP 200 但 HTML 是空的——缺少 EJS 渲染器。

解决：安装 hexo-renderer-ejs 和 hexo-renderer-stylus。

❌ hexo: command not found (exit 127)

Vercel 默认把框架识别为 “Hexo”，内置构建命令不兼容。

解决：在 Vercel 项目 Settings → Build & Development Settings 里把 Framework Preset 改成 Other。

❌ 提交邮箱不匹配被阻止

Vercel 校验提交邮箱，noreply 邮箱被阻止。

解决：改成 GitHub 绑定的真实邮箱，关掉 Require Verified Commits。

❌ 自动部署没触发

Git 集成没正确配置。

解决：Vercel 项目 Settings → Git 确认仓库已连接，Production Branch 设为 main。

最终工作流

现在发布一篇文章只需要：

1
2
3
4
git add .
git commit -m "新文章"
git push origin main
# ✅ Vercel 自动构建部署

整个过程完全自动化，再也不需要本地 hexo generate 和 hexo deploy 了。

关于 Fluid 主题

Fluid 是一个非常成熟的中文 Hexo 主题，支持：

  • 全屏 Banner 头图
  • Material Design 卡片布局
  • 代码高亮 + 复制按钮
  • 中文搜索
  • 文章目录导航
  • 自动摘要

配置也很灵活，通过 _config.fluid.yml 可以定制导航、首页样式、文章元信息等。

后续计划

  • 上传自定义头像
  • 用 Vercel KV 实现阅读计数器
  • 换一个更流畅的评论系统
  • 集成站点统计

以上就是这次迁移的完整记录。源码在 MIutopia/hexo-blog-source，欢迎参考。

]]> Hexo 博客从 GitHub Pages 迁移到 Vercel 的完整记录，含踩坑与解决方案。 Keepalived 部署实战 https://www.cloudetopia.top/2024/06/18/2024-06-18-%E9%83%A8%E7%BD%B2KeepAlived/ 2024-06-18T02:00:00.000Z 2026-07-08T08:02:15.040Z 前言

Keepalived 是一个用于 Linux 服务器的轻量级高可用解决方案。这篇文章记录了在 CentOS 上从源码编译安装 Keepalived 的完整过程，为后续搭建 Nginx + Keepalived 高可用集群做准备。

安装依赖

1
2
# 安装 libnl-3 开发库
sudo yum install libnl3-devel libnl3-cli-devel

注：本次部署专注于构建基于 Nginx 和 Keepalived 的高可用集群，已安装的 Nginx 相关工具将不再重复安装。

下载并解压 Keepalived

1
2
3
4
5
# 进入目录
cd /opt/nginx

# 解压 Keepalived
tar -xvzf keepalived-2.3.1.tar.gz

官网下载地址：Keepalived for Linux

编译安装

1
2
3
4
5
6
7
8
9
10
11
# 创建安装目录
mkdir /opt/nginx/keepalived

# 进入源码目录
cd /opt/nginx/keepalived-2.3.1

# 配置
./configure --prefix=/opt/nginx/keepalived

# 编译安装
make && make install

验证安装

编译安装完成后，如果显示以下内容，则表示安装成功：

1
2
3
4
5
6
7
Use IPVS Framework       : Yes
IPVS use libnl           : Yes
Use VRRP Framework       : Yes
Use VRRP VMAC            : Yes
Use VRRP authentication  : Yes
With track_process       : Yes
With linkbeat            : Yes

WARNING：如果出现警告，可能缺少 Keepalived 所需的第三方库/工具。

常见问题

❌ 编译报错：缺少依赖

原因：缺少 libnl 或 openssl 开发库。

解决：

1
yum install -y libnl3-devel openssl-devel

❌ 启动失败

原因：配置文件错误或权限不足。

解决：

1
2
3
4
5
# 检查配置文件
cat /opt/nginx/keepalived/etc/keepalived/keepalived.conf

# 使用 root 用户启动
/opt/nginx/keepalived/sbin/keepalived

以上就是 Keepalived 安装的全部内容。后续文章将介绍如何搭建 Nginx + Keepalived 高可用集群。

]]> Keepalived 高可用解决方案部署实战，为 Nginx 集群搭建提供基础环境。 部署 Nginx + Keepalived 高可用集群 https://www.cloudetopia.top/2024/06/18/2024-06-18-%E9%83%A8%E7%BD%B2Nginx-KeepAlived%E9%AB%98%E5%8F%AF%E7%94%A8%E9%9B%86%E7%BE%A4/ 2024-06-18T02:00:00.000Z 2026-07-08T08:02:15.040Z 前言

使用 Nginx 与 Keepalived 构建高可用集群，是提升系统稳定性和可靠性的常见方案。这篇文章从概念讲起，逐步搭建完整的高可用环境。

核心概念

Nginx

Nginx 是一款高性能的 HTTP 和反向代理服务器，主要应用于负载均衡和静态内容服务，同时也提供了 IMAP/SMTP/POP3 服务。

Keepalived

Keepalived 是一个用于监听和故障转移的工具，基于 VRRP 协议（虚拟路由冗余协议）实现。它可以监控服务器状态，并在主服务器故障时自动切换到备份服务器。

Keepalived 提供了几种冗余方式：

  • 主备模式（Master-Backup）
  • 负载均衡模式（Load Balancing）
  • 主备负载均衡模式

双机高可用方案

  • Keepalived + Nginx 双机主从模式
  • Keepalived + Nginx 双机主主模式

Nginx 核心功能

正向代理

帮助内网客户端访问外网服务器的代理方式。客户端无法直接访问目标服务器，但可以通过代理服务器进行访问。

主要目的：解决访问限制问题，如绕过地区限制或组织内部的访问限制。

反向代理

把外网客户端的请求转发给内网服务器的代理方式。客户端并不知道实际提供服务的服务器地址，只与代理服务器进行交互。

作用：

  • 作为负载均衡器，将客户端请求分发到多个后端服务器
  • 安全防护，过滤恶意请求和响应

负载均衡

将工作负载均匀地分配到多个服务器上，防止任何单一节点过载。

度量标准：CPU 使用率、内存使用率、磁盘 I/O、网络带宽、并发用户数量等。

分类：

  • 客户端负载均衡：发生在客户端，由自己决定访问哪台服务器
  • 服务端负载均衡：通过专门的负载均衡器（如 Nginx、HAProxy）分发请求

环境搭建

1. 安装依赖

1
yum -y install gcc gcc-c++ automake pcre pcre-devel zlib zlib-devel openssl openssl-devel

2. 下载并解压 Nginx

1
2
3
4
5
6
7
# 创建目录
mkdir /opt/nginx
cd /opt/nginx

# 下载并解压
wget http://nginx.org/download/nginx-1.26.1.tar.gz
tar -xzvf nginx-1.26.1.tar.gz

3. 编译安装

1
2
3
4
5
6
7
8
9
10
11
# 创建安装目录
mkdir nginx-1.26.1_install

# 进入源码目录
cd nginx-1.26.1

# 配置
./configure --prefix=/opt/nginx/nginx-1.26.1_install

# 编译安装
make && make install

4. 启动 Nginx

1
2
3
4
5
6
7
8
# 检查配置
/opt/nginx/nginx-1.26.1_install/sbin/nginx -t

# 启动
/opt/nginx/nginx-1.26.1_install/sbin/nginx

# 验证
curl http://192.168.10.100:80

Keepalived 配置

主节点配置

1
vi /opt/nginx/keepalived/etc/keepalived/keepalived.conf
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
! Configuration File for keepalived

global_defs {
   notification_email {
     acassen@firewall.loc
   }
   router_id LVS_DEVEL
}

vrrp_script chk_nginx {
    script "/opt/nginx/keepalived/check_nginx.sh"
    interval 2
    weight 2
}

vrrp_instance VI_1 {
    state MASTER
    interface eth0
    virtual_router_id 51
    priority 100
    advert_int 1
    authentication {
        auth_type PASS
        auth_pass 1111
    }
    virtual_ipaddress {
        192.168.10.100
    }
    track_script {
        chk_nginx
    }
}

检查脚本

1
vi /opt/nginx/keepalived/check_nginx.sh
1
2
3
4
5
6
7
#!/bin/bash
if ! pgrep -x nginx > /dev/null; then
    systemctl start nginx
    if ! pgrep -x nginx > /dev/null; then
        systemctl stop keepalived
    fi
fi
1
chmod +x /opt/nginx/keepalived/check_nginx.sh

备节点配置

与主节点类似，修改以下参数：

1
2
state BACKUP
priority 90

启动服务

1
2
3
4
5
6
7
8
# 主节点
/opt/nginx/keepalived/sbin/keepalived

# 备节点
/opt/nginx/keepalived/sbin/keepalived

# 验证 VIP
ip addr show eth0

常见问题

❌ VIP 无法访问

原因：Keepalived 未正确启动或配置错误。

解决：

1
2
3
4
5
# 检查 Keepalived 状态
ps -ef | grep keepalived

# 检查日志
tail -f /var/log/messages

❌ Nginx 故障未切换

原因：检查脚本未正确执行。

解决：

1
2
3
4
5
# 手动测试脚本
/opt/nginx/keepalived/check_nginx.sh

# 检查脚本权限
chmod +x /opt/nginx/keepalived/check_nginx.sh

以上就是 Nginx + Keepalived 高可用集群的完整搭建过程。

]]> 使用 Nginx 与 Keepalived 构建高可用集群，提升系统稳定性和可靠性的完整方案。 Tomcat 部署实战 https://www.cloudetopia.top/2024/06/15/2024-06-15-%E9%83%A8%E7%BD%B2Tomcat/ 2024-06-15T02:00:00.000Z 2026-07-08T08:02:15.040Z 前言

Tomcat 是 Apache 软件基金会的一个开源项目，实现了 Java Servlet 和 JavaServer Pages 规范。这篇文章记录了在 CentOS 上部署 Tomcat 的完整过程。

部署准备

安装 Java

Tomcat 是基于 Java 的应用服务器，需要先安装 Java 环境。

1
2
3
4
5
6
7
8
# 检查 Java 是否已安装
java -version

# 如果没有安装，使用 yum 安装
yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel

# 验证安装
java -version

下载 Tomcat

1
2
3
4
5
6
7
8
# 下载 Tomcat 9
wget https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.65/bin/apache-tomcat-9.0.65.tar.gz

# 解压
tar -zxvf apache-tomcat-9.0.65.tar.gz

# 移动到指定目录
mv apache-tomcat-9.0.65 /usr/local/tomcat

启动 Tomcat

1
2
3
4
5
# 启动 Tomcat
/usr/local/tomcat/bin/startup.sh

# 查看日志
tail -f /usr/local/tomcat/logs/catalina.out

配置防火墙

1
2
3
# 开放 8080 端口
firewall-cmd --add-port=8080/tcp --permanent
firewall-cmd --reload

访问 http://服务器IP:8080 即可看到 Tomcat 默认页面。

常用命令

1
2
3
4
5
6
7
8
# 停止 Tomcat
/usr/local/tomcat/bin/shutdown.sh

# 查看 Tomcat 进程
ps -ef | grep tomcat

# 查看日志
tail -f /usr/local/tomcat/logs/catalina.out

常见问题

❌ 启动失败：JAVA_HOME 未设置

原因：环境变量未正确配置。

解决：

1
2
3
4
5
6
# 设置 JAVA_HOME
export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk

# 或添加到 /etc/profile
echo 'export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk' >> /etc/profile
source /etc/profile

❌ 端口被占用

原因：8080 端口已被其他服务占用。

解决：

1
2
3
# 修改 Tomcat 端口
vi /usr/local/tomcat/conf/server.xml
# 找到 <Connector port="8080" ...> 修改端口

以上就是 Tomcat 部署的全部内容。

]]> Tomcat 部署实战教程，记录 CentOS 上 Java 环境安装与 Tomcat 服务配置全过程。 Nginx 虚拟主机配置实战 https://www.cloudetopia.top/2024/06/14/2024-06-14-Nginx%E8%99%9A%E6%8B%9F%E4%B8%BB%E6%9C%BA%E7%9A%84%E9%85%8D%E7%BD%AE/ 2024-06-14T02:00:00.000Z 2026-07-08T08:02:15.040Z 前言

Nginx 的虚拟主机功能允许单个 Nginx 服务器为多个域名或 IP 地址提供服务，无需为每个域名运行单独的 Nginx 实例。这篇文章介绍如何配置基于域名和基于 IP 的虚拟主机。

创建项目路径

1
2
3
4
5
6
7
# 创建项目目录
mkdir -p /var/www/site1
mkdir -p /var/www/site2

# 创建测试页面
echo "<h1>Welcome to Site1</h1>" > /var/www/site1/index.html
echo "<h1>Welcome to Site2</h1>" > /var/www/site2/index.html

配置虚拟主机

基于域名的虚拟主机

编辑 Nginx 配置文件 /etc/nginx/nginx.conf 或创建单独的配置文件：

1
2
3
4
5
6
7
8
9
10
11
12
13
server {
    listen 80;
    server_name site1.example.com;
    root /var/www/site1;
    index index.html;
}

server {
    listen 80;
    server_name site2.example.com;
    root /var/www/site2;
    index index.html;
}

基于端口的虚拟主机

1
2
3
4
5
6
7
8
9
10
11
12
13
server {
    listen 8080;
    server_name localhost;
    root /var/www/site1;
    index index.html;
}

server {
    listen 8081;
    server_name localhost;
    root /var/www/site2;
    index index.html;
}

重启 Nginx

1
2
3
4
5
# 测试配置
nginx -t

# 重启 Nginx
systemctl restart nginx

本地测试

在本地 /etc/hosts 文件中添加域名映射：

1
2
127.0.0.1 site1.example.com
127.0.0.1 site2.example.com

然后访问 http://site1.example.com 和 http://site2.example.com 即可看到不同的页面。

常见问题

❌ 403 Forbidden

原因：Nginx 没有权限访问目录。

解决：

1
2
chmod -R 755 /var/www/site1
chown -R nginx:nginx /var/www/site1

❌ 502 Bad Gateway

原因：后端服务未启动或配置错误。

解决：检查 proxy_pass 或 fastcgi_pass 配置是否正确。

以上就是 Nginx 虚拟主机配置的全部内容。

]]> Nginx 虚拟主机配置实战，详解基于域名和基于 IP 的虚拟主机搭建方法。 Nginx 部署实战 https://www.cloudetopia.top/2024/06/14/2024-06-14-Nginx%E9%83%A8%E7%BD%B2/ 2024-06-14T02:00:00.000Z 2026-07-08T08:02:15.040Z 前言

Nginx 是一款高性能的 HTTP 和反向代理服务器，广泛应用于 Web 服务、负载均衡和反向代理。这篇文章记录了在 CentOS 上从源码编译安装 Nginx 的完整过程。

安装依赖

1
yum -y install gcc gcc-c++ automake pcre pcre-devel zlib zlib-devel openssl openssl-devel

下载并解压 Nginx

1
2
3
4
5
6
7
8
9
# 创建目录
mkdir /opt/nginx
cd /opt/nginx

# 下载 Nginx
wget http://nginx.org/download/nginx-1.26.1.tar.gz

# 解压
tar -xvf nginx-1.26.1.tar.gz

官网下载地址：http://nginx.org/en/download.html

编译安装

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 创建安装目录
cd /opt/nginx
mkdir nginx-1.26.1_install

# 进入源码目录
cd nginx-1.26.1

# 配置（指定安装目录）
./configure --prefix=/opt/nginx/nginx-1.26.1_install

# 编译
make

# 安装
make install

安装后的目录结构

目录说明
conf/Nginx 配置文件（nginx.conf）
html/默认网页文件
logs/日志文件
sbin/Nginx 主程序

启动 Nginx

1
2
3
4
5
6
7
8
9
10
11
# 检查配置语法
/opt/nginx/nginx-1.26.1_install/sbin/nginx -t

# 启动 Nginx
/opt/nginx/nginx-1.26.1_install/sbin/nginx

# 查看版本
./sbin/nginx -v

# 查看进程
ps -ef | grep nginx

常用命令

1
2
3
4
5
6
7
8
# 停止 Nginx
/opt/nginx/nginx-1.26.1_install/sbin/nginx -s stop

# 重启 Nginx
/opt/nginx/nginx-1.26.1_install/sbin/nginx -s reopen

# 重新加载配置
/opt/nginx/nginx-1.26.1_install/sbin/nginx -s reload

验证

1
2
3
# 关闭防火墙（测试用）
systemctl stop firewalld
systemctl disable firewalld

访问 http://192.168.10.100:80 即可看到 Nginx 默认欢迎页面。

常见问题

❌ 端口被占用

原因：80 端口已被其他服务占用。

解决：

1
2
3
4
5
6
# 查看占用端口的进程
netstat -tlnp | grep 80

# 或修改 Nginx 监听端口
vi /opt/nginx/nginx-1.26.1_install/conf/nginx.conf
# 修改 listen 80; 为其他端口

❌ 权限不足

原因：非 root 用户启动 Nginx。

解决：使用 sudo 或切换到 root 用户。

以上就是 Nginx 编译安装的全部内容。

]]> Nginx 部署实战，从源码编译安装到基础配置，记录 CentOS 上完整部署流程。 架构基础理论 https://www.cloudetopia.top/2024/06/14/2024-06-14-%E6%9E%B6%E6%9E%84%E5%9F%BA%E7%A1%80%E7%90%86%E8%AE%BA/ 2024-06-14T02:00:00.000Z 2026-07-08T08:02:15.040Z 前言

在软件开发和系统设计中，”架构”是一个核心概念。这篇文章简要介绍前端、后端、接口等基础概念。

架构概述

前端

前端是用户看得见的页面（小程序、Web 网页、App），负责将后端处理好的数据进行处理和展示。

  • 静态页面：页面内容被写死，不会动态变化
  • 开发语言：Java、HTML、CSS、JavaScript 等

前端代码可以存放于任何有网且能够连接到后端数据库的地方，运行于客户端（如浏览器、App）。

后端

后端负责处理业务逻辑、数据存储和计算。它接收前端的请求，进行处理后返回结果。

  • 开发语言：Java、Python、Go、Node.js 等
  • 数据库：MySQL、PostgreSQL、MongoDB 等

接口

接口是前后端通信的桥梁，定义数据交换的格式和规范。

常见的接口规范：

规范说明
RESTful基于 HTTP 方法的接口风格
GraphQL灵活的数据查询语言
gRPC高性能远程过程调用框架

典型架构

1
2
3
4
5
6
7
8
9
┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   前端      │────→│   接口      │────→│   后端      │
│  (浏览器)   │←────│  (API)      │←────│  (服务器)   │
└─────────────┘     └─────────────┘     └─────────────┘
                                              │
                                              ↓
                                        ┌─────────────┐
                                        │   数据库    │
                                        └─────────────┘

高可用架构

为了保证服务的可用性，通常会采用集群部署：

  • Nginx + Keepalived：实现 Web 服务的高可用
  • 数据库主从复制：实现数据的高可用
  • Redis 集群：实现缓存的高可用

以上就是架构基础理论的全部内容。后续文章会继续深入讲解各个组件。

]]> 软件架构基础概念入门，介绍前端、后端、接口等核心概念及其关系。 Ceph 分布式存储详解 https://www.cloudetopia.top/2024/03/11/2024-03-11-ceph/ 2024-03-11T02:00:00.000Z 2026-07-08T08:02:15.040Z 前言

Ceph 是一个统一的分布式存储系统，可以提供对象存储、块存储和文件系统存储。这篇文章从版本介绍开始，逐步讲解 Ceph 的安装和部署过程。

Ceph 版本历史

第一个 Ceph 版本是 0.1，要回溯到 2008 年 1 月。多年来，版本号方案一直没变，直到 2015 年 4 月 0.94.1（Hammer 的第一个修正版）发布后，为了避免 0.99（以及 0.100 或 1.00？），制定了新策略：

  • x.0.z - 开发版（给早期测试者）
  • x.1.z - 候选版（用于测试集群）
  • x.2.z - 稳定版（给用户）
版本名称版本号发布时间
Argonaut0.48 (LTS)2012-06-03
Bobtail0.56 (LTS)2013-05-07
Cuttlefish0.612013-01-01
Dumpling0.67 (LTS)2013-08-14
Emperor0.722013-11-09
Firefly0.80 (LTS)2014-05
Giant0.872014-10
Hammer0.94 (LTS)2015-04
Infernalis9.2.02015-11
Jewel10.2.92016-04
Kraken11.2.12017-10
Luminous12.2.122017-10
Mimic13.2.72018-05
Nautilus14.2.52019-02
Octopus15.2.172020-03-23
Pacific16.2.152021-03-31
Quincy17.2.72022-04-19
Reef18.2.12023-08-07

根据 官网 给出的消息，从 O 版（Octopus）开始（包括 O 版）之前的版本都不会再进行维护更新。

安装方式介绍

工具说明
ceph-ansible使用 Ansible 部署和管理 Ceph 集群
ceph-deploy快速部署集群的工具
Cephadm安装和管理 Ceph 集群（推荐）

Cephadm 特点：

  • 只支持 Octopus 及更新版本
  • 与编排 API 完全集成
  • 需要容器支持（Podman 或 Docker）和 Python 3
  • 需要 systemd

环境准备

主机规划

主机名IP 地址配置
center192.168.10.1002核2G +20G
ceph-node1192.168.10.112核2G +20G+30G×3
ceph-node2192.168.10.122核2G +20G+30G×3
ceph-node3192.168.10.132核2G +20G+30G×3

关闭防火墙和 SELinux

1
2
3
# 所有节点执行
systemctl stop firewalld && systemctl disable firewalld && setenforce 0
sed -i 's/enforcing/disabled/' /etc/selinux/config

配置主机名和 hosts

1
2
3
4
5
6
7
8
9
10
11
12
13
# 各节点分别执行
hostnamectl set-hostname center
hostnamectl set-hostname ceph-1
hostnamectl set-hostname ceph-2
hostnamectl set-hostname ceph-3

# 所有节点添加 hosts 映射
cat >>/etc/hosts <<EOF
192.168.10.100 center
192.168.10.11 ceph-1
192.168.10.12 ceph-2
192.168.10.13 ceph-3
EOF

配置时间同步

1
2
3
4
5
6
7
8
9
10
11
12
13
# 安装 NTP
yum -y install ntp

# 编辑配置文件（ceph-1/2/3 节点）
vi /etc/ntp.conf
server center iburst     # 添加的内容（将原来的注释掉）

# 启动服务
systemctl restart ntpd
systemctl enable ntpd

# 验证时间同步
ntpdate -q <主机IP>

配置免密登录

1
2
3
4
5
# 在 center 节点执行
ssh-keygen -t rsa
ssh-copy-id ceph-1
ssh-copy-id ceph-2
ssh-copy-id ceph-3

常见问题

❌ OSD 启动失败

原因：磁盘未正确格式化或权限问题。

解决：

1
2
3
4
# 检查磁盘状态
ceph disk list
# 格式化磁盘
ceph-volume lvm create --data /dev/sdb

❌ 集群健康状态异常

原因：OSD 数量不足或网络问题。

解决：

1
2
3
# 查看集群状态
ceph -s
ceph health detail

以上就是 Ceph 分布式存储的基础介绍。后续文章会继续深入讲解 Ceph 的高级配置。

]]> Ceph 分布式存储系统详解，从版本演进到安装部署，覆盖对象、块和文件存储。 OpenStack Train 搭建实战（2024版） https://www.cloudetopia.top/2023/12/12/2023-12-13-OpenStack%E6%90%AD%E5%BB%BA/ 2023-12-12T16:00:00.000Z 2026-07-08T08:02:15.040Z OpenStack Train 搭建实战（2024版）

前言

OpenStack 是一个开源的云计算管理平台项目，由 NASA 和 Rackspace 于 2010 年联合发起。它可以帮助企业搭建私有云或公有云环境，管理计算、存储、网络等基础资源。本文基于 CentOS 7 + Train 版本，手把手带你搭建一个双节点的 OpenStack 环境。

⚠️ OpenStack 配置文件中不能有中文（包括注释），否则会导致服务启动失败。

环境规划

节点IP 地址（内/外）规格
controller192.168.10.10 / 192.168.11.104核4G，硬盘100G
compute192.168.10.20 / 192.168.11.204核4G，硬盘100G+100G

双网卡配置：NAT（内网通信）+ 仅主机（外部访问）。两台主机默认密码 000000。

基础环境配置

修改主机名

1
2
3
4
5
# controller 节点
hostnamectl set-hostname controller && bash

# compute 节点
hostnamectl set-hostname compute && bash

主机映射（双节点）

1
2
3
4
cat >>/etc/hosts <<EOF
192.168.10.10 controller
192.168.10.20 compute
EOF

关闭防火墙与 SELinux（双节点）

1
2
3
systemctl stop firewalld && setenforce 0
systemctl disable firewalld
sed -i 's/enforcing/disabled/' /etc/selinux/config

配置免密登录（双节点）

1
2
3
ssh-keygen -t rsa          # 连按三次回车
ssh-copy-id controller     # 第一次输入 yes，第二次输入密码
ssh-copy-id compute        # 同上

配置阿里云镜像仓库（双节点）

1
2
3
4
5
rm -rf /etc/yum.repos.d/*
curl -o /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-7.repo
yum makecache
yum -y upgrade
yum -y install epel-release

时间同步（Chrony）

推荐安装 Chrony，比 NTP 更适合虚拟化环境。

1
yum -y install chrony

controller 节点 — 修改 /etc/chrony.conf：

1
2
3
server ntp3.aliyun.com iburst
allow all
local stratum 10

compute 节点 — 修改 /etc/chrony.conf：

1
2
3
server controller iburst
allow all
local stratum 10

双节点启动服务：

1
2
3
systemctl restart chronyd
systemctl enable chronyd
chronyc sources    # 左侧显示 * 号表示同步成功

安装基础组件

部署 OpenStack Train 仓库（双节点）

1
yum -y install centos-release-openstack-train

❌ CentOS 7 已停止维护，部署后需要手动换源为阿里云镜像。

修改以下四个 repo 文件，将 baseurl 改为 mirrors.aliyun.com，注释掉 mirrorlist：

文件说明
/etc/yum.repos.d/CentOS-OpenStack-train.repoOpenStack 主仓库
/etc/yum.repos.d/CentOS-Ceph-Nautilus.repoCeph 存储仓库
/etc/yum.repos.d/CentOS-QEMU-EV.repoQEMU 虚拟化仓库
/etc/yum.repos.d/CentOS-NFS-Ganesha-28.repoNFS Ganesha 仓库
1
yum clean all && yum repolist

安装 OpenStack 客户端（双节点）

1
2
yum -y install python-openstackclient
yum -y install openstack-selinux

安装 MariaDB 数据库（controller）

1
yum -y install mariadb mariadb-server python2-PyMySQL

编辑 /etc/my.cnf.d/openstack.cnf：

1
2
3
4
5
6
7
[mysqld]
bind-address = 192.168.10.10
default-storage-engine = innodb
innodb_file_per_table = on
max_connections = 4096
collation-server = utf8_general_ci
character-set-server = utf8
1
2
3
systemctl start mariadb.service
systemctl enable mariadb.service
mysql_secure_installation    # 设置 root 密码为 000000

安装 RabbitMQ 消息队列（controller）

1
2
3
4
5
6
7
yum -y install rabbitmq-server
systemctl start rabbitmq-server.service
systemctl enable rabbitmq-server.service

# 创建 OpenStack 用户
rabbitmqctl -n rabbit@controller add_user openstack openstack123
rabbitmqctl -n rabbit@controller set_permissions openstack ".*" ".*" ".*"

安装 Memcached 缓存（controller）

1
yum install memcached python-memcached -y

修改 /etc/sysconfig/memcached，将 OPTIONS 改为：

1
OPTIONS="-l 127.0.0.1,::1,controller"
1
2
systemctl start memcached.service
systemctl enable memcached.service

安装 etcd（controller，可选）

从 Stein 版本开始引入，用于分布式键值存储。

1
yum -y install etcd

编辑 /etc/etcd/etcd.conf，根据 [Member] 和 [Clustering] 段修改对应 IP 地址，然后：

1
2
3
systemctl start etcd
systemctl enable etcd
etcdctl cluster-health    # 输出 healthy 即成功

Keystone 身份认证服务

创建数据库

1
mysql -uroot -p000000
1
2
3
CREATE DATABASE keystone;
GRANT ALL PRIVILEGES ON keystone.* TO 'keystone'@'localhost' IDENTIFIED BY 'keystone123';
GRANT ALL PRIVILEGES ON keystone.* TO 'keystone'@'%' IDENTIFIED BY 'keystone123';

安装配置

1
yum install openstack-keystone httpd mod_wsgi -y

编辑 /etc/keystone/keystone.conf：

1
2
3
4
5
[database]
connection = mysql+pymysql://keystone:keystone123@controller/keystone

[token]
provider = fernet
1
2
3
4
5
6
7
8
9
10
11
12
13
# 同步数据库
su -s /bin/sh -c "keystone-manage db_sync" keystone

# 初始化 Fernet 密钥
keystone-manage fernet_setup --keystone-user keystone --keystone-group keystone
keystone-manage credential_setup --keystone-user keystone --keystone-group keystone

# 初始化管理员用户
keystone-manage bootstrap --bootstrap-password admin \
  --bootstrap-admin-url http://controller:5000/v3/ \
  --bootstrap-internal-url http://controller:5000/v3/ \
  --bootstrap-public-url http://controller:5000/v3/ \
  --bootstrap-region-id RegionOne

配置 HTTP 服务器

1
2
3
4
5
6
vi /etc/httpd/conf/httpd.conf
# 添加：ServerName controller

ln -s /usr/share/keystone/wsgi-keystone.conf /etc/httpd/conf.d/
systemctl start httpd.service
systemctl enable httpd.service

创建环境变量脚本

创建 admin.sh：

1
2
3
4
5
6
7
8
9
#!/bin/bash
export OS_USERNAME=admin
export OS_PASSWORD=admin
export OS_PROJECT_NAME=admin
export OS_USER_DOMAIN_NAME=Default
export OS_PROJECT_DOMAIN_NAME=Default
export OS_AUTH_URL=http://controller:5000/v3
export OS_IDENTITY_API_VERSION=3
export OS_IMAGE_API_VERSION=2
1
2
source admin.sh
openstack endpoint list    # 验证

创建域、项目、用户和角色

1
2
3
4
5
6
openstack domain create --description "An Example Domain" example
openstack project create --domain default --description "Service Project" service
openstack project create --domain default --description "Demo Project" myproject
openstack user create --domain default --password-prompt myuser
openstack role create myrole
openstack role add --project myproject --user myuser myrole

Glance 镜像服务

创建数据库和用户

1
2
3
CREATE DATABASE glance;
GRANT ALL PRIVILEGES ON glance.* TO 'glance'@'localhost' IDENTIFIED BY 'glance123';
GRANT ALL PRIVILEGES ON glance.* TO 'glance'@'%' IDENTIFIED BY 'glance123';
1
2
3
4
5
6
7
8
9
source /etc/openstack/keystone/admin-openrc.sh
openstack user create --domain default --password-prompt glance
openstack role add --project service --user glance admin
openstack service create --name glance --description 'Openstack Image' image

# 创建 API 端点
openstack endpoint create --region RegionOne image public http://controller:9292
openstack endpoint create --region RegionOne image internal http://controller:9292
openstack endpoint create --region RegionOne image admin http://controller:9292

安装配置

编辑 /etc/glance/glance-api.conf，配置数据库连接、Keystone 认证和存储后端：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
[database]
connection = mysql+pymysql://glance:glance123@controller/glance

[keystone_authtoken]
www_authenticate_uri = http://controller:5000
auth_url = http://controller:5000
memcached_servers = controller:11211
auth_type = password
project_domain_name = Default
user_domain_name = Default
project_name = service
username = glance
password = glance

[glance_store]
stores = file,http
default_store = file
filesystem_store_datadir = /var/lib/glance/images/
1
2
3
su -s /bin/sh -c "glance-manage db_sync" glance
systemctl enable openstack-glance-api.service
systemctl start openstack-glance-api.service

Placement 服务

创建数据库和用户

1
2
3
CREATE DATABASE placement;
GRANT ALL PRIVILEGES ON placement.* TO 'placement'@'localhost' IDENTIFIED BY 'placement123';
GRANT ALL PRIVILEGES ON placement.* TO 'placement'@'%' IDENTIFIED BY 'placement123';
1
2
3
4
5
6
7
openstack user create --domain default --password-prompt placement
openstack role add --project service --user placement admin
openstack service create --name placement --description 'placement API' placement

openstack endpoint create --region RegionOne placement public http://controller:8778
openstack endpoint create --region RegionOne placement internal http://controller:8778
openstack endpoint create --region RegionOne placement admin http://controller:8778

安装配置

1
yum -y install openstack-placement-api

编辑 /etc/placement/placement.conf，配置数据库和 Keystone 认证后：

1
2
su -s /bin/sh -c "placement-manage db sync" placement
placement-status upgrade check    # 验证

Nova 计算服务

创建数据库和用户

1
2
3
4
5
6
7
CREATE DATABASE nova_api;
CREATE DATABASE nova;
CREATE DATABASE nova_cell0;

GRANT ALL PRIVILEGES ON nova_api.* TO 'nova'@'%' IDENTIFIED BY 'nova123';
GRANT ALL PRIVILEGES ON nova.* TO 'nova'@'%' IDENTIFIED BY 'nova123';
GRANT ALL PRIVILEGES ON nova_cell0.* TO 'nova'@'%' IDENTIFIED BY 'nova123';
1
2
3
4
5
6
7
openstack user create --domain default --password-prompt nova
openstack role add --project service --user nova admin
openstack service create --name nova --description "Openstack Compute" compute

openstack endpoint create --region RegionOne compute public http://controller:8774/v2.1
openstack endpoint create --region RegionOne compute internal http://controller:8774/v2.1
openstack endpoint create --region RegionOne compute admin http://controller:8774/v2.1

controller 节点配置

1
yum install openstack-nova-api openstack-nova-conductor openstack-nova-novncproxy openstack-nova-scheduler -y

编辑 /etc/nova/nova.conf 关键配置：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
[DEFAULT]
enabled_apis = osapi_compute,metadata
transport_url = rabbit://openstack:openstack123@controller:5672/
use_neutron = true
firewall_driver = nova.virt.firewall.NoopFirewallDriver
my_ip = 192.168.10.10

[api]
auth_strategy = keystone

[vnc]
enabled = true
server_listen = $my_ip
server_proxyclient_address = $my_ip

[glance]
api_servers = http://controller:9292

[placement]
auth_url = http://controller:5000/v3
username = placement
password = placement
1
2
3
4
5
6
7
8
9
10
11
# 同步数据库
su -s /bin/sh -c "nova-manage api_db sync" nova
su -s /bin/sh -c "nova-manage cell_v2 map_cell0" nova
su -s /bin/sh -c "nova-manage cell_v2 create_cell --name=cell1 --verbose" nova
su -s /bin/sh -c "nova-manage db sync" nova

# 启动服务
systemctl enable openstack-nova-api --now
systemctl enable openstack-nova-scheduler --now
systemctl enable openstack-nova-conductor --now
systemctl enable openstack-nova-novncproxy --now

compute 节点配置

1
yum -y install openstack-nova-compute

编辑 /etc/nova/nova.conf，主要修改 my_ip = 192.168.10.20，VNC 监听改为 0.0.0.0，并添加 novncproxy_base_url。

1
2
3
4
5
6
# 检查硬件加速支持
egrep -c '(vmx|svm)' /proc/cpuinfo
# 返回 0 则需设置 virt_type = qemu

systemctl enable libvirtd --now
systemctl enable openstack-nova-compute --now

controller 节点验证：

1
2
openstack compute service list --service nova-compute
su -s /bin/sh -c "nova-manage cell_v2 discover_hosts --verbose" nova

Neutron 网络服务

创建数据库和用户

1
2
3
CREATE DATABASE neutron;
GRANT ALL PRIVILEGES ON neutron.* TO 'neutron'@'localhost' IDENTIFIED BY 'neutron123';
GRANT ALL PRIVILEGES ON neutron.* TO 'neutron'@'%' IDENTIFIED BY 'neutron123';
1
2
3
4
5
6
7
openstack user create --domain default --password-prompt neutron
openstack role add --project service --user neutron admin
openstack service create --name neutron --description "Openstack Networking" network

openstack endpoint create --region RegionOne network public http://controller:9696
openstack endpoint create --region RegionOne network internal http://controller:9696
openstack endpoint create --region RegionOne network admin http://controller:9696

controller 节点配置

1
yum install openstack-neutron openstack-neutron-ml2 openstack-neutron-linuxbridge ebtables -y

核心配置文件包括：

配置文件关键配置
/etc/neutron/neutron.conf数据库、RabbitMQ、Keystone、Nova 联动
/etc/neutron/plugins/ml2/ml2_conf.iniML2 插件：flat/vlan 网络类型
/etc/neutron/plugins/ml2/linuxbridge_agent.iniLinux Bridge 映射物理网卡
/etc/neutron/dhcp_agent.iniDHCP 驱动配置
/etc/neutron/metadata_agent.ini元数据代理配置

⚠️ 需要配置内核参数 net.bridge.bridge-nf-call-iptables = 1

1
2
3
4
5
6
7
# 创建软连接并同步数据库
ln -s /etc/neutron/plugins/ml2/ml2_conf.ini /etc/neutron/plugin.ini
su -s /bin/sh -c "neutron-db-manage --config-file /etc/neutron/neutron.conf \
  --config-file /etc/neutron/plugins/ml2/ml2_conf.ini upgrade head" neutron

systemctl restart neutron-server neutron-linuxbridge-agent neutron-dhcp-agent neutron-metadata-agent
systemctl enable neutron-server neutron-linuxbridge-agent neutron-dhcp-agent neutron-metadata-agent

compute 节点配置

1
yum install openstack-neutron-linuxbridge ebtables ipset -y

配置 neutron.conf、linuxbridge_agent.ini 和 nova.conf 中的 neutron 段后：

1
2
systemctl restart openstack-nova-compute
systemctl enable neutron-linuxbridge-agent --now

Dashboard 仪表盘

1
yum install openstack-dashboard -y

编辑 /etc/openstack-dashboard/local_settings，关键配置：

1
2
3
4
5
6
7
OPENSTACK_HOST = "controller"
ALLOWED_HOSTS = ['*']
OPENSTACK_KEYSTONE_MULTIDOMAIN_SUPPORT = True
OPENSTACK_KEYSTONE_DEFAULT_DOMAIN = 'Default'
OPENSTACK_KEYSTONE_DEFAULT_ROLE = 'user'
TIME_ZONE = "Asia/Shanghai"
WEBROOT = '/dashboard'
1
2
3
systemctl restart httpd memcached
# 访问 http://192.168.10.10/dashboard
# 域: default | 用户名: admin | 密码: admin

Cinder 块存储服务

controller 节点

1
2
CREATE DATABASE cinder;
GRANT ALL PRIVILEGES ON cinder.* TO 'cinder'@'%' IDENTIFIED BY 'cinder123';
1
2
3
4
5
6
7
openstack user create --domain default --password-prompt cinder
openstack role add --project service --user cinder admin
openstack service create --name cinderv2 --description "OpenStack Block Storage" volumev2
openstack service create --name cinderv3 --description "OpenStack Block Storage" volumev3

# 创建 v2/v3 的 public/internal/admin 端点（端口 8776）
yum install openstack-cinder -y

编辑 /etc/cinder/cinder.conf 配置数据库、RabbitMQ 和 Keystone 后：

1
2
3
4
sudo su -s /bin/sh -c "cinder-manage db sync" cinder
systemctl restart openstack-nova-api
systemctl start openstack-cinder-api openstack-cinder-scheduler
systemctl enable openstack-cinder-api openstack-cinder-scheduler

compute 节点

1
2
3
4
5
6
yum install lvm2 device-mapper-persistent-data -y
systemctl enable lvm2-lvmetad.service && systemctl start lvm2-lvmetad.service

# 创建物理卷和卷组
pvcreate /dev/sdb
vgcreate cinder-volumes /dev/sdb

编辑 /etc/lvm/lvm.conf 添加过滤器：

1
filter = [ "a/sda/", "a/sdb/", "r/.*/"]
1
yum install openstack-cinder targetcli python-keystone -y

配置 /etc/cinder/cinder.conf，添加 [lvm] 段指定卷驱动后：

1
2
systemctl start openstack-cinder-volume.service target.service
systemctl enable openstack-cinder-volume.service target.service

Swift 对象存储服务

创建服务凭据

1
2
3
4
5
openstack user create --domain default --password-prompt swift
openstack role add --project service --user swift admin
openstack service create --name swift --description "OpenStack Object Storage" object-store

# 创建 public/internal/admin 端点（端口 8080）

controller 节点

1
2
3
4
5
yum install openstack-swift-proxy python-swiftclient python-keystoneclient \
  python-keystonemiddleware memcached -y

curl -o /etc/swift/proxy-server.conf \
  https://opendev.org/openstack/swift/raw/branch/master/etc/proxy-server.conf-sample

编辑 proxy-server.conf 配置 Keystone 认证和缓存后：

1
2
systemctl enable openstack-swift-proxy.service memcached.service
systemctl start openstack-swift-proxy.service memcached.service

compute 节点

1
2
3
4
5
6
7
8
9
10
11
12
yum install xfsprogs rsync -y

# 格式化并挂载磁盘
mkfs.xfs /dev/sdb && mkfs.xfs /dev/sdc
mkdir -p /srv/node/sdb /srv/node/sdc
# 编辑 /etc/fstab 添加挂载项后 mount

# 配置 rsync 并启动
systemctl enable rsyncd.service && systemctl start rsyncd.service

# 安装 Swift 存储组件
yum install openstack-swift-account openstack-swift-container openstack-swift-object -y

创建和分发 Ring（controller）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
cd /etc/swift/

# Account Ring
swift-ring-builder account.builder create 10 3 1
swift-ring-builder account.builder add --region 1 --zone 1 --ip 192.168.10.20 --port 6202 --device sdb --weight 100
swift-ring-builder account.builder add --region 1 --zone 1 --ip 192.168.10.20 --port 6202 --device sdc --weight 100
swift-ring-builder account.builder rebalance

# Container Ring
swift-ring-builder container.builder create 10 3 1
swift-ring-builder container.builder add --region 1 --zone 1 --ip 192.168.10.20 --port 6201 --device sdb --weight 100
swift-ring-builder container.builder add --region 1 --zone 1 --ip 192.168.10.20 --port 6201 --device sdc --weight 100
swift-ring-builder container.builder rebalance

# Object Ring
swift-ring-builder object.builder create 10 3 1
swift-ring-builder object.builder add --region 1 --zone 1 --ip 192.168.10.20 --port 6200 --device sdb --weight 100
swift-ring-builder object.builder add --region 1 --zone 1 --ip 192.168.10.20 --port 6200 --device sdc --weight 100
swift-ring-builder object.builder rebalance

# 分发到 compute 节点
scp swift.conf compute:/etc/swift/swift.conf
chown -R root:swift /etc/swift

常见问题与踩坑记录

❌ CentOS 7 源失效：部署 OpenStack 仓库后必须手动换源，否则 yum 安装会报 404。

❌ 配置文件中混入中文：OpenStack 所有服务的配置文件（包括注释）都不能有中文，否则服务启动直接报错。

❌ Nova 计算节点无法发现：需要在 controller 节点执行 nova-manage cell_v2 discover_hosts，或在 nova.conf 中设置 discover_hosts_in_cells_interval = 300 自动发现。

❌ Neutron 网络不通：检查内核参数 net.bridge.bridge-nf-call-iptables 是否设置为 1，以及 Linux Bridge 的物理网卡映射是否正确。

❌ Swift Ring 不平衡：每次添加或删除存储节点后都需要执行 rebalance，否则数据分布不均匀。

❌ Dashboard 无法访问：确认 WEBROOT = '/dashboard'，访问地址为 http://controller/dashboard，而不是根路径。

服务安装顺序总结

整个 OpenStack 的搭建按照以下顺序进行：基础环境 → Keystone（认证）→ Glance（镜像）→ Placement（资源调度）→ Nova（计算）→ Neutron（网络）→ Dashboard（仪表盘）→ Cinder（块存储）→ Swift（对象存储）。每一步都需要先创建数据库和用户，再安装配置组件，最后启动服务并验证。

搭建完成后，可以通过 Dashboard 或 CLI 命令创建实例、分配浮动 IP、挂载云硬盘等操作，真正体验 OpenStack 的云计算能力。

]]> OpenStack Train 版本双节点搭建实战，基于 CentOS 7 手把手部署私有云环境。 Kubernetes 工作流程图解 https://www.cloudetopia.top/2023/12/12/2023-12-12-Kubernetes%E6%B5%81%E7%A8%8B%E5%9B%BE/ 2023-12-12T02:00:00.000Z 2026-07-08T08:02:15.040Z 前言

本文以流程图形式展示 Kubernetes 的核心工作流程，涵盖 Pod 调度、服务发现、网络通信等关键环节。

注：原文中的图片已移除，后续将补充文字说明。

Pod 调度流程

1
2
3
4
5
6
7
8
9
10
11
用户提交 Pod 请求
       ↓
API Server 接收请求
       ↓
Scheduler 根据策略选择节点
       ↓
Controller Manager 通知 Kubelet
       ↓
Kubelet 启动容器
       ↓
Pod 运行中

服务发现流程

1
2
3
4
5
6
7
8
9
Pod 启动并注册到 Endpoints
       ↓
Service 通过 Selector 匹配 Pod
       ↓
kube-proxy 配置 iptables/IPVS 规则
       ↓
客户端访问 Service ClusterIP
       ↓
流量转发到后端 Pod

网络通信模型

K8s 网络模型遵循以下原则：

  • 每个 Pod 都有独立的 IP 地址
  • Pod 之间可以直接通信
  • 节点上的代理（kube-proxy）负责服务发现和负载均衡

后续将补充更详细的流程图和说明。

]]> 以流程图形式展示 Kubernetes 核心工作流程，涵盖 Pod 调度、服务发现与网络通信。 Kubernetes 核心概念详解 https://www.cloudetopia.top/2023/12/12/2023-12-12-Kubernetes%E8%AF%A6%E8%A7%A3/ 2023-12-12T02:00:00.000Z 2026-07-08T08:02:15.040Z 前言

Kubernetes（K8s）是容器编排的事实标准。这篇文章从 Pod 开始，逐步讲解 K8s 的核心概念和资源对象。

Pod

概述

Pod 是 K8s 中最小的部署单元，是一组（一个或多个）容器的集合。Pod 就像是豌豆荚，而容器就像是豌豆荚中的豌豆。这些容器共享存储、网络等资源。

Pod 资源清单

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
apiVersion: v1          # API 版本
kind: Pod               # 资源对象类型
metadata:               # Pod 元数据
  name: nginx-pod       # Pod 名称
  labels:               # 定义标签
    tybe: app
    test: 1.0.0
  namespace: 'default'  # 命名空间
spec:                   # Pod 规格
  containers:           # 容器列表
  - name: nginx
    image: 'nginx:1.20.2'
    imagePullPolicy: IfNotPresent
    startupProbe:       # 启动探针
      exec:
        command:
        - /bin/sh
        - -c
        - "sleep 3; echo success > /inited"
      initialDelaySeconds: 1
      periodSeconds: 5
      failureThreshold: 3
      successThreshold: 1
      timeoutSeconds: 5
    readinessProbe:     # 就绪探针
      httpGet:
        path: /started.html
        port: 80
      initialDelaySeconds: 1
      periodSeconds: 5
      failureThreshold: 3
    command:            # 启动命令
    - nginx
    - -g
    - 'daemon off;'
    workingDir: /usr/share/nginx/html
    ports:
    - name: http
      containerPort: 80
      protocol: TCP
    env:                # 环境变量
    - name: JVM_OPTS
      value: '-Xms128m -Xmx128m'
    resources:          # 资源限制
      requests:
        cpu: 100m
        memory: 128Mi
      limits:
        cpu: 200m
        memory: 256Mi
  restartPolicy: OnFailure

Deployment 控制器

配置文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deploy
  labels:
    controller: deploy
spec:
  replicas: 3                    # 副本数量
  revisionHistoryLimit: 5        # 保留历史版本数
  paused: false                  # 是否暂停部署
  progressDeadlineSeconds: 600   # 部署超时时间
  strategy:                      # 更新策略
    type: RollingUpdate
    rollingUpdate:
      maxSurge: 30%              # 最大额外副本数
  selector:                      # 选择器
    matchLabels:
      app: nginx-pod
  template:                      # Pod 模板
    metadata:
      labels:
        app: nginx-pod
    spec:
      containers:
      - name: nginx
        image: nginx:1.20.2
        ports:
        - containerPort: 80

版本管理

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# 查看升级状态
kubectl rollout status deployment nginx-deploy

# 查看升级历史
kubectl rollout history deployment nginx-deploy

# 暂停升级
kubectl rollout pause deployment nginx-deploy

# 继续升级
kubectl rollout resume deployment nginx-deploy

# 回滚到上一版本
kubectl rollout undo deployment nginx-deploy

# 回滚到指定版本
kubectl rollout undo deployment nginx-deploy --to-revision=2

滚动更新

1
2
3
4
5
# 更新镜像
kubectl set image deployment nginx-deploy nginx=nginx:1.21.0

# 或直接编辑
kubectl edit deployment nginx-deploy

金丝雀发布

金丝雀发布是一种灰度发布策略，先部署少量新版本实例，验证无误后再逐步扩大范围。

1
2
3
4
5
6
# 创建金丝雀部署（1个副本）
kubectl set image deployment nginx-deploy nginx=nginx:1.21.0
kubectl scale deployment nginx-deploy --replicas=1

# 验证通过后，全量更新
kubectl set image deployment nginx-deploy nginx=nginx:1.21.0

Service

Service 用于暴露 Pod 的访问入口，提供稳定的 IP 和 DNS 名称。

Service 类型

类型说明
ClusterIP默认类型，仅集群内部可访问
NodePort通过节点端口暴露服务
LoadBalancer使用云提供商的负载均衡器
ExternalName映射到外部 DNS 名称

配置示例

1
2
3
4
5
6
7
8
9
10
11
12
apiVersion: v1
kind: Service
metadata:
  name: nginx-service
spec:
  selector:
    app: nginx-pod
  ports:
  - port: 80
    targetPort: 80
    nodePort: 30080
  type: NodePort

ConfigMap 和 Secret

ConfigMap

用于存储非敏感配置数据。

1
2
3
4
5
6
7
8
9
10
11
12
# 创建 ConfigMap
kubectl create configmap my-config --from-file=config.properties

# 或在 YAML 中定义
apiVersion: v1
kind: ConfigMap
metadata:
  name: my-config
data:
  config.properties: |
    key1=value1
    key2=value2

Secret

用于存储敏感数据（密码、密钥等）。

1
2
3
4
5
6
7
8
9
10
# 创建 Secret
kubectl create secret generic my-secret --from-literal=password=my-password

# 在 Pod 中使用
env:
- name: DB_PASSWORD
  valueFrom:
    secretKeyRef:
      name: my-secret
      key: password

常见问题

❌ Pod 一直处于 Pending 状态

原因：节点资源不足或没有匹配的节点。

解决：

1
2
3
4
5
# 查看 Pod 事件
kubectl describe pod <pod-name>

# 查看节点资源
kubectl top nodes

❌ 镜像拉取失败

原因：镜像地址错误或网络问题。

解决：

1
2
3
4
5
# 检查镜像名称
kubectl get pod <pod-name> -o yaml | grep image

# 配置镜像仓库密钥
kubectl create secret docker-registry my-registry --docker-server=...

以上就是 Kubernetes 核心概念的详解。K8s 内容丰富，后续文章会继续深入讲解各个组件。

]]> Kubernetes 核心概念详解，从 Pod 到 Service，逐步讲解 K8s 的关键资源对象。 OpenStack 核心项目演变 https://www.cloudetopia.top/2023/12/12/2023-12-12-OpenStack%E6%A0%B8%E5%BF%83%E9%A1%B9%E7%9B%AE%E6%BC%94%E5%8F%98/ 2023-12-12T02:00:00.000Z 2026-07-08T08:02:15.040Z 前言

本文梳理 OpenStack 各个核心项目的演变历程，包括 Nova、Neutron、Cinder、Swift 等组件的发展脉络。

注：原文中的图片已移除，后续将补充文字说明。

OpenStack 核心组件

组件功能状态
Nova计算服务活跃
Neutron网络服务活跃
Cinder块存储活跃
Swift对象存储活跃
Glance镜像服务活跃
Keystone身份认证活跃
Horizon仪表盘活跃
Heat编排服务活跃

项目演变时间线

1
2
3
4
5
6
7
8
9
10
11
12
13
14
2010 - OpenStack 项目启动（NASA + Rackspace）
2011 - Austin 版本发布
2012 - Essex/Folsom 版本
2013 - Grizzly/Havana 版本
2014 - Icehouse/Juno 版本
2015 - Kilo/Liberty/Mitaka 版本
2016 - Newton/Ocata 版本
2017 - Pike/Queens/Rocky 版本
2018 - Stein/Train 版本
2019 - Ussuri/Victoria 版本
2020 - Wallaby/Xena 版本
2021 - Yoga/Zed 版本
2022 - Antelope/Bobcat 版本
2023 - Caracal 版本

架构演变趋势

早期 OpenStack 采用单体架构，各组件之间耦合度较高。随着云原生技术的发展，OpenStack 逐渐向微服务架构演进，容器化部署成为趋势。

后续将补充各组件的详细演变说明。

]]> 梳理 OpenStack 各核心项目的演变历程，包括 Nova、Neutron、Cinder 等组件的发展脉络。 MySQL 基础篇：安装与入门 https://www.cloudetopia.top/2023/10/25/2023-10-25-MySQL/ 2023-10-25T02:00:00.000Z 2026-07-08T08:02:15.040Z 前言

MySQL 是最流行的关系型数据库管理系统之一，广泛应用于 Web 应用开发。这篇文章记录了在 CentOS 上安装 MySQL 的完整过程，以及 MariaDB 作为替代方案的说明。

安装前检查

1
2
3
4
5
6
# 检查系统是否已安装 MySQL
rpm -qa | grep mysql

# 如果已安装，卸载旧版本
rpm -e mysql                    # 普通删除
rpm -e --nodeps mysql           # 强制删除（忽略依赖）

安装 MySQL

方法一：使用 YUM 安装

参考 MySQL 官方文档

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# 下载 MySQL 仓库
wget http://repo.mysql.com/mysql-community-release-el7-5.noarch.rpm

# 安装仓库
rpm -ivh mysql-community-release-el7-5.noarch.rpm

# 更新并安装
yum update
yum install mysql-server

# 设置权限
chown -R mysql:mysql /var/lib/mysql/

# 初始化
mysqld --initialize

# 启动 MySQL
systemctl start mysqld

# 检查状态
systemctl status mysqld

注意：第一次启动 MySQL 服务时，服务器会自动进行初始化配置。

方法二：使用 MariaDB（MySQL 替代方案）

MariaDB 是 MySQL 的一个分支，主要由开源社区维护，采用 GPL 授权许可。开发这个分支的原因之一是：甲骨文公司收购了 MySQL 后，有将 MySQL 闭源的潜在风险。

MariaDB 的目的是完全兼容 MySQL，包括 API 和命令行，可以轻松成为 MySQL 的代替品。

1
2
3
4
5
6
7
8
9
10
# 安装 MariaDB
yum install mariadb-server mariadb 

# 启动/停止/重启
systemctl start mariadb
systemctl stop mariadb
systemctl restart mariadb

# 设置开机启动
systemctl enable mariadb

验证安装

1
2
3
4
5
6
7
8
# 查看版本
mysqladmin --version
# 输出示例：mysqladmin  Ver 8.42 Distrib 5.6.51, for Linux on x86_64

# 如果以上命令未输出任何信息，说明 MySQL 未安装成功

# 进入 MySQL
mysql

常见问题

❌ 忘记 root 密码

解决：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 停止 MySQL 服务
systemctl stop mysqld

# 以安全模式启动
mysqld_safe --skip-grant-tables &

# 进入 MySQL 修改密码
mysql
> USE mysql;
> UPDATE user SET password=PASSWORD('新密码') WHERE user='root';
> FLUSH PRIVILEGES;
> EXIT;

# 重启 MySQL
systemctl restart mysqld

❌ 远程连接被拒绝

原因：MySQL 默认只允许本地连接。

解决：

1
2
3
-- 授权远程访问
GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY '密码' WITH GRANT OPTION;
FLUSH PRIVILEGES;

以上就是 MySQL 安装和入门的全部内容。后续文章会继续介绍 MySQL 的进阶用法。

]]> MySQL 基础入门教程，记录 CentOS 上 MySQL 安装配置的完整过程及 MariaDB 替代方案。 Dockerfile 详解：从基础到实战 https://www.cloudetopia.top/2023/10/20/2023-10-20-Dockerfile/ 2023-10-20T02:00:00.000Z 2026-07-08T08:02:15.040Z 前言

Dockerfile 是用来构建 Docker 镜像的文本文件，包含了一条条指令，告诉 Docker 如何一步步构建镜像。掌握 Dockerfile 是 Docker 进阶的必经之路。

这篇文章从基础概念讲起，通过实例带你理解 Dockerfile 的常用指令和构建流程。

Dockerfile 构建流程

一个完整的 Docker 镜像由以下几步构成：

  1. 编写 Dockerfile 文件
  2. 使用 docker build 命令构建镜像
  3. 使用 docker run 命令运行镜像
  4. 使用 docker push 发布镜像（推荐 DockerHub、阿里云镜像仓库）

参考 Docker 官方文档

Dockerfile 指令

Dockerfile 中每个指令都会创建一个新的镜像层。

指令说明
FROM基础镜像，一切从这里开始
MAINTAINER镜像维护者（姓名+邮箱）
RUN构建镜像时执行的命令
ADD添加文件并自动解压压缩包
COPY复制文件到镜像中（类似 ADD，但不解压）
WORKDIR设置工作目录
VOLUME挂载目录
EXPOSE暴露端口号
CMD容器启动时执行的命令（仅最后一个生效，可被替代）
ENTRYPOINT容器启动时执行的命令（可追加参数）
ONBUILD当镜像被继承时触发的指令
ENV设置环境变量

注意事项

  • 每个指令（关键字）必须大写
  • 文件从上到下顺序执行
  • # 表示注释
  • 每条指令都会创建并提交一个新的镜像层

实战：创建自定义 CentOS 镜像

1. 编写 Dockerfile

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 创建文件：/home/dockerfile/dockerfile.centos
FROM centos:7
MAINTAINER cf<kisssheep1557@163.com>

ENV MYPATH /usr/local/
WORKDIR $MYPATH

RUN yum -y install vim
RUN yum -y install net-tools

EXPOSE 80

CMD echo $MYPATH
CMD echo "-----end-----"
CMD /bin/bash

2. 构建镜像

1
2
# 命令格式：docker build -f <Dockerfile路径> -t <镜像名>:<tag> .
docker build -f dockerfile.centos -t mycentos:0.1 .

3. 对比测试

官方基础镜像 centos:7 通常没有 vim 等常用命令，而通过 Dockerfile 构建的 mycentos:0.1 已经预装了这些工具。

1
2
# 查看镜像构建历史
docker history <镜像ID>

CMD 与 ENTRYPOINT 的区别

这两个指令都用于指定容器启动时执行的命令，但行为不同：

  • CMD：只有最后一个生效，可以被 docker run 的参数替代
  • ENTRYPOINT：会追加参数，不会被替代

测试 CMD

1
2
FROM centos:7
CMD ["ls","-a"]
1
2
3
4
5
6
7
8
9
# 构建镜像
docker build -f mydockerfile-cmd-test -t myimage:tag .

# 运行 - 执行 ls -a
docker run 06f2cc65ea4a

# 尝试追加 -l 参数 - 报错！
docker run 06f2cc65ea4a -l
# 原因：-l 替换了 CMD ["ls","-a"]，而不是追加

测试 ENTRYPOINT

1
2
FROM centos:7
ENTRYPOINT ["ls","-a"]
1
2
3
4
5
6
7
8
9
# 构建镜像
docker build -f mydockerfile-entrypoint-test -t myimages:tag .

# 运行 - 执行 ls -a
docker run 5184c7d459a0

# 追加 -l 参数 - 成功执行 ls -al！
docker run 5184c7d459a0 -l
# 原因：-l 被追加到 ENTRYPOINT 后面

实战：制作 Tomcat 镜像

1. 准备材料

1
2
3
4
5
6
7
8
9
10
11
# 拉取基础镜像
docker pull centos:7

# 准备目录
cd /home/dockerfile

# 下载 Tomcat 和 JDK 压缩包
# Tomcat: https://tomcat.apache.org/download-80.cgi
# JDK: http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
ls
# apache-tomcat-8.5.93.tar.gz  jdk-8u381-linux-x64.tar.gz

2. 编写 Dockerfile

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
FROM centos:7
MAINTAINER yqy<kisssheep1557@163.com>

# 复制说明文件
COPY readme.txt /usr/local/readme.txt

# 添加并解压压缩包
ADD jdk-8u381-linux-x64.tar.gz /usr/local  
ADD apache-tomcat-8.5.93.tar.gz /usr/local

# 安装 vim
RUN yum install -y vim

# 设置工作目录
ENV MYPATH /usr/local
WORKDIR $MYPATH

# 配置环境变量
ENV JAVA_HOME /usr/local/jdk1.8.0_381
ENV CLASS_PATH $JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
ENV CATALINA_HOME /usr/local/apache-tomcat-8.5.93
ENV CATALINA_BASH /usr/local/apache-tomcat-8.5.93
ENV PATH $PATH:$JAVA_HOME/bin:$CATALINA_HOME/lib:$CATALINA_HOME/bin

# 暴露端口
EXPOSE 8080 

# 启动 Tomcat 并监控日志
CMD /usr/local/apache-tomcat-8.5.93/bin/startup.sh && tail -F /usr/local/apache-tomcat-8.5.93/logs/catalina.out

3. 构建并运行

1
2
3
4
5
6
7
8
9
10
11
# 构建镜像
docker build -t diytomcat .

# 运行容器（简单版）
docker run -d -p 9090:8080 --name diytomcat01 diytomcat:latest

# 运行容器（带挂载）
docker run -d -p 3355:8080 --name yqytomcat \
  -v /home/yqy/build/tomcat/test:/usr/local/apache-tomcat-8.5.93/webapps/test \
  -v /home/yqy/build/tomcat/tomcatlog:/usr/local/apache-tomcat-8.5.93/logs \
  diytomcat

访问 http://服务器IP:9090 即可看到 Tomcat 默认页面。

常见问题

❌ 构建时 yum install 失败

原因：CentOS 7 官方源已停止维护。

解决：更换为 vault 源或阿里云镜像源。

❌ CMD 命令不生效

原因：多个 CMD 指令只有最后一个生效。

解决：使用 && 连接多个命令，或使用 ENTRYPOINT。

以上就是 Dockerfile 的核心内容和实战示例。掌握这些指令，你就可以构建自己的 Docker 镜像了。

]]> Dockerfile 编写指南，从基础指令到多阶段构建，带你掌握镜像构建的核心技能。 Docker 入门实战：从安装到镜像加速 https://www.cloudetopia.top/2023/10/17/2023-10-17-Docker/ 2023-10-17T02:00:00.000Z 2026-07-08T08:02:15.040Z 前言

Docker 是一个开源的容器化平台，用于构建、部署和运行应用程序。它基于 Linux 容器（LXC）技术，提供了一种轻量级且可移植的虚拟化解决方案。

通过使用 Docker，开发人员可以将应用程序及其所有依赖项打包到一个称为容器的独立单元中。这些容器可以在任何支持 Docker 的操作系统上运行，无需额外配置。每个容器都是独立的、安全的，并且具有自己的文件系统、网络和进程空间。

这篇文章记录了在 CentOS 上安装 Docker 并配置国内镜像加速的完整过程。

Docker 的主要优点

  • 轻量级：相比传统的虚拟机，Docker 容器占用更少的系统资源，启动更快
  • 可移植性：容器可以在不同的环境中运行，无论是开发、测试还是生产环境
  • 简化部署：将应用程序及其依赖项作为一个整体打包，简化部署流程
  • 灵活性：提供灵活的管理和扩展功能，可以快速部署、停止、复制和迁移容器
  • 高效性：容器共享主机的操作系统内核，资源利用和性能非常高效

环境要求

Docker 要求 CentOS 内核版本高于 3.10（CentOS 7 以上无需升级内核）。

1
2
3
# 查看系统内核版本
uname -r
# 输出示例：3.10.0-1160.92.1.el7.x86_64

本文基于 CentOS 7.9 操作，如有其他问题请参考 Docker 官方文档。

安装 Docker

1. 卸载旧版本（如已安装）

1
2
3
4
5
6
7
8
9
10
11
12
# 检查是否已安装
docker --version
# 如果提示 command not found，说明未安装

# 卸载旧版本
sudo yum remove docker \
                docker-client \
                docker-client-latest \
                docker-common \
                docker-latest \
                docker-logrotate \
                docker-engine

2. 安装依赖工具

1
sudo yum install -y yum-utils

3. 配置 Docker 仓库

1
2
3
sudo yum-config-manager \
    --add-repo \
    https://download.docker.com/linux/centos/docker-ce.repo

4. 安装 Docker 引擎

安装最新版本：

1
sudo yum -y install docker-ce docker-ce-cli containerd.io

或安装特定版本：

1
2
3
4
5
# 查看可用版本
yum list docker-ce --showduplicates | sort -r

# 安装指定版本（示例）
sudo yum install docker-ce-24.0.0 docker-ce-cli-24.0.0 containerd.io docker-buildx-plugin docker-compose-plugin

5. 启动 Docker

1
2
3
4
5
6
7
8
9
# 启动 Docker
sudo systemctl start docker

# 设置开机自启
sudo systemctl enable docker

# 验证安装
docker --version
# 输出示例：Docker version 24.0.6, build ed223bc

6. 验证安装

1
docker run hello-world

如果看到 Hello from Docker! 的输出，说明安装成功。

配置国内镜像加速

由于 Docker Hub 服务器在国外，拉取镜像时会很慢。可以使用国内的镜像加速服务，例如阿里云、清华、网易、中科大等。

这里以阿里云为例：

  1. 打开 阿里云镜像加速地址 并登录
  2. 在左侧菜单中选择「镜像加速器」
  3. 复制你的专属加速地址
1
2
3
4
5
6
7
8
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": ["https://你的ID.mirror.aliyuncs.com"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker

常见问题

❌ 拉取镜像超时

原因：Docker Hub 在国内访问慢。

解决：配置国内镜像加速器（见上文）。

❌ 权限不足

原因：当前用户不在 docker 用户组。

解决：

1
2
sudo usermod -aG docker $USER
# 重新登录后生效

以上就是 Docker 安装和配置的全部内容。后续文章会继续介绍 Docker 的进阶用法。

]]> Docker 入门实战教程，涵盖容器核心概念、安装配置和镜像加速，助你快速上手容器化部署。