EasyTier/EasyTier

✨ Rust와 Tokio 기반의 간단하고 안전하며 탈중앙화된 가상 사설망 (VPN) 솔루션

📚 전체 문서 (Full Documentation) | 🖥️ 웹 콘솔 (Web Console) | 📝 릴리스 다운로드 (Download Releases) | 🧩 제3자 도구 (Third Party Tools) | ❤️ 후원 (Sponsor)

• 🔒
  탈중앙화 (Decentralized): 노드들은 동등하고 독립적이며, 중앙 집중식 서비스가 필요하지 않습니다 - 🚀
  사용 용이성 (Easy to Use): 웹, 클라이언트 및 명령줄 (Command Line)을 통한 다양한 운영 방식 제공 - 🌍
  크로스 플랫폼 (Cross-Platform): Win/MacOS/Linux/FreeBSD/Android 및 X86/ARM/MIPS 아키텍처를 지원합니다 - 🔐
  보안 (Secure): AES-GCM 또는 WireGuard 암호화를 사용하여 중간자 공격 (Man-in-the-middle attacks)을 방지합니다

• 🔌
  효율적인 NAT 트래버설 (Efficient NAT Traversal): UDP 및 IPv6 트래버설을 지원하며, NAT4-NAT4 네트워크에서도 작동합니다 - 🌐
  서브넷 프록시 (Subnet Proxy): 노드들이 다른 노드들이 접근할 수 있도록 서브넷을 공유할 수 있습니다 - 🔄
  지능형 라우팅 (Intelligent Routing): 최상의 네트워크 경험을 위해 지연 시간 (Latency) 우선순위 및 자동 경로 선택을 수행합니다 - ⚡
  고성능 (High Performance): 전체 링크에 걸쳐 제로 카피 (Zero-copy)를 구현하며, TCP/UDP/WSS/WG 프로토콜을 지원합니다

• 📊
  UDP 손실 저항성 (UDP Loss Resistance): KCP/QUIC 프록시가 패킷 손실이 높은 환경에서 지연 시간과 대역폭을 최적화합니다 - 🔧
  웹 관리 (Web Management): 웹 인터페이스를 통해 간편한 설정 및 모니터링이 가능합니다 - 🛠️
  제로 컨피그 (Zero Config): 정적 링크된 실행 파일 (Statically linked executables)로 간단하게 배포할 수 있습니다

사용자의 필요에 가장 적합한 설치 방법을 선택하세요:

Linux (권장):

curl -fsSL "https://github.com/EasyTier/EasyTier/blob/main/script/install.sh?raw=true" | sudo bash -s install

Homebrew (MacOS/Linux):

brew tap brewforge/chinese
brew install --cask easytier-gui

Windows (권장, 관리자 권한으로 실행):

irm "https://github.com/EasyTier/EasyTier/blob/main/script/install.ps1?raw=true" | iex

cargo를 통한 설치 (최신 개발 버전):

cargo install --git https://github.com/EasyTier/EasyTier.git easytier

사전 빌드된 바이너리 설치 (권장, 모든 플랫폼 지원)

추가 단계:

원클릭 서비스 등록 (시스템 부팅 시 자동으로 시작되며 백그라운드에서 실행됨)

EasyTier는 공유 퍼블릭 노드 (shared public nodes)를 사용하여 빠른 네트워킹을 지원합니다. 퍼블릭 IP (public IP)가 없는 경우, EasyTier 커뮤니티에서 제공하는 무료 공유 노드를 사용할 수 있습니다. 노드들은 자동으로 NAT 트래버설 (NAT traversal)을 시도하여 P2P 연결을 수립합니다. P2P 연결이 실패하면, 데이터는 공유 노드를 통해 릴레이 (relayed)됩니다.

공유 노드를 사용할 때, 네트워크에 진입하는 각 노드는 네트워크의 고유 식별자로서 동일한 --network-name 및 --network-secret 파라미터를 제공해야 합니다.

두 개의 노드를 예로 들어 설명하겠습니다 (충돌을 피하기 위해 더 복잡한 네트워크 이름을 사용하십시오):

• 노드 A에서 실행:

# 관리자 권한으로 실행
sudo easytier-core -d --network-name abc --network-secret abc -p tcp://<SharedNodeIP>:11010

• 노드 B에서 실행:

# 관리자 권한으로 실행
sudo easytier-core -d --network-name abc --network-secret abc -p tcp://<SharedNodeIP>:11010

실행에 성공하면, easytier-cli를 사용하여 네트워크 상태를 확인할 수 있습니다:

| ipv4 | hostname | cost | lat_ms | loss_rate | rx_bytes | tx_bytes | tunnel_proto | nat_type | id | version |
| ------------ | -------------- | ----- | ------ | --------- | -------- | -------- | ------------ | -------- | ---------- | --------------- |
| 10.126.126.1 | abc-1 | Local | * | * | * | * | udp | FullCone | 439804259 | 2.6.2-70e69a38~ |
...

노드 간의 연결성을 테스트할 수 있습니다:

# 연결성 테스트
ping 10.126.126.1
ping 10.126.126.2

참고: 만약 핑 (ping)이 통하지 않는다면, 방화벽이 들어오는 트래픽을 차단하고 있을 수 있습니다. 방화벽을 끄거나 허용 규칙을 추가해 주세요.

가용성을 높이기 위해, 여러 공유 노드에 동시에 연결할 수 있습니다:

# 여러 공유 노드에 연결
sudo easytier-core -d --network-name abc --network-secret abc -p tcp://<SharedNodeIP1>:11010 -p udp://<SharedNodeIP2>:11010

네트워크 설정이 성공적으로 완료되면, 시스템 부팅 시 자동으로 시작되도록 쉽게 구성할 수 있습니다. EasyTier를 시스템 서비스 (System Service)로 등록하는 단계별 지침은 '원클릭 서비스 등록 (One-Click Register Service)' 가이드를 참조하십시오.

EasyTier는 근본적으로 탈중앙화 (Decentralized)되어 있으며, 서버와 클라이언트의 구분이 없습니다. 단 하나의 장치라도 가상 네트워크 (Virtual Network) 내의 어떤 노드와도 통신할 수 있다면, 해당 장치는 가상 네트워크에 참여할 수 있습니다. 탈중앙화 네트워크를 설정하는 방법은 다음과 같습니다:

• 첫 번째 노드 시작 (Node A):

# 첫 번째 노드 시작
sudo easytier-core -i 10.144.144.1

시작 후, 이 노드는 기본적으로 다음 포트 (Ports)에서 대기합니다:

• TCP: 11010

• UDP: 11010

• WebSocket: 11011

• WebSocket SSL: 11012

• WireGuard: 11013

• 두 번째 노드 연결 (Node B):

# 첫 번째 노드의 퍼블릭 IP (Public IP)를 사용하여 연결
sudo easytier-core -i 10.144.144.2 -p udp://FIRST_NODE_PUBLIC_IP:11010

• 연결 확인:

# 연결성 테스트
ping 10.144.144.2
# 연결된 피어 (Peers) 보기
...

더 많은 노드가 네트워크에 참여하려면, -p 파라미터 (Parameter)를 사용하여 네트워크 내의 기존 노드 중 아무 곳에나 연결할 수 있습니다:

# 기존 노드의 퍼블릭 IP를 사용하여 연결
sudo easytier-core -i 10.144.144.3 -p udp://ANY_EXISTING_NODE_PUBLIC_IP:11010

네트워크 토폴로지 (Topology)가 다음과 같다고 가정할 때, Node B는 자신이 접근 가능한 서브넷 (Subnet) 10.1.1.0/24를 다른 노드들과 공유하고자 합니다:

subgraph Node A Public IP 22.1.1.1
nodea[EasyTier<br/>10.144.144.1]
...

서브넷을 공유하려면 EasyTier를 시작할 때 -n 파라미터를 추가하십시오:

# 서브넷 10.1.1.0/24를 다른 노드와 공유
sudo easytier-core -i 10.144.144.2 -n 10.1.1.0/24

서브넷 프록시 (Subnet Proxy) 정보는 가상 네트워크의 각 노드로 자동 동기화되며, 각 노드는 해당 경로 (Route)를 자동으로 구성합니다. 서브넷 프록시 설정을 다음과 같이 확인할 수 있습니다:

• 라우팅 정보 (Routing Information)가 동기화되었는지 확인 (proxy_cidrs 컬럼에 프록시된 서브넷이 표시됨):

# 라우팅 정보 보기
easytier-cli route

• 프록시된 서브넷의 노드에 접속할 수 있는지 테스트:

# 프록시된 서브넷으로의 연결성 테스트
ping 10.1.1.2

EasyTier는 WireGuard 서버 역할을 할 수 있어, WireGuard 클라이언트가 설치된 모든 장치(iOS 및 Android 포함)가 EasyTier 네트워크에 접속할 수 있도록 합니다. 다음은 설정 예시입니다:

flowchart LR
ios[[iPhone<br/>WireGuard 설치됨]]
subgraph Node A Public IP 22.1.1.1
...

• WireGuard 포털 (WireGuard portal)을 활성화하여 EasyTier 시작:

# 0.0.0.0:11013에서 대기하며 WireGuard 클라이언트를 위해 10.14.14.0/24 서브넷 사용
sudo easytier-core -i 10.144.144.1 --vpn-portal wg://0.0.0.0:11013/10.14.14.0/24

• WireGuard 클라이언트 설정 가져오기:

# WireGuard 클라이언트 설정 가져오기
easytier-cli vpn-portal

• 출력된 설정에서:
• Interface.Address를 WireGuard 서브넷의 사용 가능한 IP로 설정
• Peer.Endpoint를 EasyTier 노드의 공인 IP/도메인으로 설정
• 수정된 설정을 WireGuard 클라이언트에 가져오기

설정할 수 있습니다.

다른 노드들이 서로를 발견할 수 있도록 돕기 위해 직접 공용 공유 노드 (public shared node)를 실행할 수 있습니다. 공용 공유 노드는 다른 네트워크가 연결할 수 있는 일반적인 EasyTier 네트워크(동일한 네트워크 이름과 비밀번호 사용)일 뿐입니다.

공용 공유 노드를 실행하려면:

# 공용 공유 노드에는 IPv4 주소를 지정할 필요가 없음
sudo easytier-core --network-name mysharednode --network-secret mysharednode

• ZeroTier: 장치를 연결하기 위한 글로벌 가상 네트워크.

• TailScale: 네트워크 설정을 단순화하는 것을 목표로 하는 VPN 솔루션.

• 💬
  Telegram Group - 👥
  [QQ Group]

EasyTier는 LGPL-3.0 라이선스로 배포됩니다.

공용 서버를 후원해 주신 Langlang Cloud와 RainCloud에 특별히 감사드립니다.

EasyTier가 도움이 되었다면 후원을 고려해 주세요. 소프트웨어 개발 및 유지 관리에는 많은 시간과 노력이 필요하며, 여러분의 후원은 저희가 EasyTier를 더 잘 유지하고 개선하는 데 큰 도움이 될 것입니다.