Linux iscsiadm 命令详解:iSCSI 存储连接管理、发现、登录与挂载实战

发布时间:2026/10/2 8:16:36
Linux iscsiadm 命令详解:iSCSI 存储连接管理、发现、登录与挂载实战 文档教程【免费下载链接】linux-commandLinux命令大全搜索工具内容包含Linux命令手册、详解、学习、搜集。https://git.io/linux项目地址https://gitcode.com/GitHub_Trending/linux/linux-command点击查看免费下载iSCSIInternet Small Computer System Interface是一种基于 IP 网络的块级存储协议它允许客户端initiator启动器通过网络直接访问远端服务器target目标器上的磁盘把远端磁盘当作本地硬盘使用。本文基于 iscsiadm 命令文档 完整讲解 iscsiadm 的安装配置、语法选项与工作模式并通过「发现 → 登录 → 查看会话 → 退出 → 分区格式化挂载」的全流程实战让你掌握在 Linux 上挂载 NAS 或存储阵列 iSCSI 磁盘的完整技能文中同时结合本仓库中 lsblk、fdisk、mkfs、mount、df 等命令文档打通从网络存储连接到本地文件系统使用的整条链路。一、iSCSI 与 iscsiadm 简介iscsiadm 命令是 open-iscsi 工具集提供的命令行管理工具用于管理 iSCSI 存储连接。iSCSI 是一种基于网络的存储协议允许在计算机之间传输块级别的数据即以磁盘扇区为粒度的读写而不是文件级别。iscsiadm 命令提供了与 iSCSI 存储设备进行连接、配置和管理的功能主要职责包括向 iSCSI 目标器target发送**发现discovery**请求枚举网络上可用的存储设备登录login或退出logout已发现的 iSCSI 目标管理本机已建立的 iSCSI 会话session与网络接口iface持久化记录发现的节点信息便于后续重连与开机自动挂载。iSCSI 存储连接通常由两个角色组成Initiator启动器发起连接请求的一端即当前 Linux 主机通过 iscsiadm 管理Target目标器提供存储资源的一端通常是 NAS如 Synology、QNAP、SAN 存储阵列或软件定义的 iSCSI 目标服务导出名为iqn.*iSCSI Qualified Name的目标标识符。二、安装与初始化配置在绝大多数 Linux 发行版上iscsiadm 由iscsi-initiator-utilsRHEL/CentOS 系列或open-iscsiDebian/Ubuntu 系列软件包提供。安装与基础配置命令如下yum install iscsi-initiator-utils #安装iscsiadmRHEL/CentOS 系列 # Debian/Ubuntu 系列使用 # apt-get install open-iscsi /etc/iscsi/initiatorname.iscsi #iscsi启动器名称配置文件位置 systemctl enable iscsi #设置服务开机启动 systemctl enable iscsid systemctl restart iscsi #重启iscsi服务 systemctl restart iscsid关键说明/etc/iscsi/initiatorname.iscsi文件用于配置本机 initiator 的名称IQN格式形如InitiatorNameiqn.1994-05.com.redhat:xxxx。部分存储设备如不少 NAS会基于 initiator 名称做 ACL 访问控制或 CHAP 认证白名单因此若目标存储端限制了允许连接的 initiator需要在此文件中把名称改成存储端注册过的值然后重启iscsid服务使其生效。iscsi与iscsid是相互关联的两个 systemd 服务iscsid是后台守护进程daemon负责处理登录、会话维护等内核交互iscsi服务负责按持久化配置自动执行发现与登录。修改配置或首次安装后通常需要同时重启二者。服务管理使用的systemctl enable / restart是 systemd 体系的标准操作详细说明可参考仓库中的 systemctl 命令文档。三、语法与选项详解iscsiadm 的基本语法为iscsiadm [选项] 命令 参数其核心是-m/--mode指定的工作模式不同模式下配合不同的选项完成对应操作。各选项说明如下-m--mode # 模式 指定工作模式如discovery发现模式、node管理节点、session管理会话、discoverydb、host、iface管理 iSCSI 网络接口 -t--type # 指定类型如sendtargets (或st)、isns、fw仅用于discovery模式 -T--targetname # 指定目标名称仅用于node模式 -p--portal # ip:port 指定目标IP,不带端口默认使用3260仅用于discovery、node模式 -l--login # 登录一个iSCSI设备仅用于discovery、node模式 -u--logout # 退出一个iSCSI设备仅用于node、session模式 -I--interface # 指定用于iSCSI操作的网络接口 -P--print # 0-4 打印详细用于discovery、node、session模式 -s--stats # 查看会话状态 -h--help # 显示帮助 -V--version # 显示版本信息。逐项展开说明-m, --modeiscsiadm 的入口模式开关决定了后续操作对象。常见取值包括discovery发现模式用于探测目标端导出的 iSCSI 设备node节点模式管理已发现/已记录的目标节点执行登录、退出、删除等操作session会话模式查看和管理当前已建立的会话iface网络接口模式管理 iSCSI 使用的网络接口用于多网卡、多路径等场景discoverydb管理持久化的发现记录host查看主机相关信息。-t, --type仅用于 discovery 模式指定发现方式常用sendtargets可简写为st向目标端发送 SendTargets 请求以枚举其导出的 target此外还有isns通过 iSNS 服务器发现与fw固件发现。-T, --targetname仅用于 node 模式指定要操作的目标名称IQN如iqn.2000-01.com.synology:NAS.target.1。-p, --portal指定目标端 IP可带端口格式ip:port。不带端口时默认使用 iSCSI 标准端口3260仅用于 discovery、node 模式。-l, --login登录目标仅用于 discovery、node 模式。在 discovery 模式下使用会直接登录发现到的目标在 node 模式下配合-T与-p登录指定目标。-u, --logout退出断开已登录的设备仅用于 node、session 模式。-I, --interface指定用于 iSCSI 操作的网络接口适用于多网卡绑定或需要固定源 IP 的场景配合iface模式管理。-P, --print打印详细级别取值0-4数值越大输出越详细用于 discovery、node、session 模式。-s, --stats查看会话的统计信息如读写字节数。-h, --help与-V, --version分别显示帮助与版本信息。提示iscsiadm --help会按模式分组列出完整选项实际使用时可将-m与-P、-p等组合成一条命令例如iscsiadm -m session -P 3查看会话的详细参数。四、实战全流程从发现目标到挂载使用以下实战以一台 CentOS 主机主机名Azroy-s1连接一台 Synology NAS 导出的 iSCSI 目标为例覆盖完整生命周期。4.1 发送发现请求列出可用的 iSCSI 目标[rootAzroy-s1 ~]# iscsiadm -m discovery -t st -p 10.10.10.10 10.10.10.10:3260,1 iqn.2000-01.com.synology:NAS.default-target.1命令解析-m discovery进入发现模式-t st使用 sendtargets 方式-p 10.10.10.10指定目标端 IP未带端口默认使用 3260。输出第一列10.10.10.10:3260,1是 portalIP、端口与 portal 组号第二列iqn.2000-01.com.synology:NAS.default-target.1是目标端导出的 target 名称IQN。4.2 登录到发现的 iSCSI 目标[rootAzroy-s1 ~]# iscsiadm -m node -T iqn.2000-01.com.synology:NAS.target.1 -p 10.10.10.10 -l Logging in to [iface: default, target: iqn.2000-01.com.synology:NAS.target.1, portal: 10.10.10.10,3260] (multiple) Login to [iface: default, target: iqn.2000-01.com.synology:NAS.target.1, portal: 10.10.10.10,3260] successful.命令解析-m node进入节点管理模式-T指定目标 IQN-p指定 portal-l执行登录。成功输出中(multiple)表示使用多路径/多连接方式尝试Login ... successful.表示该条连接登录成功。登录成功后目标磁盘会以 SCSI 磁盘的形式出现在系统中通常为/dev/sdX。注意node 模式下使用的 IQN 应与 discovery 结果中的名称保持一致实例中NAS.target.1即发现到的目标。若目标端启用了 CHAP 认证还需要在/etc/iscsi/iscsid.conf或对应节点记录中配置node.session.auth.username与node.session.auth.password再重新登录。4.3 查看已登录的会话与设备[rootAzroy-s1 ~]# iscsiadm -m session tcp: [3] 10.10.10.10:3260,1 iqn.2000-01.com.synology:NAS.target.1 (non-flash)iscsiadm -m session列出所有已建立的 iSCSI 会话tcp表示传输协议[3]为会话编号sid随后是 portal 与目标 IQN括号中的(non-flash)表示目标磁盘为非闪存介质。会话建立后可在本地设备层面确认新出现的磁盘。使用 lsblk 查看块设备列表[rootAzroy-s1 ~]# lsblk NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT sda 8:0 0 1.8T 0 disk ├─sda1 8:1 0 1G 0 part /boot └─sda2 8:2 0 1.8T 0 part ├─centos-root 253:0 0 1.8T 0 lvm / └─centos-swap 253:1 0 5.9G 0 lvm [SWAP] sdb 8:32 0 10G 0 disk新增的sdb10G即为通过 iSCSI 挂载上来的远端磁盘。确认它确实走的是 iSCSI 传输可用lsblk -S查看磁盘的传输类型TRAN 列为iscsi[rootAzroy-s1 ~]# lsblk -S /dev/sd* #可以查看硬盘传输类型 NAME HCTL TYPE VENDOR MODEL REV TRAN sda 0:1:0:0 disk HP LOGICAL VOLUME 3.00 sas sdb 12:0:0:1 disk SYNOLOGY Storage 4.0 iscsi从输出可以看到本地sda的传输类型为sas而 iSCSI 挂载的sdb其 VENDOR 为SYNOLOGY、TRAN 为iscsi直观印证了远端存储的身份。lsblk的更多选项如-a显示所有设备、-m显示权限信息、-nl无标题列表输出等可参考 lsblk 命令文档。4.4 退出已登录的设备[rootAzroy-s1 ~]# iscsiadm -m node -T iqn.2000-01.com.synology:NAS.target.1 -p 10.10.10.10 -u Logging out of session [sid: 11, target: iqn.2000-01.com.synology:NAS.target.1, portal: 10.10.10.10,3260] 或 [rootAzroy-s1 ~]# iscsiadm -m session -u #退出所有iscsi会话两种退出方式iscsiadm -m node -T iqn -p portal -u退出指定目标的会话iscsiadm -m session -u一次退出当前主机上的所有 iSCSI 会话适合统一清理。退出后对应的/dev/sdb设备将从系统中消失因此执行退出前务必先卸载umount其上挂载的文件系统。4.5 分区、格式化与挂载登录成功后目标磁盘在本地表现为一块普通的裸盘可以像本地磁盘一样分区、格式化并挂载使用。1查看磁盘基本信息[rootAzroy-s1 ~]# fdisk -l /dev/sdb 磁盘 /dev/sdb10.7 GB, 10737418240 字节20971520 个扇区 Units 扇区 of 1 * 512 512 bytes 扇区大小(逻辑/物理)512 字节 / 512 字节 I/O 大小(最小/最佳)512 字节 / 512 字节fdisk -l显示磁盘容量、扇区数与扇区大小等参数。若需要交互式创建分区输入n新建、p打印分区表、w保存退出可使用fdisk /dev/sdb具体交互流程详见 fdisk 命令文档。2创建文件系统格式化mkfs.ext4 /dev/sdb # 或将 sdb 分区为 sdb1 后执行 mkfs.ext4 /dev/sdb1mkfs本身不直接建立文件系统而是调用对应的格式化程序如mkfs.ext4执行可通过-t指定文件系统类型详见 mkfs 命令文档。对 iSCSI 网络盘建议使用 ext4、xfs 等日志型文件系统以增强数据一致性。3挂载目录mkdir /iscsi-data mount /dev/sdb /iscsi-data df -hdf -h以易读方式确认挂载结果与容量信息其选项详见 df 命令文档。临时挂载用mount即可若需要开机自动挂载可参照 mount 命令文档 中的方法把对应行建议使用 UUID 而非设备名避免 iSCSI 盘设备号漂移写入/etc/fstab。4.6 持久化与会话恢复iscsiadm 发现并登录过的目标会被持久化记录在/etc/iscsi/下的节点数据库中/var/lib/iscsi/nodes/等目录因此重启后执行iscsiadm -m node可以查看历史记录的目标结合systemctl enable iscsi设置的开机自启主机重启后iscsi服务会自动按记录重新登录目标配合/etc/fstab实现整盘自动挂载若要彻底移除某条记录可使用iscsiadm -m node -T iqn -p portal -o delete。五、典型应用场景与注意事项5.1 典型场景NAS 扩容将 NASSynology/QNAP 等或商用存储阵列导出的 iSCSI LUN 挂载到服务器扩展数据卷服务器迁移/共享存储多个服务器共享同一块 iSCSI 磁盘需注意文件系统层面的并发冲突通常搭配集群文件系统或分布式文件系统使用多路径MPIO配合-I/--interface与 iface 模式配置多网卡配合 device-mapper-multipath 实现链路冗余与负载均衡。5.2 注意事项登录前确认认证配置目标端启用 CHAP 时需在/etc/iscsi/iscsid.conf或节点级记录配置用户名/密码否则Login会失败先卸载再退出退出会话前必须umount相关挂载点否则可能造成数据丢失或设备繁忙报错iSCSI 盘是网络设备性能与稳定性依赖底层网络建议使用独立存储网络/千兆以上链路网络抖动可能触发会话超时重连设备名不稳定重启后 iSCSI 盘对应的/dev/sdX可能变化持久化配置应尽量使用 UUID 或文件系统标签iscsiadm -m session -u会退出所有会话在有多会话环境执行前应确认影响范围。六、总结iscsiadm 是 Linux 下管理 iSCSI 存储连接的核心工具通过-m模式区分 discovery发现、node节点、session会话、iface接口等操作对象配合-t/-T/-p/-l/-u等选项即可完成「发现目标 → 登录 → 会话管理 → 退出」的完整生命周期管理。将 iscsiadm 与本仓库中的 lsblk、fdisk、mkfs、mount、df、systemctl 命令组合使用即可在服务器上完成从远端存储发现、登录到本地分区、格式化、挂载、开机自启的整套磁盘接入方案这也是虚拟化宿主机、数据库服务器与 NAS 扩容场景中必备的运维技能。赞分享文档教程【免费下载链接】linux-commandLinux命令大全搜索工具内容包含Linux命令手册、详解、学习、搜集。https://git.io/linux项目地址https://gitcode.com/GitHub_Trending/linux/linux-command点击查看免费下载相关推荐Linux nmcli 网络管理命令详解NetworkManager 命令行配置静态 IP 与连接管理实战Linux nmcli 网络管理命令详解NetworkManager 命令行配置静态 IP 与连接管理实战 导读 nmcli 是 NetworkManager文档教程macOS高效存储革命智能iSCSI连接实战指南在数字化工作场景日益普及的今天macOS用户对远程存储的需求正以前所未有的速度增长。iSCSI Initiator作为专业的存储连接工具为Mac用户打开了通存储驱动开发网络3 步跑通 N_m3u8DL-RE让流媒体下载变成一句话的事3 步跑通 N_m3u8DL RE让流媒体下载变成一句话的事 手里有一条 MPD、M3U8 或 ISM 的流地址却不知道 m3u8 下载方法只能眼睁睁看着CLI音视频上一篇Mac Mouse Fix 终极上手指南把普通鼠标调校出苹果触控板的顺滑手感下一篇ik_llama.cpp 的 llama-gguf-hash 实战指南GGUF 模型逐层张量哈希、UUIDv5 生成与 Manifest 校验创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

关于本文作者

来自尧图内容编辑团队

尧图内容编辑团队 内容团队

尧图内容编辑团队

本文由尧图网络内容编辑团队执笔。团队由资深项目经理、前端工程师与设计师组成,所有内容均来自亲手交付的真实项目,先讲清问题、再给出可落地的解法。尧图深耕北京网站建设十年,服务过京华建材集团、智造科技等各行业客户,把一线经验沉淀为可复用的行业观察。

  • 十年建站经验,覆盖建材、制造、服务、文创等
  • 项目经理把关选题与事实准确性
  • 工程师与设计师联合撰写专业细节
  • 统一编辑规范,保证文风与排版一致
  • 每月复盘转化数据,迭代选题方向

延伸阅读

相关资讯与近期热门内容

深度阅读推荐

建站决策前值得细读的三篇

网站改版的5个关键决策
2024-08-12

网站改版的5个关键决策

什么时候该改版、改到什么程度、如何避免流量掉光,京华建材集团改版复盘给出答案。

获取专属建站方案

看完文章,把您的行业与预算告诉我们,免费获取一份量身定制的官网建设方案与报价。

立即免费咨询