ShellCrash容器化最佳实践：Docker Compose编排与服务健康检查

ShellCrash容器化最佳实践：Docker Compose编排与服务健康检查

【免费下载链接】ShellCrash RM 项目地址: https://gitcode.com/GitHub_Trending/sh/ShellCrash

容器化部署已成为现代应用架构的核心实践，ShellCrash作为基于Linux内核的网络工具包，通过Docker Compose实现服务编排可显著提升部署一致性与运维效率。本文将从环境准备、配置编排到健康监控，完整呈现企业级容器化解决方案。

容器化架构设计

ShellCrash容器化部署采用"应用容器+数据卷"分离架构，通过Docker Compose实现多服务协同。核心组件包括：

• 主应用容器：运行ShellCrash核心服务，基于Alpine构建最小镜像
• 配置数据卷：持久化存储规则配置与运行时数据
• 健康检查容器：独立监控主服务状态，实现自动恢复

关键配置文件路径：

• 启动脚本：scripts/start.sh
• 服务管理：scripts/menu.sh
• 规则配置：rules/ShellCrash.ini

环境准备与基础镜像构建

系统要求

• Docker Engine 20.10+
• Docker Compose v2+
• 内核版本≥3.10的Linux系统

基础镜像选择

官方推荐使用Alpine作为基础镜像，通过以下命令快速启动容器环境：

docker run -d --name ShellCrash alpine sleep infinity
docker exec -it ShellCrash sh

详细步骤参见README_CN.md中"虚拟机/Docker环境安装"章节

自定义镜像构建

创建Dockerfile优化基础镜像：

FROM alpine:3.18
RUN apk add --no-cache curl iptables nftables
WORKDIR /ShellCrash
COPY . .
RUN chmod +x install.sh scripts/*.sh
ENTRYPOINT ["/ShellCrash/scripts/start.sh"]

Docker Compose编排实现

核心配置文件

创建docker-compose.yml实现服务定义：

version: '3.8'
services:
  shellcrash:
    build: .
    container_name: shellcrash-core
    restart: always
    network_mode: "host"
    volumes:
      - ./config:/ShellCrash/configs
      - ./rules:/ShellCrash/rules
      - ./logs:/ShellCrash/logs
    environment:
      - TZ=Asia/Shanghai
      - REDIR_MODE=混合模式
      - MIX_PORT=7890
    healthcheck:
      test: ["CMD", "/ShellCrash/scripts/healthcheck.sh"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 60s

数据卷配置策略

卷路径	用途	备份策略
./config	配置文件	每日备份
./rules	规则列表	版本控制
./logs	运行日志	日志轮转

健康检查机制实现

健康检查脚本

创建scripts/healthcheck.sh实现服务状态检测：

#!/bin/sh
# 检查进程状态
if ! pgrep -x "CrashCore" >/dev/null; then
    exit 1
fi
# 检查API响应
if ! curl -s "http://127.0.0.1:9999/version" >/dev/null; then
    exit 1
fi
# 检查端口监听
if ! netstat -tuln | grep -q ":7890"; then
    exit 1
fi
exit 0

健康检查逻辑需与scripts/menu.sh中的状态检测保持一致

自动恢复流程

通过Docker Compose的restart策略与健康检查联动：

1. 健康检查失败3次触发容器重启
2. 重启后执行scripts/init.sh恢复环境
3. 关键错误记录至logs/error.log

性能优化与安全加固

资源限制配置

在Compose文件中添加资源约束：

deploy:
  resources:
    limits:
      cpus: '0.5'
      memory: 256M
    reservations:
      cpus: '0.2'
      memory: 128M

安全最佳实践

1. 非root用户运行：在Dockerfile中创建专用用户
2. 只读文件系统：关键目录设置只读挂载
3. capabilities限制：仅保留必要系统调用权限
4. 规则文件权限：rules/目录设置600权限

部署流程与验证步骤

完整部署命令

# 克隆仓库
git clone https://gitcode.com/GitHub_Trending/sh/ShellCrash
cd ShellCrash

# 创建环境配置
cp .env.example .env
vi .env  # 修改环境变量

# 启动服务
docker-compose up -d

# 验证部署状态
docker-compose ps
docker-compose logs -f --tail=100

功能验证清单

•  服务启动状态：docker-compose exec shellcrash crash -h
•  端口监听：netstat -tuln | grep 7890
•  规则加载：检查configs/loaded_rules.log
•  健康状态：docker inspect --format='{{.State.Health.Status}}' shellcrash-core

常见问题解决

网络模式冲突

当使用host网络模式时，需确保宿主机端口未被占用：

# 检查端口占用
ss -tuln | grep -E "7890|7892|9999"

数据卷权限问题

修复挂载目录权限：

chown -R 1000:1000 ./config ./rules ./logs

健康检查失败排查

1. 查看详细日志：docker-compose logs healthcheck
2. 手动执行检查：docker-compose exec shellcrash /ShellCrash/scripts/healthcheck.sh
3. 检查依赖：scripts/start.sh中的依赖检查部分

总结与展望

通过Docker Compose实现ShellCrash容器化部署，可显著提升：

• 环境一致性：消除"在我机器上能运行"问题
• 部署效率：单命令完成多服务编排
• 运维自动化：健康检查+自动恢复降低人工干预
• 资源利用率：容器化隔离实现资源精细控制

未来版本将引入：

• 基于Prometheus的监控指标暴露
• 多节点服务发现机制
• Kubernetes部署支持

官方文档：README_CN.md
配置示例：rules/ShellCrash_Full.ini
社区支持：通过scripts/menu.sh中的"日志推送"功能获取技术支持

【免费下载链接】ShellCrash RM 项目地址: https://gitcode.com/GitHub_Trending/sh/ShellCrash