ulfrasark/mieru-proxy repository overview

⁠ulfrasark/mieru-proxy

Mieru proxy server container for MikroTik RouterOS Docker.

Lightweight Mieru proxy server based on Alpine Linux. Designed for running a private proxy service directly on MikroTik devices with Docker support.

⁠Features

• Lightweight Alpine-based container
• Optimized for MikroTik RouterOS Docker
• Simple environment-based configuration
• Persistent configuration and client storage
• Automatic restart support
• TCP and UDP proxy support

⁠Container configuration

This image uses environment variables for initial setup.

Environment list example:

/container envs
add key=MIERU_MTU list=MIERU value="1400"
add key=MIERU_PASSWORD list=MIERU value="PASS"
add key=MIERU_PUBLIC_HOST list=MIERU value="YOUR_IP"
add key=MIERU_TCP_PORT_RANGE list=MIERU value="2012-2020"
add key=MIERU_UDP_PORT_RANGE list=MIERU value="2012-2020"
add key=MIERU_USER list=MIERU value="USERNAME"

⁠Environment variables

⁠Persistent storage

Required mounts:

/container mounts
add dst=/clients list=mieru_clients src=/docker/mita/clients
add dst=/etc/mita list=mieru_config src=/docker/mita/config

Container paths:

⁠MikroTik network setup

Example:

/interface/veth
add name=veth-mieru address=192.168.254.20/24 gateway=192.168.254.1

/interface bridge port
add bridge=Bridge-Docker interface=veth-mieru

⁠Install container

Example:

/container add \
remote-image=ulfrasark/mieru-proxy:latest \
interface=veth-mieru \
envlist=MIERU \
mounts=mieru_clients,mieru_config \
root-dir=/docker/mieru-proxy

⁠Start container

/container start [find image~"mieru-proxy"]

⁠Check logs

/log print where topics~"container"

or:

/container print

⁠Ports

⁠Client setup

Client configuration requires:

Server:
YOUR_IP

Port:
2012-2020

Username:
USERNAME

Password:
PASS

⁠Storage size

Approximate size:

⁠Requirements

• MikroTik RouterOS 7.x with Docker support
• Available storage for container data
• Public IP address or reachable hostname

⁠Notes

• Keep /docker/mita/config persistent
• Backup /docker/mita/clients before migration
• Use a stable public IP or DNS hostname
• MTU 1400 is recommended for most networks

⁠Compatible clients

Use the latest versions of client applications.

⁠Android

Recommended:

• Exclave (latest)
• NekoBox + Mieru plugin (latest)

Exclave supports the Mieru protocol and can be used as a client application. :contentReference[oaicite:0]{index=0}

NekoBox supports Mieru through plugins. Use the latest version of NekoBox and the latest Mieru plugin for proper compatibility. :contentReference[oaicite:1]{index=1}

⁠Required plugins

For NekoBox clients install:

Mieru plugin

Plugin source:

https://github.com/enfein/mieru⁠

⁠Original projects

This Docker image is based on the original Mieru project:

https://github.com/enfein/mieru⁠

Client applications:

• Exclave: https://github.com/ExclaveNetwork/Exclave⁠

• NekoBox plugins: https://github.com/enfein/mieru⁠

Always use the latest available versions of clients and plugins.