Install Shadowsocks via Ansible.

• Install or upgrade Shadowsocks Python version easily
• Tuning sysctl automatically for better performance
• Detect tcp_fastopen support
• Support init startup script

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

None

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

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

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

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

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

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

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

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

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

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

You can also define password in command line:

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

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

GPLv3

Tunghsiao Liu

• Twitter: @tunghsiao
• GitHub: @sparanoid