查看“︁搬瓦工 KiwiVM 面板免费 AI 助手 Amy 功能演示告别繁琐的命令行”︁的源代码

== 介绍 ==

'''Amy''' 是搬瓦工在 2025 年 1 月推出的内置 AI 助手，向所有套餐免费开放。彼时的 Amy 还只是个对接了 KiwiVM 控制面板的 “问答型” AI，只能提供简单的对话以及操作建议。

在 2026 年 5 月，Amy 迎来了全面升级，不再是一个简单的问答助手，她可以直接在 VPS 执行'''任何任务'''，无论是修改系统设置、下载安装软件，还是配置复杂的环境，都能帮你一键搞定。

接下来，我们就'''由浅入深'''，通过几个高频案例，演示一下升级后的 Amy 具体能做些什么。

'''开启方式'''：登录 KiwiVM 面板，在侧边栏找到 '''Assistant Amy'''，点击右侧的 Launch 即可启动 Amy。另外，Amy 完美支持'''中文对话'''，对国内用户非常友好。

[[[bwh-amy-start]]]

<span id="一vps-测评"></span>
== 一、VPS 测评 ==

买到新机器的第一时间，肯定是迫不及待地想看配置、跑分和路由情况，以往总要在 SSH 里复制粘贴各式各样的“一键脚本”，而现在直接给 Amy 下几句简单指令就可以完成这些步骤~

=== 配置与状态 ===

让 Amy 查看一下 VPS 的具体配置，她不但能正确返回 '''CPU 型号、核心数、内存、硬盘'''等基本信息，甚至还包含了当前的'''占用情况'''。

除了能从 VPS 内获取配置信息外，Amy 还会从 KiwiVM 面板读取到'''机房位置、节点以及流量的使用情况'''等信息，这是任何第三方 AI 助手都做不到的。

[[[bwh-amy-status-1]]]

Amy 还顺便把'''当前负载、网络与防火墙、服务状态'''等信息一同输出了。

[[[bwh-amy-status-2]]]

此时你可能会有个疑问，Amy 回答的信息不会是胡编乱造的吧？为了验证一下 Amy 给出的信息，我们在 VPS 上手动运行一下 YABS，可以看到两者基本一致，Amy 输出的信息甚至更加的'''丰富和直观'''！

[[[bwh-amy-status-3]]]

=== 性能与网络 ===

了解完配置，我们直接让 Amy 测试 VPS 的性能和回程路由。在对话框中，可以实时看到每一步执行的命令以及对应的执行结果。

<blockquote>涉及到 GeekBench 跑分，测试时间会比较长，需要耐心等待。
</blockquote>
测试完成后，Amy 不仅在对话框中展示了测试报告，还把测试结果以'''文件的形式'''保存到了 VPS 本地，方便日后查看。

[[[bwh-amy-test-1]]]

[[[bwh-amy-test-2]]]

在回程路由测试中，Amy 不但给出了大致路径，还附上了结论，即便你完全看不懂路由同样能够判断线路的好坏。

<div class="mw-collapsible mw-collapsed">
  <strong>路由测试</strong>
  <div class="mw-collapsible-content" style="padding: 16px; border: 1px solid #eaecf0;">

测试目标：

* 电信上海：<code>202.96.209.133</code>
* 联通上海：<code>210.22.97.1</code>
* 移动上海：<code>120.204.197.126</code>

'''电信回程 大致路径：'''

<syntaxhighlight lang="text">日本大阪 VPS
→ 121.59.140.81 / AS23764 / CN2
→ CTG / 东京
→ 59.43.22.17 / CN2 / 上海
→ 上海电信 AS4812
→ 202.96.209.133</syntaxhighlight>
结果：

* 走 '''电信 CN2 / 59.43''' - 到上海电信终点约 '''33-39 ms'''
* 路由质量很好，属于优质电信回程。

MapTrace：

* https://assets.nxtrace.org/tracemap/0cc4c566-8523-5ee0-b93c-9a6341ce2ac4.html

'''联通回程 大致路径：'''

<syntaxhighlight lang="text">日本大阪 VPS
→ 121.59.140.81 / AS23764 / CN2
→ CTG / 东京
→ 59.43.22.17 / CN2 / 上海
→ 219.158.38.241 / 联通 AS4837
→ 上海联通
→ 210.22.97.1</syntaxhighlight>
结果：

* 前半段同样走 '''CN2''' - 进入国内后转 '''联通 169 / AS4837'''
* 到上海联通终点约 '''38 ms''' - 联通回程也不错。

MapTrace：

* https://assets.nxtrace.org/tracemap/f4400c49-30d7-5887-babf-6aa98170b417.html

'''移动回程 大致路径：'''

<syntaxhighlight lang="text">日本大阪 VPS
→ CN2 / CTG 东京
→ 59.43.159.17 / CN2 / 上海
→ 上海移动 CMNET
→ 120.204.197.126</syntaxhighlight>
结果：

* 前半段仍然走 '''CN2''' - 后段转入 '''移动 CMNET''' - 到上海移动终点约 '''80 ms'''
* 移动比电信/联通高一些，但路线仍然比较规整。

MapTrace：

* https://assets.nxtrace.org/tracemap/caeed159-98b8-5711-971e-03c1e9ba935e.html

简单结论

这台大阪 VPS：

* '''磁盘性能很强''' - '''海外带宽表现不错'''，新加坡/美国方向尤其好
* '''电信回程优秀，明显走 CN2'''
* '''联通回程也走 CN2 后转联通，表现不错'''
* '''移动回程 CN2 入境后转移动，延迟约 80 ms，尚可'''
* IPv6 当前未配置，所以 YABS 显示 IPv6 Offline

  </div>
</div>

<span id="二系统设置"></span>
== 二、系统设置 ==

查看完配置与性能测试，正式投入使用前，通常还要对 VPS 的一些默认设置进行调整，以符合日常使用习惯，例如修改 IPv4 优先、开启 BBR 加速、调整 Swap、修改 SSH 端口等，以上操作同样可以通过 Amy 直接完成。

<span id="ipv4-优先"></span>
=== IPv4 优先 ===

现在的 VPS 镜像大多默认 IPv6 优先。如果需要修改回 IPv4 优先，直接向 Amy 下达指令即可。从执行过程可以看出，Amy 修改配置前还备份了原文件，方便后期回退。

[[[bwh-amy-ipv4-first-1]]]

通过查看 <code>/etc/gai.conf</code> 文件，可以发现 <code>precedence ::ffff:0:0/96 100</code> 这一行前面的 # 注释已经被移除，说明 IPv4 优先已正常生效。

[[[bwh-amy-ipv4-first-2]]]

<span id="开启-bbr"></span>
=== 开启 BBR ===

BBR 作为网络加速的常用内核模块，也是新机器必开的选项。一句话即可让 Amy 帮我们完成开启工作。

[[[bwh-amy-bbr-1]]]

检查 <code>/etc/sysctl.d/99-bbr.conf</code> 配置文件，可以看到 BBR 相关的内核参数已经正确写入。

[[[bwh-amy-bbr-2]]]

<span id="调整-swap"></span>
=== 调整 Swap ===

对于低配或者小内存的 VPS，设置 Swap 也是相当重要的，可以防止内存溢出导致服务崩溃。

手动调整 Swap 的步骤还是相当繁琐的，而借助 Amy 可以一步调整到位，并且还能直接告诉她 “优先使用内存”。

[[[bwh-amy-swap-1]]]

执行 <code>free -h</code> 验证，可以看到 Swap 已经设置成了 4G，进一步查看 <code>swappiness</code> 的值也设置成了 <code>10</code>，符合我们提出的 “优先使用内存”。

[[[bwh-amy-swap-2]]]

<span id="ssh"></span>
=== SSH ===

修改 SSH 默认端口并配置密钥登录，是个十分常见的需求。这里我直接将公钥发送给 Amy，让她修改完 SSH 端口的同时帮我添加公钥，开启密钥登录。

能看到她不但正确执行了我的要求，还提醒我可以进一步加固——直接关闭密码登录、只允许密钥登录，最后还附上了检测端口的链接。

不过我这里就先开着密码登录，方便后面演示修改 SSH 密码。

[[[bwh-amy-ssh-1]]]

忘记 SSH 密码的时候，也可以让 Amy 直接重置密码，免去了登录 VNC 终端的繁琐步骤。

[[[bwh-amy-ssh-2]]]

=== 清理日志 ===

对于入门的 VPS，硬盘容量通常也比较小，容易被系统日志填满，可以让 Amy 清理一下旧日志，同时限制一下日志的最大占用，避免日志占用过多存储。

[[[bwh-amy-logs]]]

=== 防火墙 ===

完成上面这些基本配置后，最后需要安装并启用防火墙，这里我故意不做提示，看看她会不会自己开放 SSH 的端口。

结果很让人意外，她不但能正确识别修改后的 <code>2333</code> 端口，还把 IPv6 的端口也一并开放了。

[[[bwh-amy-ufw]]]

<span id="三应用实战"></span>
== 三、应用实战 ==

除了调整 VPS 自身的配置以外，安装和配置第三方应用 Amy 也是不在话下。

<span id="docker"></span>
=== Docker ===

现在装机必备的 Docker，一句话就能让 Amy 帮忙安上。在安装完成后，甚至还会自己运行一个 <code>hello-world</code> 测试容器，来验证 Docker 能否正常工作。

最后，她还会提醒用 Docker 部署服务时，需要在 ufw 中放行对应的端口。

[[[bwh-amy-docker]]]

<span id="caddy"></span>
=== Caddy ===

接着，增加一点难度，让 Amy 给我用 Caddy 搭建一个静态引导页。这一步中，可以明显看出她有联系上下文的能力——上一步刚让她安装了 Docker，这一步立马就选择通过 Docker 的方式来部署 Caddy。

[[[bwh-amy-caddy-1]]]

部署完成后，Amy 还给出了所有配置文件的路径，便于我们后期维护。同时，她也自动放行了 <code>80</code> 端口，确保 Web 服务可以直接访问。

[[[bwh-amy-caddy-2]]]

测试最终的访问效果，能看到静态页确实已经搭建好可以正常访问了~

[[[bwh-amy-caddy-3]]]

<span id="四故障排查"></span>
== 四、故障排查 ==

为了测试 Amy 的故障诊断能力，我们'''假装'''刚才搭建的网站无法在国内访问，让 Amy 排查一下什么原因。

[[[bwh-amy-troubleshooting]]]

Amy 先是从 KiwiVM 面板入手，确认 VPS 运行状态正常、未触发 IP 黑洞、服务暂停等违规策略，接着排查 VPS 内部，Caddy 是否正常监听了 80 端口，防火墙是否放行了端口。

最后，Amy 告诉我们服务器端目前是正常的，更像是国内到机房的网络问题，并且给出了其它可能的原因让我们继续排查。

当然网站实际上就是能打开的，因此 Amy 的判断也完全符合预期~


<div class="mw-collapsible mw-collapsed">
  <strong>排查结果</strong>
  <div class="mw-collapsible-content"  style="padding: 16px; border: 1px solid #eaecf0;">

我帮你排查了，服务器这边目前是正常的。

结论：不是 Caddy、Docker、防火墙或 VPS 本身的问题，更像是中国大陆到这个日本 Osaka IP 的网络可达性/路由/阻断问题。

当前检查结果：

* VPS 状态：运行中
* 机房：日本 Osaka
* 公网 IP：<code>212.50.232.122</code>
* IP 黑洞 / Nullroute：没有
* 服务暂停 / 策略违规：没有
* Caddy：正在监听 <code>80</code> 端口
* 防火墙：已放行 <code>80/tcp</code>
* 公网 HTTP 检查：<code>200 OK</code>
* 公网 TCP 80 检查：可连接
* 公网 ping：可达

也就是说，从外部公网探针访问：

<syntaxhighlight lang="text">http://tcp.ping.pe/212.50.232.122:80</syntaxhighlight>
是可以正常打开的。

你可以用这些链接复测：

<syntaxhighlight lang="text">https://ping.pe/212.50.232.122</syntaxhighlight>
比较可能的原因有这些：

<ol style="list-style-type: decimal;">
<li><p>中国大陆到该 IP 段路由不佳或被部分运营商阻断</p>
<ul>
<li><p>这个 IP 在日本机房，国际出口链路可能因地区、运营商不同表现差异很大。</p></li>
<li><p>可能移动打不开，电信能打开，或反过来。</p></li></ul></li>
<li><p>直连 IP 的 HTTP 访问被本地网络、运营商或浏览器策略干扰</p>
<ul>
<li><p>你需要确认访问的是：</p></li></ul>

<syntaxhighlight lang="text">http://212.50.232.122/</syntaxhighlight>
<p>而不是：</p>
<syntaxhighlight lang="text">https://212.50.232.122/</syntaxhighlight>
<p>当前没有配置 HTTPS，直接访问 <code>https://</code> 会失败或警告。</p></li>
<li><p>该 IP 在大陆方向可能存在污染、封锁或质量问题</p>
<ul>
<li><p>服务器端没有发现异常。</p></li>
<li><p>如果中国大陆完全无法访问，但其他地区正常，通常是大陆网络侧问题。</p></li></ul></li></ol>

建议你先做两个简单确认：

* 用手机流量和家宽分别试一下；
* 确认浏览器地址栏是 <code>http://212.50.232.122/</code>，不是自动跳成 <code>https://</code>。

如果你希望我继续处理，我可以帮你做其中一种方案：

# 改用一个非 80 端口测试，例如 <code>8080</code> 或 <code>2080</code>；
# 绑定域名并接入 CDN / 反代，改善大陆访问；
# 迁移到对中国大陆线路更友好的机房，但迁移会更换 IPv4；
# 保留当前页面，额外开放一个备用访问端口，方便判断是不是 80 端口或路由问题。

  </div>
</div>

<span id="五联动-kiwivm"></span>
== 五、联动 KiwiVM ==

上面测试的所有操作都是在 VPS 内部执行的。接下来，我们让 Amy 直接操作 KiwiVM 控制面板，这是深度集成到面板的 Amy 独家功能，也是第三方 AI 助手无法实现的~

<span id="设置-ptr"></span>
=== 设置 PTR ===

搭建邮局的时候常要设置 PTR (rDNS)，这在其它商家通常需要发工单才能实现，而搬瓦工不仅允许用户在面板自助设置，现在更是能让 Amy 直接一句话搞定。

[[[bwh-amy-ptr-1]]]

设置完成后前往 KiwiVM 面板查看，可以看到反向解析记录确实已经生效。

[[[bwh-amy-ptr-2]]]

<span id="备份快照"></span>
=== 备份/快照 ===

让 Amy 备份一下 VPS，可以看到她并没有在 VPS 内创建任何打包、备份脚本，而是直接调用了 KiwiVM 面板创建了一个系统快照，无感实现了整机备份。

[[[bwh-amy-backup]]]

=== 迁移机房 ===

自由迁移机房也是搬瓦工的特色之一，这里让 Amy 帮我们把 VPS 从'''大阪机房'''迁移到'''新加坡机房'''，她会先确认机房是否存在，接着再次询问我们是否确认迁移。

由于是'''高风险操作'''，需要'''明确回复''' <code>CONFIRM AMY-XXXXXXXXXX</code>。

[[[bwh-amy-migrate-1]]]

一字不差地回复确认代码后，Amy 就开始执行迁移了，同时也会告知我们迁移系统的一些注意事项：

* IP 会被替代
* PTR 需要重新设置
* 配置会随系统一起迁移
* 迁移期间 VPS 短暂不可用

[[[bwh-amy-migrate-2]]]

在 KiwiVM 控制面板中也能看到迁移的进度。

[[[bwh-amy-migrate-3]]]

=== 重装系统 ===

经过了前面一系列的跑分、测试，服务器内已残留了较多的测试数据。最后，再让 Amy 将 VPS 重装为纯净系统。

和迁移机房一样，重装系统同样是'''高风险操作'''，需要一字不差地回复 <code>CONFIRM AMY-XXXXXXXXXX</code> 才能继续。

同时 Amy 还会告知我们重装会清空 VPS 现有系统和数据，包括刚才安装的那些程序。

[[[bwh-amy-reinstall-1]]]

确认无误后，Amy 就开始执行重装了，也会同步给出重装后的 SSH 密码。

[[[bwh-amy-reinstall-2]]]

== 总结 ==

=== 优点 ===

通过 Amy 来维护 VPS 可以告别繁琐的命令行，无论你的系统是 Debian、Ubuntu、Rocky 还是上古的 CentOS，不用区分各个系统的命令格式或包管理器，都可以通过对话的方式执行命令，不仅大大降低了 Linux 运维的门槛，也让日常操作更加高效和优雅。

=== 建议 ===

说到底 Amy 还是 AI，总归是不太成熟，'''请勿用于生产环境'''！同时 Amy 的权限非常大，无论是在 VPS 内部还是 KiwiVM 控制面板，她都有操作权限，下达指令的时候务必注意数据备份。

最后，希望搬瓦工可以进一步优化 Amy，'''一是'''目前对所有 VPS 都默认启用了，没有关闭按钮，如果能提供一个明确的禁用按钮就更好了；'''二是'''现在不太方便查看历史对话，期待早日支持保存和切换多个聊天记录。
[[Category:200 KiwiVM 简介 — KiwiVM Introduction]]