本页内容
- 前置条件
- 在 Rocky Linux 9 上安装 Teleport
- 配置 Teleport 服务器
- 添加 Teleport 用户
- 通过命令行管理 Teleport 集群
- 向 Teleport 集群添加节点 通过 Teleport 管理仪表盘添加节点 手动添加节点
- 结论
- 通过 Teleport 管理仪表盘添加节点
- 手动添加节点
Teleport 是一个开源工具,可用作你全球基础设施的访问平面(access plane)。它为多种服务提供零信任(zero-trust)访问,例如服务器、Kubernetes 集群、数据库服务器,以及 AWS Management Console、CI/CD、版本控制、桌面等 DevOps 应用。Teleport 是访问的单一信息源(single source of truth),并在你的整个基础设施中保持同步。Teleport 通过提供单一网关来访问你的全球计算基础设施,从而消除对 VPN 的需求。它是一个身份原生的访问代理(Identity-Native Access Proxy),可让你安全地访问基础设施。Teleport 已通过 Cure53 和 Doyensec 等安全公司的公开审计。Teleport 目前已被 Samsung、NASDAQ、IBM、Epic Games 等众多公司在生产环境中部署和使用。
在本教程中,你将通过 Teleport 在 Rocky Linux 9 服务器上搭建并保护一套用于你基础设施的访问平面。你将安装 Teleport、初始化 Teleport 集群(Teleport Cluster)、启用 Teleport Web Service、添加一个 Teleport 用户,然后通过不同方法将节点/服务器(Nodes/Servers)添加到 Teleport 集群。
完成本教程后,你将拥有一套只能通过 Teleport 访问的安全服务器基础设施。此外,你可以在本地节点/服务器上禁用 SSH 访问。
前置条件
要完成本教程,你必须满足以下要求:
- 一台 Rocky Linux 9 服务器 —— 本示例使用主机名(hostname)为 ' teleport-rocky '、服务器 IP 地址为 '192.168.5.100 ' 的 Rocky Linux。
- 一个具有 sudo/root 管理员权限的非 root 用户。
- 一个指向你服务器 IP 地址的域名。
- 生成 SSL 证书 —— 你可以通过 Certbot 和 Letsencrypt 生成免费的 SSL 证书。
- SELinux 运行在 permissive(宽松)模式。
- 双因素认证(Two Factor Authentication)应用 —— 桌面端你可以使用带有 2FA 插件的 KeepassXC。手机用户可以使用 Aegis(Android 用户)或 Google Authentication(iOS 用户)。
你还需要额外的服务器/节点来添加到 Teleport 集群。你可以使用任何 Linux 发行版,但本示例使用两台额外的 Rocky Linux 服务器,主机名(hostname)分别为 ' client1 ' 和 ' client2 '。
在 Rocky Linux 9 上安装 Teleport
Teleport 是一个提供安全访问你基础设施方式的应用程序。你可以通过网关安全地访问 Linux 服务器、Kubernetes 集群(Kubernetes Cluster)、数据库服务器、应用和桌面(Desktops)。
要将 Teleport 设置为你基础设施的访问平面,你需要将 Teleport 仓库(repository)添加到系统中,然后再进行安装。对于基于 RHEL 的发行版,你可以通过官方 Teleport 仓库安装 Teleport。
运行以下 dnf 命令将 Teleport 仓库添加到你的 Rocky Linux 系统。然后,验证活动仓库列表。
sudo dnf config-manager --add-repo https://rpm.releases.teleport.dev/teleport.repo
sudo dnf repolist
Teleport 仓库现在应该已经在你的系统上可用。

通过以下 dnf 命令安装 Teleport 软件包。当提示确认时,输入 y 并按下 ENTER。
sudo dnf install teleport

Teleport 软件包应该已经安装在 ' /usr/local/bin ' 目录下。运行以下命令验证 Teleport 提供的命令行列表。
ls /usr/local/bin/
你应该会看到 teleport 、 tsh 和 tctl 等 Teleport 命令行。
接下来,使用以下命令将 '/usr/local/bin ' 目录添加到 sudoers 的 secure_path 中。这样你就可以在命令开头加上 sudo 来运行 Teleport 命令行。
echo "Defaults secure_path = /sbin:/bin:/usr/sbin:/usr/bin:/usr/local/bin" > /etc/sudoers.d/secure_path
sudo chmod 440 /etc/sudoers.d/secure_path

最后,通过以下命令验证 Teleport 版本。
sudo teleport version
sudo tsh version
sudo tctl version
你应该会收到类似截图的输出:你现已在 Rocky Linux 系统上安装了 Teleport v11。

Teleport 安装完成后,你接下来将初始化并配置 Teleport 集群。
配置 Teleport 服务器
要使用 Teleport,你必须先配置 Teleport 本身。但在此之前,你必须确保你的域名(domain name)已指向服务器 IP 地址,并且你已经生成了 SSL 证书。本示例使用域名 ' teleport.example.local ' 以及来自 Letsencrypt 的 SSL 证书,证书位于目录 '/etc/letsencrypt/live/teleport.example.local ' 中。
Teleport 安装完成后,你现在将初始化 Teleport 集群,并启用提供管理仪表盘(administration dashboard)用于管理 Teleport 集群的 Teleport web service。最后,你将启动并启用 Teleport 服务。
首先,运行以下 teleport 命令来初始化 Teleport 服务器配置。同时,请务必修改域名、集群名称(cluster name)以及两个 SSL 证书(公钥和私钥)的路径。
sudo teleport configure -o file \
--cluster-name=teleport.example.local \
--public-addr=teleport.example.local:443 \
--cert-file=/etc/letsencrypt/live/teleport.example.local/fullchain.pem \
--key-file=/etc/letsencrypt/live/teleport.example.local/privkey.pem
在你的终端屏幕上,你应该会收到类似以下的输出 —— Teleport 配置文件已生成在 '/etc/teleport.yaml' 文件中。

接下来,使用以下 nano 编辑器命令打开 Teleport 配置文件 ' /etc/teleport.yaml'。
sudo nano /etc/teleport.yaml
在文件中添加以下行。通过这些行,你将启用 Teleport Web Service,它将运行在 Teleport 域名 ' teleport.example.local ' 上。
app_service: enabled: yes apps: - name: "teleport-webapp" uri: "http://localhost:9000" public_addr: "teleport.example.local"
完成后保存并关闭文件。
现在运行以下 systemctl 命令工具,在你的系统上启动并启用 Teleport 服务。
sudo systemctl start teleport
sudo systemctl enable teleport

Teleport 服务应该正在运行并已启用,运行以下命令验证并确保 Teleport 服务正在运行。
sudo systemctl status teleport
你将收到类似的输出 —— Teleport 服务正在运行且已启用,这意味着 Teleport 服务将在系统启动时自动运行。

Teleport 服务运行后,你现在应该可以通过 Web 浏览器访问 Teleport。但在此之前,你必须开放一些 Teleport 服务将使用的端口。你可以查看 Teleport Network 页面获取 Teleport 集群所需的具体端口列表。
运行以下 firewall-cmd 命令添加 Teleport 将使用的端口。
sudo firewall-cmd --add-port={443/tcp,3021/tcp,3022/tcp,3025/tcp,3028/tcp} --permanent
现在重新加载 firewalld 以应用更改,然后验证 firewalld 规则列表。
sudo firewall-cmd --reload
sudo firewall-cmd --list-all
现在确保你得到的输出与以下内容类似。

最后,打开你的 Web 浏览器并访问你的 Teleport 域名(例如:https://teleport.example.local/)。如果你的 Teleport 安装成功,你应该会看到 Teleport 登录页面。

在下一步中,你将创建并设置一个 Teleport 用户,该用户可用于通过命令行和管理仪表盘管理 Teleport 集群。
添加 Teleport 用户
至此,你的 Teleport 集群已经运行,并且其上启用了 web service。在本步骤中,你将创建并设置用于管理 Teleport 集群的 Teleport 用户。
在开始之前,请确保已在你的设备上安装了 2FA 应用,桌面端你可以使用 KeepassXC,Android 用户可以使用 Aegis,iOS 用户可以使用 Google Authentication。
首先,在 ' teleport-rocky ' 服务器上运行以下命令来创建一个新的 Teleport 用户。这将创建一个名为 ' teleport-admin' 的新用户,具有 editor 和 access 角色。' --logins ' 标志允许 ' teleport-admin ' 通过 root 、 rocky 或 ec2-user 用户登录到任意节点。'--login ' 标志后的用户必须在目标节点上创建。
sudo tctl users add teleport-admin --roles=editor,access --logins=root,rocky,ec2-user
你应该会收到类似以下的输出 —— Teleport 用户 ' teleport-admin ' 已创建,你应该会获得一个用于配置新用户的生成链接。

将生成的链接复制到你的 Web 浏览器中,你现在应该会看到设置 Teleport 用户的欢迎信息。点击 GET STARTED(开始)按钮来设置新的 Teleport 用户。

输入你的 Teleport 用户名,并输入密码。请确保你使用的是一个强度高且容易记住的密码。点击 NEXT(下一步)继续。

配置用户名和密码后,你现在将为你的 Teleport 用户设置双因素认证(two-factor authentication)。
扫描 Teleport 设置页面上的二维码,并输入生成的 OTP 验证码。然后点击 SUBMIT(提交)确认。

如果 OTP 验证码正确,你现在应该会看到 ' Registration Successful '(注册成功)消息。至此,你已为新 Teleport 用户配置了密码和 2FA。
点击 GO TO DASHBOARD(前往仪表盘)。

你现在应该会看到 Teleport 部署的 Web 管理仪表盘,它运行在安全启用的 HTTPS 下,并且用户已创建并启用了 2FA。

通过命令行管理 Teleport 集群
Teleport 软件包包含位于 '/usr/local/bin' 目录下的命令行 tsh 和 tctl。
tsh 命令允许用户从终端认证并管理 Teleport 集群。你可以添加、编辑或删除集群上的 Teleport 资源。出于安全考虑,你必须以非 root 用户身份运行 tsh 命令。tctl 命令用于设置和配置 Teleport Auth Service。这必须以 sudo 或 root 权限运行。
在本步骤中,你将通过 tsh 和 tctl 这两个命令行访问并管理 Teleport 集群。
首先,通过以下命令登录到非 root 用户。本示例使用用户 ' rocky '。
su - rocky
现在运行以下 tsh 命令来认证到你的 Teleport 集群。本示例将认证到运行在域名 ' teleport.example.local ' 上、用户为 'teleport-admin' 的 Teleport 集群。
tsh login --proxy=teleport.example.local --user=teleport-admin
系统会要求你输入 'teleport-admin' 用户的密码以及 OTP 认证码。输入你用户的正确密码以及来自你 2FA 应用的正确 OTP 验证码。
认证成功后,你应该会收到与以下类似的到 Teleport 集群的详细连接信息。

你也可以通过以下 tsh 命令验证当前到 Teleport 集群的连接。这将生成与上方截图相同的输出。
tsh status
既然你已经通过 tsh 认证到 Teleport 集群,你现在可以通过终端管理 Teleport 中的资源了。
运行以下 tsh 命令来查看 Teleport 集群上可用的主机/节点/服务器列表。
tsh ls
现在通过以下 tsh 命令验证 Teleport 集群上已启用的应用。
tsh apps ls
在输出中,你应该会看到 Teleport 集群上有一个节点可用(teleport-rocky),并且应用 ' teleport-webapp ' 已启用。

接下来,你也可以通过以下 tsh 命令登录到 Teleport 集群上可用的节点。借此,你将通过 tsh 命令以 ' root ' 和/或 ' rocky ' 用户登录到 ' teleport-rocky '。
tsh ssh root@teleport-rocky
tsh ssh rocky@teleport-rocky
你应该会看到类似以下的输出 —— 通过这两个 tsh 命令,你已经成功登录到 ' teleport-rocky '。

对于 tctl 命令,你应该在开头加上 sudo 运行。运行以下 tctl 命令来查看 Teleport 集群上可用的节点/服务器。
sudo tctl nodes ls

在下一步中,你将学习如何通过两种不同的方法将节点/服务器添加到 Teleport 集群:通过 Web 管理仪表盘自动添加,或通过命令行手动添加。
向 Teleport 集群添加节点
要将节点/服务器添加到 Teleport 集群,你必须确保服务器可达。并且你可以使用两种不同的方法将节点/服务器添加到你的 Teleport 集群。
在本步骤中,你将向 Teleport 集群添加两个不同的节点。你将通过 Web 管理仪表盘生成的安装脚本添加 ' client1 ' 节点,并通过命令行手动添加 ' client2 ' 节点。
通过 Teleport 管理仪表盘添加节点
在开始之前,运行以下 firewall-cmd 命令在 ' client1 ' 节点上开放一些端口。
sudo firewall-cmd --add-port={3021/tcp,3022/tcp,3025/tcp} --permanent
现在重新加载 firewalld 以应用更改,并在 ' client1 ' 节点上验证 firewalld 规则的状态。
sudo firewall-cmd --reload
sudo firewall-cmd --list-all
然后你将收到类似以下的输出。

接下来,访问 Teleport Web 管理仪表盘并点击 ADD SERVER(添加服务器)按钮。

选择你想要添加的资源类型。你可以添加 Kubernetes 集群(Kubernetes Cluster)、数据库服务器(Database servers)、应用(Applications)和桌面(Desktops)。选择 SERVERS 以添加服务器类型的资源,然后点击 NEXT(下一步)。

现在你将看到生成的安装脚本和命令行,可用于添加 ' client1 ' 节点。复制该生成的命令行。

现在登录到 ' client1 ' 节点,通过 sudo 命令获取 root 权限,然后粘贴并在 ' client1 ' 节点上运行生成的命令行。这将在 ' client1 ' 节点上下载并运行生成的脚本。
你将在终端上收到类似以下的输出 —— 安装脚本将使用生成的 token 和 Teleport 集群的 ca pin 添加 ' client1 ' 节点。此外,安装脚本将检测你当前的操作系统,自动安装 Teleport 软件包,并生成 Teleport 配置文件 '/etc/teleport.yaml'。

过程完成后,你应该会收到类似以下的输出。' client1 ' 节点上的 Teleport 服务也会自动启动并启用。

现在返回 Teleport Web 管理仪表盘,你应该会看到类似 ' The server successfully joined this Teleport cluster '(服务器已成功加入此 Teleport 集群)的消息。点击 NEXT(下一步)继续。
现在输入允许访问 ' client1 ' 节点的用户名。确保这些用户在 ' client1 ' 节点上已创建。再次点击 NEXT(下一步)继续。

最后,你可以使用 Web 管理仪表盘上提供的步骤验证到 ' client1 ' 节点的连接。
- 首先,选择你想要用于登录的用户。
- 其次,点击 'Step 2'(第 2 步)上的 TEST SERVER(测试服务器)按钮,并确保所有测试都已勾选/标记为完成。
- 最后,点击 START SESSION(开始会话)按钮,它将在你的 Web 浏览器中自动打开一个新标签页,并通过所选用户访问 ' client1 ' 节点。
以下是 ' Test Connection '(测试连接)部分的截图,状态为成功。

以下是在第 3 步中通过 START SESSION(开始会话)登录到 'client1 ' 节点后的截图。

点击 FINISH(完成)以完成流程。
然后你将被重定向到 Teleport Web 管理仪表盘,你应该会看到 ' client1 ' 节点已添加到 Teleport 集群。

此外,你也可以通过 tsh 和 tctl 命令行验证 Teleport 集群上的节点/服务器列表。
返回 'teleport-rocky ',运行以下命令验证 Teleport 集群上的节点/服务器列表。
sudo tctl nodes ls
你应该会收到类似的输出 —— client1 节点已可用并已添加到 Teleport 集群。

最后,运行以下 tsh 命令以 rocky 用户身份登录到 client1 节点。你现在应该已经通过 Teleport 登录到了 ' client1 ' 节点。
tsh ssh rocky@client1
以下是通过 Teleport 登录到 client1 节点后的终端界面。

至此,你已通过 Teleport Web 管理仪表盘生成的安装脚本,自动将 ' client1 ' 节点/服务器添加到了 Teleport 集群。
手动添加节点
现在你将通过以下步骤手动将 'client2' 节点添加到 Teleport 集群:
- 检查 Teleport 集群的 CA pin
- 生成 Teleport token
- 在 client2 节点上配置 firewalld
- 在 client2 节点上安装并配置 Teleport
让我们开始吧。
运行以下命令检查你 Teleport 集群的 ' CA pin'(CA 指纹)。该 'CA pin' 指纹将用于添加 ' client2 节点。
sudo tctl status
以下是你应该收到的类似输出 —— 请务必复制 'CA pin' 指纹。

接下来,运行以下 tctl 命令生成一个新 token,供 client2 节点加入 Teleport 集群使用。然后,验证你 Teleport 集群上的 token 列表。
sudo tctl nodes add --ttl=30m --roles=node | grep "invite token:" | grep -Eo "[0-9a-z]{32}"
sudo tctl token ls
你应该会收到类似的输出 —— 请务必复制生成的 token,client2 节点将使用该 token 加入 Teleport 集群。

接下来,连接到 ' client2 ' 节点并运行以下命令开放端口。
sudo firewall-cmd --add-port={3021/tcp,3022/tcp,3025/tcp} --permanent
通过以下命令重新加载 firewalld 并验证端口列表。
sudo firewall-cmd --reload
sudo firewall-cmd --list-all
以下是应在 client2 节点上开放的端口列表。

现在运行以下命令将 Teleport 仓库添加到 client2 节点。
sudo dnf config-manager --add-repo https://rpm.releases.teleport.dev/teleport.repo
sudo dnf repolist
以下是在 client2 节点上验证仓库列表后的类似输出。

运行以下 dnf 命令在 client2 节点上安装 Teleport。出现提示时输入 y 并按下 ENTER 继续。
sudo dnf install teleport

你还会被提示接受 Teleport 仓库的 GPG 密钥。输入 y 并按下 ENTER 确认。

Teleport 现在应该已安装在 '/usr/local/bin' 目录下。运行以下命令验证 Teleport 二进制软件包列表。
ls /usr/local/bin/
现在运行以下命令将 '/usr/local/bin' 目录添加到 sudoers 的 secure_path 。这样你就可以以 sudo 或 root 权限运行 Teleport 命令行。
echo "Defaults secure_path = /sbin:/bin:/usr/sbin:/usr/bin:/usr/local/bin" > /etc/sudoers.d/secure_path
sudo chmod 440 /etc/sudoers.d/secure_path
你可以通过以下命令验证 client2 节点上的 Teleport 版本。你应该会看到已安装 Teleport v11。
sudo teleport version

接下来,使用以下 nano 编辑器命令创建一个新的 Teleport 配置文件 ' /etc/teleport.yaml'。
sudo nano /etc/teleport.yaml
在文件中添加以下行。请务必将 namenode 替换为节点主机名,将 token_name 替换为你生成的 token,将 proxy_server 替换为你的 Teleport 集群域名,将 ca_pin 替换为 Teleport 集群的 CA pin 指纹。
version: v3
teleport:
nodename: client2
data_dir: /var/lib/teleport
join_params:
token_name: 30c7156ba908284dbd6000605806f9ab
method: token
proxy_server: teleport.example.local:443
log:
output: stderr
severity: INFO
format:
output: text
ca_pin: sha256:25a6945151b89f10eaf89ac5fe0bd7c88caf77acefce9a4e77edb84737974e4d
diag_addr: ""
auth_service:
enabled: "no"
ssh_service:
enabled: "yes"
commands:
- name: hostname
command: [hostname]
period: 1m0s
proxy_service:
enabled: "no"
https_keypairs: []
acme: {}
完成后保存文件并退出编辑器。
接下来,运行以下 systemctl 命令工具在 client2 节点上启动并启用 Teleport 服务。
sudo systemctl start teleport
sudo systemctl enable teleport

然后通过以下命令验证 Teleport 服务。
sudo systemctl status teleport
你应该会收到与以下截图类似的输出 —— client2 节点上的 Teleport 服务已配置完成,并且正在运行且已启用。

现在返回 ' teleport-rocky ' 终端,从那里验证可用节点/服务器列表。运行以下命令查看 Teleport 集群上的节点列表。
sudo tctl nodes ls
你应该会看到 client2 节点已可用并已添加到 Teleport 集群。

接下来,运行以下 tsh 命令通过 Teleport SSH 访问 client2 节点。你现在应该已经通过 Teleport 登录到了 client2 节点。请确保 ' rocky ' 用户在 client2 节点上可用。
tsh ssh rocky@client2
以下是通过 Teleport 登录到 client2 节点后你应该得到的输出。

现在返回 Teleport Web 管理仪表盘,你应该会看到 client2 节点在 Teleport 集群上可用。

最后,点击 ' client2 ' 节点上的 ' CONNECT '(连接)按钮以启动并连接到 ' client2 '。你现在应该已经通过 Teleport Web 管理仪表盘登录到了 ' client2 ' 节点。
至此,你已通过生成 Teleport token、使用 Teleport 集群的 CA pin 指纹、安装 Teleport 软件包以及创建 Teleport 配置文件,成功手动添加并配置了 client2 节点。
结论
你的服务器基础设施现在已通过 Teleport 集群得到保护,你可以禁用每个节点上的 SSH 服务,只允许来自 Teleport 服务器的访问。你现在已学会如何在 Rocky Linux 9 服务器上安装 Teleport 集群,并了解了设置 Teleport 的基本配置。
你还学会了如何创建启用了双因素认证(Two Factor Authentication)的 Teleport 用户,并学会了如何使用 Teleport 命令行(TSH 和 tctl)管理 Teleport 集群。
最后,你已成功使用两种不同方法配置了 client1 和 client2 两个节点并将其添加到 Teleport 集群。第一种方法是通过 Teleport Web 管理仪表盘生成的安装脚本。第二种方法是通过在目标机器上安装和配置 Teleport 来手动添加节点/服务器。