Docker 安装

MSM 提供官方 Docker 镜像，适合容器化部署。

快速开始

拉取镜像

docker pull msmbox/msm:latest

运行容器（推荐）

docker run -d \
  --name msm \
  --privileged \
  --device /dev/net/tun \
  --network host \
  -v /opt/msm:/opt/msm \
  msmbox/msm:latest

访问管理界面：http://localhost:7777

注意

目前 Docker 部署仅支持 --network host（不支持 -p/ports 端口映射），并需要特权模式（--privileged）和 TUN 设备访问权限以支持透明代理、TUN 模式等高级网络功能。

Docker Compose

version: '3.8'

services:
  msm:
    image: msmbox/msm:latest
    container_name: msm
    restart: unless-stopped
    network_mode: host
    privileged: true
    devices:
      - /dev/net/tun
    volumes:
      - ./msm-data:/opt/msm
    environment:
      - TZ=Asia/Shanghai
      - MSM_PORT=7777

环境变量

变量	默认值	说明
MSM_PORT	7777	Web 管理界面端口
MSM_CONFIG_DIR	/opt/msm	配置文件目录
JWT_SECRET	-	JWT 密钥（建议设置）
TZ	Asia/Shanghai	时区设置

端口说明

端口	协议	用途
7777	TCP	Web 管理界面
53	UDP/TCP	DNS 服务（MosDNS）
1053	UDP	DNS 备用端口
7890	TCP	HTTP 代理
7891	TCP	SOCKS5 代理
7892	TCP	混合代理端口
6666	TCP	管理端口

支持的架构

此镜像支持以下平台架构：

• linux/amd64 - x86_64（Intel/AMD 64位）
• linux/arm64 - ARM64（树莓派 4、Apple Silicon 等）
• linux/arm/v7 - ARMv7（树莓派 3 等）
• linux/arm/v6 - ARMv6（树莓派 1/Zero 等）
• linux/386 - x86 32位

Docker 会自动选择适合您平台的镜像。

数据持久化

建议挂载数据卷以持久化配置：

docker run -d \
  --name msm \
  --privileged \
  --device /dev/net/tun \
  --network host \
  -v /your/data/path:/opt/msm \
  msmbox/msm:latest

安全建议

1. 设置 JWT 密钥：

-e JWT_SECRET="$(openssl rand -base64 32)"

2. 限制网络访问：Host 模式下无法通过端口映射限制访问，请在宿主机上通过防火墙限制 7777 端口访问（仅允许可信网段/来源）。
3. 特权模式说明：
   • 容器以 root 用户运行以支持透明代理、TUN 设备等高级网络功能
   • 如不需要这些功能，可移除 --privileged 和 --device /dev/net/tun 参数
   • 建议在可信环境中运行，或使用网络隔离

版本标签

• latest - 最新稳定版本（每日自动构建）
• 0.7.2 - 具体版本号

更多版本请查看 Tags 页面。

健康检查

容器内置健康检查，每 30 秒检查一次服务状态：

docker ps --format "table {{.Names}}\t{{.Status}}"

RouterOS (Version 7.21.3) Container

1.为容器添加veth接口，为其分配一个内网专用 IP

/interface veth
add address=192.168.88.2/24,fd88::2/64 dhcp=no gateway=192.168.88.1 gateway6=fd88::1 name=veth-msm

2.将veth 添加到网桥

/interface bridge port
add bridge=bridge1 interface=veth-msm

3.设置“Docker注册表 URL”，并为镜像设置目录

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

4.定义配置文件的挂载点

/container mounts
add list=msm_mount dst=/opt/msm src=/docker/msm_config

5.创建环境变量

/container envs
add list=msm_envs key=JWT_SECRET value=""
add list=msm_envs key=MSM_CONFIG_DIR value=/opt/msm
add list=msm_envs key=MSM_PORT value=7777
add list=msm_envs key=PATH value=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
add list=msm_envs key=TZ value=Asia/Shanghai

6.拉取 MSM 镜像并等待其提取，创建容器完成

/container
add name=msm remote-image=msmbox/msm:latest check-certificate=no interface=veth-msm mountlists=msm_mount envlists=msm_envs root-dir=/docker/msm layer-dir=layer/msm workdir=/opt/msm logging=yes start-on-boot=yes

7.启动容器 （！！！MSM 初始化向导，Linux 透明代理必须选择TUN模式！！！）

/container start [find interface=veth-msm]

重要说明

• 容器以 root 权限运行，并需要特权模式以支持透明代理、TUN 设备等高级网络功能
• Docker 部署目前仅支持 Host 网络模式（--network host / network_mode: host），不支持桥接模式（端口映射）
• 所有网络功能（iptables、路由配置等）均由 Golang 实现，无需外部依赖
• 自动映射 /dev/net/tun 设备以支持 TUN 模式
• 建议在可信网络环境中运行，或配置适当的网络隔离措施