makemd/archive/handover/README (8).md at 56b8a2e2f89af8fa5caf5e65371a213e5870b09b

Files

wurenzhi 136c2fa579 feat: 初始化项目结构并添加核心功能模块

- 新增文档模板和导航结构
- 实现服务器基础API路由和控制器
- 添加扩展插件配置和前端框架
- 引入多租户和权限管理模块
- 集成日志和数据库配置
- 添加核心业务模型和类型定义

2026-03-17 22:07:19 +08:00

3.6 KiB

Raw Blame History

About

This is minimized official FreeSwitch docker container. Container designed to run on host network. Size of container decreased to 120MB (54MB compressed) Significantly increased security:

removed all libs except libc, busybox, 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.

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 file on your hosts.

$ 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

Unit file can be placed to /etc/systemd/system/freeswitch-docker.service and enabled by command

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

.bashrc file

To simplify freeswitch management 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://github.com/signalwire/freeswitch.git

execute make_min_archive.sh script

cd freeswitch/docker/base_image
./make_min_archive.sh

build custom container

docker build -t freeswitch_custom .

Dockerfile of official FreeSwitch container

3.6 KiB Raw Blame History