bg6cq/ahstatus

bg6cq/ahstatus镜像文档

镜像概述

bg6cq/ahstatus镜像用于部署网络状态监控服务，支持通过生成GPG密钥对完成身份认证，将各测试点（如高校）的网络状态数据上传至指定平台，并可通过网页查看监控结果。适用于教育机构等场景的网络状态监测需求。

核心功能

1. 生成无密码保护的GPG密钥对用于身份认证
2. 运行监控服务并上传网络状态数据
3. 支持Docker直接运行和Docker Compose部署
4. 通过Watchtower实现镜像自动更新
5. 提供网页端查看各测试点的网络状态结果

使用场景

• 高校教育网出口网络状态监测
• 教育机构内部网络状态监控
• 多测试点的网络质量统一管理

配置说明

1. 系统环境准备

建议使用CentOS 7系统，执行以下命令安装Docker并禁用SELinux：

bash
yum update -y
yum install docker
systemctl enable docker
sed -i 's/enforcing/disabled/g' /etc/selinux/config /etc/selinux/config
reboot

2. 生成密钥对

重启后以root用户执行以下脚本生成私钥（my-sec-key.txt）和公钥（my-pub-key.txt），需修改Name-Real和Name-Email字段：

bash
gpg --batch --gen-key <<EOF
%no-protection
Key-Type:1
Key-Length:1024
Subkey-Type:1
Subkey-Length:1024
Name-Real: HTTPtest USTC
Name-Email: httptest@ustc.edu.cn
Expire-Date:0
EOF

gpg --export-secret-key --armor > /root/my-sec-key.txt
gpg --export --armor > /root/my-pub-key.txt

将公钥发送至指定***（***），私钥用于容器挂载。

3. 部署方式

Docker直接运行

测试运行（需替换SITE为测试点缩写）：

bash
docker run -it --name ahstatus -e SITE=test -e DEBUG=1 \
     -v /root/my-sec-key.txt:/my-sec-key.txt docker.xuanyuan.run/bg6cq/ahstatus

正式运行：

bash
docker container rm -f ahstatus
docker run -d --name ahstatus -e SITE=test \
     -v /root/my-sec-key.txt:/my-sec-key.txt docker.xuanyuan.run/bg6cq/ahstatus

docker run -d --name watchtower \
     -v /var/run/docker.sock:/var/run/docker.sock docker.xuanyuan.run/containrrr/watchtower --cleanup ahstatus

Docker Compose部署

创建docker-compose.yml文件（替换SITE为测试点缩写）：

yaml
version: "3"
services:
  ahstatus:
    image: docker.xuanyuan.run/bg6cq/ahstatus
    volumes:
      - /root/my-sec-key.txt:/my-sec-key.txt
    environment:
      - SITE=ustc
  watchtower:
    image: docker.xuanyuan.run/containrrr/watchtower
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    command: --cleanup ahstatus

执行部署命令：

bash
docker-compose up -d

4. 查看结果

访问http://status.ah.edu.cn:3000/查看各测试点的网络状态结果。

5. 当前测试点列表