ppptran/usque-mikrotik repository overview

///////////////////////// UPDATED: AS of Mat 2026 with Mikrotik Ver 7.23

just add entrypoint = /usr/local/bin/entrypoint.sh

////////////////////////

⁠🚀 Usque-Mikrotik

Expose MASQUE as a SOCKS5 proxy within a MikroTik Container.

This project allows you to run the usque client on MikroTik hardware to create a localized SOCKS5 proxy.

---

⁠📦 Supported Architectures

Please pull the specific image tag matching your CPU architecture:

---

⁠🛠️ Setup Instructions

⁠Step 0: Network Preparation

1. Create a Veth: Assign an IP of your choice (e.g., 172.18.1.5).
2. Bridge Setup: Create a bridge named docker, add your Veth to it, and assign an IP address to the bridge in IP -> Address.
3. Firewall: If you use interface lists for your firewall, ensure this docker bridge is added to your LAN list.

⁠Step 1: Configuration & Mounts

1. Prepare Config: Follow Diniboy1123's instructions⁠ to generate your config.json.
2. Upload: Upload config.json to your MikroTik in a folder named /usqueconfig.
3. Create Mount: In Container > Mounts:
   • Name: usque_config
   • Src: /usqueconfig
   • Dst: /app/

⁠Step 2: Environment Variables (Envs)

In the MikroTik Container > Envs tab, create a list named usque with the following entries:

⁠Step 3: Deploy the Container

In the Container tab, click Add New:

• Remote Image: ppptran/usque-mikrotik:latest (or your specific arch tag)
• Interface: veth1
• Envlist: usque
• Mount: usque_config
• Root Dir: usque

---

⁠⚡ Usage

Once the container is started, your SOCKS5 proxy will be available at:

Address: 172.18.1.5:1080
Auth: Use the username/password defined in the Envs tab.

---

⁠🤝 Credits

• Original Tool: Diniboy1123⁠ for the excellent usque tool.
• Image Maintainer: ppptran