dgraziotin/smokeping-slave

dgraziotin/smokeping-slave 镜像文档

镜像概述和主要用途

dgraziotin/smokeping-slave是一个Docker化的Smokeping从节点镜像，基于https://github.com/linuxserver/docker-smokeping%E6%9E%84%E5%BB%BA%EF%BC%8C%E7%94%A8%E4%BA%8E%E4%BD%9C%E4%B8%BA%E5%8F%A6%E4%B8%80%E4%B8%AASmokeping%E5%AE%9E%E4%BE%8B%EF%BC%88%E5%8F%AF%E4%BD%BF%E7%94%A8%E5%8E%9Flinuxserver/smokeping%E9%95%9C%E5%83%8F%EF%BC%89%E7%9A%84%E4%BB%8E%E8%8A%82%E7%82%B9%E8%BF%90%E8%A1%8C%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E4%BF%9D%E7%95%99%E4%BA%86linuxserver.io%E6%8F%90%E4%BE%9B%E7%9A%84%E6%89%80%E6%9C%89%E7%89%B9%E6%80%A7%EF%BC%8C%E5%8C%85%E6%8B%AC%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E6%94%AF%E6%8C%81%E3%80%81%E6%96%87%E4%BB%B6%E7%B3%BB%E7%BB%9F%E6%9D%83%E9%99%90%E7%AE%A1%E7%90%86%E5%92%8C%E8%BD%AF%E4%BB%B6%E8%87%AA%E5%8A%A8%E6%9B%B4%E6%96%B0%E7%AD%89%E3%80%82

核心功能和特性

• 基于成熟基础：继承自linuxserver/smokeping镜像，具备其所有核心功能和特性
• 从节点功能：专门配置为Smokeping从节点，可与主节点协同工作
• 兼容性：支持linuxserver/smokeping的环境变量、文件权限设置和更新机制
• 安全认证：通过共享密钥与主节点进行身份验证
• 灵活配置：支持自定义容器主机名，满足主节点对从节点标识的要求

使用场景和适用范围

• 分布式网络监控：在不同网络位置部署从节点，扩展监控覆盖范围
• 多区域性能测试：从多个地理位置向主节点上报网络延迟数据
• Smokeping扩展：为现有linuxserver/smokeping主节点添加从节点能力
• 容器化部署：通过Docker简化Smokeping从节点的部署和管理流程

使用方法和配置说明

基础设置

首先需参考https://github.com/linuxserver/docker-smokeping#usage%E7%9A%84%E8%AF%B4%E6%98%8E%E8%BF%9B%E8%A1%8C%E5%9F%BA%E7%A1%80%E9%85%8D%E7%BD%AE%E3%80%82%E5%9C%A8%E6%AD%A4%E5%9F%BA%E7%A1%80%E4%B8%8A%EF%BC%8C%E8%BF%98%E9%9C%80%E6%B7%BB%E5%8A%A0%E4%BB%8E%E8%8A%82%E7%82%B9%E7%89%B9%E5%AE%9A%E9%85%8D%E7%BD%AE%E3%80%82

必须配置项

环境变量

• SHARED_SECRET: 与主节点共享的密钥，用于身份验证（例如：12345password）
• MASTER_URL: 主节点Smokeping CGI的URL（例如：http://your.smokeping.ext/smokeping/smokeping.cgi）

容器主机名

必须将容器主机名设置为主节点预期的名称，可通过Docker命令行的--hostname参数或docker-compose.yml中的hostname字段配置。

主节点配置参考

主节点推荐使用linuxserver/smokeping镜像，并需修改其配置文件以支持从节点。共享密钥文件的预期位置为/config/smokeping_secrets，具体配置方法可参考https://manpages.ubuntu.com/manpages/trusty/man7/smokeping_master_slave.7.html%E3%80%82

部署示例

Docker Compose配置

yaml
---
version: "2.1"
services:
  smokeping-slave:
    image: docker.xuanyuan.run/dgraziotin/smokeping-slave
    container_name: smokeping-slave
    hostname: smokeping-slave  # 必须设置为主节点预期的主机名
    environment:
      - PUID=1000              # 运行容器的用户ID
      - PGID=1000              # 运行容器的用户组ID
      - TZ=Europe/Berlin       # 时区设置
      - SHARED_SECRET=12345password  # 与主节点共享的密钥
      - MASTER_URL=http://your.smokeping.ext/smokeping/smokeping.cgi  # 主节点URL
    volumes:
      - </path/to/smokeping/config>:/config  # 配置文件目录（本地路径替换为实际路径）
      - </path/to/smokeping/data>:/data      # 数据存储目录（本地路径替换为实际路径）
    ports:
      - 80:80                  # 端口映射（如需访问从节点Web界面）
    restart: unless-stopped    # 容器重启策略

镜像获取

可直接使用Docker Hub上的预构建镜像：

bash
docker pull docker.xuanyuan.run/dgraziotin/smokeping-slave

也可通过项目仓库中的Dockerfile和docker-compose.yml自行构建。