targetcli

targetcli iSCSI 目标管理

补充说明

targetcli 配置 Linux LIO iSCSI target，把本地磁盘、文件或 LVM 卷导出为 iSCSI LUN，供其他主机挂载。常用于共享存储和虚拟化。

核心对象：backstore、target、tpg、lun、acl、portal。

常用示例

进入交互界面：

targetcli

创建文件后端：

/backstores/fileio create name=disk1 file_or_dev=/data/disk1.img size=100G

创建 target 和 LUN：

/iscsi create iqn.2026-10.com.example:storage
/iscsi/iqn.2026-10.com.example:storage/tpg1/luns create /backstores/fileio/disk1

配置 ACL 和门户：

/iscsi/iqn.2026-10.com.example:storage/tpg1/acls create iqn.2026-10.com.example:client1
/iscsi/iqn.2026-10.com.example:storage/tpg1/portals create 0.0.0.0 3260

保存配置：

targetcli saveconfig
systemctl enable --now target

客户端发现和登录：

iscsiadm -m discovery -t sendtargets -p 10.0.0.10
iscsiadm -m node -T iqn.2026-10.com.example:storage -l

易错点与排错

• 没有配置 ACL，客户端无法登录。
• portal 绑定错误网卡或防火墙未放行 3260。
• backstore 文件所在磁盘满，LUN 写入失败。
• 多客户端同时写同一 LUN，文件系统损坏。
• 修改配置后没有 saveconfig，重启丢失。
• CHAP 认证配置不一致，登录失败。
• 客户端缓存旧 target，重新发现前先清理 node 记录。