goaway 的安装和配置教程

项目基础介绍

goaway 是一个轻量级的 DNS Sinkhole，用于阻止不需要的域名，它受到了 Pi-hole 的启发。该项目主要使用 Go 和 TypeScript 编程语言开发，提供了一个基于 Web 的管理仪表板，用于管理和监控 DNS 过滤活动。

项目使用的关键技术和框架

• Go：用于后端服务的主要编程语言，提供了 DNS 服务和统计功能。
• TypeScript：用于前端仪表板的开发，通过编译成 JavaScript 在浏览器中运行。
• Docker：容器化技术，用于打包和运行 goaway 服务，简化了部署过程。
• Web 框架：可能使用了某种前端框架（如 React 或 Vue.js），用于构建仪表板用户界面。

准备工作

在开始安装 goaway 之前，请确保您的系统满足以下要求：

• 操作系统：Linux、macOS 或 Windows
• Docker（如果选择 Docker 安装方式）
• 支持的架构：amd64、arm64 或 386

请根据您的操作系统和架构下载并安装必要的依赖。

安装步骤

Docker 安装（推荐）

1. 下载 Docker 并安装到您的系统。

2. 打开终端或命令提示符。

3. 运行以下命令以在容器中启动 goaway 服务：

   docker run pommee/goaway:latest
   

   或者，使用 Docker Compose 来运行服务。首先，创建一个名为 docker-compose.yml 的文件，并添加以下内容：

   version: '3'
   services:
     goaway:
       image: pommee/goaway:latest
       container_name: goaway
       ports:
         - "53:53/udp"
         - "8080:8080"
   

   然后运行以下命令启动服务：

   docker-compose up -d
   

快速安装

1. 打开终端或命令提示符。

2. 使用 curl 命令运行安装脚本：

   curl https://raw.githubusercontent.com/pommee/goaway/main/installer.sh | sh /dev/stdin
   

   如果您想安装特定版本的 goaway，可以使用以下命令：

   curl https://raw.githubusercontent.com/pommee/goaway/main/installer.sh | sh /dev/stdin 0.40.4
   

   安装脚本会检测您的操作系统和架构，下载相应的二进制文件，并将其安装到 ~/.local/bin 目录。

从源代码构建

1. 克隆 goaway 仓库到本地：

   git clone https://github.com/pommee/goaway.git
   cd goaway
   

2. 构建前端客户端：

   make build
   

3. 构建 goaway 二进制文件：

   go build -o goaway
   

4. 运行 goaway：

   ./goaway
   

请按照上述步骤操作，您应该能够成功安装并配置 goaway。如果遇到任何问题，请查看项目的官方文档或访问 GitHub 仓库以获取进一步的帮助。