Easy-VPN-Ansible

Ansible playbooks for provisioning a Debian/Ubuntu VPS with censorship-circumvention services running in Docker.

Available services:

• WireGuard VPN
• VLESS (XTLS-Reality)
• Telegram MTProxy (Fake TLS via telemt)

Client configuration files are saved locally under ansible/client_configs/<inventory_hostname>/.

Quick Start

1. Install Ansible on your control machine.
2. Prepare a Debian/Ubuntu VPS with SSH key access and passwordless sudo.
3. Edit ansible/inventory.ini with your server details.
4. Install collections:

cd ansible
ansible-galaxy collection install -r collections/requirements.yml

5. Initialize the server:

ansible-playbook -i inventory.ini playbook.yml --tags "init"

6. Deploy the services you want:

ansible-playbook -i inventory.ini playbook.yml --tags "deploy_wireguard,deploy_vless,deploy_mtproxy"

Examples:

ansible-playbook -i inventory.ini playbook.yml --tags "deploy_wireguard"
ansible-playbook -i inventory.ini playbook.yml --tags "deploy_vless"
ansible-playbook -i inventory.ini playbook.yml --tags "deploy_mtproxy"
ansible-playbook -C -D -i inventory.ini playbook.yml --tags "deploy_wireguard,deploy_vless,deploy_mtproxy"

Docs

• Getting Started
• GitHub Actions Deployment
• Services and Configuration