twingate/connector

Twingate Connector 镜像文档

快速参考

• 维护者: Twingate
• 获取帮助: Twingate 帮助中心、Twingate 社区论坛
• 支持架构: amd64, arm32v7, arm64v8

镜像概述

Twingate 是一款零信任网络访问（Zero Trust Network Access）解决方案，旨在简化部署、提升易用性并确保安全性。作为集中式零信任编排层，Twingate 允许企业构建一流安全生态系统，无需重构现有网络架构。

Connector 是 Twingate 的核心组件，部署在企业防火墙后方，专门用于提供对私有资源的安全访问。

了解更多关于 Twingate 工作原理，探索 Twingate 使用场景 并阅读 Docker 部署指南。

核心功能与特性

• 零信任架构支持：作为零信任网络访问的关键组件，实现资源访问的细粒度控制
• 跨平台部署：支持 amd64、arm32v7、arm64v8 多种架构
• 私有资源访问：部署在防火墙后方，安全桥接外部访问与内部私有资源
• 灵活网络配置：支持自定义 DNS 服务器及本地网络连接日志功能
• 对等连接优化：可配置支持同一本地网络内客户端与 Connector 的对等连接

使用场景

• 企业远程办公场景下，为外部员工提供安全的内部资源访问通道
• 多云环境中，统一管理不同云平台私有资源的访问权限
• 简化第三方合作伙伴对特定内部系统的受控访问
• 替换传统 *** 方案，实现更细粒度的访问控制与更高安全性

部署与使用指南

前置条件

启动 Connector 需准备：

• 通过 Twingate 管理控制台或 API 生成的访问令牌（Access Token）
• 通过 Twingate 管理控制台或 API 生成的刷新令牌（Refresh Token）

Docker 快速启动命令

sh
docker run -d \
    --sysctl net.ipv4.ping_group_range="0 2147483647" \
    --env TWINGATE_NETWORK="twingate-network" \
    --env TWINGATE_ACCESS_TOKEN="" \
    --env TWINGATE_REFRESH_TOKEN="" \
    --env TWINGATE_DNS="198.51.100.42" \
    --env TWINGATE_LABEL_HOSTNAME="`hostname`" \
    --env TWINGATE_LOG_ANALYTICS="v2" \
    --name "twingate-connector-name" \
    --restart=unless-stopped \
    --pull=always \
    twingate/connector:1

配置参数说明

网络配置优化

当客户端与 Connector 位于同一本地网络时，建议移除 --sysctl net.ipv4.ping_group_range="0 2147483647" 参数，使 Connector 可在主机本地网络中被发现，从而支持客户端与 Connector 之间的对等（P2P）连接，提升访问性能。