安装 Teleport#

在你想要作为请求转发服务器的服务器上运行如下脚本

1
curl https://goteleport.com/static/install.sh | bash -s <version>

例如

1
curl https://cdn.teleport.dev/install.sh | bash -s 18.9.2

配置或生成 TLS 证书#

对于域名有所有权且 443 端口可以访问的设备, 可以使用

1
sudo teleport configure -o file \
2
    --acme --acme-email=<email> \
3
    --cluster-name=<domain>

对于已有 TLS 证书的用户, 可以将证书复制至 /var/lib/teleport/fullchain.pem 和 /var/lib/teleport/privkey.pem, 并使用

1
sudo teleport configure -o file \
2
    --cluster-name=<domain> \
3
    --public-addr=<domain:port> \
4
    --cert-file=/var/lib/teleport/fullchain.pem \
5
    --key-file=/var/lib/teleport/privkey.pem

要使用 openssl 自签名证书, 请使用

1
# teleport-ext.cnf
2
[req]
3
distinguished_name = req_distinguished_name
4
x509_extensions = v3_req
5
prompt = no
6

7
[req_distinguished_name]
8
C = GS
9
ST = Genshin Impact
10
L = Teyvat
11
O = Miruku Teleport Lab
12
CN = <domain>
13

14
[v3_req]
15
keyUsage = critical, digitalSignature, keyEncipherment
16
extendedKeyUsage = serverAuth, clientAuth
17
subjectAltName = @alt_names
18

19
[alt_names]
20
DNS.1 = <domain>

1
sudo openssl req -x509 -nodes -days 3650 \
2
-newkey ec -pkeyopt ec_paramgen_curve:prime256v1 \
3
-keyout /var/lib/teleport/privkey.pem \
4
-out /var/lib/teleport/fullchain.pem \
5
-config teleport-ext.cnf

开启 Systemd 服务#

1
sudo systemctl enable --now teleport

如果使用 --public-addr=<domain:port> 开启的服务, 则启动于 0.0.0.0:port 上, 否则请查看 /etc/teleport.yaml 中 proxy_service.web_listen_addr

同时, 如果服务器位于 NAT 后, :3025 为默认鉴权端口, 请开启端口以保证 domain:3025 可以被访问

创建用户#

在运行有 Teleport 设备上运行如下命令, 以创建 admin 用户

如下示例中, admin 可以管理集群 (administrative), 连接到任何 Teleport 功能保护的资源, 查看审计事件和会话记录, 并支持使用 root 或 ubuntu Linux 用户 登录集群中的设备

1
sudo tctl users add admin --roles=editor,access,auditor --logins=root,ubuntu

打开命令输出的连接

1
User "admin" has been created but requires a password. Share this URL with the user to complete user setup, link is valid for 1h:
2
https://<domain>:<port>/web/invite/<id>

即可初始化用户密码

添加 Node#

https://goteleport.com/docs/get-started/connect/ 为了使现有服务器可以连接到 Teleport, 我们需要在服务器上配置 Teleport Agent

在 WebUI 中选择 Add New > Resource, 按照流程添加即可

NOTE

为了避免 Node 添加状态出现问题, 在进入添加流程至至成功前, 请不要刷新页面, 也不要在同一服务器重复运行 Agent 安装程序

要删除 Node, 请使用

1
tctl rm node/<uuid>

客户端 CLI 工具#

https://goteleport.com/docs/connect-your-client/teleport-clients/tsh/

tsh 是 Teleport 的 CLI 连接与鉴权工具

使用如下命令获取服务端版本

1
curl https://<domain>[:<port> | '443']/webapi/find | jq '.server_version'

使用如下命令安装

1
curl -O https://cdn.teleport.dev/teleport-v<version>-linux-amd64-bin.tar.gz
2
tar -xzf teleport-v<version>-linux-amd64-bin.tar.gz
3
cd teleport
4
sudo ./install

使用如下命令登录 Teleport

1
tsh login --proxy=<domain>[:<port> | '443'] [--user=<user>]

登出

1
tsh logout

查看可用 Node

1
tsh ls

登录成功后, 使用如下命令可以连接到 Node

1
tsh ssh [<user>@]<node>