falconerity/sing-box-mikrotik repository overview

⁠sing-box-mikrotik

A plain Alpine Docker image with a compressed sing-box⁠ executable inside and nothing else. Intended for MikroTik devices running RouterOS⁠. Optimized for low disk usage on the router at the cost of RAM.

Images are automatically kept up to date with the latest stable sing-box release.

GitHub repo: https://github.com/bdragon300/sing-box-mikrotik⁠

⁠Usage

⁠Prerequisites

First, check that your MikroTik device can run containers — its CPU architecture must be ARM32 (ARMv7), ARM64, or x86. See the products page⁠.

Also, make sure the container package⁠ is installed and containers are enabled (the device may ask for a physical button press or a reboot to confirm):

/system/device-mode update container=yes

Finally, set up the container registry:

/container/config set registry-url=https://registry-1.docker.io tmpdir=tmp1

⁠Run the container

/interface/veth add name=veth-vless address=192.168.254.2/24 gateway=192.168.254.1
/container/mounts add dst=/etc/sing-box list=VLESS mode=ro,noexec src=/vless_conf
/container add remote-image=falconerity/sing-box-mikrotik:latest interface=veth-vless root-dir=/containers/vless mountlists=VLESS start-on-boot=yes logging=no dns=1.1.1.1,8.8.8.8

Upload your sing-box configuration files to the router's /vless_conf directory, then start the container:

/container start [find remote-image~"sing-box-mikrotik"]