/ansible-shadowsocks-libev

Ansible role for shadowsocks-libev

Primary LanguageShell

Ansible Role: shadowsocks-libev

Build Status

Install shadowsocks-libev via Ansible.

Features

  • Install or upgrade shadowsocks-libev version easily
  • Tuning sysctl automatically for better performance
  • Detect tcp_fastopen support
  • Support init startup script

Requirements

This role requires Ansible 1.6 or higher and platform requirements are listed in the metadata file.

Dependencies

None

Example Playbooks

Install shadowsocks-libev with custom location (default: /etc/shadowsocks-libev):

- hosts: servers
  roles:
    - { role: sparanoid.shadowsocks-libev, shadowsocks_home: /home/sparanoid/shadowsocks-libev }

Install shadowsocks-libev with different encryption (default: aes-256-cfb):

- hosts: servers
  roles:
    - { role: sparanoid.shadowsocks-libev, shadowsocks_config_method: salsa20 }

Install shadowsocks-libev with different server port (default: 443):

- hosts: servers
  roles:
    - { role: sparanoid.shadowsocks-libev, shadowsocks_config_server_port: 9999 }

Install shadowsocks-libev without tuning sysctl (default: shadowsocks_sysctl_tweak: true):

- hosts: servers
  roles:
    - { role: sparanoid.shadowsocks-libev, shadowsocks_sysctl_tweak: false }

Install shadowsocks-libev without shadowsocks/simple-obfs support (default: shadowsocks_obfs: true):

- hosts: servers
  roles:
    - { role: sparanoid.shadowsocks-libev, shadowsocks_obfs: false }

Install shadowsocks-libev using custom specified password (default: apn!proxy!ss!ftw!):

- hosts: servers
  roles:
    - { role: sparanoid.shadowsocks-libev, shadowsocks_password: "myFancy@Passwd!" }

You can also define password in command line:

$ ansible-playbook shadowsocks-servers.yml --extra-vars "shadowsocks_password=myFancy@Passwd!"

Todos

  • init.d script
  • Tuning sysctl support
  • Detect tcp_fastopen
  • Multiple users support
  • Distro support
    • EL
      • Better init.d script for 7
    • Debian
    • Ubuntu

License

GPLv3

Author Information

Tunghsiao Liu