企业官网建设流程全解析

ARL灯塔Docker部署全流程排错手册：从容器异常到安全访问

最近在帮团队部署ARL资产侦察系统时，发现不少同事都会卡在Docker环境配置和容器启动环节。明明按照教程执行了所有命令，却在最后访问https://localhost:5003时遇到各种"拦路虎"。本文将结合实战中遇到的七个典型故障场景，手把手带你打通ARL灯塔的部署全流程。

1. 环境预检：避开90%的基础配置错误

在拉取ARL镜像前，建议先完成这三个关键检查项：

# 检查Docker服务状态（Active状态为正常） systemctl status docker | grep Active # 验证当前用户是否在docker组（避免后续权限问题） groups | grep docker # 检测5003端口占用情况（返回空表示端口可用） netstat -tulnp | grep 5003

常见问题排查表：

提示：生产环境建议提前配置好Docker镜像加速器，可显著提升ARL镜像拉取速度

2. 容器启动异常深度排查指南

当执行docker-compose up -d后看不到ARL容器运行时，按这个顺序排查：

2.1 检查容器创建状态

# 查看最近创建的容器（包括已停止的） docker ps -a --latest # 若看到Exited状态容器，检查日志 docker logs <容器ID>

典型日志错误及解决方案：

1. 数据库卷挂载失败：

   Error response from daemon: create arl_db: driver "local" failed to create volume

   手动创建数据卷：

   docker volume create --name=arl_db

2. 证书生成失败：

   openssl req: Can't open /etc/nginx/cert/server.crt

   需确保cert目录存在且可写：

   mkdir -p cert && chmod 777 cert

2.2 系统级限制检查

对于SELinux开启的系统（如CentOS），需要额外配置：

# 临时设置SELinux为permissive模式 setenforce 0 # 永久修改需编辑/etc/selinux/config SELINUX=permissive

3. HTTPS访问失败的六种修复方案

即使容器正常运行，访问https://localhost:5003仍可能遇到：

3.1 证书信任问题

ARL默认使用自签名证书，浏览器会显示不安全警告。可通过以下方式解决：

# 从容器内导出证书（需先获取容器ID） docker cp <容器ID>:/etc/nginx/cert/server.crt . # 将证书导入系统信任库（Linux示例） sudo cp server.crt /usr/local/share/ca-certificates/ sudo update-ca-certificates

3.2 防火墙配置

UFW防火墙放行命令：

sudo ufw allow 5003/tcp sudo ufw reload

Firewalld防火墙放行命令：

sudo firewall-cmd --add-port=5003/tcp --permanent sudo firewall-cmd --reload

4. 性能优化与高可用配置

默认配置可能无法满足大规模资产扫描需求，建议调整：

# 修改docker-compose.yml中的资源限制 services: arl: deploy: resources: limits: cpus: '2' memory: 4G reservations: memory: 2G

数据库优化参数（修改arl/config-docker.yaml）：

mongodb: poolSize: 50 maxPoolSize: 100 socketTimeoutMS: 60000

5. 日常维护与监控

推荐部署以下监控方案：

# 容器资源监控 docker stats arl_web_1 # 日志实时查看（Ctrl+C退出） docker logs -f arl_web_1 # 健康检查端点 curl -k https://localhost:5003/api/status

关键指标监控表：

6. 备份与迁移方案

为确保资产数据安全，建议定期执行：

# 数据库备份（需先安装mongodb-clients） docker exec arl_mongo_1 mongodump --archive=/data/db/backup.gz --gzip # 将备份文件复制到宿主机 docker cp arl_mongo_1:/data/db/backup.gz . # 迁移到新环境时恢复数据 docker cp backup.gz new_mongo:/data/db/ docker exec new_mongo mongorestore --archive=/data/db/backup.gz --gzip

7. 进阶安全加固措施

生产环境部署还需注意：

1. 修改默认管理员密码：

   # 进入ARL容器 docker exec -it arl_web_1 bash # 执行密码修改脚本 python3 manage.py changepassword admin

2. 配置Nginx反向代理时，建议添加：

   location / { proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header Host $http_host; proxy_redirect off; proxy_pass https://arl_web:5003; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; }

3. 定期更新镜像版本：

   docker-compose pull docker-compose up -d --force-recreate

遇到特别棘手的问题时，可以尝试重置整个环境：

# 完全清理ARL环境（谨慎操作！） docker-compose down -v docker volume rm arl_db rm -rf cert/