Skip to content

2.2 Preview4 (docker版)

Pre-release
Pre-release
Compare
Choose a tag to compare
@er10yi er10yi released this 10 Jan 15:23
· 3 commits to main since this release
d358cbb

魔方-MagiCude 2.2预览版4 (docker版)

测试通过的系统

macOS 12.1(M1)
macOS 10.15.7
Win10 21H2 (X64)
Debian 11(PD)

说明

  1. 当前版本,对比预览版3没有任何功能更新,仅部署模式修改为docker(要更新的功能已经写完了,但是来不及合并测试....=-=先鸽着吧)
  2. 由于agent和center的通信还没确定方案,所以仅支持center和agent部署在一台服务器,建议4U8G及以上(2U4G也行,我没试)
  3. install.info有密码和端口信息
  4. dns辅助认证未完成开发
  5. 部署包为什么这么大?内置了arm版本和x64的jdk、nmap的压缩包、masscan的包
  6. 为什么要自己build,不直接拉远程镜像,同1

必须软件

docker > 20.10.11

docker-compose

需要安装docker和docker-compose之后才能部署

部署步骤

  1. 下载MagiCude.tar.gz,解压后,MagiCude目录下执行以下命令,初始化文件和密码(如果提示权限不足,使用sudo即可,不需要切到root)
docker-compose -f initconfig/docker-compose-init.yaml up --build

如果没有报错,会有前端的账号密码并提示执行步骤2(其他密码可以查看install.info)

  1. 执行以下命令,启动
docker-compose up -d --build

所有容器启动后稍等片刻,使用第一步的前端账号密码登录(登录提示502证明服务没完全启动),未修改nginx端口的情况下

本地部署,则访问 http://127.0.0.1 进行登录

服务器部署,则访问 http://服务器ip 进行登录

可能存在的问题

  1. 容器全部启动了,但无法登录,使用以下命令重启center和agent
docker-compose restart center
docker-compose restart agent

​ 之后再重新登录应该就正常了

​ 如果还是不行,就docker-compose restart后再重试(win下可能需要重启一两次才行,看运气..)

  1. 扫描127.0.0.1没有任何端口

​ agent运行的容器没有开放端口,所以肯定扫不到的,可以扫宿主机的ip

  1. 登录后没有看到agent在线,使用以下命令重启agent

docker-compose restart agent

​ 然后等一会应该能看到agent在线了

如果还有其他问题,可以docker-compose logs -f自己看日志

  1. 如何卸载
docker-compose down
docker-compose -f initconfig/docker-compose-init.yaml down

问题反馈

提issue或者进群反馈

扫描二维码关注公众号,回复自己的微信号+魔方,会有人拉你进群

公众号二维码

TODO(可能会进TDL也可能不会)

TDL

  1. 镜像推到dockerhub
  2. agent分布式部署
  3. 优化配置文件、agent在线状态(使用etcd等)
  4. 优化agent与center通信
  5. ...

免责声明

预览版,说明该版本我自己也没有用于生产环境,未经过完整测试,仅测试功能(可能有些功能会有bug)

魔方-MagiCude仅限用于甲方企业安全建设,请勿将其用于非授权的测试,本人不负任何连带法律责任

题外话

如果你觉得魔方-MagiCude对你有一丢丢帮助,可以动动小手关注一下公众号~~