VoidTunnel - GitLite

KO | EN

gitlite — search

#javascript #python #react #go #deep-learning #docker #macos #awesome #cli #kubernetes #vue #awesome-list #pytorch #openai

VoidTunnel

(★ 140)

A powerful Linux VPN/Proxy client (GUI) built with Python & PyQt6. Uses Xray-core for VMess, VLESS, Trojan, Shadowsocks & SSH connections. Features payload injection & real-time stats.

파일 탐색기

최종 버전 다운로드 (.zip)

- - __init__.py
  - config_manager.py
  - profile_manager.py
  - protocol_parser.py
  - proxy_manager.py
  - singbox_manager.py
  - tun_manager.py
  - xray_controller.py
- - __init__.py
  - connect_widget.py
  - download_dialog.py
  - log_viewer.py
  - main_window.py
  - payload_editor.py
  - profile_widget.py
  - settings_dialog.py
- - __init__.py
  - helpers.py
  - network.py
- __init__.py
- main.py
.gitignore
LICENSE
README.md
requirements.txt
screenshot.png
VoidTunnel

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/klsdfernando/VoidTunnel

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd VoidTunnel

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Python

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Python 3 설치 시 'Add Python to PATH' 옵션을 꼭 체크하세요 (Windows).

python -m venv venv

파이썬 스크립트(또는 모듈)를 실행합니다.

pip install -r requirements.txt

requirements.txt 등에 명시된 파이썬 라이브러리를 설치합니다.

✅ 에러 메시지 없이 실행되고 터미널에 안내 문구가 출력되면 정상입니다.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# VoidTunnel

<p align="center">
  <img src="VoidTunnel" alt="VoidTunnel Logo" width="120" height="120">
</p>

<p align="center">
  <strong>A powerful VPN/Proxy client for Linux</strong>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/version-1.1-blue.svg" alt="Version">
  <img src="https://img.shields.io/badge/python-3.10+-green.svg" alt="Python">
  <img src="https://img.shields.io/badge/platform-Linux-orange.svg" alt="Platform">
  <img src="https://img.shields.io/badge/license-MIT-purple.svg" alt="License">
</p>

---

## ✨ Features

- 🔌 **Multiple Protocols**: VMess, VLESS, Trojan, Shadowsocks, SSH
- 📋 **Profile Management**: Import/export via URL, subscription support
- 🛠️ **Payload Editor**: HTTP header injection for bypassing restrictions
- 🌐 **System Proxy**: Auto-configure GNOME/KDE system proxy
- 📊 **Real-time Stats**: Upload/download speed, total data usage
- 📝 **Connection Logs**: Real-time colored log viewer
- 🎨 **Modern UI**: Dark theme with PyQt6

## 📸 Screenshots

<p align="center">
  <img src="screenshot.png" alt="VoidTunnel Screenshot" width="800">
</p>

## 🚀 Installation

### Prerequisites

- Python 3.10 or higher
- Linux (Ubuntu, Fedora, Arch, etc.)
- PyQt6

### Quick Start

```bash
# Clone the repository
git clone https://github.com/klsdfernando/VoidTunnel.git
cd VoidTunnel

# Create virtual environment
python -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Run the application
python src/main.py
```

On first run, VoidTunnel will prompt you to download Xray-core automatically.

## 📖 Usage

### Adding Servers

1. Go to **Servers** tab
2. Click **+ Add** or **📥 Import**
3. Paste your server URL:
   - `vmess://...`
   - `vless://...`
   - `trojan://...`
   - `ss://...` (Shadowsocks)

### Subscription Import

1. Go to **Servers** → **📥 Import**
2. Enter your subscription URL
3. Click **Import**

### Payload Editor

Access the **Payload** tab to configure HTTP header injection:
- Set HTTP method and path
- Add custom headers
- Enable/disable per profile

## 📁 Configuration

Settings are stored in: `~/.config/voidtunnel/`

| File | Description |
|------|-------------|
| `settings.json` | Application preferences |
| `profiles/` | Server profile database |
| `config.json` | Current Xray configuration |

## 🔧 Supported Protocols

| Protocol | Status | Description |
|----------|--------|-------------|
| VMess | ✅ Full | V2Ray protocol |
| VLESS | ✅ Full | Lightweight V2Ray |
| Trojan | ✅ Full | TLS-based protocol |
| Shadowsocks | ✅ Full | Proxy protocol |
| SSH | 🔄 Basic | SSH tunneling |

## 🛠️ Tech Stack

- **Language**: Python 3.10+
- **GUI**: PyQt6
- **Core Engine**: Xray-core
- **Networking**: requests, psutil

## 📝 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 👨‍💻 Author

**klsdfernando**

- GitHub: [@klsdfernando](https://github.com/klsdfernando)

## 🙏 Acknowledgments

- [Xray-core](https://github.com/XTLS/Xray-core) - The core proxy engine
- [PyQt6](https://www.riverbankcomputing.com/software/pyqt/) - GUI framework

---

<p align="center">
  Made by klsdfernando
</p>