5分钟极速部署Spug：Docker Compose全自动化运维实战指南

每次登录十几台服务器手动更新配置时，我总在想要是有个工具能批量执行命令就好了。直到发现Spug这个开箱即用的运维神器，它让我从重复劳动中彻底解放——而最惊喜的是，用Docker Compose部署它只需要5分钟。

1. 为什么选择Spug+Docker Compose方案？

传统运维平台部署往往需要配置数据库、安装依赖、编译前端，整个过程可能耗费半天时间。而Spug官方提供的Docker镜像已经将Python运行环境、Node.js编译结果和MySQL数据库全部打包，配合Docker Compose的容器编排能力，真正实现了"一条命令完成部署"。

对比其他方案的三大优势：

• 零环境依赖：不需要在主机安装Python、Node.js等任何运行时
• 隔离性：所有组件运行在独立容器中，不污染主机环境
• 可移植性：配置文件即部署方案，轻松迁移到其他服务器

提示：虽然Spug支持传统部署方式，但Docker方案能节省90%的初始化时间，特别适合快速验证和中小团队使用。

2. 五分钟部署实战

2.1 准备Docker环境

确保系统已安装Docker和Docker Compose插件。主流Linux发行版只需执行：

# Ubuntu/Debian
sudo apt update && sudo apt install -y docker.io docker-compose-plugin

# CentOS/RHEL
sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install -y docker-ce docker-ce-cli docker-compose-plugin
sudo systemctl enable --now docker

验证安装是否成功：

docker --version && docker compose version

2.2 编写Compose配置文件

创建docker-compose.yml文件，这是整个部署的核心：

version: "3.8"

services:
  db:
    image: mariadb:10.8
    container_name: spug-db
    restart: unless-stopped
    environment:
      MYSQL_DATABASE: spug
      MYSQL_USER: spug
      MYSQL_PASSWORD: spug123
      MYSQL_ROOT_PASSWORD: root123
    volumes:
      - spug_db:/var/lib/mysql

  spug:
    image: openspug/spug-service:v3
    container_name: spug
    depends_on:
      - db
    ports:
      - "9000:80"
    privileged: true
    restart: unless-stopped
    environment:
      - MYSQL_HOST=db
      - MYSQL_PORT=3306
      - MYSQL_USER=spug
      - MYSQL_PASSWORD=spug123
      - MYSQL_DATABASE=spug
    volumes:
      - spug_data:/data/spug
      - spug_repos:/data/repos

volumes:
  spug_db:
  spug_data:
  spug_repos:

关键配置说明：

参数	说明	建议值
ports	服务暴露端口	9000:80（避免与现有服务冲突）
MYSQL_PASSWORD	数据库密码	建议修改为复杂密码
volumes	数据持久化	必须配置防止数据丢失

2.3 启动服务并初始化

一键启动所有服务：

docker compose up -d

初始化管理员账户（将admin/password替换为你的凭证）：

docker exec spug init_spug admin password

3. 核心功能快速上手

3.1 批量执行命令

这是Spug最实用的功能之一。假设我们需要在10台服务器上检查磁盘空间：

1. 在"主机管理"添加所有服务器（支持SSH密钥认证）
2. 进入"批量执行"→"执行任务"
3. 选择目标主机，输入命令：df -h | grep -v overlay
4. 点击"开始执行"，实时查看所有主机返回结果

高阶技巧：将常用命令保存为模板，比如这个检查磁盘的模板我命名为"disk_check"，下次直接调用。

3.2 Web终端管理

不再需要记住各服务器的IP和密码：

1. 在主机列表找到目标服务器
2. 点击"Web终端"按钮
3. 直接获得交互式Shell界面

注意：首次连接可能需要输入SSH密码或密钥密码，之后会话会被加密存储。

3.3 文件分发实战

部署一个Nginx配置文件到所有Web服务器：

# 在Spug的"文件分发"界面
1. 上传本地nginx.conf文件
2. 选择目标路径：/etc/nginx/conf.d/
3. 设置权限为644
4. 选择目标主机组"web-servers"
5. 执行分发

整个过程比手动SCP高效十倍，特别是当需要同时操作多台服务器时。

4. 进阶配置与优化

4.1 邮件报警设置

在"系统管理"→"报警设置"中配置SMTP：

邮件服务器: smtp.example.com
端口: 465
SSL: 启用
发件人: monitor@example.com
用户名: your_email
密码: your_password

测试配置后，可以在监控任务中设置触发条件，比如当磁盘使用超过90%时自动发送告警。

4.2 定时任务管理

Spug内置了强大的任务调度系统，比crontab更直观。例如设置每天凌晨3点清理日志：

1. 进入"任务计划"→"新建任务"
2. 设置Cron表达式：0 3 * * *
3. 选择执行主机
4. 输入命令：find /var/log -type f -mtime +7 -delete
5. 保存后任务会自动生效

4.3 安全加固建议

1. 修改默认端口：编辑Compose文件将9000改为非常用端口
2. 启用HTTPS：在Nginx反向代理后配置SSL证书
3. 定期备份：对Docker卷进行定时备份

   # 备份命令示例
   docker run --rm -v spug_data:/data -v $(pwd):/backup busybox tar czf /backup/spug_data_$(date +%Y%m%d).tar.gz /data
   

5. 常见问题排错指南

Q1: 访问9000端口无响应

• 检查防火墙：sudo ufw allow 9000
• 查看容器日志：docker logs spug
• 确认端口映射正确：docker ps查看PORTS列

Q2: Web终端连接失败

• 确认主机SSH服务正常运行
• 检查是否启用密钥认证且密钥已添加到Spug
• 测试网络连通性：docker exec spug ping 目标主机IP

Q3: 数据库连接问题

# 进入数据库容器检查
docker exec -it spug-db mysql -uroot -p
> SHOW DATABASES;  # 确认spug库存在
> SELECT User FROM mysql.user;  # 确认spug用户存在

性能调优参数： 对于超过50台主机的环境，建议调整Compose配置：

environment:
  - WORKER_COUNT=4  # 默认2个worker进程
  - TASK_WORKERS=8  # 任务执行并发数

记得第一次登录后立即修改管理员密码，然后创建一个专属角色并分配权限，而不是直接使用admin账户操作。我在实际使用中发现，合理规划角色权限能大幅降低误操作风险——比如给新人分配只读权限，给运维人员分配批量执行权限但不给系统设置权限。