体系结构角色

下面概述了此体系结构中的角色服务。通信所需的端口和协议包括 列出以允许在您的环境中使用防火墙或过滤设备

Web 应用服务器

这是最终用户的登陆点。如果最终用户从 Internet 访问此服务器，则可能是 放入 DMZ 飞地。此服务器包括以下服务：

• Web 应用程序Web 应用程序 （kasm_api）
• 经理服务 （kasm_manager）
• 代理 （kasm_proxy）

• 端口/协议
  • HTTPS协议 （443）

数据库服务器

数据库服务器必须可通过 API 和管理服务访问。此服务器包括以下服务：

• 数据库服务 （kasm_db）
• 共享数据库服务 （kasm_redis）

• 端口/协议
  • POSTGRESQL （5432）
  • 瑞迪斯 （6379）

代理服务器

代理是创建最终用户会话的位置。根据所需的架构，它们可以放置在不同的位置。 代理必须可由管理和 Web 应用服务器访问。 此服务器包括以下服务：

• 代理服务 （kasm_agent）
• 代理 （kasm_proxy）

• 端口/协议
  • HTTPS协议 （443）

连接代理

连接代理用于代理 Web 原生 RDP/VNC/SSH 会话到固定或自动缩放的服务器。如果此功能 不需要，则不需要安装此角色。 连接代理需要可从 WebApp 服务器和目标 RDP/VNC/SSH 服务器访问。 此服务器包括以下服务：

• 高克服务 （kasm_guac）
• 代理 （kasm_proxy）

• 端口/协议
  • HTTPS协议 （443）

端口和协议

系统要求

在开始之前，请查看系统要求。

安装指南

按照以下步骤在单独的服务器上设置 Kasm。

安装数据库服务器角色

可以按照以下步骤在数据库服务器上安装数据库服务

• 将最新版本的 Kasm Workspaces 下载到 /tmp
• 解压缩包并执行安装。请注意在安装过程中生成的默认登录凭据。

cd /tmp
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_1.14.0.3a7abb.tar.gz
tar -xf kasm_release_1.14.0.3a7abb.tar.gz
sudo bash kasm_release/install.sh --role db --database-user [DATABASE_USERNAME] --database-name [DATABASE_NAME]

安装 Web 应用角色

可以按照以下步骤在单个服务器上预配 Web 应用组件。重复这些步骤 额外的服务器，以增加冗余和可扩展性。利用具有多个公共 IP 的单个公共 DNS 名称来拥有 DNS 负载将请求分发到 Web 应用程序 Kasm Workspaces 服务器群集。

对于后续步骤，您需要以下信息

• DATABASE_HOSTNAME ：Web 应用服务器可解析和访问的数据库服务器的 IP、主机名或 FQDN。
• DATABASE_PASSWORD ：数据库安装过程中生成的数据库密码。
• REDIS_PASSWORD ：数据库安装过程中生成的 Redis 密码。
• DATABASE_USERNAME 可选 ：数据库用户名（如果使用自定义用户名）。如果使用标准数据库服务器角色安装，则不需要包含此内容。
• DATABASE_NAME 可选 ：如果使用自定义数据库名称，则为数据库名称。如果使用标准数据库服务器角色安装，则不需要包含此内容。

在继续之前，请验证此服务器是否可以访问端口 [DATABASE_HOSTNAME]：5432 和 6379

• 将最新版本的 Kasm Workspaces 下载到 /tmp
• 解压缩包并运行执行安装

cd /tmp
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_1.14.0.3a7abb.tar.gz
tar -xf kasm_release_1.14.0.3a7abb.tar.gz
sudo bash kasm_release/install.sh --role app --db-hostname [DATABASE_HOSTNAME] --db-password [DATABASE_PASSWORD] --redis-password [REDIS_PASSWORD] --database-user [DATABASE_USERNAME]  --database-name [DATABASE_NAME]

• 登录到在端口 443 上运行的 Web 应用程序，https://<WEBAPP_SERVER>
• 默认用户名为 admin@kasm.local 和 user@kasm.local。除非指定了 or/and，否则密码将随机生成并在安装结束时显示。--admin-password--user-password

安装代理服务器角色

可以按照以下步骤安装代理和代理服务。对旨在设置最终用户会话的任何其他服务器重复此步骤

对于后续步骤，您需要以下信息

• MANAGER_HOSTNAME ：代理服务器可解析和访问的 Web 应用服务器的 IP、主机名或 FQDN。
• MANAGER_TOKEN ：数据库安装期间生成的管理器令牌。这用于代理的身份验证。
• AGENT_HOSTNAME ：此代理服务器的此 IP、主机名或 FQDN，可由 Web 应用服务器解析和访问。 此值将由代理服务在签入例程期间报告，并由其他服务用于与其通信。

在继续之前，请验证此服务器是否可以访问端口 [MANAGER_HOSTNAME]：443

• 将最新版本的 Kasm Workspaces 下载到 /tmp
• 解压缩包并执行安装

cd /tmp
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_1.14.0.3a7abb.tar.gz
tar -xf kasm_release_1.14.0.3a7abb.tar.gz
sudo bash kasm_release/install.sh --role agent --public-hostname [AGENT_HOSTNAME] --manager-hostname [MANAGER_HOSTNAME] --manager-token [MANAGER_TOKEN]

• 以管理员身份登录 UI，选择 Infrastructure > Docker Agents，然后使用箭头菜单在刚刚创建的代理上选择编辑。确保已选择“已启用”，然后单击“保存”。
  

  

（可选）安装连接代理 （Guac） 角色

需要连接代理角色才能支持通过 RDP、VNC 或 SSH 连接到 VM/硬件。工作区支持连接到 预先退出计算机或通过 Cloud Autoscaling 自动配置它们。如果不需要这些服务， 不需要安装此角色。

对于后续步骤，您需要以下信息

• MANAGER_HOSTNAME ：代理服务器可解析和访问的 Web 应用服务器的 IP、主机名或 FQDN。
• SERVICE_REGISTRATION_TOKEN ：数据库安装期间生成的注册令牌。这用于向系统注册连接代理。 服务注册令牌也可以在 Kasm Admin UI 的全局设置中找到。
• CONNECTION_PROXY_HOSTNAME ：此连接代理服务器的此 IP、主机名或 FQDN，可由 Web 应用服务器解析和访问。 此值将在注册期间由连接代理服务器报告，并由其他服务用于与之通信。

在继续之前，请验证此服务器是否可以访问端口 [MANAGER_HOSTNAME]：443

• 将最新版本的 Kasm Workspaces 下载到 /tmp
• 解压缩包并执行安装

cd /tmp
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_1.14.0.3a7abb.tar.gz
tar -xf kasm_release_1.14.0.3a7abb.tar.gz
sudo bash kasm_release/install.sh --role guac --api-hostname [MANAGER_HOSTNAME] --public-hostname [CONNECTION_PROXY_HOSTNAME] --registration-token [SERVICE_REGISTRATION_TOKEN]

专用 Kasm 代理（可选）

在标准多服务器安装中，代理服务负责将客户端指向正确的代理服务器 包含在 Web 应用角色以及所有其他客户端 UI 和路由中。可能需要将许多代理分布在不同的地理位置，同时保留单个 Web 端点提供静态 Web 内容，而代理则为 Kasm Workspaces 会话提供服务。为此，有一个安装角色，用于安装和配置 Web 代理，以将最终用户定向到正确的代理以启动 Kasm Workspaces 会话。proxy

代理概述

The user follows the same workflow when launching a workspace and on the backend we direct them to the correct Agent/s, but unlike a standard Multi Server Deployment the Workspaces Session is routed through the Proxy in the user’s geographic region to reduce latency.

Proxy installation

Note

This guide assumes you have a running Multi Server deployment of Kasm Workspaces and have a basic understanding of domain/SSL management. For help with SSL certificates please see Custom Certificates

The following steps can be followed to install the proxy role to a server:

• Ensure the Proxy server has a domain name pointed to it and a legitimate SSL certificate.
• Download the latest version of Kasm Workspaces to /tmp.
• Extract the package and execute the installation.
• Post install, configure Kasm Workspaces via the Web UI to use the new Proxy.

In this example we assume the proxy domain is proxy.example.com and the Web App hosting the API server is located at workspaces.example.com.

Proxy Server installation

Note

It is important that the agents in your Multi Server installation can be accessed by this Proxy server deployment ensure connectivity to the Agent server from the Proxy server before installation.

In order to install the proxy role you will need to know the URL for the Web App server you plan to have your users connect from. This endpoint will be pointed to for authentication and is needed to enforce strict CORS policies.

cd /tmp
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_1.14.0.3a7abb.tar.gz
tar -xf kasm_release*.tar.gz
sudo bash kasm_release/install.sh --role proxy --api-hostname workspaces.kasmweb.com

Post Install Configuration

With the proxy running you will need to login to your Kasm Workspaces installation as an administrator and navigate to Admin->Settings->Global->Authentication->Kasm Auth Domain. Change this setting to example.com and click Save.

Next navigate to Admin->Infrastructure->Zones->Click the arrow next to the zone you want to point to the Proxy->Edit Set Proxy Hostname to proxy.example.com

While in this menu also set Upstream Auth Address to workspaces.example.com

With these setting changed we need to restart the API server container on the Web App server/s:

sudo docker restart kasm_api

When a user now deploys a Kasm Workspace their streaming session will be served up by this new external proxy instead of the default one deployed with the Web App role.

Slim images

使用安装标志将下载并使用基于 Alpine 的瘦服务容器。这些图像更小、更简化，但保留了相同的功能。这些映像与默认的 Ubuntu 容器不具有相同的广泛兼容性。--slim-images

已知的不兼容：

已知的应用程序错误：

• 游戏手柄直通当前不起作用。如果为组启用，则工作区将不会启动。

安装疑难解答

install.sh 脚本在运行时会创建一个日志文件，此文件将在成功安装完成后删除。但是，如果出现问题，日志文件将从执行 install.sh 脚本的目录中以 kasm_install_${TIMESTAMP}.log 格式提供。此文件对于诊断导致安装失败的错误非常重要，并且在向 Kasm Technologies 提交支持票证时将请求此文件。