johann8/alpine-meshcentral

MeshCentral Alpine Docker镜像 🐋

!https://img.shields.io/docker/pulls/johann8/alpine-meshcentral?style=flat-square !https://img.shields.io/docker/image-size/johann8/alpine-meshcentral

关于

本镜像为https://github.com/Ylianst/MeshCentral%E7%9A%84Docker%E7%89%88%E6%9C%AC%EF%BC%8C%E5%9F%BA%E4%BA%8EAlpine%E7%B3%BB%E7%BB%9F%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%94%AF%E6%8C%81MongoDB%E6%95%B0%E6%8D%AE%E5%BA%93%E3%80%82

虽然部署和启动相对简单，但仍建议参考官方指南以获取详细信息：

• MeshCentral2安装指南
• MeshCentral2用户指南

免责声明

本镜像使用了MongoDB这一专用数据库解决方案。

安装部署

推荐通过docker-compose方式启动镜像（以下为示例配置）。通过环境变量可定义初始设置，快速完成部署。若需自定义未被环境变量覆盖的配置，可在初始化容器前，将编辑好的config.json文件放入meshcentral-data目录（建议参考用户指南进行配置）。容器初始化后，修改config.json并重启容器即可更新设置。

docker-compose.yml示例

yaml
version: '3.7'

networks:
  meshcentralNet:
    ipam:
      driver: default
      config:
        - subnet: ${SUBNET}.0/24

services:
  meshcentral:
    restart: always
    container_name: meshcentral
    image: johann8/alpine-meshcentral:${MC_VERSION}
    # 若使用Apache反向代理则注释以下端口配置
    #ports:
      #- 127.0.0.1:8084:443  # MeshCentral默认避免使用80端口，但可根据需求修改config.json后使用
      #- 8086:443
    environment:
      - TZ=${TZ} # 时区
      - HOSTNAME=${HOSTNAME_MC} # 主机名
      - REVERSE_PROXY=${REVERSE_PROXY} # 反向代理地址
      - REVERSE_PROXY_TLS_PORT=${REVERSE_PROXY_TLS_PORT} # 反向代理TLS端口
      - NODE_ENV=${NODE_ENV} # 运行环境（如production）
      - USE_TRAEFIK=${USE_TRAEFIK} # 是否使用Traefik反向代理
      - PORT=${PORT} # 服务端口
      - USE_MONGODB=${USE_MONGODB} # 是否启用MongoDB
      - MONGO_URL=${MONGO_URL} # MongoDB连接字符串
      - MONGO_DB_NAME=${MONGO_DB_NAME} # MongoDB数据库名
      - MONGO_MC_USERNAME=${MONGO_MC_USERNAME} # MeshCentral的MongoDB用户名
      - MONGO_MC_USER_PASSWORD=${MONGO_MC_USER_PASSWORD} # MeshCentral的MongoDB密码
      - IFRAME=${IFRAME} # 是否启用iframe支持
      - ALLOW_NEW_ACCOUNTS=${ALLOW_NEW_ACCOUNTS} # 是否允许新用户注册（除初始管理员外）
      - WEBRTC=${WEBRTC} # 是否启用WebRTC（需谨慎使用，非官方正式版功能）
      - LOCALSESSIONRECORDING=${LOCALSESSIONRECORDING} # 是否允许会话录制
      - MINIFY=${MINIFY} # 是否启用JSON压缩以减少流量
    volumes:
      # 存储config.json等重要文件，必须挂载以持久化数据
      - "${DOCKERDIR}/data/mc/data:/opt/meshcentral/meshcentral-data"
      # 用户文件上传目录
      - "${DOCKERDIR}/data/mc/user_files:/opt/meshcentral/meshcentral-files"
      # 备份文件目录
      - "${DOCKERDIR}/data/mc/backups:/opt/meshcentral/meshcentral-backups"
      # 站点自定义文件目录
      - "${DOCKERDIR}/data/mc/web:/opt/meshcentral/meshcentral-web"
    env_file:
      - .env # 加载环境变量文件
    depends_on:
      - mongodb # 依赖MongoDB服务
    networks:
      - meshcentralNet # 加入自定义网络

  # MeshCentral的MongoDB服务
  mongodb:
    image: mongo:latest
    container_name: mongodb
    restart: "always"
    environment:
      - MONGO_INITDB_ROOT_USERNAME=${MONGO_INITDB_ROOT_USERNAME} # MongoDB根用户名
      - MONGO_INITDB_ROOT_PASSWORD=${MONGO_INITDB_ROOT_PASSWORD} # MongoDB根密码
    volumes:
      # MongoDB数据持久化目录
      - "${DOCKERDIR}/data/mongodb/dbdata:/data/db"
    env_file:
      - .env
    networks:
      - meshcentralNet

docker-compose.override.yml示例（Traefik反向代理配置）

yaml
version: "3.7"
services:
  meshcentral:
    labels:
      - "traefik.enable=true" # 启用Traefik

      ### === 重定向到HTTPS ===
      - "traefik.http.routers.meshcentral-secure.entrypoints=websecure"
      - "traefik.http.routers.meshcentral-secure.rule=Host(`$HOSTNAME0.$DOMAINNAME`)" # 匹配域名
      - "traefik.http.routers.meshcentral-secure.tls=true" # 启用TLS
      - "traefik.http.routers.meshcentral-secure.tls.certresolver=production" # 使用自定义证书解析器
      ### === 路由到服务 ===
      - "traefik.http.routers.meshcentral-secure.service=meshcentral"
      - "traefik.http.services.meshcentral.loadbalancer.server.port=${PORT}" # 服务端口
      - "traefik.http.services.meshcentral.loadbalancer.passHostHeader=true" # 传递主机头
      - "traefik.docker.network=proxy" # 加入Traefik代理网络
      ### === 中间件配置 ===
      - "traefik.http.routers.meshcentral-secure.middlewares=secHeaders@file,traefik-compress@file" # 安全头和压缩
      #- "traefik.http.routers.meshcentral-secure.middlewares=authelia@docker,rate-limit@file,secHeaders@file" # 可选：添加认证和限流
    networks:
      - proxy # 加入外部代理网络

networks:
  proxy:
    external: true # 使用外部已存在的网络

.env示例（环境变量配置）

yaml
#
### === 系统配置 ===
#
# 时区
TZ="Europe/Berlin"
# Docker文件目录
DOCKERDIR=/opt/meshcentral

#
### === 网络配置 ===
#
# MeshCentral主机名
HOSTNAME_MC=mc.changeme.de
# 域名
DOMAINNAME=changeme.de
# 子域名前缀
HOSTNAME0=mc
# 服务端口
PORT=4430
# 网络子网
SUBNET=172.26.8
# 反向代理地址
REVERSE_PROXY=${HOSTNAME_MC}
# 反向代理TLS端口
REVERSE_PROXY_TLS_PORT=443

#
### === MeshCentral应用配置 ===
#
# 运行环境（生产环境为production）
NODE_ENV=production
# MeshCentral镜像版本
MC_VERSION=latest
# 是否使用Traefik反向代理
USE_TRAEFIK="true"
# 是否启用MongoDB
USE_MONGODB=true
# MeshCentral的MongoDB用户名
MONGO_MC_USERNAME=meshuser
# MeshCentral的MongoDB密码（建议使用强密码）
MONGO_MC_USER_PASSWORD=User-PW-ChangeMe135
# MongoDB数据库名
MONGO_DB_NAME=meshcentral
# 已存在的MongoDB连接字符串（若使用外部MongoDB）
MONGO_URL=
# MongoDB根用户名（若部署新MongoDB服务）
MONGO_INITDB_ROOT_USERNAME=admin
# MongoDB根密码（建议使用强密码）
MONGO_INITDB_ROOT_PASSWORD=Root-PW-ChangeMe579
# 是否启用iframe支持
IFRAME=false
# 是否允许新用户注册（除初始管理员外）
ALLOW_NEW_ACCOUNTS=false
# 是否启用WebRTC（非官方正式功能，需谨慎）
WEBRTC=true
# 是否允许会话录制
LOCALSESSIONRECORDING=false
# 是否启用JSON压缩
MINIFY=true

若不想使用预构建镜像，也可自行构建。构建时需确保包含config.json.template和startup.sh文件（若未修改Dockerfile）。

https://github.com/johann8/alpine-meshcentral