A soldier who went on a deadly rampage in Thailand, killing more than 20 people and injuring dozens of others, has been shot dead by security forces, police confirmed.