Internet Pi 项目安装与使用指南
1. 项目目录结构及介绍
internet-pi
项目的目录结构如下:
internet-pi/
├── ansible-lint
├── gitignore
├── yamllint
├── LICENSE
├── README.md
├── ansible.cfg
├── example.config.yml
├── example.inventory.ini
├── main.yml
├── requirements.yml
├── files/
│ ├── images/
│ └── internet-monitoring/
├── tasks/
└── templates/
目录结构介绍
ansible-lint
: Ansible 代码风格检查工具的配置文件。gitignore
: Git 忽略文件配置。yamllint
: YAML 代码风格检查工具的配置文件。LICENSE
: 项目许可证文件。README.md
: 项目说明文档。ansible.cfg
: Ansible 配置文件。example.config.yml
: 示例配置文件。example.inventory.ini
: 示例库存文件。main.yml
: 主 Ansible Playbook 文件。requirements.yml
: Ansible Galaxy 依赖文件。files/
: 包含项目所需的文件,如图片和监控配置文件。tasks/
: 包含 Ansible 任务文件。templates/
: 包含 Ansible 模板文件。
2. 项目启动文件介绍
main.yml
main.yml
是项目的启动文件,它是一个 Ansible Playbook,用于配置和管理 Raspberry Pi 上的各种 Internet 相关服务。该文件定义了多个任务,包括安装 Docker、配置 Pi-hole、设置 Internet 监控等。
主要任务
- 安装 Docker: 确保 Docker 和 Docker Compose 已安装并配置。
- 配置 Pi-hole: 安装和配置 Pi-hole,用于网络广告拦截和 DNS 服务。
- Internet 监控: 安装 Prometheus 和 Grafana,用于监控网络连接速度和状态。
3. 项目配置文件介绍
example.config.yml
example.config.yml
是一个示例配置文件,用户可以根据自己的需求进行修改。该文件包含了多个配置项,用于定义项目的各种功能和参数。
主要配置项
- pihole_enable: 是否启用 Pi-hole 功能。
- monitoring_enable: 是否启用 Internet 监控功能。
- shelly_plug_enable: 是否启用 Shelly Plug 监控功能。
- airgradient_enable: 是否启用 AirGradient 监控功能。
- starlink_enable: 是否启用 Starlink 监控功能。
example.inventory.ini
example.inventory.ini
是一个示例库存文件,用于定义 Ansible 管理的设备列表。用户可以根据实际情况修改该文件,指定 Raspberry Pi 的 IP 地址或使用本地连接。
主要配置项
- [pi]: 定义 Raspberry Pi 的 IP 地址或使用本地连接。
总结
通过以上介绍,您可以了解 internet-pi
项目的目录结构、启动文件和配置文件。根据这些信息,您可以轻松地配置和管理 Raspberry Pi 上的 Internet 相关服务。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考