MSF-Docker

MSF Docker is a free, open-source, TUN-only DNS and proxy gateway that manages MosDNS and Mihomo through one WebUI.

  • Network Services
  • Plugins
  • Tools & Utilities
MSF Docker is a free, open-source, TUN-only DNS and proxy gateway that manages MosDNS and Mihomo through one WebUI.

Platform availability

Available on 2 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

52/100 Fair

Maintained
95last commit 9 days ago
Popular
44150 GitHub stars
Easy to install
452 install platforms, install notes, Docker image
Light to run
304 GB minimum RAM
Security check
07 serious findings, 3 minor, CI, tests

Availability: platform listings confirmed today, links checked 20 days ago

GitHub stars
150
Open issues
2
Last commit
2026-11-12
Latest release
v0.6.7.2
License
GPL-3.0
Activity
declining

Checked 6 days ago - source: GitHub (scoltzero/msf)

Resources & Compatibility

Minimum requirements: 4 GB RAM, 6 GB disk.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Set the Metasploit login variables Set MSFHOST, MSFUSER, and MSFPASS before starting. MSFHOST is the address of the Metasploit RPC server (a remote server your program talks to), and the other two are its username and password; without them, the app cannot sign in. source
  • Make the Metasploit RPC port reachable Start the Metasploit RPC server first and make sure the port in MSFHOST is open. If the server is off or the port is blocked, you will get a connection or login failure. source
  • Use environment variables for secrets Store MSFHOST, MSFUSER, and MSFPASS as environment variables (settings your system loads before the program starts), rather than pasting them into code. That helps you avoid missing setup values and accidentally sharing your login details. source
  • Unraid network setup For the Unraid deployment, assign the container a dedicated IPv4 address on the LAN (br0). source

Fetched 47 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How do I update or uninstall MSF on a Linux tarball or systemd deployment?

Use `msf update` to update the installation and `msf uninstall` to remove it. Other deployment types should use their respective package managers.

Does MSF include proxy nodes, subscriptions, or accounts?

No, it does not provide proxy nodes, subscriptions, accounts, credentials, or managed proxy services. User-imported subscriptions, connections, rules, and configuration are user-provided.

What router configuration is needed after installing MSF?

On a router you own or are authorized to manage, configure DHCP DNS and Fake-IP static routing. This is part of the basic deployment steps.

Is the Cloudflare Redirect plugin guaranteed to improve performance?

No, Cloudflare Redirect is experimental. Its effect depends on local network conditions, ISP routing, Cloudflare Anycast behavior, IPv6 reachability, the domain list, and the current MosDNS configuration.

Can MSF automatically resolve port conflicts?

It can theoretically try to resolve some port conflicts automatically. In practice, an occupied port may belong to system DNS, a gateway service, containers, virtualization, or another critical service.

Answers sourced from github.com, github.com

Community

Collected 49 days ago - public community threads