...

AKR Updater

1.7.3

...

💻 安装命令
curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash

本实用指南详细介绍了该软件的分步使用方法，从发现网页界面到设置您的第一个计划任务。您还将学习如何链接您的 Discord 帐户以远程控制重启。

在开始部署应用程序之前，了解如何快速且规范地配置您的主机。整个过程依赖于在您的 Linux 终端中执行的单一 shell 命令。

安装

1

准备 Linux 环境

启动一个 Linux 系统或创建一个干净的专用 LXC 容器来承载该服务。请确保您拥有 sudo 管理员权限的终端访问权限，并具备可下载必要文件的活跃网络连接。

2

执行安装命令

打开终端并粘贴以下确切命令：curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash。确认执行以启动官方自动化安装脚本。

3

等待自动配置

让安装程序部署文件并配置后台服务。脚本会在几秒钟内自动运行，准备好系统运行所需的组件。

4

检查网络端口

检查 TCP 8080 端口是否可以从本地网络访问，或在您的应用防火墙规则中允许该端口。此端口对于与软件托管的图形管理界面通信至关重要。

5

访问网页管理面板

启动 Web 浏览器，转到您的服务器 IP 地址后接端口 8080（例如 http://IP_SERVEUR:8080）。您将进入服务器管理专用面板的首页。

6

添加第一台远程服务器

在网页面板中，填写其地址和初始连接所需的凭据，以注册您的第一台目标机器。系统将生成加密的 SSH 密钥，从而为未来的维护操作锁定安全访问。

使用指南

网页管理面板导航

可在 8080 端口访问的仪表板集中显示了所有已注册机器的状态。您可以在此查看集群的整体情况、检查最近执行的操作并浏览完整的操作历史。这个空间是您编排技术任务的核心，无需打开多个 SSH 会话。

任务规划与 SSD trim

在规划部分，您可以定义系统软件包的检查和更新频率。您还可以集成 SSD trim 优化，以保持闪存存储设备的良好性能。设置完成后，例程会根据既定时间表在后台自动运行。

警报与 Discord Bot 配置

为了实现远程监控，可以通过输入 Discord Webhook 或激活内置 Bot 来设置您的警报渠道。在 Bot 模式下，每次任务执行后，您都会收到详细的卡片通知。这些富文本通知内置了交互按钮，只需点击一下即可重启机器或安排重启计划。

管理 NetBird 实例

如果您的基础设施依赖于 NetBird，该软件支持管理其组件版本。您可以直接通过该工具对客户端和 NetBird SelfHosted 基础设施进行升级。这种原生集成确保了您的覆盖网络版本一致性，无需复杂的手动操作。

日志监控与可追溯性

定期查看界面上的操作历史记录，以审计在机器上执行的动作。如果升级后服务出现异常，日志允许您精确查看哪些软件包在何时被处理。这种可见性有助于对环境进行分析和预防性维护。

这些使用建议旨在帮助您充分利用控制面板并优化集群的安全性。实践这些建议以保持您的 Linux 环境的稳定性。

技巧

优先使用专用 LXC 容器

将工具安装在纯净的 LXC 实例中，以将服务器管理与日常应用负载隔离开来。这简化了整体备份并维护了监控服务器的完整性。

在非高峰时段进行规划

将更新和 SSD trim 周期安排在深夜空闲时段。这样可以避免意外的磁盘减速或对用户造成的短暂不可用。

利用 Discord 操作按钮

配置 Discord Bot 模式而不是被动 Webhook，以享受交互式重启按钮。这允许您从手机上确认系统重启，而无需连接到仪表板。

监控内核包

注意有关 Linux 内核更新的通知。届时安排一次主机的快速重启，以加载新的安全版本，避免机器处于中间状态。

检查已保存的 SSH 密钥

由于该工具会自动加密生成的 SSH 密钥，请确保不要手动修改目标机器上密钥目录的权限。让工具管理其自身的访问权限，以避免通信中断。

集中管理 NetBird 节点

将您的 NetBird 客户端和 SelfHosted 服务器的监控整合到同一个仪表板中。这保证了协议的完美同质性，并限制了网络版本之间不兼容的风险。

在进行重大修改前查阅历史记录

在远程服务器上安装新重型应用之前，请在历史记录中确认上次维护已无错误地完成。这样您可以确保从一个完全健康且最新的软件基础开始。

检查 8080 端口的连通性

如果您通过远程网络管理机器，请考虑将网页面板放置在安全隧道后面，或者严格过滤允许连接 8080 端口的 IP 地址。

如果访问网页面板或与远程机器通信时出现意外，请参阅此故障排除部分。它汇集了针对最常见技术阻塞点的具体解决方案。

故障排除

⚠️ 安装后 8080 端口上的网页界面无法加载
通过在终端查看当前运行的进程，检查主机上的服务是否处于活动状态。确保本地防火墙没有拦截 8080 端口的连接，并验证所使用的 IP 地址是否可从您的工作站访问。
⚠️ 添加新目标机器时连接失败
检查远程服务器的网络连通性，并确认 SSH 服务在该机器上运行正常。验证输入的临时管理员凭据是否准确，以便软件能够部署其初始加密密钥。
⚠️ Discord 警报未发送到讨论频道
检查面板设置中配置的 Webhook URL 或 Discord Bot 令牌。确保目标文本频道授予了 Bot 写入权限和发送富文本消息（embeds）的权限。
⚠️ Discord 交互按钮无法触发重启
确保您使用的是 Discord Bot 模式而不是简单的 Webhook，因为后者不支持交互功能。同时检查从主机到 Discord API 的出站通信是否被阻止。
⚠️ 特定服务器上的 SSD trim 操作失败
检查目标机器的存储是否基于支持 fstrim 命令的 SSD 介质。在虚拟机或容器的情况下，必须在虚拟机管理程序上启用 SSD 模拟选项或 discard 命令访问权限。
⚠️ NetBird SelfHosted 更新没有进展
在网页界面查看历史日志，以发现潜在的软件包或容器冲突。确保 NetBird 实例有足够的磁盘空间来下载和解压新的二进制文件。
⚠️ 初始安装时 curl 命令中断
检查您的互联网连接稳定性，并确保您的基础系统上已安装 curl 和 sudo 软件包。然后在您的终端重新运行 curl -fsSL https://dl.akra13.fr/AKRUpdaterInstaller | sudo bash 命令。
⚠️ 定时重启未在预定时间执行
检查运行 Updater 的服务器与远程机器之间的时间同步（时区和 NTP 服务）。时钟偏差可能会延迟预定任务的执行。

了解确保网页面板及其后台任务最佳运行所需的硬件和系统先决条件。该工具设计之初便保持高效节省，非常适合性能普通的硬件配置。

系统要求

最低配置

系统现代 Linux 发行版（推荐使用新建 LXC 容器）
处理器1 核 64 位处理器
内存512 MB 内存
磁盘1 GB 可用空间
网络用于下载和软件包仓库访问的互联网连接

推荐配置

系统专用 LXC 容器中的现代 Linux 发行版
处理器2 核处理器
内存1 GB 或更多内存
磁盘5 GB 可用空间（用于历史和日志）
网络宽带连接，且本地网络开放 8080 端口