运维指令手册集

三十份手册，覆盖国内外主流 Linux 发行版、国外主流数据库、国产数据库、通用容器技术栈，以及国内容器平台与运维面板。共用一套编写约定，可交叉检索。

容器与平台有两条入口：

• 通用技术栈（Docker / Podman / containerd / Kubernetes / Harbor）→ 容器平台总览与跨平台速查
• 国内产品与交付环境（面板 / 国产 K8s 平台 / 云容器服务）→ 国内容器平台与运维面板总览

手册清单

操作系统

数据库（国外主流）

国产数据库

国产数据库先从其他国产数据库手册第 1 章「选型与版本矩阵」确认血统，再翻对应分册。国测等级与端口速查在同手册第 2 章。

容器与编排

国内容器平台与运维面板

国内容器环境：先记住这七条

1. 镜像源：多数高校/公益 Docker Hub 加速已关停；生产用云厂商账号专属加速器，更优是把镜像同步到同地域自有仓库走 VPC 内网拉取。curl -I https://<地址>/v2/ 返回 200/401 才算通。
2. 两套面板不同机：1Panel（OpenResty 在容器里，反代写宿主 IP）与宝塔（nginx 在宿主机，反代写 127.0.0.1）的迁移差异是全站 502 的头号原因。
3. 代际别搞混：KubeSphere v4 用 Helm ks-core，不再有 ks-installer；Kuboard v4 需要外部关系型数据库且必须 utf8mb4。
4. 部署器 ≠ 管理平台：KubeKey/Sealos/kubeasz 装完集群就离场；KubeSphere/Kuboard/Rainbond 是常驻的。换管理平台可热切，换部署器基本要重建。
5. 托管集群没有 etcd 快照：ACK/TKE/CCE 灾备靠 Velero + GitOps 清单 + 数据备份 + 镜像跨地域复制。
6. 版本 EOS 由不得你：以 2026-11 计，TKE 1.30 于 2026-11-20 EOS；ACK 只支持最近 3 个 minor 建集群、一次只升一个 minor 且不可降级。
7. 离线交付验收标准：在完全断网的测试机上从零跑通全流程；六类物料（OS 包 / K8s 镜像 / CNI / CSI / 平台镜像与 chart / 业务镜像）缺一类都会返工。

数据库速查：先确认四件事

不同数据库的运维心智差异远大于命令差异。上手一个陌生实例，先确认这四项：

mysql -e "SELECT VERSION();"                  # 关系型：版本决定升级路径与认证插件
psql -c "SELECT version();"
sqlplus -v                                    # Oracle：26ai 内部版本号是 23.x
sqlcmd -Q "SELECT @@VERSION"
mongosh --eval "db.version()"                 # MongoDB：8.1/8.2 仅 Atlas，不可自建
redis-cli INFO server | grep redis_version

备份与恢复方式对照

高危操作红线（各库通用）

1. DROP / TRUNCATE 都没有回收站。Oracle 的 DROP TABLE 默认进 recyclebin，加 PURGE 就没了；其余数据库删了就是删了。
2. 大批量 DELETE / UPDATE 之前先 SELECT COUNT(*) 用同一条件确认行数，并在事务里先跑一次。
3. DDL 前先看有没有长事务。MySQL 的 MDL、PG 的 ACCESS EXCLUSIVE 排队、SQL Server 的 Sch-M 锁，都会因为一个未提交事务把整张表堵死。
4. 磁盘不要用到 100%。Oracle 归档区满会全库挂起；SQL Server 日志满会拒写；MongoDB 满会崩溃；PG 满时连 VACUUM 都做不了。
5. 改配置用持久化方式。MySQL SET PERSIST、PG ALTER SYSTEM、Oracle SCOPE=SPFILE、SQL Server sp_configure、Redis CONFIG REWRITE——只改内存，重启就白干。

国产数据库速查：先看血统，再看国测

国产库品牌多，但技术底子只有三条。判断出血缘，工具名和运维心智基本就定了。

端口辨识

国测等级（选型硬门槛）

测评结果有效期 3 年。2023 年第一批入库的产品在 2026-12 到期，投标前必须核对厂商是否已完成复核，拿过期报告会被直接废标。

国产库五个特有坑

1. License 先于技术。集群功能（达梦数据守护、KES RAC、GoldenDB 分布式）需要集群版授权，装到一半卡在授权校验是最常见的实施事故。
2. 文档滞后于发布。达梦 DM9 于 2026-04 发布，到 9 月安装介质仍是测试版、文档站只有 DM8 手册。以现场 --help 和交付文档为准。
3. 建库参数不可改。金仓 database_mode、达梦 CASE_SENSITIVE/PAGE_SIZE、openGauss DBCOMPATIBILITY 都是初始化时定死，选错只能重建。
4. 统计信息多半不自动。达梦默认不自动收集，openGauss/金仓需靠 autovacuum。迁过去"跑一阵突然变慢"多半是这个原因。
5. 分布式不给你命令行。GaussDB 分布式扩容、TDSQL 扩 SET、GoldenDB 扩容都必须走管控平台，手工改元数据会破坏分片一致性。

先判断血统，再翻文档

上手任何一台陌生 Linux，先跑这三条：

cat /etc/os-release                  # 看 ID 与 ID_LIKE
for c in apt dnf yum zypper apk; do command -v $c >/dev/null && echo "有 $c"; done
command -v systemctl && echo systemd || echo "非 systemd"

跨系统核心差异总表

包管理

服务与初始化

网络配置

防火墙与安全模块

日志路径

跨发行版通用避坑十条

1. 改 sshd 端口：RHEL 系需同步 firewalld + SELinux 端口标签，缺一即失联。
2. 改 fstab：加 nofail 并 mount -a 验证，否则磁盘缺失会导致无法开机。
3. 改网络：远程操作前准备好带外管理；netplan try / 保留旧会话是保命手段。
4. limit 对 systemd 无效：改 limits.conf 不管用，要写 LimitNOFILE。
5. XFS 不能缩容：lvreduce 会直接损坏文件系统。
6. rsync --delete 先 --dry-run：方向写反会清空源数据。
7. rm -rf $VAR/：VAR 为空等于删根，脚本必写 ${VAR:?}。
8. SELinux 不要改 disabled：用 setenforce 0 验证，按 restorecon / semanage 修，关掉是埋雷。
9. Alpine 不是 glibc：x86 二进制跑不了不是权限问题，是 libc 不兼容。
10. 国产系统不要混源：UOS/麒麟/Deepin 混入上游官方源会破坏定制组件。

维护建议

• 与具体环境强相关的部分（网卡名、端口规范、备份路径、服务命名、授权方式）建议替换为团队实际值，沉淀为内部 SOP。
• 厂商定制能力（国产系统的激活、安全管理平台、补丁渠道；面板的专业版功能边界；云产品的版本日历与配额）随版本变化快，涉及处标注了"以实测/官方文档为准"，请勿当作固定命令使用。
• 容器与国内平台部分建议每季度复核一次版本 EOS 与镜像加速地址可用性，并把结果写回对应手册的版本章节。

运维工具手册（66 篇，按工具拆分）

上面的手册按系统/数据库组织，回答"这台机器怎么管"；运维工具手册 按工具组织，回答"这件事用什么干、参数怎么调、坑在哪"。

一个工具一篇，共 66 篇，分 12 个分类：

每篇统一结构：它解决什么问题 → 安装与版本 → 核心用法 → 输出怎么读 → 实战场景 → 常见坑 → 速查表。 索引里还有一张"问题 → 工具"决策表（系统卡了、端口不通、丢包、磁盘满、502、证书到期等 17 种现象对应到具体工具）。

# 按现象速查
grep -n "端口不通" 运维工具手册/README.md
# 按工具找文件
ls 运维工具手册/*/ | grep -i tcpdump

运维监控软件手册（按软件拆分）

运维监控软件手册（共 25 篇、7 类）与上面的工具手册互补：工具手册讲 prometheus 命令怎么写，监控软件手册讲整套监控平台怎么部署、接数据、配告警、做容量规划，含选型决策表、典型组合方案与上线检查清单。分七类：

向量数据库手册（按产品拆分）

向量数据库手册（共 16 篇、4 类）覆盖专用向量库、现有数据库的向量能力、向量索引库与云托管服务。每篇统一 11 章：定位与选型 → 版本许可 → 安装 → 数据模型 → 完整 CRUD → 索引与检索进阶 → 生产运维 → 故障排障 → 避坑清单 → 速查表 → 参考；册首另附选型决策表、横向对比总表与「旧写法 → 当前写法」API 变动对照。

事实核实于 2026-11。向量库 SDK 变化快，抄旧教程前先看该册的「版本与 API 变动对照」；已有 PG / Redis / ES 实例的场景优先看 02 分类，通常不必新引入组件。