本文将详细向您介绍如何快速安装 IrisNode，让您能够顺利使用 IrisCloud 相关功能。

1、准备一台虚拟机机器

硬件要求：

     准备一台虚拟机机器，其系统配置需满足：采用 x86 架构，具备 4U 的计算资源（4U=4vCPU），配备 8G 的运行内存，以及拥有 50G 的磁盘空间用于存储各类数据及安装文件。

操作系统选择：

     操作系统选用 ubuntu22.04.1 版本。ubuntu 系统以其开源、稳定且社区支持丰富等特性，非常适合作为 IrisNode 的运行环境。您可以从 ubuntu 官方网站下载该版本的镜像文件，并按照常规的虚拟机安装流程，将 ubuntu22.04.1 系统安装到准备好的虚拟机中。安装过程中，请确保网络连接正常，以便系统自动安装必要的驱动和更新。

端口放行：

TCP：10000（API端口）、10002（链路TCP）、3200（tcp拨入端口）、9100（监控）

UDP：4500（加密隧道）、8472（默认vxlan端口）

链路GRE没有端口，需放行GRE协议

创建网络OpenVPN （TCP/UDP）：建议9000-9100 根据使用放行 TCP：9000-9100  UDP：9000-9100

2、下载一键安装脚本

获取脚本链接：

     点击下方链接下载一键安装脚本 node-installer.sh

https://download.iris-cloud.cn/irisnode/V2.1.0/node-installer.sh

上传脚本到虚拟机：

     下载完成后，您需要将该脚本上传到已安装好 ubuntu22.04.1 系统的虚拟机机器上。常见的上传方式有多种，如果您的虚拟机支持共享文件夹功能，可以将脚本文件放置在共享文件夹中，然后在虚拟机内访问共享文件夹并复制脚本到合适的目录，例如 “/home/user/”（这里 “user” 为您在 ubuntu 系统中创建的用户名）。若虚拟机不支持共享文件夹，也可以通过 SSH 连接配合 SCP 命令进行上传。

     首先，确保您在本地机器上安装了 SSH 客户端（如 PuTTY 等），然后使用 SCP 命令格式：scp 本地脚本文件路径 username@虚拟机 IP 地址:/home/user/ （将 “本地脚本文件路径” 替换为您实际下载脚本所在的路径，“username” 为虚拟机内的用户名，“虚拟机 IP 地址” 为虚拟机的网络 IP 地址）。输入虚拟机用户密码后，即可将脚本上传至虚拟机指定目录。

3、执行脚本

修改文件权限：

chmod 777 node-installer.sh

     上传完成后，打开虚拟机的终端。在终端中，先通过以下命令来修改下载下来的脚本文件权限，使其具备可执行权限。

     这里的 “chmod” 命令用于改变文件或目录的权限，“777” 表示赋予文件所有者、所属组以及其他用户读、写、执行的全部权限，以确保脚本能够顺利执行。  

执行安装脚本：

./node-installer.sh

      权限修改完成后，在同一终端中执行以下命令来启动 IrisNode 的安装过程：

     执行该命令后，请耐心等待安装过程完成。期间，脚本会自动下载并配置 IrisNode 运行所需的各类依赖组件、软件包等。安装过程中，终端可能会输出一些信息，包括下载进度、安装步骤等提示，这属于正常现象。如果安装过程中出现任何错误提示，请仔细阅读错误信息，通常可能是网络连接问题、系统缺少某些必备组件等原因导致，您可以根据具体错误提示进行相应的排查和解决。

4、检查环境

查看容器状态：

docker ps

     当安装脚本执行完毕后，需要检查 IrisNode 的运行环境是否正常启动。

     在虚拟机终端中执行命令：“docker ps” 命令用于列出当前正在运行的 Docker 容器。IrisNode 正常安装完成后，应该可以看到四个相关的容器已经成功启动并处于运行状态。这四个容器分别承担着 IrisNode 不同的功能模块。如果容器状态显示正常，说明 IrisNode 已经安装完成，可以进入下一步使用环节。

若容器未正常启动的排查方法：

     如果执行 “docker ps” 命令后，发现四个容器并未全部启动，或者部分容器处于异常状态（如 Exited 等），您可以通过执行 “docker logs 容器 ID”（将 “容器 ID” 替换为实际未正常启动容器的 ID，可通过 “docker ps -a” 命令查看所有容器包括未运行容器的详细信息来获取容器 ID）来查看容器的日志信息，日志中通常会记录容器启动失败的原因，例如可能是某个依赖服务未正确配置、端口冲突等。根据日志提示的错误信息，进行针对性的修复，例如重新配置相关服务参数、更换未被占用的端口等，然后再次尝试启动容器（可通过 “docker start 容器 ID” 命令启动单个容器，或者重新执行安装脚本来尝试重新安装和启动所有相关容器）。

四、使用 IrisNode

     当通过 “docker ps” 命令确认四个容器均已正常启动，即 IrisNode 已经安装完成。此时，您可以前往 IrisCloud 页面开始具体使用 IrisNode 的各项功能。关于如何在 IrisCloud 页面快速创建和使用相关资源等详细操作，请查看《IrisCloud 快速创建使用》文档，该文档中有更为详尽的步骤说明和操作指南，以帮助您充分利用 IrisNode 为您带来的便捷服务。