buluma/fathom

Fathom容器（基于Ansible构建）

https://github.com/buluma/fathom-container/actions/workflows/build.yml/badge.svg](https://github.com/buluma/fathom-container/actions/workflows/build.yml) https://img.shields.io/docker/pulls/buluma/fathom](https://hub.docker.com/r/buluma/fathom/)

镜像概述

本项目提供基于Ansible构建的Fathom网站分析工具容器，支持快速部署与灵活管理，适用于需要隐私友好型流量统计的场景。项目包含三个核心部分：Ansible项目（代码维护）、Docker Hub镜像（直接使用）、Ansible角色（兼容多环境）。

核心功能

• 轻量级网站流量统计，保护用户隐私（不收集个人身份信息）
• 容器化部署，支持Docker run与Docker Compose
• 数据持久化配置，保留数据库与自定义设置
• 兼容Ansible自动化管理，可扩展至多环境

使用场景

• 个人博客或小型网站的流量监控
• 企业内部站点的访问数据统计
• 开发环境中快速验证分析工具功能

配置说明

独立部署

无需依赖本项目，直接拉取镜像运行：

bash
docker run -d --name=fathom -p 9000:9000 buluma/fathom:latest

或使用Docker Compose简化配置：

yaml
version: "3"
services:
  fathom:
    image: buluma/fathom:latest
    container_name: fathom
    ports:
      - "9000:9000"
    restart: always
    volumes: [] # 参考持久化配置添加卷

执行启动命令：

bash
docker-compose up -d

访问地址：http://localhost:9000/

数据持久化

如需保留数据，挂载卷到/opt/fathom：

bash
docker run -d --name=fathom -p 9000:9000 -v ./fathom:/opt/fathom:rw,delegated buluma/fathom:latest

Docker Compose配置：

yaml
services:
  fathom:
    ...
    volumes:
      - ./fathom:/opt/fathom:rw,delegated

Ansible管理

前提条件

• 安装Docker Community Edition
• 安装Ansible

构建镜像

1. 安装角色依赖：

bash
ansible-galaxy install -r requirements.yml

2. 执行构建剧本：

bash
ansible-playbook main.yml

3. 查看生成镜像：docker images

许可证

MIT / BSD

作者信息

由Michael Buluma于2021年创建，项目地址：https://github.com/buluma/fathom-container