jannik
/
ansible-role-tinc
1
1
Fork 0
Code Issues Pull Requests Releases Activity
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
11 Commits
1 Branch
0 Tags
38 KiB
Jinja 100%
 
master
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'master'
${ noResults }
Go to file
Jannik Beyerstedt cdd9bc58d2 [TIDY] Set some "diff: false", fix linter warnings 5 months ago
defaults [FIX] hostname should not have hyphens 3 years ago
handlers [TIDY] yaml auto-format 4 years ago
meta change license, add license file 4 years ago
tasks [TIDY] Set some "diff: false", fix linter warnings 5 months ago
templates Use utun device on macOS (no tuntap kext needed) 3 years ago
.gitignore [CODE] add tasks 4 years ago
LICENSE change license, add license file 4 years ago
README.md [TIDY] Update to ansible 4 module names 2 years ago

README.md

Tinc

Setup and configuration of a tinc VPN network.

Requirements

none

Role Variables

Central configuration:

  • tinc_vpn_id: name of the vpn to be created (default: vpn0)
  • tinc_central_host: hostname of the always-on server (default: hetzner-01)
  • tinc_vpn_net: local vpn network (IPv4, CIDR notation)
  • tinc_remote_nets: list of remote networks, that should be forwarded to localhost (TODO: currently only one entry supported)
    • net_cidr: IPv4 network range (CIDR notation)
    • gateway: VPN network IP address of the gateway

Configuration for each host:

  • tinc_client_ip: own IP address in the tinc-local network
  • tinc_public_addr: public domain or IP address of the central server

Dependencies

none

Example Playbook

Hostfile:

tinc:
  vars:
    tinc_vpn_net: 172.16.1.0/24
    tinc_remote_nets:
      - net_cidr: 192.168.1.0/24
        gateway: 172.16.1.2
  hosts:
    central_server:
      tinc_public_addr: central_server.example.com
      tinc_client_ip: 172.16.1.1
    remote_gateway:
      tinc_client_ip: 172.16.1.2
    localhost:
      tinc_client_ip: 172.16.1.3

Playbook:

- name: Install tinc
  hosts: tinc
  roles:
    - tinc

- name: Distribute hostfiles
  hosts: tinc
  tasks:
  - name: Tinc - Distribute hostfiles
    ansible.builtin.import_role:
      name: tinc
      tasks_from: distribute

License

GPLv3