安装与配置

系统要求

在安装坦克渐进式 web 应用访问助手（pwa3）之前，请确保您的系统满足以下最低要求：

操作系统：坦克 PWA3 支持多种主流 Linux 发行版和 Windows，包括但不限于：
- CentOS Stream 9 64位
- Ubuntu Desktop 22 64位
- Debian GNU/Linux 12 (bookworm) 64位
- 深度桌面 20 64位
- 优麒麟 22 64位
- Windows 10 64 位

硬件要求：
- CPU：至少 1 核
- 内存：至少 512MB
- 硬盘空间：至少 100MB 可用空间

网络要求：
- 稳定的网络连接，用于下载软件和更新
- 配置好静态 IP 地址，以便于坦克 PWA3 稳定运行。

下载与安装过程

下载坦克 PWA3：
- 访问坦克 PWA3 的官方网站或下载页面，下载最新版本的坦克 PWA3 软件包。
- 下载链接：坦克 PWA3 下载页面

创建安装目录：
- 在您的系统中创建一个目录，用于存放坦克 PWA3 软件。例如，您可以创建一个名为 tank-pwa3 的目录：
```
mkdir tank-pwa3
cd tank-pwa3
```

解压软件包：
- 将下载的软件包解压到刚刚创建的目录中。例如，如果您下载的是一个名为 tankpwa3_v0.1.6_linux_amd64.tar.gz 的文件，可以使用以下命令解压：
```
tar -xzvf tankpwa3_v0.1.6_linux_amd64.tar.gz
```

赋予执行权限：
- 解压完成后，需要赋予坦克 PWA3 可执行权限：
```
chmod +x tankpwa3    
```

安装坦克 PWA3：
- 使用 sudo 权限运行坦克 PWA3 安装脚本：
```
sudo ./tankpwa3 安装
```
- 安装过程中，坦克 PWA3 会生成必要的配置文件和数据目录。

配置文件解析与初始化设置

配置文件结构：
- 安装完成后，坦克 PWA3 会在当前目录下生成一系列名为 虚拟机 和 记录 等等文件夹，以及一个名为 生产环境.tconf 的配置文件。
- 生产环境.tconf文件是坦克 PWA3 的主要配置文件，用于定义坦克 PWA3 的各种行为。

配置文件示例：

以下是一个简单的 生产环境.tconf 文件部份示例：

=#"，,《{》}“”！!	

#全局配置

语言=zh-CN

#坦克PWA访问助手虽然通过 tk.shos 域名可以访问到，但这是基于 坦克NS 提供的灵活局域网域名才能实现。如果在公网，你可能需要通过其它域名访问坦克PWA访问助手，这时，你就需要绑定域名功能了。绑定后，坦克PWA访问助手就会判断是否是 目标绑定域名 然后路由到自己这里。可以绑定多个域名，使用，（逗号）分隔。

绑定域名=「tankpwa3.tankprint.online」

!监听网络接口=0.0.0.0

#软件运行过程会产生记录，包括：错误，消息。这些记录会对外输出给用户，当你使用 systemD 启动的时候，会保存到“记录保存文件”字设置的文件里面，当你在前台运行的时候，除了保存在上面指定的文件里面，还会输出到终端。如果不需要这个功能，请添加！号注释它。
运行情况记录《
    记录保存文件=./日志.txt
》

初始化设置：
- 首次运行坦克 PWA3 时，它会读取 生产环境.tconf 文件并加载相应的配置。您可以根据需要修改配置文件中的各项设置。
- 例如，如果您希望坦克 PWA3 监听回环地址，可以将 监听网络接口 设置为 127.0.0.1 ：
```
监听网络接口=127.0.0.1
```

启动服务：

使用以下命令启动坦克 PWA3 服务：

sudo ./tankpwa3 前台运行
# 或者使用 systemd 运行服务
# sudo systemctl start tank-pwa3.service

服务启动后，坦克 PWA3 会自动加载配置文件并开始监听指定的 IP 和端口。

如果遇到下面这个问题：

已经有程序正在使用 UDP/53 端口，请先关闭 53 端口后再运行软件。机器消息：listen udp :53: bind: address already in use

解决这个问题只需要按照这个步骤：

sudo lsof -i:53

# 输出
COMMAND  PID    USER   FD   TYPE DEVICE SIZE/OFF NODE NAME
dnsmasq 5062 dnsmasq    6u  IPv4  15935      0t0  UDP Workspace:domain 
dnsmasq 5062 dnsmasq    7u  IPv4  15936      0t0  TCP Workspace:domain (LISTEN)

# 杀掉 5062 端口，你的终端不一定是这个端口，可能是其它端口。
sudo kill -9 5062

然后重启服务。

验证安装：
- 为了确保坦克 PWA3 安装成功并正常运行，可以打开浏览器访问 http://127.0.0.1:9094/ 访问网站首页。
- 输入用户名 tankpwa3 和密码 123456 登陆。

通过以上步骤，您可以顺利完成坦克 PWA3 的安装与初始配置。接下来，您可以进入快速入门部分，了解如何使用坦克 PWA3 的基本功能。

文档目录

安装与配置

系统要求

下载与安装过程

配置文件解析与初始化设置