Zerotier

Zerotier creates a virtual network between hosts. You may refer to [zerotier-openwrt's official Wiki](https://github.com/mwarning/zerotier-openwrt/wiki) for the latest instructions.

opkg update
opkg install zerotier

• Create the virtual network on Zerotier Central. Note the Network ID.
• Add the virtual network to the Openwrt zerotier config (the section name my_zt_net is arbitrary, you can consistently replace it with whatever label you want)

uci delete zerotier.sample_config
uci add zerotier my_zt_net
uci add_list zerotier.my_zt_net.join=<network_id_from_zerotier_central>
uci set zerotier.my_zt_net.enabled='1'
uci commit zerotier
service zerotier restart

• When a new virtual network is joined, a secret will be generated, which may take a while. When it's finished, the secret will be saved in /etc/config/zerotier, and the device will join the virtual network.
  • Typical communication with Zerotier peers will happen on UDP port 9993, and no additional configuration is needed for an out-of-the-box router configuration.
• To use the virtual network, the device must be authorized on Zerotier Central by clicking the “Auth?” box next to the device under Members
• Device connectivity can be seen by using the “info” command:

zerotier-cli info

• Some services (eg dropbear, luci) may need to be reconfigured to allow access from the new Zerotier virtual interface. The easy way is to un-restrict them from specific networks/interfaces.
  • For dropbear (allow access from anywhere, potentially unsafe):

cat /etc/config/dropbear 

config dropbear
	option PasswordAuth 'on'
	option Port '22'

You must reboot here OpenWRT before continue otherwise the `ztXXXXXXXX` interface won't be created.

# Create interface
uci -q delete network.ZeroTier
uci set network.ZeroTier=interface
uci set network.ZeroTier.proto='none'
uci set network.ZeroTier.device='ztXXXXXXXX' # Replace ztXXXXXXXX with your own ZeroTier interface name
 
# Configure firewall zone
uci add firewall zone
uci set firewall.@zone[-1].name='vpn'
uci set firewall.@zone[-1].input='ACCEPT'
uci set firewall.@zone[-1].output='ACCEPT'
uci set firewall.@zone[-1].forward='ACCEPT'
uci set firewall.@zone[-1].masq='1'
uci add_list firewall.@zone[-1].network='ZeroTier'
uci add firewall forwarding
uci set firewall.@forwarding[-1].src='vpn'
uci set firewall.@forwarding[-1].dest='lan'
uci add firewall forwarding
uci set firewall.@forwarding[-1].src='vpn'
uci set firewall.@forwarding[-1].dest='wan'
uci add firewall forwarding
uci set firewall.@forwarding[-1].src='lan'
uci set firewall.@forwarding[-1].dest='vpn
 
# Commit changes
uci commit
 
# Reboot
reboot

The sample configuration is helpful to see which uci options are available for configuring the ZeroTier client.

While basic uci configuration of ZeroTier as shown above is supported, almost no advanced configuration support via uci has yet been added. The ZeroTier documentation requires manipulation of the configuration files for many advanced features. However, ZeroTier configurations are stored by default under /var/lib in Linux-based systems, which is a temporary filesystem in OpenWrt, where changes are not persistent. Instead, ordinarily OpenWrt writes a new configuration folder in that location based on the uci configuration above each time the service is started. These configuration files are lost on reboot or service restart, and rewritten each time the service starts again. For a basic configuration which will suit most users, this is not an issue.

In order to configure advanced features, two uci directives may be used to configure OpenWrt to load a copy of a persistent configuration folder from another location when starting the service, such as /etc/zerotier, which the user must first create and populate based on the simple copy made upon first joining a network. Once this persistent location is configured, the user may make persistent changes according to the ZeroTier documentation, with support for all current features otherwise enabled.

• Complete the basic configuration steps above to joint a working network, which will create a temporary copy of the configuration folder with which to start.
• Create the persistent folder in any permanent location (/etc/zerotier will be used for this example), and copy the contents of the temporary folder to the permanent location:

mkdir /etc/zerotier
cp -r /var/lib/zerotier-one/* /etc/zerotier/

• Add the directives to use the new persistent folder. The network name deadbeef00 will be used, similar to most ZeroTier documentation examples:

uci set zerotier.deadbeef00.config_path='/etc/zerotier'
uci set zerotier.deadbeef00.copy_config_path='1'
uci commit zerotier
service zerotier restart

The router will now refer to the configuration in /etc/zerotier for persistent advanced changes. Restarting the service after any configuration changes using the last line above will reset and apply any changes made. Do not attempt to edit the configuration in the /var/lib/zerotier-one location, as this temporary location will still be overwritten on restart by the configuration in the new persistent directory.