Linux搭建iSCSI目标端教程详解

本文深入解析了在Linux系统中搭建iSCSI Target时高频遇到的四大典型故障及其根因：包括targetcli创建LUN时报“Target not found”（实为未加载iscsi_target_mod模块且未初始化配置树）、客户端连接超时（源于iSCSI服务未真正监听3260端口、防火墙拦截或portal绑定不当）、登录后fdisk无法识别新磁盘（关键在于initiator侧缺失SCSI总线重扫机制），以及配置重启失效（根源是configfs未挂载、target.service未启用或saveconfig未被systemd自动加载）。文章不仅给出精准命令级解决方案，更揭示了模块依赖、内核子系统联动与systemd服务协同等底层逻辑，帮助运维人员跳出“试错式排障”，真正理解iSCSI Target稳定运行的必要条件。

targetcli 创建 LUN 时提示 Target not found

这是因为 targetcli 启动后默认不自动加载内核模块，也没初始化配置树。得手动载入 iscsi_target_mod 并进入 shell 初始化：

• 运行 sudo modprobe iscsi_target_mod（检查是否已加载可用 lsmod | grep iscsi）
• 执行 sudo targetcli 进入交互环境
• 输入 ls，如果看到空或报错，立刻执行 cd / → create（这步会生成默认 backstore 和 target）
• 别跳过 saveconfig，否则重启后整个配置丢失

Linux 客户端用 iscsiadm 登录时报 connection timed out

大概率是防火墙或服务没真正监听。iSCSI Target 默认走 TCP 3260 端口，但 targetcli 不等于自动启动了 iSCSI 服务进程：

• 确认 targetcli 里已启用 portal：执行 ls /iscsi，看到类似 iqn.2003-01.org.linux-iscsi.xxx.x8664:sn.1234567890ab 后，进入该 target → ls → 检查 tpg1/portals/ 下是否有 0.0.0.0:3260 或具体 IP
• 若 portal 是 0.0.0.0:3260，但服务器有多个网卡，建议显式绑定到业务网卡 IP，避免被防火墙规则误拦
• 运行 sudo ss -tlnp | grep :3260，必须看到 target_core_mod 或 ksmbd（旧版可能显示为 -）在监听；没输出就说明服务未生效
• 临时关防火墙验证：sudo ufw disable（Ubuntu）或 sudo systemctl stop firewalld（CentOS/RHEL）

客户端映射后 fdisk -l 看不到新磁盘

不是服务端问题，而是 initiator 侧未触发 SCSI 总线重扫。Linux 内核不会自动发现新 LUN，尤其当 target 已在线、只是新增了 LUN 时：

• 先确认登录成功：iscsiadm -m session -P 3 | grep "Attached scsi disk"，应有类似 sdb 的输出
• 如果没有，运行 sudo iscsiadm -m node -R 强制重读节点配置，再 sudo iscsiadm -m session --rescan
• 如果已有设备名但 fdisk -l 不显示，执行 sudo echo "- - -" > /sys/class/scsi_host/host*/scan（注意引号和空格）
• 某些发行版（如 RHEL 8+）默认禁用 scsi_mod 的动态扫描，需确保 /etc/iscsi/iscsid.conf 中 node.session.scan 设为 auto

targetcli 配置保存后重启失效

targetcli 的 saveconfig 只写入 JSON 文件，默认路径是 /etc/target/saveconfig.json，但系统启动时不自动加载——得靠 target.service 驱动：

• 检查服务状态：systemctl status target，常见问题是服务未启用或失败（比如依赖 configfs 未挂载）
• 确认 configfs 已挂载：mount | grep configfs，没有就手动 sudo mount -t configfs none /sys/kernel/config，并写入 /etc/fstab
• 启用开机自启：sudo systemctl enable target，然后 sudo systemctl restart target
• 注意：targetcli 修改配置后，必须退出再进、或执行 refresh，否则 saveconfig 可能写入旧快照

配置看似简单，但每个环节都依赖底层模块加载顺序和内核子系统联动。最容易被忽略的是 configfs 挂载和 target 服务的 systemd 依赖关系——缺一不可，且无法靠日志一眼识别。

本篇关于《Linux搭建iSCSI目标端教程详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！