safarov/freeswitch

•Updated over 1 year ago

This is minimized official FreeSwitch docker container.

Image

1M+

safarov/freeswitch repository overview

⁠About

This is minimized official FreeSwitch docker container. Container designed to run on host, bridge and swarm network. Size of container decreased to 149MB (62MB compressed) Significantly increased security:

removed all libs except libc, busybox, tcpdump, dumpcap, freeswitch and dependent libs;
removed 'system' API command from vanila config;
updated FreeSwitch default SIP password to random value.

⁠Used environment variables

SOUND_RATES - rates of sound files that must be downloaded and installed. Available values 8000, 16000, 32000, 48000. May defined multiply values using semicolon as delimiter. Example SOUND_RATES=8000:16000;
SOUND_TYPES - types of sound files that must be downloaded and installed. Available values music, en-us-callie, en-us-allison, ru-RU-elena, en-ca-june, fr-ca-june, pt-BR-karina, sv-se-jakob, zh-cn-sinmei, zh-hk-sinmei. Example SOUND_TYPES=music:en-us-callie;
EPMD - start epmd daemon, useful when you use mod_erlang and mod_kazoo FreeSwitch modules. Available values true, false.
DUMPCAP - start dumpcap daemon, useful when you need PCAP files voip troubleshooting and call monitoring. Available values true, false or any value if you want define custom options for dumpcap. When used true value, then dumpcap options is -i any -p -t -q -b duration:3600 -b files:48 -w /dumpcap/packets.pcap and PCAP files will be wrote to /dumpcap folder of container.

⁠Usage container

Creating volume for sound files. This may be skipped if you not use freeswitch MOH and other sound files.

docker volume create --name freeswitch-sounds

Stating container

docker run --net=host --name freeswitch \
           -e SOUND_RATES=8000:16000 \
           -e SOUND_TYPES=music:en-us-callie \
           -v freeswitch-sounds:/usr/share/freeswitch/sounds \
           -v /etc/freeswitch/:/etc/freeswitch \
           safarov/freeswitch

⁠systemd unit file

You can use this systemd unit files on your docker host. Unit file can be placed to /etc/systemd/system/freeswitch-docker.service and enabled by commands

systemd start freeswitch-docker.service
systemd enable freeswitch-docker.service

⁠host network

$ cat /etc/systemd/system/freeswitch-docker.service
[Unit]
Description=freeswitch Container
After=docker.service network-online.target
Requires=docker.service


[Service]
Restart=always
TimeoutStartSec=0
#One ExecStart/ExecStop line to prevent hitting bugs in certain systemd versions
ExecStart=/bin/sh -c 'docker rm -f freeswitch; \
          docker run -t --net=host --name freeswitch \
                 -e SOUND_RATES=8000:16000 \
                 -e SOUND_TYPES=music:en-us-callie \
                 -v freeswitch-sounds:/usr/share/freeswitch/sounds \
                 -v /etc/kazoo/freeswitch/:/etc/freeswitch \
                 freeswitch'
ExecStop=-/bin/sh -c '/usr/bin/docker stop freeswitch; \
          /usr/bin/docker rm -f freeswitch;'

[Install]
WantedBy=multi-user.target

⁠default bridge network

[Unit]
Description=freeswitch Container
After=docker.service network-online.target
Requires=docker.service


[Service]
Restart=always
TimeoutStartSec=0
#One ExecStart/ExecStop line to prevent hitting bugs in certain systemd versions
ExecStart=/bin/sh -c 'docker rm -f freeswitch; \
          docker run -t --network bridge --name freeswitch \
                 -p 5060:5060/udp -p 5060:5060 \
                 -e SOUND_RATES=8000 \
                 -e SOUND_TYPES=music:en-us-callie \
                 -v freeswitch-sounds:/usr/share/freeswitch/sounds \
                 -v /etc/freeswitch/:/etc/freeswitch \
                 safarov/freeswitch'

ExecStartPost=/bin/sh -c 'sleep 5; \
          IP_ADDR=$(docker inspect -f "{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}" freeswitch); \
          /sbin/iptables -A DOCKER -t nat -p udp ! -i docker0  --dport 17000:17999 -j DNAT --to $IP_ADDR:17000-17999; \
          /sbin/iptables -A DOCKER -p udp ! -i docker0 -o docker0 -d $IP_ADDR --dport 17000:17999 -j ACCEPT'

ExecStop=-/bin/sh -c 'IP_ADDR=$(docker inspect -f "{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}" freeswitch); \
          /sbin/iptables -D DOCKER -t nat -p udp ! -i docker0  --dport 17000:17999 -j DNAT --to $IP_ADDR:17000-17999; \
          /sbin/iptables -D DOCKER -p udp ! -i docker0 -o docker0 -d $IP_ADDR --dport 17000:17999 -j ACCEPT; \
          /usr/bin/docker stop freeswitch; \
          /usr/bin/docker rm -f freeswitch;'

[Install]
WantedBy=multi-user.target

⁠.bashrc file

To simplify freeswitch managment you can add alias for fs_cli to .bashrc file as example bellow.

alias fs_cli='docker exec -i -t freeswitch /usr/bin/fs_cli'

⁠How to create custom container

This container created from scratch image by addiding required freeswitch files packaged to tar.gz archive. To create custom container:

install required FreeSwitch packages. Now supported debian dist

apt-get install freeswitch-conf-vanilla

clone freeswitch repo

git clone https://freeswitch.org/stash/projects/FS/repos/freeswitch/browse

execute make_min_archive.sh script

cd freeswitch/docker/base_image
./make_min_archive.sh

build custom container

docker build -t freeswitch_custom .

Tag summary

Recent tags

Content type

Image

Digest

sha256:b31c743f4…

Size

107.7 MB

Last updated

over 1 year ago

docker pull safarov/freeswitch