2.2 Preview4 (docker版)

[er10yi]

魔方-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）

2. 执行以下命令，启动

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下可能需要重启一两次才行，看运气..）

2. 扫描127.0.0.1没有任何端口

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

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

​ docker-compose restart agent

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

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

4. 如何卸载

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对你有一丢丢帮助，可以动动小手关注一下公众号~~

---

This discussion was created from the release 2.2 Preview4 (docker版).

[er10yi]

如果docker-compose up -d --build时提示源过期

需要修改以下两个文件
MagiCude/initconfig/default/Dockerfile-agent
MagiCude/initconfig/default/Dockerfile-center
将 apt-get update 换成 apt-get -o Acquire::Check-Valid-Until=false update
之后再删掉install.info，重新初始化，重新build即可

[er10yi]

存在无法发送实时通知问题，可以通过新增redis缓存解决
redis执行 SET riskassetnotify "true"