「Ubuntu 22.04/24.04 连接绿联 NAS iSCSI LUN」的最简操作手册，全部步骤在 5 min 内可完成，已验证通过。
（如你用的是 20.04，命令完全一致）

---

1. 绿联 NAS 端准备（只需做一次）

---

1. 应用中心 → 安装「SAN 管理」→ 打开后切到「LUN」页
2. 新增 LUN：
   • 类型：Thick（厚置备）或 Thin 均可，容量按需要填
   • 名称随意，例如 ubuntu-lun01
3. 切到「Target」页 → 新增 Target：
   • 把刚建的 LUN 勾上 → 下一步
   • 如果启用了 CHAP，记住「用户名/密码」；不用就留空 → 保存
4. 记录 Target 的 IQN（页面会显示，格式类似
   iqn.2000-01.com.ugreen:target.ubuntu-lun01）与 NAS 的 IP（例如 192.168.1.100）

---

2. Ubuntu 客户端操作

---

2.1 安装 initiator

bash

复制

sudo apt update
sudo apt install open-iscsi         # 20.04+ 统一包名
sudo systemctl enable --now open-iscsi

2.2 发现目标（把 IP 换成你的 NAS）

bash

复制

sudo iscsiadm -m discovery -t st -p 192.168.1.100

正常会回显一行 IQN，与 NAS 端一致即发现成功

。

2.3 登录（无 CHAP 可跳过粗体部分）

bash

复制

# 如启用了 CHAP，先写入账号密码
sudo iscsiadm -m node -T iqn.2000-01.com.ugreen:target.ubuntu-lun01 \
              -p 192.168.1.100 --op update \
              -n node.session.auth.authmethod -v CHAP
sudo iscsiadm -m node -T iqn.2000-01.com.ugreen:target.ubuntu-lun01 \
              -p 192.168.1.100 --op update \
              -n node.session.auth.username -v <用户名>
sudo iscsiadm -m node -T iqn.2000-01.com.ugreen:target.ubuntu-lun01 \
              -p 192.168.1.100 --op update \
              -n node.session.auth.password -v <密码>

# 正式登录
sudo iscsiadm -m node -T iqn.2000-01.com.ugreen:target.ubuntu-lun01 \
              -p 192.168.1.100 --login

看到 Login successful 即连接成功 。

2.4 检查新磁盘

bash

复制

sudo fdisk -l | grep -i "Disk /dev/sd"      # 会多一块 /dev/sdb（或 sdc）

设备名重启后可能漂移，建议后续用 /dev/disk/by-path/ip-*-lun-1 或 UUID 挂载 。

2.5 分区-格式化（仅第一次）

bash

复制

# 举例整个盘一个区
sudo fdisk /dev/sdb    # 依次 n → p → 1 → 回车 → w
sudo mkfs.ext4 /dev/sdb1

2.6 手动挂载测试

bash

复制

sudo mkdir /mnt/ugreen-lun
sudo mount /dev/sdb1 /mnt/ugreen-lun
df -h                  # 确认容量正确

2.7 开机自动挂载（可选）
先用 blkid /dev/sdb1 取 UUID，然后在 /etc/fstab 追加一行：UUID=xxxx-xxxx-xxxx /mnt/ugreen-lun ext4 _netdev 0 0

_netdev 是关键，告诉系统等网络就绪再挂载，防止启动时挂空 。

---

3. 常用运维命令

---

• 查看会话
  • sudo iscsiadm -m session -P 3
• 临时断开（不掉分区）
  • sudo iscsiadm -m node -T <IQN> -p <IP> --logout
• 彻底删除节点
  • sudo iscsiadm -m node -T <IQN> -p <IP> --op delete
• 添加新节点
  • sudo iscsiadm -m node -T <IQN> -p <IP> --op new

---

4. 排坑速查

---

1. 登录失败报 authentication failure → 检查 CHAP 用户名/密码与 NAS 端是否一致，区分大小写。
2. 登录成功但 fdisk 看不到盘 → 确认 LUN 已映射到该 Target；绿联端「Target 详情」里能看见 LUN 列表。
3. 重启后没自动挂载 → 检查 /etc/fstab 有没有 _netdev；并用 systemctl status open-iscsi 确认服务已启动。
4. 设备名变掉 → 用 UUID 或 /dev/disk/by-path/... 挂载，避免写成固定 /dev/sdb。

完成以上步骤后，Ubuntu 就把绿联 NAS 的 iSCSI LUN 当作本地硬盘用了

问题处理：

添加节点：sudo iscsiadm -m node -T iqn.2025-03.com.ugreen:target-2.661c00dd42 \ -p 120.76.251.151:3260 –op new