cephadm是官方推荐的部署工具，替代已弃用的ceph-deploy；bootstrap失败主因是镜像拉取超时，应配置国内镜像源或改用quay.io；osd激活失败多因磁盘残留元数据，须用ceph-volume lvm zap清理；时间同步偏差超0.05s会导致mon共识失败。
别用 ceph-deploy —— 它已弃用，且默认不推包，90% 的初始化失败都卡在这一步。 新集群直接上 cephadm；若必须兼容旧系统（如 CentOS 7），则选 v16（Pacific）镜像并确认内核 ≥ 3.10，同时手动配好国内镜像源。
cephadm bootstrap 失败：Failed to pull image docker.io/ceph/ceph:v17
这不是配置写错，是网络拉不到国外镜像。cephadm 默认优先调用 podman，其次才是 docker，而 docker.io 在国内常超时或被重置。
- 提前在所有节点的
/etc/docker/daemon.json或/etc/containers/registries.conf中配置阿里云或腾讯云镜像加速器 - 改用更稳定的源：
cephadm bootstrap --mon-ip <code>192.168.10.10--image quay.io/ceph/ceph:v17 - 若仍失败，先手动拉一次：
sudo podman pull quay.io/ceph/ceph:v17 - 老系统（如 CentOS 7）内核不满足 v17 要求（≥ 5.4），必须降级：
--image quay.io/ceph/ceph:v16
OSD 创建卡在 activating 状态，ceph -s 显示 HEALTH_WARN
根本不是磁盘坏，而是 Ceph 拒绝复用有残留元数据的设备。哪怕只用过一次 LVM、fdisk 分过区，或之前挂载过，都会触发 bluestore 初始化失败。
Linux Ai Server
下载
Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI，零 GUI 开销。
- 务必用官方清理命令：
sudo ceph-volume lvm zap /dev/sdb --destroy（比dd更彻底，会清 LVM label、GPT header、filesystem sig） - 确认设备未被占用：
lsblk和sudo pvs都不应显示该盘；sudo blkid /dev/sdb应无输出 - 若用目录方式（
--data /var/lib/ceph/osd/ceph-0），确保目录属主是ceph:ceph，权限为0755 - 查日志看真实原因：
journalctl -u ceph.target -f | grep -E "(bluestore|device is busy)"
cephfs 挂载报错：mount error 5 = Input/output error
常见于内核不支持 msgr2 协议（v16+ 默认启用），尤其 Ubuntu 18.04 / CentOS 7 默认内核版本偏低。
- 临时方案：降级协议，挂载时加选项：
mount -t ceph <code>192.168.10.10:6789:/ /mnt/cephfs -o name=admin,secretfile=/etc/ceph/admin.secret,ms_mode=prefer-crc - 推荐方案：换用
ceph-fuse（用户态，不依赖内核模块）：ceph-fuse -n client.admin -r / /mnt/cephfs - 验证内核支持：
zgrep CONFIG_CEPH_FS /proc/config.gz（若无，说明未编译 CephFS 支持）
最容易被忽略的是时间同步精度——clock skew detected on mon 不只是警告，会导致 monitor 无法达成 Paxos 共识，整个集群 hang 住。别只跑 ntpdate 一次，必须启用 chronyd 或 ntpd 持续校准，且所有节点 drift 要控制在 0.05s 内。
