麒麟系统iSCSI服务开启与远程存储连接方法

必须先安装targetcli、启动target服务、放行3260端口、构建backstore/Target/LUN结构并验证发现，否则iSCSI存储共享无法生效。

在银河麒麟操作系统中配置远程存储访问时，一个常见的问题是iSCSI服务未启用，导致存储提供方（Target端）与连接方（Initiator端）均无法正常工作。以下步骤将详细说明如何逐步启用该服务。

一、安装iSCSI目标管理工具targetcli

工欲善其事，必先利其器。在银河麒麟上配置iSCSI Target，核心工具是targetcli，它负责创建和管理后端存储、定义Target标识以及LUN映射，缺少该工具则流程无法进行。通常需要手动安装。

首先，使用root权限登录系统，运行安装命令：sudo yum install targetcli -y。

安装完成后，验证安装结果：targetcli --version。若返回版本号，表明安装成功。

若出现“command not found”提示，则可能是软件源配置问题。此时应检查仓库列表：sudo yum repolist，确保正确的源已启用。

二、启动并启用target服务

需注意：安装了targetcli配置工具，并不等于iSCSI Target服务已运行。实际服务由target这个systemd服务提供，只有启动它，服务端才能监听并响应客户端连接请求。

启动服务的命令为：sudo systemctl start target。

为自动恢复运行，还需设置开机自启：sudo systemctl enable target。

最后，确认服务状态：sudo systemctl status target | grep "active (running)"。出现“active (running)”字样即表示运行正常。

若显示红色的failed或inactive，切勿跳过！表明服务启动失败，可能由依赖缺失或端口冲突引起，必须先行解决。

三、配置防火墙放行iSCSI端口

服务运行后，网络通路需畅通。iSCSI协议默认使用TCP 3260端口通信。银河麒麟SP3/SP2等版本中，默认firewalld防火墙可能拦截此端口。

放行端口分两步：首先，永久添加规则：sudo firewall-cmd --permanent --add-port=3260/tcp。

然后，重载防火墙配置使规则立即生效：sudo firewall-cmd --reload。

操作完成后，验证端口监听情况：sudo ss -tlnp | grep :3260。若能看到target进程在监听3260端口，说明网络层准备就绪。

注意：若服务器配置了多个IP地址，需确保监听地址包含客户端可访问的IP，而非仅限于127.0.0.1（本地回环地址）。

四、创建基础iSCSI Target结构

基础环境完成后，进入核心配置环节。需在targetcli交互式环境中构建完整iSCSI资源树，包括后端存储（backstore）、Target对象（用唯一IQN标识）、LUN映射，并可设置访问控制（ACL）。

启动配置界面：sudo targetcli。

在出现的 /> 提示符下，依次执行以下命令：

1. 创建一个5GB大小的文件作为后端存储：/backstores/fileio create kylin_disk /root/iscsi-disk.img 5G

2. 创建iSCSI Target，注意IQN格式规范：/iscsi create iqn.2026-05.com.kylin:storage

3. 将后端存储映射为Target下的LUN：/iscsi/iqn.2026-05.com.kylin:storage/tpg1/luns create /backstores/fileio/kylin_disk

4. 所有配置完成后，执行sa veconfig保存，然后exit退出。

五、验证Target可被客户端发现

配置完成后，需从客户端视角验证服务可用性。若客户端无法发现Target，则此前工作无效。

在另一台作为客户端的银河麒麟机器上，执行发现命令（将IP地址替换为服务器实际IP）：sudo iscsiadm -m discovery -t st -p 192.168.24.158。

若正常，命令应返回类似 192.168.24.158:3260,1 iqn.2026-05.com.kylin:storage 的结果，其中包含创建的Target IQN。

若命令无输出或提示“connection refused”，则需回溯排查。重点检查第二步的target服务状态和第三步的防火墙规则，这两步是连接失败的常见原因。