CentOS 与 Docker 集成开发环境配置指南
一 环境准备与安装 Docker
- 系统要求：建议使用 CentOS 7/8，内核版本不低于 3.10（执行
uname -r 检查）。
- 卸载旧版本（如有）：
sudo yum remove -y docker
docker-client
docker-client-latest
docker-common
docker-latest
docker-latest-logrotate
docker-logrotate
docker-engine
- 安装依赖与仓库：
sudo yum install -y yum-utils device-mapper-persistent-data lvm2
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
可选（国内更快）：sudo yum-config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
- 安装 Docker 引擎：
sudo yum install -y docker-ce docker-ce-cli containerd.io
- 启动与开机自启：
sudo systemctl start docker && sudo systemctl enable docker
- 验证：
docker --version
docker run --rm hello-world
以上步骤覆盖在线安装、版本选择与基础验证，适用于 CentOS 7/8。
二 基础配置与用户权限
- 非 root 用户免 sudo 使用 Docker：
sudo usermod -aG docker $USER
newgrp docker # 或重新登录终端
- 镜像加速器（国内环境强烈建议）：
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-‘EOF’
{
“registry-mirrors”: [“https://.mirror.aliyuncs.com”]
}
EOF
sudo systemctl daemon-reload && sudo systemctl restart docker
- 日志与存储优化（可选）：
sudo tee -a /etc/docker/daemon.json <<-‘EOF’
{
“log-driver”: “json-file”,
“log-opts”: {
“max-size”: “100m”,
“max-file”: “3”
},
“storage-driver”: “overlay2”
}
EOF
sudo systemctl restart docker
- 如需暴露 Docker API（仅在内网可信环境）：
sudo firewall-cmd --permanent --add-port=2375/tcp && sudo firewall-cmd --reload
以上配置涵盖用户组、加速器、日志轮转与存储驱动，兼顾性能与可维护性。
三 多容器开发环境搭建与编排
- 示例目标：使用 Docker Compose 编排 Nginx + 应用 + Redis，实现代码热更新与日志持久化。
- 目录结构建议：
project/
├─ docker-compose.yml
├─ nginx/
│ └─ nginx.conf
├─ app/
│ └─ index.html（示例）
└─ logs/
- docker-compose.yml（示例）：
version: “3.8”
services:
app:
build: ./app
volumes:
- ./app:/usr/src/app
- ./logs/app:/var/log/app
environment:
- ENV=development
redis:
image: redis:alpine
volumes:
- redis-data:/data
nginx:
image: nginx:alpine
ports:
- “8080:80”
volumes:
- ./nginx/nginx.conf:/etc/nginx/nginx.conf:ro
- ./logs/nginx:/var/log/nginx
- ./app:/usr/share/nginx/html:ro
depends_on:
- app
volumes:
redis-data:
- 构建与启动：
docker-compose up -d --build
docker-compose logs -f
- 常用命令：
docker-compose ps
docker-compose exec app sh
docker-compose down
该示例展示了多服务编排、卷挂载、端口映射与依赖管理，适合快速搭建一致的开发环境。
四 IDE 集成与远程调试
- VS Code + Docker 扩展：
- 安装 VS Code 与 Docker 扩展；在扩展中连接本机 Docker（Linux 本机通常无需额外配置）。
- 使用 Dev Containers 打开项目，自动构建开发容器；通过 .devcontainer 配置开发镜像、端口转发与启动任务。
- 适合 Python/Node.js/Go 等语言，结合卷挂载实现代码热更新与调试。
- PhpStorm（在 CentOS 上）：
- 安装 Docker 后，在 Settings → PHP → CLI Interpreter 选择 From Docker；
- 在 Settings → PHP → Docker 配置 Docker Compose 文件路径；
- 在 Settings → PHP → Debug 配置 PHP Remote Debug 与路径映射，实现断点调试。
上述集成可显著提升本地与容器内的开发调试效率，并保持环境一致性。
五 可视化管理与运维实践
- Portainer 管理面板：
docker run -d -p 9000:9000
-v /var/run/docker.sock:/var/run/docker.sock
-v portainer_data:/data
–restart always
–name portainer portainer/portainer
访问 http://<服务器IP>:9000 完成初始化，集中管理容器、镜像、网络与卷。
- 资源清理与成本控制：
- 定期清理无用资源：
docker system prune -af --volumes
- 在 CI/CD 或定时任务中清理旧镜像（示例：删除 48 小时前未使用的镜像）：
docker image prune -a -f --filter “until=48h”
- 安全提示：
- 避免将 2375/TCP 暴露在公网；如需远程 API，使用 TLS 或仅在受控内网开放。
- 遵循最小权限原则，谨慎使用特权容器与主机挂载。
Portainer 提供直观的 Web 管理界面，配合定时清理策略可保持开发环境轻量与稳定。
