kasmweb/redirector

Kasm Redirector 镜像文档

镜像概述和主要用途

Kasm redirector是一款提供无缝浏览器隔离的Docker镜像。其核心功能是：当用户在本地浏览器中导航至互联网上的任意网站时，会被自动重定向到本地部署或云SaaS Kasm安装实例，由隔离浏览器加载并访问原始请求的URL，同时为用户提供无缝的使用体验。

核心功能和特性

• 无缝重定向：用户本地浏览器访问网站时自动重定向至Kasm隔离环境，无感知过渡
• 浏览器隔离：所有网页内容在隔离环境中加载，保护本地系统安全
• 灵活部署支持：兼容本地部署和云SaaS Kasm安装实例
• 策略路由支持：通过策略路由实现精准流量控制，仅将指定客户端流量引导至隔离环境

使用场景和适用范围

• 企业网络安全防护，防止***网站威胁本地终端
• 需要严格控制互联网访问风险的组织环境
• 多客户端环境下的统一浏览器安全管理
• 希望实现浏览器隔离但不影响用户体验的场景

详细使用方法和配置说明

前提条件

• 操作系统：Ubuntu 16.04LTS（可适配大多数Linux发行版）
• 已安装：docker-ce 和 docker-compose

架构示例

文档中使用以下架构作为配置示例：

流量路由配置

必须将流量路由至Kasm Redirector，推荐使用策略路由。策略路由允许选择特定源流量并将其发送到不同于三层路由指定的目的地。

配置示例：创建策略路由，将来自客户端子网（如192.168.90.0/24）、目标端口为80或443的所有流量路由至Kasm Redirector（如192.168.204.3）。

注意：Kasm Redirector必须位于配置策略路由的防火墙/路由器所定义的子网上。具体配置方法请参考您的路由器或防火墙文档。

安装步骤

1. 系统配置

bash
# 启用IPv4转发
sudo sysctl -w net.ipv4.ip_forward=1
sudo sed -i 's$#net.ipv4.ip_forward=1$net.ipv4.ip_forward=1

#### 2. 创建docker-compose配置文件

创建 `/opt/kasm_redirector/docker-compose.yaml` 文件，内容如下：

```yaml
version: '3'
services:
  redirector:
    image: docker.xuanyuan.run/kasmweb/redirector:latest
    volumes:
      - /opt/kasm_redirector/certs/:/usr/local/openresty/nginx/certs/
      - /opt/kasm_redirector/private/:/usr/local/openresty/nginx/private/
      - /opt/kasm_redirector/routing/:/usr/local/openresty/nginx/conf/sites/routing/
    ports:
      - "443:443"
      - "80:80"
    restart: always
    environment:
      KASM_URL: "https://kasm.company.internal"  # 替换为您的Kasm安装实例URL
      PROXY_RESOLVER: "8.8.4.4"  # 替换为Kasm Redirector可访问的DNS服务器IP

3. 启动服务

bash
cd /opt/kasm_redirector
sudo docker-compose up -d

4. 配置更新

修改 docker-compose.yaml 文件后，需重启服务：

bash
cd /opt/kasm_redirector
sudo docker-compose stop
sudo docker-compose rm
sudo docker-compose up -d

参数说明

环境变量

卷挂载

端口映射

配置iptables规则（拦截80/443端口流量）

替换192.168.204.3为Kasm Redirector的IP地址

替换192.168.0.0/24为需要通过Kasm访问的客户端子网（需与防火墙策略路由匹配）

sudo iptables -t nat -A PREROUTING -p tcp -m tcp --dport 80 -j DNAT --to-destination 192.168.204.3:80 -s 192.168.0.0/24 sudo iptables -t nat -A PREROUTING -p tcp -m tcp --dport 443 -j DNAT --to-destination 192.168.204.3:443 -s 192.168.0.0/24

创建工作目录

mkdir /opt/kasm_redirector

#### 2. 创建docker-compose配置文件

创建 __CODE_TOKEN_4__ 文件，内容如下：

__CODE_TOKEN_1__

#### 3. 启动服务

__CODE_TOKEN_2__

#### 4. 配置更新

修改 __CODE_TOKEN_5__ 文件后，需重启服务：

__CODE_TOKEN_3__

### 参数说明

#### 环境变量

| 变量名 | 描述 | 示例值 |
|--------|------|--------|
| KASM_URL | Kasm安装实例的URL | [***] |
| PROXY_RESOLVER | DNS服务器IP地址，用于解析域名 | 8.8.4.4 |

#### 卷挂载

| 本地路径 | 容器路径 | 用途 |
|----------|----------|------|
| /opt/kasm_redirector/certs/ | /usr/local/openresty/nginx/certs/ | 证书存储目录 |
| /opt/kasm_redirector/private/ | /usr/local/openresty/nginx/private/ | 私有文件存储目录 |
| /opt/kasm_redirector/routing/ | /usr/local/openresty/nginx/conf/sites/routing/ | 路由配置文件目录 |

#### 端口映射

| 主机端口 | 容器端口 | 用途 |
|----------|----------|------|
| 80 | 80 | HTTP流量端口 |
| 443 | 443 | HTTPS流量端口 |