md5.pw - 用户贡献 [zh]

KiwiVM 智能助手 Amy：你可以让她帮你做的事

2026-02-23T13:53:41Z

Root：创建页面，内容为“搬瓦工最近在 KiwiVM 控制面板新增了一个智能助理功能，名字叫 Assistant Amy。这是一个与 KiwiVM 环境深度集成的 AI 助手，可以实时访问你的 VPS 诊断信息、系统日志、防火墙配置、SSH 设置等数据，并且支持中文问答，对新手用户非常友好。很多用户可能看到了这个功能但不知道具体能帮什么忙，本文就整理一下 Amy 的实际用途，包括你可以问她什么、…”

搬瓦工最近在 KiwiVM 控制面板新增了一个智能助理功能，名字叫 Assistant Amy。这是一个与 KiwiVM 环境深度集成的 AI 助手，可以实时访问你的 VPS 诊断信息、系统日志、防火墙配置、SSH 设置等数据，并且支持中文问答，对新手用户非常友好。

很多用户可能看到了这个功能但不知道具体能帮什么忙，本文就整理一下 Amy 的实际用途，包括你可以问她什么、她能帮你做什么、以及使用时需要注意的事项。

= 一、Amy 是什么，怎么打开 =
Assistant Amy 是搬瓦工内置在 KiwiVM 控制面板中的 AI 智能助理，24 小时在线，随时可用。登录 KiwiVM 控制面板后，在左侧菜单栏找到 Assistant Amy，点击 Launch 按钮即可进入对话界面。

根据搬瓦工官方的介绍，Amy 与 KiwiVM 环境完全集成，可以实时访问 VPS 的关键诊断信息、系统日志、防火墙配置、SSH 设置等数据。这意味着 Amy 不是一个通用聊天机器人，她是绑定你当前这台 VPS 的，回答的内容是基于你 VPS 的实际状态。
{| class="wikitable"
|ℹ️ '''提示：'''每台 VPS 的 KiwiVM 面板都有独立的 Amy，因此她查看的是当前这台 VPS 的信息。如果你有多台 VPS，需要切换到对应的 KiwiVM 面板再使用 Amy。
|}

= 二、Amy 能帮你做什么 =
下面按场景分类整理了 Amy 的主要用途。每个场景都附带了示例问题，大家可以直接参考。

== 2.1 排查 SSH 连接问题 ==
SSH 连不上是搬瓦工用户遇到最多的问题之一。可能的原因包括 IP 被封、端口错误、防火墙拦截、SSH 服务未启动等。以前遇到这类问题只能一步步排查，现在可以直接问 Amy，她会根据你 VPS 的实际状态给出具体建议。

'''示例问题：'''
{| class="wikitable"
|'''👤 你：'''我的 VPS 无法通过 SSH 连接，连接超时，能帮我查一下是什么原因吗？
|-
|'''🤖 Amy：'''Amy 会检查 VPS 运行状态、SSH 服务是否正常、当前 SSH 端口号、防火墙规则是否阻断了连接，并给出分步解决方案。
|}

== 2.2 检查防火墙配置 ==
Amy 可以实时读取 VPS 的防火墙配置信息。如果你不确定是不是防火墙拦截了某个端口，或者不确定 iptables / ufw / firewalld 的规则是否正确，都可以直接询问 Amy。她会根据实际配置告诉你哪些端口已开放、哪些被阻断。

'''示例问题：'''
{| class="wikitable"
|'''👤 你：'''我的 Nginx 服务已经启动，但是外部无法访问 80 端口，能帮我检查一下防火墙吗？
|-
|'''🤖 Amy：'''Amy 会检查当前防火墙规则，确认 80 端口是否被允许，并给出开放端口的具体命令。
|}

== 2.3 查看和分析系统日志 ==
VPS 运行出现异常时，通常需要查看系统日志来定位问题。但对于新手而言，看日志本身就是一件困难的事。Amy 可以帮你读取系统日志并解释其中的关键信息，告诉你哪里有报错、可能的原因是什么。

'''示例问题：'''
{| class="wikitable"
|'''👤 你：'''我的 VPS 昨天突然重启了，能帮我看看日志里有没有相关报错信息？
|-
|'''🤖 Amy：'''Amy 会检查系统日志，找出重启前后的关键事件，并解释可能的原因（如 OOM、内核崩溃等）。
|}

== 2.4 性能优化建议 ==
VPS 运行变慢、响应迟钟、CPU 占用率高、内存不足等问题，都可以向 Amy 询问。她会根据当前 VPS 的资源使用情况给出优化建议，比如哪个进程占用过高、是否需要调整 SWAP、是否有异常进程在跑等。

'''示例问题：'''
{| class="wikitable"
|'''👤 你：'''我的 VPS 最近很卡，内存和 SWAP 都快满了，能帮我看看是什么问题吗？
|-
|'''🤖 Amy：'''Amy 会分析当前资源使用状态，列出占用内存最多的进程，并建议具体的优化措施。
|}

== 2.5 配置变更指导 ==
Amy 还可以提供一些常见配置操作的分步指导，比如修改 SSH 端口号、设置 SSH 密钥登录、配置防火墙规则、修改 hostname 等。她会根据你 VPS 当前的操作系统给出对应的命令，这对新手非常友好。

'''示例问题：'''
{| class="wikitable"
|'''👤 你：'''我想把 SSH 端口从默认改成其他端口，具体要怎么操作？
|-
|'''🤖 Amy：'''Amy 会根据你的操作系统给出修改 sshd_config 的具体步骤，并提醒修改后需要同步调整防火墙规则。
|}

== 2.6 错误信息解读 ==
当 VPS 报错但你看不懂错误信息时，可以直接把错误内容发给 Amy。她会解释这个错误是什么意思、可能的原因、以及建议的解决方法。这个功能对于不熟悉 Linux 的用户尤其有用。

'''示例问题：'''
{| class="wikitable"
|'''👤 你：'''重装系统后登录提示 Permission denied (publickey)，这是什么意思？
|-
|'''🤖 Amy：'''Amy 会解释这个错误表示 SSH 密钥认证失败，并指导你如何恢复密码登录或重新配置密钥。
|}

== 2.7 KiwiVM 面板操作指导 ==
Amy 也可以回答关于 KiwiVM 面板本身的问题，比如如何迁移机房、如何创建快照、如何重装系统、如何重置 root 密码等。如果你对某个面板功能不太熟悉，问 Amy 是最快的方式。

'''示例问题：'''
{| class="wikitable"
|'''👤 你：'''我想把 VPS 从美国 DC6 机房迁移到日本软银机房，迁移后数据会丢失吗？
|-
|'''🤖 Amy：'''Amy 会解释迁移机房的流程、数据是否保留、IP 是否会变化，以及迁移前需要做哪些准备。
|}

= 三、Amy 能力一览表 =
下表汇总了 Amy 的主要能力和对应的使用场景：
{| class="wikitable"
|'''能力类型'''
|'''具体可做的事'''
|'''示例问题'''
|-
|'''SSH 连接排查'''
|检查 SSH 服务状态、端口号、防火墙规则
|“SSH 连不上怎么办”
|-
|'''防火墙配置'''
|读取并分析 iptables/ufw/firewalld 规则
|“80 端口被封了吗”
|-
|'''系统日志分析'''
|读取系统日志，定位关键报错信息
|“VPS 昨天突然重启”
|-
|'''性能优化'''
|分析 CPU/内存/SWAP 使用情况，定位异常进程
|“内存快满了怎么办”
|-
|'''配置变更指导'''
|提供修改 SSH、防火墙、hostname 等的分步教程
|“怎么改 SSH 端口”
|-
|'''错误解读'''
|解释报错信息含义并给出解决方案
|“Permission denied 啥意思”
|-
|'''KiwiVM 面板操作'''
|指导迁移机房、快照、重装系统等操作
|“怎么迁移到其他机房”
|}

= 四、使用 Amy 的小技巧 =

== 4.1 用中文提问完全没问题 ==
Amy 支持中文和英文问答，你用中文提问，她会用中文回复。对于不熟悉英文技术术语的用户来说，这非常方便。

== 4.2 描述问题要尽量具体 ==
和所有 AI 工具一样，描述越具体，得到的回答越准确。比如不要只说“我的 VPS 有问题”，而是说“''我的 VPS 无法通过 SSH 连接，提示 Connection timed out，从昨天开始的''”。这样 Amy 能更快定位问题。

== 4.3 Amy 不能做的事 ==
Amy 主要定位为故障排查助手，她不会直接帮你执行操作（比如不会帮你直接重装系统或修改配置文件），她的角色是诊断问题并给出建议，具体的操作仍然需要你自己通过 SSH 或 KiwiVM 面板完成。另外，Amy 是 AI，有时候也可能给出不完全准确的答案，建议对重要操作仍然保持验证的习惯。
{| class="wikitable"
|⚠️ '''注意：'''Amy 是 AI 智能助手，不是搬瓦工官方客服。如果遇到账单、续费、退款等账户类问题，仍然需要通过搬瓦工官网后台提交工单联系官方客服。
|}

= 五、Amy 与其他排查方式的对比 =
{| class="wikitable"
|'''方式'''
|'''优点'''
|'''缺点'''
|'''适合场景'''
|-
|'''Amy 智能助手'''
|实时访问 VPS 数据，中文问答，无需 SSH
|AI 回答不一定 100% 准确
|新手快速排查问题
|-
|'''SSH 手动排查'''
|完全控制，最灵活
|需要 Linux 基础
|有经验的用户自行排查
|-
|'''提交工单'''
|官方客服介入
|响应需要时间
|复杂问题或账户类问题
|-
|'''Root shell (VNC)'''
|SSH 不可用时的应急访问
|界面简陋，操作不便
|SSH 断连时的紧急操作
|}
实际使用中，这几种方式并不冲突。建议的流程是：遇到问题先问 Amy 快速定位，如果 Amy 的建议无法解决，再通过 SSH 或 Root shell 手动排查，实在解决不了的再提交工单联系官方客服。

= 总结 =
Assistant Amy 是搬瓦工在 KiwiVM 面板中集成的一个非常实用的功能，尤其对新手用户而言，可以省去很多自己排查问题的时间。她与 KiwiVM 环境深度集成，可以实时访问你 VPS 的诊断信息，不是泛泛的通用回答，而是基于你 VPS 实际状态的具体建议。

核心用途总结：SSH 连接排查、防火墙检查、系统日志分析、性能优化、配置指导、错误解读、KiwiVM 操作指导。支持中文问答，24/7 在线，免费使用。

[https://www.banwagong.net/ 搬瓦工中文网] — 专业的搬瓦工中文教程站
[[Category:200 KiwiVM 简介 — KiwiVM Introduction]]

KiwiVM 隐藏技巧：你可能不知道的 10 个实用面板功能

2026-02-21T12:59:02Z

Root：创建页面，内容为“= 前言 = 搬瓦工的 KiwiVM 控制面板功能其实非常完善，但大多数用户日常使用的也就是重装系统、重启、查看 IP 端口这几个功能。实际上 KiwiVM 还有不少实用但容易被忽略的功能，有些是比较新的，有些则是一直都在但知道的人不多。本文整理了 10 个 KiwiVM 面板中比较实用但用户可能不太熟悉的功能，希望对大家有所帮助。按照使用频率和实用性排序…”

= 前言 =
搬瓦工的 KiwiVM 控制面板功能其实非常完善，但大多数用户日常使用的也就是重装系统、重启、查看 IP 端口这几个功能。实际上 KiwiVM 还有不少实用但容易被忽略的功能，有些是比较新的，有些则是一直都在但知道的人不多。

本文整理了 10 个 KiwiVM 面板中比较实用但用户可能不太熟悉的功能，希望对大家有所帮助。按照使用频率和实用性排序，越往前的越值得优先了解。

= 一、快照永久保存（Snapshot Sticky） =
KiwiVM 的快照功能（Snapshots）很多人都知道，但有一个细节容易被忽略：快照默认只保存 30 天，过期后会被自动清除。如果你在正式上线前做了一个快照作为基线备份，30 天后可能就没了。

'''解决方法是将快照设置为 Sticky 状态'''。在 KiwiVM 面板的 Snapshots 页面，创建快照后会看到一个“Sticky”选项，勾选后该快照就不会被自动清除，可以永久保存。目前最多可以同时保留两个 Sticky 快照。
{| class="wikitable"
|✅ '''实用场景：'''配置好环境后立即创建一个 Sticky 快照，相当于有了一个永久的“出厂设置”回滚点。万一折腾坏了，随时恢复。
|}

= 二、自动备份转快照（Backup → Snapshot） =
KiwiVM 的自动备份功能（Backups）会定期自动备份 VPS 数据，备份周期由系统自动计算，用户无法自定义。但很多人不知道的是，自动备份可以转换为快照。

在 Backups 页面，每个自动备份旁边有一个 Copy to Snapshot 按钮，点击后该备份就会被复制到快照列表中。转换成快照后，你就可以手动管理它——包括设置为 Sticky 永久保存、下载、导入到其他 VPS 等。通过 API 调用的接口是 backup/copyToSnapshot。
{| class="wikitable"
|ℹ️ '''提示：'''自动备份和快照的区别：自动备份由系统定期创建，无法手动控制，保存周期也由系统决定；快照是用户手动创建的，可以设置 Sticky 永久保存，也可以导出和导入。两者都是免费的。
|}

= 三、KiwiVM Sessions：多 VPS 会话切换 =
如果你有多台搬瓦工 VPS，以前想切换管理不同的 VPS，需要回到官网后台重新点击对应 VPS 的 KiwiVM Control Panel 按钮。现在 KiwiVM 新增了 Sessions 功能，可以在同一个浏览器窗口内直接切换不同 VPS 的 KiwiVM 会话。

登录 KiwiVM 后，右上角会显示当前 VPS 的信息，点击可以看到你账户下其他 VPS 的 KiwiVM 会话，直接点击即可切换。这个功能是 2022 年之后才有的，很多老用户可能还不知道。
{| class="wikitable"
|✅ '''实用场景：'''管理多台 VPS 时不用反复在官网后台和 KiwiVM 之间来回切换，直接在 KiwiVM 内一键切换即可。
|}

= 四、审计日志（Audit Log）：查看所有操作记录 =
KiwiVM 左侧菜单的 Security & Records 分类下有一个 Audit Log 功能，可以查看通过 KiwiVM 面板进行的所有操作记录，包括登录时间、登录 IP、具体执行的操作（重启、重装系统、调用 API、迁移机房等）。

这个功能的实用之处在于安全排查。如果你发现 VPS 被进行了自己没有做过的操作（比如被重装了系统），可以通过 Audit Log 查看是否有异常的登录记录或降作。需要注意的是，Audit Log 记录的是在 KiwiVM 面板上执行的操作，并不是 VPS 内部的命令行操作。后者需要通过 SSH 登录后查看系统日志。
{| class="wikitable"
|⚠️ '''注意：'''如果在 Audit Log 中发现不是自己的 IP 登录记录，说明你的账户可能已经泄露。建议立即修改搬瓦工账户密码、重置 KiwiVM 面板密码、重置 API KEY，并开启两步验证。
|}

= 五、VNC 实时截图（Screenshot） =
KiwiVM 面板首页有一个 Screenshot 功能，可以不用登录 VPS，直接在网页上查看 VPS 当前的 VNC 屏幕截图。相当于给你的服务器接了一个暑示器，可以直接看到屏幕上显示的内容。

这个功能在以下场景下特别有用：VPS 无法 SSH 登录时，可以通过截图判断是卡在了哪个步骤（比如内核报错、磁盘检查等）；重装系统或挂载 ISO 后，可以查看安装进度；安装了桌面环境后，可以快速预览界面。
{| class="wikitable"
|ℹ️ '''提示：'''截图功能和 KiwiVM 面板的 Root shell – interactive（VNC 交互式 Shell）配合使用，可以在无法 SSH 登录时对 VPS 进行应急操作。
|}

= 六、挂载 ISO 镜像（Mount ISO）：130+ 种系统和应用 =
KiwiVM 面板的 Install new OS 功能只提供 CentOS、Debian、Ubuntu 等常见发行版，选择有限。但在 KiwiVM 首页下方还有一个 Mount ISO 功能，可以挂载超过 130 种镜像文件，包括：

'''系统镜像：'''Arch Linux、Fedora Server、Alpine Linux、Gentoo、openSUSE、NixOS、FreeBSD 等，甚至包括 Ubuntu 桌面版（Desktop）和 Windows 10 镜像。

'''Turnkey 应用镜像：'''基于 Turnkey Linux 封装的一键式应用包，包括 LAMP、Django、WordPress、GitLab、ownCloud、Drupal、phpBB 等。挂载后通过 VNC 进行安装即可。

使用流程：在 KiwiVM 首页选择要挂载的 ISO，点击 mount，等待几分钟挂载完成；然后先 force stop，再 start，VPS 就会从挂载的 ISO 启动，通过 VNC 控制台完成安装。安装完成后记得在首页点 unmount 取消挂载，然后再次重启。
{| class="wikitable"
|⚠️ '''注意：'''Mount ISO 安装流程比较复杂，需要手动通过 VNC 操作。如果没有特殊需求，建议优先使用 Install new OS 一键重装，简单快捷。
|}

= 七、私有网络（Private Network）：内网传输不耗流量 =
KiwiVM 左侧菜单有一个 Private Network 选项，可以为 VPS 添加一个私有 IP 地址。同一机房内的多台搬瓦工 VPS，如果都添加了私有 IP，就可以通过内网互联互通。

'''关键点在于：私有网络内部的数据传输不占用流量配额。'''也就是说，两台同机房的 VPS 之间通过内网 IP 传文件，不会消耗任何一方的月度流量。

目前私有网络功能仅部分套餐支持（一般是 80GB 及以上的方案），如果你的套餐不支持，进入 Private Network 页面会看到相应提示。
{| class="wikitable"
|✅ '''实用场景：'''如果你有两台同机房的 VPS，一台做 Web 服务器、一台做数据库，用内网传输既快速又不耗流量，还能提升安全性（数据库不需要暴露公网 IP）。
|}

= 八、自定义反向 DNS（PTR Records） =
KiwiVM 面板首页下方有一个 PTR Records (Reverse DNS) 设置入口，可以为 VPS 的 IP 地址设置自定义的反向 DNS 记录。反向 DNS 的意思是，当别人通过 IP 地址查询域名时，会返回你设置的这个值。

'''在什么情况下需要设置反向 DNS？'''最常见的场景是搭建邮件服务器。很多邮箱服务商（如 Gmail、Outlook）会检查发送服务器的 PTR 记录，如果没有设置或设置不一致，邮件很容易被判为垃圾邮件。设置方法很简单，直接在 PTR Records 页面填写你的域名即可。

= 九、自定义邮件通知（Email Notifications） =
这是 KiwiVM 改版后新增的功能。在左侧菜单找到 Email notifications 选项，可以自定义哪些事件发送邮件通知。你可以选择在以下情况下收到通知：VPS 异常停止、VPS 被暂停、迁移机房完成、备份完成等。

建议至少开启 VPS 异常停止的通知，这样当服务器意外关机时，你能第一时间收到邮件提醒，及时处理。这比自己写监控脚本方便得多。

= 十、Passkeys 和 Security Keys：无密码登录 KiwiVM =
这是 KiwiVM 最新的 Beta 功能，在左侧菜单的 Security & Records 分类下可以找到 Passkeys and Security Keys 选项。

'''Passkeys（密码钥匙）：'''可以让你通过指纹、面容识别等生物认证方式登录 KiwiVM，不需要每次输入密码。每台 VPS 可以设置一个独立的 Passkey。

'''Security Keys（安全密钥）：'''支持 Google Titan、YubiKey 等硬件安全密钥，提供硬件级别的登录保护。
{| class="wikitable"
|ℹ️ '''提示：'''目前这个功能还在 Beta 测试阶段，官方还没有正式发布公告，但 KiwiVM 面板中已经可以使用。如果你比较关注账户安全，可以尝鲜设置一下。
|}

= 附加：其他值得了解的功能 =

== 临时恢复已暂停的 VPS ==
VPS 因流量耗尽或 CPU 占用过高被暂停后，KiwiVM 面板提供了一个临时恢复功能，可以先恢复 VPS 的运行，让你有时间登录上去备份数据或进行紧急处理。这个功能在 VPS 被暂停时会自动出现在 KiwiVM 面板中。比起被暂停后干等流量重置，这个功能能救急。

== KiwiVM 独立密码登录 ==
大多数用户都是通过搬瓦工官网后台的 KiwiVM Control Panel 按钮直接跳转进入 KiwiVM 的，这种方式不需要输入密码。但实际上 KiwiVM 面板有自己独立的登录密码，可以直接通过 kiwivm.64clouds.com 访问并使用密码登录。在 KiwiVM 面板左侧菜单的 KiwiVM password modification 可以设置或重置这个密码。

这意味着 KiwiVM 有三套独立的密码体系：搬瓦工官网账户密码、VPS root 密码、KiwiVM 面板密码，三者互不关联。

== 批量导出 API KEY ==
如果你有多台搬瓦工 VPS，在搬瓦工官网后台的 Services → My Services 页面，有一个 Export all services with private API keys 选项，可以一次性导出所有 VPS 的 VEID 和 API KEY 为 CSV 文件。这个功能对于需要批量管理或写自动化脚本的用户非常实用。

== 两步验证（Two-factor Authentication） ==
KiwiVM 支持两步验证，开启后每次登录 KiwiVM 面板都需要输入谷歌验证器（Google Authenticator）或 Authy 生成的验证码。在左侧菜单的 Security & Records 分类下找到 Two-factor authentication，按提示设置即可。建议所有用户都开启这个功能。

= 总结 =
下表汇总了本文介绍的所有功能及其在 KiwiVM 面板中的位置：
{| class="wikitable"
|'''#'''
|'''功能名称'''
|'''KiwiVM 位置'''
|'''用途说明'''
|-
|1
|'''Snapshot Sticky'''
|Snapshots
|快照永久保存，不被自动清除
|-
|2
|'''Backup → Snapshot'''
|Backups
|自动备份转快照，方便手动管理
|-
|3
|'''KiwiVM Sessions'''
|右上角会话切换
|多 VPS 会话快速切换
|-
|4
|'''Audit Log'''
|Security & Records
|查看所有 KiwiVM 操作记录
|-
|5
|'''Screenshot'''
|KiwiVM 首页
|VNC 实时截图，远程查看屏幕
|-
|6
|'''Mount ISO'''
|KiwiVM 首页
|挂载 130+ 种系统和应用镜像
|-
|7
|'''Private Network'''
|Private network
|内网 IP，同机房免流量传输
|-
|8
|'''PTR Records'''
|KiwiVM 首页
|自定义反向 DNS，邮件服务器必备
|-
|9
|'''Email Notifications'''
|Email notifications
|自定义邮件告警通知项
|-
|10
|'''Passkeys'''
|Security & Records
|生物认证/硬件密钥登录 (Beta)
|}

KiwiVM 的功能远不止重装系统和重启这么简单。快照永久保存、私有网络、审计日志、邮件通知这些功能在日常管理中都能派上用场，尤其是快照 Sticky 和自动备份转快照这两个功能，建议所有用户都了解一下。

[https://www.banwagong.net/ 搬瓦工中文网] — 做最专业的搬瓦工中文教程站
[[Category:200 KiwiVM 简介 — KiwiVM Introduction]]

KiwiVM API 自动化入门指南

2026-02-19T15:28:19Z

Root：创建页面，内容为“= 一、前言 = KiwiVM 控制面板的大多数功能，其实都可以通过 API 接口来实现。搬瓦工官方对此的说法是：“Whether you want to automatically create nightly snapshots, query status of your VPS, or develop a complete replacement for the KiwiVM panel, this page is for you.” 简单来说，不管你是想定时自动备份、查询 VPS 状态，还是想自己写一套管理程序来替代 KiwiVM 面板，都可以通过 API 实…”

= 一、前言 =
KiwiVM 控制面板的大多数功能，其实都可以通过 API 接口来实现。搬瓦工官方对此的说法是：“Whether you want to automatically create nightly snapshots, query status of your VPS, or develop a complete replacement for the KiwiVM panel, this page is for you.” 简单来说，不管你是想定时自动备份、查询 VPS 状态，还是想自己写一套管理程序来替代 KiwiVM 面板，都可以通过 API 实现。

对于有一定编程基础的朋友，搬瓦工的 API 使用起来其实很简单——本质上就是发送一个 HTTP 请求，然后收到一个 JSON 格式的返回结果。没有复杂的 OAuth 认证流程，也不需要 SDK，用 curl、wget、Python、PHP 甚至浏览器都能调用。本文就从零开始，介绍 KiwiVM API 的获取方法、调用方式、常用接口以及实用自动化场景。
{| class="wikitable"
|ℹ️ '''提示：'''KiwiVM API 适合有一定编程基础的用户。如果你平时只是用 KiwiVM 面板做一些简单操作（重启、重装系统等），不需要专门研究 API，直接用面板就行。
|}

= 二、获取 API KEY 和 VEID =
调用 KiwiVM API 需要两个参数：VEID 和 API KEY。这两个参数是每台 VPS 独立的，也就是说如果你有多台搬瓦工 VPS，每台的 VEID 和 API KEY 都不一样。

== 2.1 通过 KiwiVM 面板获取 ==
'''第一步：'''登录搬瓦工官网（bwh81.net），进入 Services → My Services，点击对应 VPS 的 KiwiVM Control Panel 按钮进入面板。

'''第二步：'''在 KiwiVM 面板左侧菜单找到 API 选项，点击进入。

'''第三步：'''点击 Show API Key 按钮，即可查看该 VPS 的 API KEY（一个以 private_ 开头的随机字符串）。页面上同时会显示 VEID（一个 7 位数的数字）。

如果需要重置 API KEY（比如怀疑密钥泄露），可以点击 Reset API Key 按钮，重置后旧的 API KEY 立即失效。

== 2.2 批量导出所有 VPS 的 API KEY ==
如果你有多台搬瓦工 VPS，逐个登录 KiwiVM 面板查看 API KEY 比较麻烦。搬瓦工官网后台提供了一个批量导出功能：在搬瓦工官网后台的 Services → My Services 页面，找到 Export all services with private API keys 选项，可以导出一个 CSV 文件，里面包含了你所有 VPS 的 VEID 和 API KEY。
{| class="wikitable"
|⚠️ '''注意：'''API KEY 相当于你 VPS 的管理密码，拥有 API KEY 的人可以通过 API 对你的 VPS 进行重启、重装系统、执行命令等操作。请妥善保管，不要泄露给不信任的人。
|}

= 三、API 调用基础 =

== 3.1 请求格式 ==
KiwiVM API 的调用方式非常直接：向指定 URL 发送 HTTP 请求，带上 VEID 和 API KEY 作为参数即可。支持 GET 和 POST 两种方式传参。

API 基础地址如下：
{| class="wikitable"
|<nowiki>https://api.64clouds.com/v1/{API接口名称}?veid={VEID}&api_key={API_KEY}</nowiki>
|}
举个例子，如果要查询 VPS 的基本信息，完整的请求 URL 是这样的：
{| class="wikitable"
|<nowiki>https://api.64clouds.com/v1/getServiceInfo?veid=1234567&api_key=private_xxxxxxxxxxxx</nowiki>
|}

== 3.2 返回格式 ==
所有 API 调用的返回结果都是 JSON 格式。每个返回结果都包含一个 error 字段，如果 error 为 0 表示调用成功，否则请查看 message 字段了解具体错误原因。示例：
{| class="wikitable"
|// 成功返回示例（getServiceInfo）

{

"error": 0,

"hostname": "my-vps",

"node_datacenter": "USCA_6",

"ip_addresses": ["1.2.3.4"],

"plan_monthly_data": 1000000000000,

"data_counter": 52428800,

"os": "ubuntu-24.04-x86_64",

"ve_status": "Running",

...

}

// 失败返回示例

{

"error": 700005,

"message": "Authentication failure"

}
|}

== 3.3 常见错误码 ==
{| class="wikitable"
|'''错误码'''
|'''含义'''
|'''解决方法'''
|-
|700005
|Authentication failure（认证失败）
|VEID 或 API KEY 不正确，核对参数
|-
|700000
|VPS is not running / stopped
|VPS 未运行，需先启动
|-
|700003
|VPS is already running
|已在运行中，无需重复启动
|-
|rate limit
|请求过于频繁，被限流
|等待几分钟后重试，减少调用频率
|}
{| class="wikitable"
|ℹ️ '''提示：'''KiwiVM API 有限流机制，短时间内调用太频繁会被临时屏蔽。可以通过 getRateLimitStatus 接口查询当前限流状态。建议调用间隔不要低于 1 秒。
|}

= 四、常用 API 接口整理 =
下面按功能分类整理 KiwiVM API 的主要接口。这些接口基本覆盖了 KiwiVM 面板上能做的所有操作。

== 4.1 VPS 信息查询 ==
{| class="wikitable"
|'''接口名称'''
|'''说明'''
|-
|getServiceInfo
|获取 VPS 基本信息：IP、端口、操作系统、流量使用、机房位置等
|-
|getLiveServiceInfo
|获取 VPS 实时状态（含 getServiceInfo 全部字段），返回磁盘使用、运行状态等实时数据（调用可能需 15 秒）
|-
|getRawUsageStats
|获取详细统计数据，对应 KiwiVM 面板的 Detailed Statistics 页面
|-
|getAvailableOS
|获取当前可用的操作系统列表（用于重装系统）
|-
|getSuspensionDetails
|查询当前是否有暂停情况及具体原因
|-
|getAuditLog
|获取 KiwiVM 操作日志，对应面板的 Audit log 功能
|}

== 4.2 电源管理 ==
{| class="wikitable"
|'''接口名称'''
|'''说明'''
|-
|start
|启动 VPS
|-
|stop
|正常停止 VPS
|-
|restart
|重启 VPS
|-
|kill
|强制停止 VPS（用于 VPS 卡死无法正常停止的情况，未保存数据会丢失）
|}

== 4.3 备份与快照 ==
{| class="wikitable"
|'''接口名称'''
|'''说明'''
|-
|snapshot/create
|创建快照，参数 description 为快照描述
|-
|snapshot/list
|获取快照列表（包含文件名、大小、MD5、下载链接等）
|-
|snapshot/delete
|删除指定快照，参数 snapshot 为文件名
|-
|snapshot/restore
|恢复指定快照，参数 snapshot 为文件名
|-
|backup/list
|获取自动备份列表（系统定期自动备份）
|-
|backup/copyToSnapshot
|将自动备份转换为快照（方便手动管理）
|}

== 4.4 系统与网络管理 ==
{| class="wikitable"
|'''接口名称'''
|'''说明'''
|-
|reinstallOS
|重装操作系统，参数 os 为系统模板名称
|-
|resetRootPassword
|重置 root 密码，新密码通过返回结果获取
|-
|setHostname
|设置主机名，参数 newHostname
|-
|setPTR
|设置反向 DNS 记录，参数 ip 和 ptr
|-
|ipv6/add
|分配新的 IPv6 地址
|-
|migrate/getLocations
|获取可迁移的机房列表
|-
|migrate/start
|开始迁移机房，参数 location 为目标机房 ID
|}

== 4.5 Shell 命令执行 ==
{| class="wikitable"
|'''接口名称'''
|'''说明'''
|-
|basicShell/exec
|在 VPS 上同步执行 Shell 命令，参数 command，返回执行结果
|-
|shellScript/exec
|在 VPS 上异步执行 Shell 脚本，参数 script，返回日志文件名
|}
{| class="wikitable"
|⚠️ '''注意：'''basicShell/exec 和 shellScript/exec 这两个接口的权限非常高，可以直接在你的 VPS 上执行任意命令。这也是为什么必须保护好 API KEY 的原因。
|}

= 五、实战调用示例 =

== 5.1 使用 curl / wget 调用 ==
最简单的调用方式，在终端直接运行一条命令即可：
{| class="wikitable"
|# 使用 wget 查询 VPS 信息

wget -qO- "<nowiki>https://api.64clouds.com/v1/getServiceInfo?veid=YOUR_VEID&api_key=YOUR_API_KEY</nowiki>"

<nowiki>#</nowiki> 使用 curl 重启 VPS

curl "<nowiki>https://api.64clouds.com/v1/restart?veid=YOUR_VEID&api_key=YOUR_API_KEY</nowiki>"

<nowiki>#</nowiki> 使用 curl 创建快照

curl "<nowiki>https://api.64clouds.com/v1/snapshot/create?veid=YOUR_VEID&api_key=YOUR_API_KEY&description=manual_backup</nowiki>"
|}

== 5.2 使用 Python 调用 ==
用 Python 调用也很简单，使用标准库或第三方 requests 库都可以：
{| class="wikitable"
|import requests

import json

VEID = 'YOUR_VEID'

API_KEY = 'YOUR_API_KEY'

BASE_URL = '<nowiki>https://api.64clouds.com/v1'</nowiki>

def call_api(action, params=None):

   url = f'{BASE_URL}/{action}'

   data = {'veid': VEID, 'api_key': API_KEY}

   if params:

   data.update(params)

   r = requests.get(url, params=data)

   return r.json()

<nowiki>#</nowiki> 查询 VPS 信息

info = call_api('getServiceInfo')

print(json.dumps(info, indent=2))

<nowiki>#</nowiki> 重启 VPS

result = call_api('restart')

print(result)

<nowiki>#</nowiki> 创建快照

result = call_api('snapshot/create', {'description': 'nightly_backup'})

print(result)
|}

== 5.3 使用 PHP 调用 ==
搬瓦工官方给出的示例是 PHP 代码，以下是最基本的调用方式：
{| class="wikitable"
|<?php

$veid = 'YOUR_VEID';

$api_key = 'YOUR_API_KEY';

// 查询 VPS 信息

$url = "<nowiki>https://api.64clouds.com/v1/getServiceInfo?veid={$veid}&api_key={$api_key}</nowiki>";

$info = json_decode(file_get_contents($url));

print_r($info);

// 使用 curl 进行 POST 请求（适合需要传递更多参数的场景）

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, '<nowiki>https://api.64clouds.com/v1/restart'</nowiki>);

curl_setopt($ch, CURLOPT_POST, 1);

curl_setopt($ch, CURLOPT_POSTFIELDS, ['veid' => $veid, 'api_key' => $api_key]);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

$result = json_decode(curl_exec($ch));

curl_close($ch);

print_r($result);

?>
|}

= 六、实用自动化场景 =
光会调用 API 还不够，关键是要知道拿它来做什么。下面介绍几个实用的自动化场景。

== 6.1 定时自动快照备份 ==
KiwiVM 面板本身有自动备份功能（Backups），但备份周期是系统自动计算的，用户无法自定义。如果你希望每天晚上自动创建一个快照，可以用 crontab + API 来实现：
{| class="wikitable"
|#!/bin/bash

<nowiki>#</nowiki> 文件名: auto_snapshot.sh

<nowiki>#</nowiki> 功能: 自动创建 KiwiVM 快照

VEID="YOUR_VEID"

API_KEY="YOUR_API_KEY"

DATE=$(date +%Y%m%d_%H%M%S)

DESC="auto_backup_${DATE}"

RESULT=$(curl -s "<nowiki>https://api.64clouds.com/v1/snapshot/create?veid=${VEID}&api_key=${API_KEY}&description=${DESC}</nowiki>")

echo "[$(date)] Snapshot result: ${RESULT}" >> /var/log/bwg_snapshot.log
|}
然后添加到 crontab 中，每天凌晨 3 点执行：
{| class="wikitable"
| colspan="2" |# 编辑 crontab

crontab -e

<nowiki>#</nowiki> 添加以下行（每天 03:00 执行）

0 3 * * * /root/auto_snapshot.sh
|
|-
|
| colspan="2" |ℹ️ '''提示：'''搬瓦工快照有数量限制，建议配合 snapshot/list 和 snapshot/delete 接口实现自动轮转，保留最近 N 个快照，删除更早的。
|-
|
|
|
|}

== 6.2 VPS 状态监控与告警 ==
通过定期调用 getLiveServiceInfo 接口，可以监控 VPS 的运行状态，当 VPS 异常停止时自动发送通知或尝试自动重启：
{| class="wikitable"
|#!/bin/bash

<nowiki>#</nowiki> 文件名: monitor_vps.sh

<nowiki>#</nowiki> 功能: 监控 VPS 状态，停止时自动重启

VEID="YOUR_VEID"

API_KEY="YOUR_API_KEY"

<nowiki>#</nowiki> 查询 VPS 状态

STATUS=$(curl -s "<nowiki>https://api.64clouds.com/v1/getLiveServiceInfo?veid=${VEID}&api_key=${API_KEY}</nowiki>" | python3 -c "import sys,json; print(json.load(sys.stdin).get('ve_status','Unknown'))")

if [ "$STATUS" != "Running" ]; then

   echo "[$(date)] VPS status: ${STATUS}, attempting restart..." >> /var/log/bwg_monitor.log

   curl -s "<nowiki>https://api.64clouds.com/v1/start?veid=${VEID}&api_key=${API_KEY}</nowiki>" >> /var/log/bwg_monitor.log

   # 可以在这里加上邮件/Telegram 通知

fi
|}
配合 crontab 每 5 分钟执行一次即可实现基本的健康监控。当然，更完善的方案可以结合 Python 脚本和邮件通知来做。

== 6.3 流量使用监控 ==
getServiceInfo 接口返回的数据中包含 plan_monthly_data（套餐月流量）和 data_counter（已用流量）两个字段，单位是字节。可以用这两个字段计算流量使用百分比，当超过阈值时发出告警，避免因流量耗尽导致 VPS 被暂停。
{| class="wikitable"
|import requests

VEID = 'YOUR_VEID'

API_KEY = 'YOUR_API_KEY'

THRESHOLD = 0.85 # 流量使用超过 85% 时告警

info = requests.get(

   f'<nowiki>https://api.64clouds.com/v1/getServiceInfo?veid={VEID}&api_key={API_KEY}'</nowiki>

).json()

monthly = info['plan_monthly_data']

used = info['data_counter']

usage = used / monthly

print(f'流量使用: {used/1e9:.2f} GB / {monthly/1e9:.0f} GB ({usage:.1%})')

if usage > THRESHOLD:

   print(f'警告: 流量已使用 {usage:.1%}，请注意控制用量!')

   # 发送邮件或 Telegram 消息通知
|}

== 6.4 批量管理多台 VPS ==
如果你有多台搬瓦工 VPS，可以将所有 VPS 的 VEID 和 API KEY 保存在一个配置文件中（或直接用导出的 CSV），然后写一个脚本遍历所有 VPS，批量查询状态、批量创建快照等。实现了开头提到的 “develop a complete replacement for the KiwiVM panel”。

社区也有一些现成的工具可以直接使用，比如 iOS 上的“瓦工助手”、安卓上的“Bandwagon 控制台”等 APP，原理都是调用 KiwiVM API 实现的。当然，第三方 APP 的安全性需要自行评估。

= 七、API 与 KiwiVM 面板功能对照 =
下表整理了 KiwiVM 面板主要功能与对应 API 接口的关系，方便大家查找。
{| class="wikitable"
|'''KiwiVM 面板功能'''
|'''对应 API 接口'''
|'''备注'''
|-
|Main Controls
|getServiceInfo
|查看 IP、端口、状态、流量等
|-
|Detailed Statistics
|getRawUsageStats
|CPU、网络、磁盘统计数据
|-
|Root shell – basic
|basicShell/exec
|同步执行命令
|-
|Install new OS
|reinstallOS
|需先调用 getAvailableOS
|-
|Root password modification
|resetRootPassword
|返回新密码
|-
|Snapshots
|snapshot/*
|create/list/delete/restore
|-
|Backups
|backup/*
|list / copyToSnapshot
|-
|Migrate to another DC
|migrate/*
|getLocations / start
|-
|Audit log
|getAuditLog
|操作日志审计
|}

= 八、常见问题与注意事项 =

== 8.1 调用报 Authentication failure ==
最常见的问题。通常是 VEID 或 API KEY 填错了，检查以下几点：VEID 是一串纯数字，API KEY 以 private_ 开头；确认没有多余的空格或换行符；如果最近重置过 API KEY，需要更新为新的 KEY。

== 8.2 调用无响应或超时 ==
可能是网络问题导致无法访问 api.64clouds.com。可以尝试更换 DNS，或者在其他网络环境下重试。另外，getLiveServiceInfo 接口本身就比较慢，可能需要 15 秒才返回结果，这是正常的。

== 8.3 被限流了怎么办 ==
短时间内调用 API 太频繁会触发限流，API 会丢弃你的请求。解决方法很简单：等待几分钟后重试，并降低调用频率。可以通过 getRateLimitStatus 接口查询当前的限流状态。建议在脚本中加上适当的 sleep 间隔。

== 8.4 API KEY 安全问题 ==
几个安全建议：不要将 API KEY 硬编码在公开的代码仓库中（比如 GitHub）；可以使用环境变量或配置文件来存储 API KEY；如果怀疑密钥泄露，立即在 KiwiVM 面板点击 Reset API Key 重置密钥；所有通过 API 进行的操作都会记录在 KiwiVM 面板的 Audit log 中，定期查看审计日志可以发现异常操作。

= 九、总结 =
KiwiVM API 的设计很简洁，认证方式直接，调用方法简单，不需要额外的 SDK 或库，用 curl 一行命令就能完成大多数操作。对于有编程基础的用户来说，利用 API 可以实现很多自动化场景：定时备份、状态监控、流量告警、批量管理等。

对于普通用户，日常管理 VPS 用 KiwiVM 面板就完全足够了，不需要专门研究 API。但如果你有自动化的需求，或者单纯想折腾写点代码，搬瓦工的 API 接口是很好的练手素材。

[https://www.banwagong.net/ 搬瓦工中文网] — 专业的搬瓦工中文教程站
[[Category:200 KiwiVM 简介 — KiwiVM Introduction]]

KiwiVM 面板无法登录的常见原因与解决方法

2026-02-19T15:11:24Z

Root：创建页面，内容为“= 一、前言 = KiwiVM Control Panel 是搬瓦工为每台 VPS 实例提供的自研管理面板，功能涵盖重启/关机、重装系统、迁移机房、Root Shell、快照备份等核心操作。正常情况下，我们通过搬瓦工官网后台点击「KiwiVM Control Panel」按钮即可一键进入面板，无需额外输入密码。但在实际使用过程中，不少朋友会遇到 KiwiVM 面板打不开、无法登录、报错等各种问题。根…”

= 一、前言 =
KiwiVM Control Panel 是搬瓦工为每台 VPS 实例提供的自研管理面板，功能涵盖重启/关机、重装系统、迁移机房、Root Shell、快照备份等核心操作。正常情况下，我们通过搬瓦工官网后台点击「KiwiVM Control Panel」按钮即可一键进入面板，无需额外输入密码。

但在实际使用过程中，不少朋友会遇到 KiwiVM 面板打不开、无法登录、报错等各种问题。根据站长这些年的经验，这类问题的原因其实比较集中，大部分情况下都可以自行排查和解决。本文就整理一下 KiwiVM 面板无法登录的几种常见原因，以及对应的解决方法，方便大家对号入座。
{| class="wikitable"
|ℹ️ '''提示：'''登录 KiwiVM 面板有两种方式：一是通过搬瓦工官网后台 Services → My Services → KiwiVM Control Panel 一键进入；二是直接访问 kiwivm.64clouds.com 独立登录页面，输入 VPS IP 和 KiwiVM 密码进行登录。两种方式遇到的问题可能不同，下面分别说明。
|}

= 二、提示 Session Expired（会话已过期） =

== 2.1 问题描述 ==
打开 KiwiVM 面板后，页面提示 "Your session has timed out due to inactivity. Please log in again to continue."，无论怎么刷新都是同样的错误，无法进入面板。

== 2.2 原因分析 ==
这个问题通常有两种情况：

'''长时间未操作导致会话超时。''' KiwiVM 面板有会话有效期限制，如果长时间停留在面板页面没有操作，会话会自动失效。这种情况属于正常现象。

'''KiwiVM 面板更新导致旧 Cookie 冲突。''' 搬瓦工会不定期对 KiwiVM 面板进行安全升级（例如 2024 年 9 月的一次大版本更新，加强了 Cookie 和会话处理的安全性），升级后浏览器中保存的旧 Cookie 可能与新版面板不兼容，导致反复报 Session Expired。

== 2.3 解决方法 ==
'''方法一：直接从官网后台重新进入。''' 登录搬瓦工官网（bwh81.net），进入 Services → My Services，点击对应 VPS 后面的 KiwiVM Control Panel 按钮重新进入面板，会自动创建新的会话。

'''方法二：清除浏览器 Cookie。''' 如果从官网进入仍然报 Session Expired，需要清除浏览器中 kiwivm.64clouds.com 和 64clouds.com 这两个域名下的 Cookie。操作方法如下：
{| class="wikitable"
|Chrome 浏览器操作步骤：

1. 按 F12 打开开发者工具

2. 切换到「应用」（Application）选项卡

3. 左侧展开「Cookies」

4. 找到 64clouds.com 相关的条目

5. 右键点击 → 清除（Clear）

6. 关闭开发者工具，刷新页面重新登录
|}
'''方法三：使用无痕/隐私模式。''' 如果只是临时需要登录面板，可以直接开一个无痕窗口（Chrome 快捷键 Ctrl+Shift+N），在无痕模式下访问不会受到旧 Cookie 的影响。

= 三、提示 Unable to reach Target (720923) =

== 3.1 问题描述 ==
登录 KiwiVM 面板后，页面显示错误信息：
{| class="wikitable"
|Unable to reach Target. This is a temporary problem;

please try again in a few minutes. (v7718) (720923)
|}
其中 v7718 是 VPS 所在节点编号（每个人的不同），720923 是错误码。

== 3.2 原因分析 ==
这个错误意味着 KiwiVM 面板暂时无法与你的 VPS 所在物理节点通信。常见原因包括：

'''机房维护或故障。''' 搬瓦工某个机房正在进行计划维护或遇到设备故障（例如路由器故障、网络设备异常等），导致该机房下所有 VPS 的 KiwiVM 面板暂时不可用。

'''节点暂时不可达。''' 也有可能是该节点的管理通道临时中断，通常等待几分钟到几十分钟就会自动恢复。

== 3.3 解决方法 ==
'''第一步：查看搬瓦工服务状态页面。''' 前往 bwhstatus.com 查看是否有正在进行的维护或故障通告。如果你的节点编号（如 v7718）正好在受影响范围内，耐心等待维护完成即可。

'''第二步：等待几分钟后重试。''' 如果 bwhstatus.com 上没有相关维护信息，建议间隔 5-10 分钟后再次尝试打开 KiwiVM 面板。大多数情况下，短暂的通信中断会自动恢复。

'''第三步：提交工单联系客服。''' 如果等待较长时间（超过 30 分钟）仍未恢复，可以提交工单（Support Ticket）向搬瓦工官方反馈，说明错误信息和节点编号，等待官方处理。
{| class="wikitable"
|⚠️ '''注意：'''遇到 720923 错误时不要急着重装系统或做其他操作，这个错误与你的 VPS 本身无关，重装系统也解决不了。等机房恢复后一切会自动正常。
|}

= 四、KiwiVM 独立登录页面密码问题 =

== 4.1 问题描述 ==
直接访问 kiwivm.64clouds.com 时，需要输入 Server IP 和 KiwiVM Password 进行登录。有朋友不清楚这里的密码是什么，或者忘记了密码，导致无法登录。

== 4.2 原因分析 ==
需要明确的是，KiwiVM 面板密码是一个独立的密码，和搬瓦工官网的账户密码、VPS 的 SSH root 密码都不是同一个。三者的区别如下：
{| class="wikitable"
|'''密码类型'''
|'''用途'''
|'''设置/重置方式'''
|-
|'''搬瓦工账户密码'''
|登录搬瓦工官网（bwh81.net）
|官网 → Password Reset
|-
|'''KiwiVM 面板密码'''
|独立登录 kiwivm.64clouds.com
|KiwiVM → KiwiVM password modification
|-
|'''VPS root 密码'''
|SSH 远程连接 VPS
|KiwiVM → Root password modification
|}

如果你从来没有设置过 KiwiVM 面板密码，那在独立登录页面确实是登不上去的——因为这个密码需要你主动设置。

== 4.3 解决方法 ==
'''方法一：通过官网后台进入（推荐）。''' 通过搬瓦工官网后台一键进入 KiwiVM 面板，无需输入密码。这是最常用也最方便的方式，正常情况下完全够用。

'''方法二：设置或重置 KiwiVM 密码。''' 如果确实需要使用独立登录页面，先通过官网后台进入 KiwiVM 面板，然后在左侧菜单找到 KiwiVM password modification，设置一个新密码即可。

'''方法三：通过邮箱重置密码。''' 在 kiwivm.64clouds.com 登录页面点击 "Reset KiwiVM password"，输入 VPS 的 IP 地址，系统会发送密码重置链接到你注册搬瓦工时使用的邮箱。链接有效期 20 分钟，需尽快操作。
{| class="wikitable"
|ℹ️ '''提示：'''一般情况下直接通过搬瓦工官网后台进入 KiwiVM 就够用了，KiwiVM 独立登录主要用于将 VPS 管理权限临时分享给他人（无需提供搬瓦工账户密码）的场景。
|}

= 五、kiwivm.64clouds.com 页面打不开 =

== 5.1 问题描述 ==
访问 kiwivm.64clouds.com 时，浏览器提示连接超时、无法访问、响应时间过长等错误，页面无法加载。

== 5.2 原因分析 ==
'''DNS 解析问题。''' 64clouds.com 的域名解析在某些地区或某些 DNS 服务器上可能存在问题，导致无法正确解析到服务器 IP。搬瓦工官方曾针对此类问题修改过域名解析。

'''网络连通性问题。''' 64clouds.com 的服务器位于海外，国内部分地区或网络环境下可能存在访问不稳定的情况。

== 5.3 解决方法 ==
'''方法一：改为从官网后台进入 KiwiVM。''' 不通过 kiwivm.64clouds.com 独立页面，而是登录搬瓦工官网（bwh81.net），从后台一键进入 KiwiVM 面板。这种方式走的是搬瓦工主站的通道，通常更稳定。

'''方法二：更换 DNS。''' 尝试将本地 DNS 更换为公共 DNS，例如 114.114.114.114、8.8.8.8 或 1.1.1.1，然后刷新 DNS 缓存后重试。
{| class="wikitable"
|# Windows 刷新 DNS 缓存

ipconfig /flushdns

<nowiki>#</nowiki> macOS 刷新 DNS 缓存

sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
|}
'''方法三：联系搬瓦工客服。''' 如果上述方法无效，可以提交工单反馈该问题。如果是 DNS 解析层面的共性问题，搬瓦工官方通常会及时修复。

= 六、二次验证（Two-factor Authentication）问题 =

== 6.1 问题描述 ==
登录 KiwiVM 面板时弹出二次验证码输入界面，但由于更换手机、卸载验证器 APP 或丢失设备等原因，无法获取 6 位验证码，导致无法登录。

== 6.2 背景说明 ==
KiwiVM 面板提供 Two-factor authentication（二次验证）功能，启用后每次登录面板都需要输入 Google Authenticator（或其他兼容 APP，如 Authy）生成的动态验证码。此外，搬瓦工近期还新增了 Passkeys（密码钥匙）和 Security Keys（安全密钥）功能，进一步增强了面板安全性。

这些安全功能本身是好事，但如果丢失了验证设备而又没有保存恢复密钥，就会比较麻烦。

== 6.3 解决方法 ==
'''情况一：还有恢复密钥。''' 如果当初设置二次验证时保存了 account key（密钥字符串），可以在新手机上重新添加该密钥到 Google Authenticator 或 Authy 中，即可重新生成验证码。

'''情况二：没有恢复密钥。''' 提交工单联系搬瓦工客服，说明情况并请求关闭该 VPS 的二次验证。客服可能需要验证你的身份信息（注册邮箱、账户信息等），处理时间通常为 1-3 个工作日。
{| class="wikitable"
|⚠️ '''注意：'''建议在设置二次验证时务必保存好 account key，或者使用 Authy 等支持云备份的验证器 APP，避免更换设备后丢失验证码。
|}

= 七、VPS 被暂停（Suspended） =

== 7.1 问题描述 ==
登录 KiwiVM 面板后，发现 VPS 状态显示为 Suspended（已暂停），面板功能受限，无法正常操作。或者面板上 SSH Port 信息不显示，在线 SSH 工具和 Shell 工具也无法使用。

== 7.2 原因分析 ==
VPS 被暂停通常有以下几种原因：
{| class="wikitable"
|'''暂停原因'''
|'''表现'''
|'''解决方式'''
|-
|'''流量超额'''
|月流量用尽，VPS 自动暂停
|等待下月流量重置，或升级套餐
|-
|'''CPU 滥用'''
|长时间高 CPU 占用触发限制
|优化程序，降低 CPU 使用率
|-
|'''账单问题'''
|续费逾期或支付信息异常
|完成续费或更新账单信息
|-
|'''违规使用'''
|违反 ToS 被官方暂停
|提交工单与官方沟通
|}

== 7.3 解决方法 ==
首先在 KiwiVM 面板的 Main Controls 页面查看 VPS 状态和相关提示信息，确认具体的暂停原因，然后按照上表中的解决方式对应处理。对于流量超额的情况，可以在 KiwiVM 面板的 Bandwidth 页面查看本月流量使用详情。

另外还有一种特殊情况：如果 SSH Port 不显示，同时在线 SSH 和 Shell 工具都不可用，但 VPS 状态显示为 Running，那么很可能是系统镜像损坏或安装不正确。这种情况下直接重装系统（KiwiVM → Install new OS）即可恢复。
{| class="wikitable"
|ℹ️ '''提示：'''KiwiVM 面板的 Detailed Statistics 功能可以查看 CPU、网络、磁盘等历史使用数据，有助于排查 CPU 超限或流量异常的原因。
|}

= 八、页面显示 Checking your browser =

== 8.1 问题描述 ==
访问搬瓦工官网或 KiwiVM 面板时，页面卡在 "Checking your browser before accessing..." 的提示上，长时间无法进入。

== 8.2 原因分析 ==
这是搬瓦工官网使用的 Cloudflare 安全防护机制。Cloudflare 会对访客浏览器进行安全检查，防止恶意请求。正常情况下这个检查只需几秒钟就会自动通过，但在某些情况下可能会卡住。

== 8.3 解决方法 ==
等待几秒钟，大多数情况下会自动跳转。如果长时间卡住，可以尝试以下方法：

确保浏览器启用了 JavaScript 和 Cookie（Cloudflare 检查依赖这两者）；尝试更换浏览器或使用无痕模式；清除浏览器缓存和 Cookie 后重试；如果使用了浏览器插件（如广告拦截、隐私保护插件），可以尝试临时禁用后再访问。

= 九、常见问题速查表 =
下面将本文涉及的常见问题和首选解决方案整理成表格，方便快速查找。
{| class="wikitable"
|'''问题现象'''
|'''常见原因'''
|'''首选解决方法'''
|-
|Session Expired 反复出现
|Cookie 冲突 / 面板更新
|清除 64clouds.com Cookie
|-
|Unable to reach Target (720923)
|机房维护 / 节点故障
|查看 bwhstatus.com，等待恢复
|-
|独立登录页面密码不对
|未设置或忘记 KiwiVM 密码
|从官网后台进入，或重置密码
|-
|kiwivm.64clouds.com 打不开
|DNS 解析 / 网络连通性问题
|从官网后台进入，更换 DNS
|-
|二次验证码丢失
|更换设备 / 卸载验证器
|用 account key 恢复，或联系客服
|-
|VPS 显示 Suspended
|流量超额 / CPU / 账单 / 违规
|对应处理（续费/优化/工单）
|-
|Checking your browser 卡住
|Cloudflare 安全检查
|换浏览器 / 关闭拦截插件
|-
|SSH Port 不显示
|系统镜像损坏
|重装系统（Install new OS）
|}

= 十、日常建议 =
根据站长自己的使用习惯，给几条建议，能避免大部分 KiwiVM 登录问题：

'''优先从官网后台进入 KiwiVM。''' 通过搬瓦工官网 → Services → My Services → KiwiVM Control Panel 一键进入，避免密码问题，也能减少 DNS 和 Cookie 导致的访问异常。

'''保存好各类密码和密钥。''' 搬瓦工账户密码、KiwiVM 面板密码、VPS root 密码、二次验证 account key，这些信息建议统一记录在密码管理工具中，避免丢失后影响正常使用。

'''关注 bwhstatus.com。''' 搬瓦工的服务状态页面会发布机房维护和故障通告。如果遇到面板打不开的情况，先去这个页面看看是否有相关信息，不用急着提交工单。

'''善用 KiwiVM 面板的安全功能。''' 二次验证（Two-factor Authentication）、Passkeys、Security Keys 这些功能虽然增加了登录步骤，但能有效保护 VPS 安全。建议在做好密钥备份的前提下启用这些安全特性。

'''定期检查 VPS 状态。''' 留意 KiwiVM 面板上的流量使用情况、CPU 负载等信息，及时发现问题，避免因为流量耗尽或 CPU 超限导致 VPS 被暂停。

= 十一、总结 =
KiwiVM 面板无法登录的问题，绝大多数都可以归结为上面几种情况。总结下来就是：Session Expired 清 Cookie；720923 错误等机房恢复；密码问题走官网后台或重置密码；64clouds.com 打不开换 DNS 或走官网入口；二次验证丢失联系客服。

遇到问题时不要慌，按照上面的排查思路逐一检查，基本上都能解决。如果实在解决不了，还可以提交工单联系搬瓦工客服，他们的响应速度还是比较快的。

[https://www.banwagong.net/ 搬瓦工中文网] — 专业的搬瓦工中文教程站
[[Category:200 KiwiVM 简介 — KiwiVM Introduction]]

通过 Root Shell 修改 sshd 配置与防火墙设置

2026-02-18T14:02:25Z

Root：创建页面，内容为“搬瓦工 KiwiVM 控制面板提供了三种 Root Shell 工具，可以直接在浏览器中操作服务器，而不需要依赖 SSH 客户端。对于修改 sshd 配置和防火墙规则这类操作来说，Root Shell 有一个天然的优势：它完全独立于 SSH 服务运行，即使 SSH 服务出了问题，你依然可以通过 Root Shell 进入系统进行修复。这一点对新手来说尤其重要。修改 sshd 配置和防火墙是 VPS 管理中…”

搬瓦工 KiwiVM 控制面板提供了三种 Root Shell 工具，可以直接在浏览器中操作服务器，而不需要依赖 SSH 客户端。对于修改 sshd 配置和防火墙规则这类操作来说，Root Shell 有一个天然的优势：它完全独立于 SSH 服务运行，即使 SSH 服务出了问题，你依然可以通过 Root Shell 进入系统进行修复。

这一点对新手来说尤其重要。修改 sshd 配置和防火墙是 VPS 管理中最容易把自己锁在门外的操作，端口改错了、防火墙规则写反了、sshd 重启失败了，都有可能让你无法通过 SSH 连上服务器。有 Root Shell 在手，就相当于给自己留了一条后路。

本文将详细介绍如何利用搬瓦工 KiwiVM 面板的 Root Shell 功能，在不同操作系统上完成 sshd 配置修改和防火墙管理。覆盖 Ubuntu/Debian、CentOS 7/8 以及 Rocky Linux 9 三大主流系统，适用于搬瓦工 KiwiVM 控制面板当前支持的所有可安装系统。
{| class="wikitable"
|'''本文适用场景'''

1. 需要修改 SSH 端口、禁用密码登录等 sshd 参数

2. 需要配置或修复防火墙规则（firewalld / iptables / ufw）

3. SSH 连接出问题，需要通过 Root Shell 紧急修复

4. 首次拿到搬瓦工 VPS，需要进行基础安全加固
|}

= 一、KiwiVM Root Shell 工具概述 =

== 1.1 三种 Root Shell 的区别 ==
搬瓦工 KiwiVM 面板提供了三种不同的 Root Shell 工具，定位各有不同。进入方式都是在 KiwiVM 面板左侧菜单中找到对应选项并点击 Launch 按钮。
{| class="wikitable"
|'''功能'''
|'''Root shell - basic'''
|'''Root shell - advanced'''
|'''Root shell - interactive'''
|-
|'''界面形式'''
|单行命令输入框
|多行命令输入框
|完整 Web 终端（VNC）
|-
|'''交互能力'''
|不支持交互
|不支持交互
|完整交互支持
|-
|'''适用场景'''
|查看状态

执行简单命令
|批量执行命令

输出较长的命令
|vi/nano 编辑文件

修复 SSH/防火墙

密码修改等
|-
|'''编辑配置文件'''
|不适合
|可用 sed 替换
|vi/nano 均可
|-
|'''推荐指数'''
|日常查看
|批量操作
|'''本文推荐'''
|}
对于修改 sshd 和防火墙这类操作，'''Root shell - interactive（交互式 Shell）'''是最推荐的选择。因为修改配置文件通常需要用到 vi 或 nano 这类文本编辑器，只有 interactive 模式才支持完整的交互操作。

== 1.2 进入 Root shell - interactive ==
具体步骤如下：

1. 登录搬瓦工官网 '''bwh81.net'''，进入 Services → My Services，找到你的 VPS 实例。

2. 点击 Open KiwiVM（或 KiwiVM Control Panel）进入控制面板。

3. 在左侧菜单中找到 Root shell – interactive，点击进入。

4. 点击 Launch 按钮，稍等几秒，会弹出一个基于 Web 的终端窗口。

5. 输入用户名 root，回车后输入密码（密码输入时不会显示任何字符，这是正常的），回车即可登录。
{| class="wikitable"
|'''关于密码'''

Root shell - interactive 使用的是 VPS 的 root 密码，即安装系统时分配的密码。如果忘记了，可以在 KiwiVM 面板的 Root password modification 中重新生成。注意重置密码需要 VPS 处于运行状态。
|}

== 1.3 Root shell - basic/advanced 的使用场景 ==
虽然本文主要推荐 interactive 模式，但 basic 和 advanced 在某些场景下也有用处。例如你只想快速查看当前 sshd 端口或防火墙状态，用 basic 模式输入一条命令就行，不需要登录完整终端。

常用的快速查看命令：
{| class="wikitable"
|# 查看当前 SSH 端口

grep -i '^Port' /etc/ssh/sshd_config

<nowiki>#</nowiki> 查看 sshd 服务状态

systemctl status sshd

<nowiki>#</nowiki> 查看防火墙状态（firewalld）

firewall-cmd --state

<nowiki>#</nowiki> 查看防火墙状态（ufw）

ufw status
|}
这些命令不需要交互，在 basic 或 advanced 模式下直接粘贴执行即可。但涉及到编辑配置文件的操作，务必切换到 interactive 模式。

= 二、通过 Root Shell 修改 sshd 配置 =

== 2.1 sshd 配置文件位置 ==
SSH 服务的主配置文件位于 '''/etc/ssh/sshd_config'''，所有系统都一样。需要注意的是 Rocky Linux 9 / AlmaLinux 9 引入了 '''/etc/ssh/sshd_config.d/''' 目录，支持以 .conf 后缀的配置片段方式加载。但主配置文件路径不变，直接编辑主文件也完全可以。

在开始修改之前，强烈建议先备份原始配置文件：
{| class="wikitable"
|cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak
|}

== 2.2 修改 SSH 端口 ==
搬瓦工在安装系统时会分配一个随机的高位端口作为默认 SSH 端口，这个端口可以在 KiwiVM 面板的 Main Controls 页面看到。如果需要修改成其他端口，操作步骤如下。

'''步骤一：编辑配置文件'''

在 Root shell - interactive 中登录后，使用 vi 编辑配置文件：
{| class="wikitable"
|vi /etc/ssh/sshd_config
|}
找到 Port 所在的行（可以按 / 然后输入 Port 进行搜索），将端口号修改为你想要的值。如果该行前面有 # 号，需要先去掉注释符。
{| class="wikitable"
|# 修改前（可能的形式）

<nowiki>#</nowiki>Port 22

Port 28456

<nowiki>#</nowiki> 修改后（例如改为 36912）

Port 36912
|}
按 i 进入编辑模式，修改完成后按 Esc，然后输入 :wq 回车保存退出。
{| class="wikitable"
|'''端口选择建议'''

建议选择 10000-65535 之间的高位端口，避开常见服务端口（如 80、443、3306、8080 等）。

搬瓦工默认分配的随机端口一般就在这个范围内，如果只是因为端口被封才修改，换一个新的高位端口即可。
|}
'''步骤二：处理 SELinux（仅 CentOS / Rocky Linux）'''

如果你的系统是 CentOS 7/8 或 Rocky Linux 9，并且 SELinux 处于 enforcing 状态，直接重启 sshd 会失败。需要先告知 SELinux 允许新端口：
{| class="wikitable"
| colspan="2" |# 查看 SELinux 状态

getenforce

<nowiki>#</nowiki> 如果返回 Enforcing，需要执行以下命令

<nowiki>#</nowiki> CentOS 7：

yum install -y policycoreutils-python

<nowiki>#</nowiki> CentOS 8 / Rocky Linux 9：

dnf install -y policycoreutils-python-utils

<nowiki>#</nowiki> 添加新端口到 SELinux 白名单

semanage port -a -t ssh_port_t -p tcp 36912
|
|}
'''步骤三：配置防火墙放行新端口'''

这一步根据操作系统不同，使用的工具也不一样，详见下面的第三部分。这里先给出通用思路：在修改 sshd 端口之后、重启 sshd 服务之前，要确保防火墙已经放行了新端口。否则重启 sshd 后虽然服务正常运行，但新端口被防火墙拦截，SSH 照样连不上。

'''步骤四：重启 sshd 服务'''
{| class="wikitable"
|# Rocky Linux 9 建议先做语法检查

sshd -t

<nowiki>#</nowiki> 所有系统通用的重启命令

systemctl restart sshd
|}
如果 sshd -t 没有任何输出，说明配置文件语法正确。如果有报错，按照提示修改对应行即可。

== 2.3 其他常见 sshd 配置修改 ==
除了端口，以下几个 sshd 参数也经常需要调整。同样在 /etc/ssh/sshd_config 中修改：
{| class="wikitable"
|'''参数'''
|'''推荐值'''
|'''说明'''
|
|-
|PermitRootLogin
|prohibit-password
|允许 root 登录但禁止密码方式，仅允许密钥
|
|-
|PasswordAuthentication
|no
|禁用密码登录，仅允许密钥登录（需先配好密钥）
|
|-
|PubkeyAuthentication
|yes
|启用公钥认证
|
|-
|MaxAuthTries
|3
|最大认证尝试次数，减少暴力破解风险
|
|-
|ClientAliveInterval
|300
|每 300 秒发送一次心跳，防止空闲断连
|
|-
| colspan="4" |'''禁用密码登录前请确认'''

在将 PasswordAuthentication 设为 no 之前，请务必确认 SSH 密钥已经正确配置并能成功登录。否则一旦重启 sshd，密码和密钥都用不了，就只能靠 Root Shell 来救了。
|}
修改完成后，同样执行 sshd -t 检查语法，然后 systemctl restart sshd 重启服务使配置生效。

= 三、通过 Root Shell 管理防火墙 =
搬瓦工 VPS 在默认安装系统后，防火墙的状态因系统而异。有的系统默认开启了防火墙，有的没有。下面按操作系统分别说明如何查看和管理防火墙。

== 3.1 Ubuntu / Debian — ufw 防火墙 ==
Ubuntu 和 Debian 系统使用 '''ufw'''（Uncomplicated Firewall）作为默认防火墙管理工具。搬瓦工安装的 Ubuntu/Debian 系统默认情况下 ufw 通常是未启用的，也就是说所有端口默认都是开放的。

'''查看 ufw 状态：'''
{| class="wikitable"
|ufw status
|}
如果返回 Status: inactive，说明 ufw 未启用，防火墙不会阻拦任何端口，此时修改 SSH 端口后不需要额外操作防火墙。

'''如果 ufw 已启用，放行新 SSH 端口的操作：'''
{| class="wikitable"
|# 放行新端口（例如 36912）

ufw allow 36912/tcp

<nowiki>#</nowiki> 如果要移除旧端口的放行规则

ufw delete allow 22/tcp

<nowiki>#</nowiki> 查看当前规则

ufw status numbered
|
|-
| colspan="2" |'''ufw 常用操作速查'''

ufw enable    — 启用防火墙

ufw disable — 关闭防火墙

ufw allow 80/tcp    — 放行 TCP 80 端口

ufw allow 443 — 放行 TCP/UDP 443 端口

ufw deny 3306/tcp — 拒绝 TCP 3306 端口

ufw reset — 重置所有规则为默认
|-
| colspan="2" |'''启用 ufw 前注意'''

如果你要首次启用 ufw，一定要先确保已经放行了当前的 SSH 端口，否则启用防火墙的一瞬间就会断开 SSH 连接。通过 Root Shell 操作可以避免这个风险，因为 Root Shell 不走 SSH 通道。
|}

== 3.2 CentOS 7/8 — firewalld 防火墙 ==
CentOS 7 和 CentOS 8 使用 '''firewalld''' 作为默认防火墙管理工具。搬瓦工安装的 CentOS 系统中，firewalld 默认状态不一定是开启的，具体取决于安装的系统模板。

'''查看 firewalld 状态：'''
{| class="wikitable"
|# 检查服务状态

systemctl status firewalld

<nowiki>#</nowiki> 或者直接查看运行状态

firewall-cmd --state
|}
如果返回 not running 或者提示服务未找到，说明防火墙未启用。

'''firewalld 已启用时，放行新 SSH 端口：'''
{| class="wikitable"
|# 永久放行新端口

firewall-cmd --permanent --add-port=36912/tcp

<nowiki>#</nowiki> 如果要移除旧端口

firewall-cmd --permanent --remove-port=28456/tcp

<nowiki>#</nowiki> 重新加载使永久规则生效

firewall-cmd --reload

<nowiki>#</nowiki> 查看当前放行的所有端口

firewall-cmd --list-ports
|}
'''也可以使用 service 方式管理（推荐用于标准服务）：'''
{| class="wikitable"
|# 查看当前放行的服务

firewall-cmd --list-services

<nowiki>#</nowiki> 放行 HTTP/HTTPS

firewall-cmd --permanent --add-service=http

firewall-cmd --permanent --add-service=https

firewall-cmd --reload
|
|-
| colspan="2" |'''firewalld 常用操作速查'''

systemctl start firewalld — 启动防火墙

systemctl stop firewalld    — 停止防火墙

systemctl enable firewalld    — 开机自启

systemctl disable firewalld — 禁止开机自启

firewall-cmd --list-all — 查看所有规则

firewall-cmd --reload — 重新加载规则
|}

== 3.3 Rocky Linux 9 — firewalld 防火墙 ==
Rocky Linux 9 同样使用 firewalld，操作方式与 CentOS 7/8 基本一致。主要区别在于：Rocky Linux 9 使用 '''dnf''' 替代 yum 作为包管理器，以及配置文件目录结构有细微差异（如 sshd_config.d/ 目录），但防火墙的操作命令完全一样。
{| class="wikitable"
|# 查看防火墙状态

firewall-cmd --state

<nowiki>#</nowiki> 放行新 SSH 端口

firewall-cmd --permanent --add-port=36912/tcp

firewall-cmd --reload

<nowiki>#</nowiki> 验证端口已放行

firewall-cmd --list-ports
|}
Rocky Linux 9 的 firewalld 还支持更高级的区域（zone）管理。默认区域通常是 public，如果你有更精细的安全需求，可以创建自定义区域并设置基于来源 IP 的访问控制。但对于大多数搬瓦工用户来说，直接在默认区域操作就够用了。

== 3.4 旧版 CentOS 6 / 手动安装的 iptables ==
虽然搬瓦工目前已不推荐安装 CentOS 6，但如果你的系统使用的是 iptables 而非 firewalld，操作方式如下：
{| class="wikitable"
|# 放行新端口

iptables -A INPUT -p tcp --dport 36912 -j ACCEPT

<nowiki>#</nowiki> 保存规则（CentOS 6）

service iptables save

<nowiki>#</nowiki> 如果是 Ubuntu/Debian 使用 iptables

iptables-save > /etc/iptables.rules

<nowiki>#</nowiki> 查看当前规则

iptables -L -n
|
|-
| colspan="2" |'''iptables 规则顺序很重要'''

iptables 的规则是按顺序匹配的。如果前面有一条 DROP 所有的规则，后面加的 ACCEPT 不会生效。建议使用 -I 参数将规则插入到链的最前面：iptables -I INPUT -p tcp --dport 36912 -j ACCEPT
|}

= 四、各系统完整操作流程对比 =
下面这张表把三个系统上修改 SSH 端口的完整流程放在一起对比，方便快速查阅。假设目标端口为 36912。
{| class="wikitable"
|'''操作步骤'''
|'''Ubuntu / Debian'''
|'''CentOS 7/8'''
|'''Rocky Linux 9'''
|-
|'''编辑配置'''
|vi /etc/ssh/sshd_config
|vi /etc/ssh/sshd_config
|vi /etc/ssh/sshd_config

或建 .conf 文件到

sshd_config.d/ 目录
|-
|'''SELinux'''
|不需要处理
|semanage port -a

-t ssh_port_t

-p tcp 36912
|semanage port -a

-t ssh_port_t

-p tcp 36912
|-
|'''防火墙工具'''
|ufw
|firewalld
|firewalld
|-
|'''放行端口'''
|ufw allow 36912/tcp
|firewall-cmd --permanent

--add-port=36912/tcp

firewall-cmd --reload
|firewall-cmd --permanent

--add-port=36912/tcp

firewall-cmd --reload
|-
|'''语法检查'''
|sshd -t
|sshd -t
|sshd -t
|-
|'''重启服务'''
|systemctl restart sshd
|systemctl restart sshd
|systemctl restart sshd
|-
|'''SELinux 工具包'''
|无需安装
|CentOS 7:

policycoreutils-python

CentOS 8:

policycoreutils-python-utils
|policycoreutils-python-utils
|}

= 五、常见实战场景 =

== 5.1 场景一：SSH 端口被封，通过 Root Shell 紧急更换 ==
这是搬瓦工用户最常遇到的情况。SSH 端口被运营商封锁后，客户端无法连接，但通过 KiwiVM 的 Root shell - interactive 可以正常进入系统。操作步骤：

6. 通过 KiwiVM 面板进入 Root shell - interactive 并登录。

7. 编辑 /etc/ssh/sshd_config，将 Port 改为新端口。

8. 如果是 CentOS/Rocky，处理 SELinux。

9. 如果防火墙已启用，放行新端口。

10. 重启 sshd 服务。

11. 使用 SSH 客户端以新端口连接测试。

== 5.2 场景二：改坏了 sshd_config，SSH 服务起不来 ==
如果修改 sshd_config 时写错了参数，sshd 服务无法启动，SSH 自然就连不上了。这时候 Root Shell 就派上用场了：
{| class="wikitable"
|# 1. 进入 Root shell - interactive 并登录

<nowiki>#</nowiki> 2. 查看 sshd 错误日志

journalctl -u sshd -n 20

<nowiki>#</nowiki> 3. 检查配置文件语法

sshd -t

<nowiki>#</nowiki> 4. 根据报错信息修复配置

vi /etc/ssh/sshd_config

<nowiki>#</nowiki> 5. 或者直接恢复备份

cp /etc/ssh/sshd_config.bak /etc/ssh/sshd_config

<nowiki>#</nowiki> 6. 重启 sshd

systemctl restart sshd
|}

== 5.3 场景三：防火墙规则写错，把自己锁在外面 ==
这个场景也很经典。比如你在配置 iptables 时不小心执行了一条 DROP ALL 规则，或者启用 ufw 时忘了先放行 SSH 端口。处理方法：
{| class="wikitable"
|# 进入 Root shell - interactive 后

<nowiki>#</nowiki> 方案一：直接关闭防火墙（简单粗暴）

<nowiki>#</nowiki> Ubuntu/Debian

ufw disable

<nowiki>#</nowiki> CentOS / Rocky Linux

systemctl stop firewalld

<nowiki>#</nowiki> 方案二：清除 iptables 规则

iptables -F

iptables -X

iptables -P INPUT ACCEPT

iptables -P FORWARD ACCEPT

iptables -P OUTPUT ACCEPT

<nowiki>#</nowiki> 方案三：重新配置正确的规则后再启用

<nowiki>#</nowiki> （推荐，修好规则再开防火墙）
|}
恢复连接后，再认真重新配置防火墙规则。Root Shell 在这种场景下是唯一的救命通道，因为它完全绕开了网络层面的限制。

== 5.4 场景四：首次安全加固的推荐操作顺序 ==
对于刚拿到搬瓦工 VPS 的用户，建议按以下顺序进行基础安全加固。可以通过 Root Shell 完成全部操作，也可以通过 SSH 客户端完成（但建议在旁边开着 Root Shell 备用）：

12. 修改 root 密码为强密码（KiwiVM 面板或 passwd 命令）

13. 配置 SSH 密钥登录

14. 修改 SSH 端口为自定义高位端口

15. 禁用密码登录（确认密钥能用之后）

16. 配置防火墙，仅开放必要端口

17. 安装 fail2ban 防暴力破解（可选但推荐）

= 六、Root Shell 使用注意事项 =

== 6.1 Root shell - interactive 的限制 ==
虽然 Root shell - interactive 提供了完整的终端功能，但它毕竟是基于 VNC 的 Web 终端，有一些使用上的限制需要注意：

• 无法直接复制粘贴长文本。Web 终端的剪贴板功能有限，如果需要粘贴较长的命令或脚本，建议改用 Root shell - advanced 或将内容写成脚本通过 wget/curl 下载后执行。

• 会话超时后需要重新登录。如果长时间不操作，VNC 会话会断开，重新点击 Launch 即可。

• 屏幕分辨率有限。Web 终端的显示区域比较小，查看长输出时可能不太方便，建议用 less 或 more 命令分页查看。

• VPS 必须处于运行状态。Root Shell 需要 VPS 正常运行才能使用，如果 VPS 处于关机状态，需要先在 KiwiVM 面板点击 Start 开机。

== 6.2 用 sed 替代 vi 的技巧 ==
如果你觉得在 Web 终端里用 vi 不太顺手，也可以用 sed 命令直接替换配置文件中的内容。这种方式在 Root shell - basic 或 advanced 模式下也能执行，不需要交互。
{| class="wikitable"
|# 将 SSH 端口从 28456 改为 36912

sed -i 's/^Port 28456/Port 36912/' /etc/ssh/sshd_config

<nowiki>#</nowiki> 禁用密码登录

sed -i 's/^#PasswordAuthentication yes/PasswordAuthentication no/' /etc/ssh/sshd_config

sed -i 's/^PasswordAuthentication yes/PasswordAuthentication no/' /etc/ssh/sshd_config

<nowiki>#</nowiki> 修改完后记得重启 sshd

systemctl restart sshd
|
|-
| colspan="2" |'''sed 的优势'''

sed 命令的好处是可以精确替换，不需要进入交互式编辑器。对于在 Root shell - basic/advanced 中快速修改配置非常方便。缺点是需要你确切知道要替换的内容，写错了可能破坏配置文件。建议操作前先备份。
|}

== 6.3 终极兜底方案：重装系统 ==
如果 sshd 和防火墙配置彻底改坏了，Root Shell 也修不好（比如系统层面的问题），还有最后一招：通过 KiwiVM 面板的 Install new OS 功能重装系统。重装后会分配新的 root 密码和 SSH 端口，所有配置恢复默认。

'''注意：'''重装系统会清除所有数据，请提前做好备份。如果你有重要数据，可以先通过 Root Shell 把关键文件打包，然后用 KiwiVM 的 Snapshots 功能做一个快照备份。

= 七、总结 =
Root Shell 是搬瓦工 KiwiVM 面板中一个容易被忽视但极其实用的功能。对于 sshd 配置和防火墙管理来说，它既是操作工具，也是安全保障。这里再强调几个关键点：

• 修改 sshd 或防火墙时，始终保持一个 Root Shell 会话作为备用通道。

• CentOS / Rocky Linux 用户修改 SSH 端口时不要忘记处理 SELinux。

• 配置防火墙前先确认 SSH 端口已放行，避免把自己锁在门外。

• 修改前备份配置文件，修改后用 sshd -t 做语法检查。

• 善用 sed 命令，可以在非交互模式下快速完成配置修改。

如果你在操作过程中遇到任何问题，Root Shell 就是你的最后一道防线。只要 VPS 还在运行，就能通过 KiwiVM 面板的 Root shell - interactive 进入系统修复。实在修不好，还有重装系统兜底。所以大胆操作，'''但记得备份'''。

以上就是通过搬瓦工 KiwiVM Root Shell 修改 sshd 配置和管理防火墙的完整教程。后续还会有更多关于 KiwiVM 控制面板功能的详细介绍。有任何疑问欢迎在评论区留言，或加入本站的交流群一起讨论。

'''[https://www.banwagong.net/ 搬瓦工中文网]''' — 专业的搬瓦工中文教程站
[[Category:200 KiwiVM 简介 — KiwiVM Introduction]]

修改 SSH 端口

2026-02-17T16:46:27Z

Root：创建页面，内容为“= 前言 = 搬瓦工的 VPS 在购买并安装系统后，SSH 端口号是随机分配的，并不是常见的默认 22 端口。虽然随机端口本身已经比固定 22 端口更安全一些，但在实际使用中，我们仍然会遇到需要修改 SSH 端口的情况。最常见的场景有两个：一是 SSH 端口被封，导致无法连接 VPS；二是出于安全考虑，想要自定义一个特定的端口。不管是哪种原因，修改 SSH 端…”

= 前言 =
搬瓦工的 VPS 在购买并安装系统后，SSH 端口号是随机分配的，并不是常见的默认 22 端口。虽然随机端口本身已经比固定 22 端口更安全一些，但在实际使用中，我们仍然会遇到需要修改 SSH 端口的情况。

最常见的场景有两个：一是 SSH 端口被封，导致无法连接 VPS；二是出于安全考虑，想要自定义一个特定的端口。不管是哪种原因，修改 SSH 端口的操作本身并不复杂，但不同操作系统之间存在一些细节差异，稍不注意可能会把自己锁在门外。

本文将分别介绍在 CentOS、Rocky Linux、Ubuntu 等搬瓦工常用系统上修改 SSH 端口的完整步骤，同时也会讲解如何配合 KiwiVM 控制面板进行操作，确保即使改错了也有办法补救。

= 一、准备工作 =

== 1.1 确认当前 SSH 端口 ==
搬瓦工 VPS 的 SSH 连接信息（IP 地址、端口号）可以在 KiwiVM 控制面板中查看。登录方法如下：

1. 登录搬瓦工官网，进入 Client Area

2. '''点击 Services → My Services'''，找到你的 VPS 套餐

3. '''点击 Open KiwiVM''' 进入 KiwiVM 控制面板

4. 在面板首页即可看到 IP Address 和 SSH Port 信息

如果你已经能通过 SSH 客户端连接到 VPS，也可以直接在终端中查看当前端口：
{| class="wikitable"
|# 查看当前 SSH 监听端口

ss -tlnp | grep sshd

<nowiki>#</nowiki> 或者查看 sshd 配置文件中的端口设置

grep -i "^Port" /etc/ssh/sshd_config
|}

== 1.2 选择新端口号 ==
端口号的有效范围是 1 到 65535。选择新端口时，需要注意以下几点：

• '''避免使用常见服务端口：'''如 22（SSH 默认）、80（HTTP）、443（HTTPS）、3306（MySQL）、8080 等

• '''建议选择高位端口：'''1024 到 65535 之间的端口，且尽量选择 10000 以上的随机数字，如 28456、39721 等

• '''避免与搬瓦工系统服务冲突：'''搬瓦工部分端口可能被内部服务占用，选择一个不常见的高位端口即可
{| class="wikitable"
|'''提示'''

建议用一个自己能记住但别人猜不到的端口，比如 5 位数的随机端口。不要使用网上教程中的示例端口（如 2222），因为这些端口同样会被扫描工具覆盖到。
|}

== 1.3 了解 KiwiVM 应急通道 ==
这一步很重要。在修改 SSH 端口之前，你需要确认自己知道如何通过 KiwiVM 面板进入系统。因为一旦 SSH 端口改错了或者防火墙配置有误导致连不上 SSH，KiwiVM 的 '''Root shell''' 功能就是你的救命稻草。

KiwiVM 控制面板提供了三种在线 Shell 工具：
{| class="wikitable"
|'''功能名称'''
|'''说明'''
|-
|'''Root shell - basic'''
|简易命令行，输入单条命令后回车执行，适合简单操作
|-
|'''Root shell - advanced'''
|高级命令行，支持复制粘贴，适合执行较长的命令
|-
|'''Root shell - interactive'''
|交互式 VNC 终端，最接近真实终端体验，支持 vi 编辑器等交互操作
|}
这三个工具都'''不依赖 SSH 连接'''，直接通过网页操作 VPS。所以即使 SSH 完全连不上，也可以通过 KiwiVM 进入系统修复配置。改端口之前先试试这几个功能，确保它们能正常使用。
{| class="wikitable"
|'''重要提醒'''

如果你通过 Root shell - interactive（VNC）登录，请注意：

'''用户名输入 root'''，密码是你的 root 密码（输入时不会显示任何字符，这是正常的）。

如果忘记了 root 密码，可以在 KiwiVM 左侧菜单的 Root password modification 中重置。
|}

= 二、Ubuntu / Debian 修改 SSH 端口 =
Ubuntu 和 Debian 是搬瓦工上最常用的操作系统之一，操作也相对简单。这两个系统默认不启用 SELinux，防火墙工具一般是 ufw（如果安装了的话）。搬瓦工默认安装的系统通常没有启用 ufw，所以在大多数情况下只需要修改配置文件并重启服务即可。

== 2.1 修改 sshd_config ==
通过 SSH 或 KiwiVM Root shell 登录 VPS 后，执行以下命令：
{| class="wikitable"
|# 备份配置文件（养成好习惯）

cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak

<nowiki>#</nowiki> 编辑 SSH 配置文件

vi /etc/ssh/sshd_config
|}
在文件中找到 #Port 22 这一行（可能被注释掉了），去掉前面的 #，然后将 22 改成你想要的端口号。例如改成 28456：
{| class="wikitable"
|Port 28456
|}
如果你使用 vi 编辑器：按 '''i''' 进入编辑模式，修改完成后按 '''Esc'''，然后输入 ''':wq''' 回车保存退出。
{| class="wikitable"
|'''安全建议'''

在确认新端口可用之前，建议先保留 22 端口不删除，而是同时监听两个端口：

Port 22

Port 28456

等新端口连接测试成功后，再回来删掉 Port 22 那行。这样可以避免把自己锁在外面。
|}

== 2.2 重启 SSH 服务 ==
{| class="wikitable"
|# 重启 SSH 服务使配置生效

systemctl restart sshd

<nowiki>#</nowiki> 检查 SSH 服务状态

systemctl status sshd

<nowiki>#</nowiki> 确认新端口已在监听

ss -tlnp | grep sshd
|}
如果输出中能看到你设置的新端口号，说明修改成功了。

== 2.3 配置 ufw 防火墙（如果启用了的话） ==
搬瓦工默认系统一般没有启用 ufw。但如果你之前手动启用了 ufw，那么必须先放行新端口，否则新端口的流量会被防火墙拦截：
{| class="wikitable"
|# 检查 ufw 状态

ufw status

<nowiki>#</nowiki> 如果 ufw 是 active 状态，放行新端口

ufw allow 28456/tcp

<nowiki>#</nowiki> 确认放行成功后，可以删除旧端口的规则

ufw delete allow 22/tcp

<nowiki>#</nowiki> 重载防火墙

ufw reload
|}
如果 ufw status 显示 inactive，那说明防火墙没有启用，跳过这一步即可。

= 三、CentOS 7/8 修改 SSH 端口 =
CentOS 的操作比 Ubuntu 多了两个环节：SELinux 和 firewalld。搬瓦工默认安装的 CentOS 系统通常启用了 SELinux（enforcing 模式），如果只修改了配置文件而没有处理 SELinux，重启 sshd 服务时会直接报错，这是很多新手踩坑的地方。

== 3.1 修改 sshd_config ==
这一步和 Ubuntu 完全一样：
{| class="wikitable"
|# 备份

cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak

<nowiki>#</nowiki> 编辑

vi /etc/ssh/sshd_config

<nowiki>#</nowiki> 找到 Port 行，修改为新端口

Port 28456
|}

== 3.2 处理 SELinux ==
这是 CentOS/RHEL 系操作系统的关键步骤。SELinux 默认只允许 SSH 使用 22 端口，如果你改成了其他端口但没有告知 SELinux，sshd 服务将'''无法启动'''。

首先检查 SELinux 状态：
{| class="wikitable"
|# 查看 SELinux 当前状态

getenforce
|}
如果输出是 '''Enforcing'''，那么必须执行以下操作。如果输出是 Disabled 或 Permissive，可以跳过这一步。
{| class="wikitable"
|# 安装 SELinux 管理工具（如果 semanage 命令不存在）

yum install -y policycoreutils-python-utils

<nowiki>#</nowiki> CentOS 7 使用这个包名

<nowiki>#</nowiki> yum install -y policycoreutils-python

<nowiki>#</nowiki> 向 SELinux 添加新的 SSH 端口

semanage port -a -t ssh_port_t -p tcp 28456

<nowiki>#</nowiki> 验证端口是否添加成功

semanage port -l | grep ssh
|}
正常情况下，输出应该包含你新增的端口号。比如：ssh_port_t tcp 28456, 22

== 3.3 配置 firewalld 防火墙 ==
CentOS 默认使用 firewalld 作为防火墙。同样需要放行新端口：
{| class="wikitable"
|# 检查 firewalld 是否运行

systemctl status firewalld

<nowiki>#</nowiki> 如果正在运行，添加新端口

firewall-cmd --permanent --add-port=28456/tcp

<nowiki>#</nowiki> 重载防火墙规则

firewall-cmd --reload

<nowiki>#</nowiki> 验证

firewall-cmd --list-ports
|}
如果 firewalld 没有运行（inactive），同样可以跳过这一步。搬瓦工的部分系统镜像默认并未启用 firewalld。

== 3.4 重启 SSH 服务 ==
{| class="wikitable"
| colspan="2" |# 重启 sshd

systemctl restart sshd

<nowiki>#</nowiki> 查看状态（确认没有报错）

systemctl status sshd

<nowiki>#</nowiki> 确认端口监听

ss -tlnp | grep sshd
|
|}

= 四、Rocky Linux 9 / AlmaLinux 9 修改 SSH 端口 =
Rocky Linux 是 CentOS 停止维护后的主流替代方案，搬瓦工的系统模板中也已经提供了 Rocky Linux。操作方法与 CentOS 基本一致，但有一些小区别值得注意。

== 4.1 修改配置文件 ==
Rocky Linux 9 引入了 /etc/ssh/sshd_config.d/ 目录来管理配置片段。你可以选择直接修改主配置文件，也可以在该目录下创建一个新的配置文件（推荐后者，更清晰）：

'''方法一：创建配置片段（推荐）'''
{| class="wikitable"
|# 创建一个自定义配置文件

echo "Port 28456" > /etc/ssh/sshd_config.d/custom-port.conf
|}
'''方法二：直接修改主配置文件'''
{| class="wikitable"
|cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak

vi /etc/ssh/sshd_config

<nowiki>#</nowiki> 找到 #Port 22，去注释并修改为 Port 28456
|}

== 4.2 处理 SELinux ==
Rocky Linux 9 默认启用 SELinux enforcing 模式，操作与 CentOS 相同：
{| class="wikitable"
|# 安装 SELinux 管理工具

dnf install -y policycoreutils-python-utils

<nowiki>#</nowiki> 添加新端口到 SELinux 策略

semanage port -a -t ssh_port_t -p tcp 28456

<nowiki>#</nowiki> 验证

semanage port -l | grep ssh
|}

== 4.3 配置 firewalld ==
{| class="wikitable"
|# 放行新端口

firewall-cmd --permanent --add-port=28456/tcp

firewall-cmd --reload

<nowiki>#</nowiki> 可选：如果不再使用 22 端口，移除默认的 ssh 服务

firewall-cmd --permanent --remove-service=ssh

firewall-cmd --reload
|}

== 4.4 重启并验证 ==
{| class="wikitable"
|# 先检查配置是否有语法错误

sshd -t

<nowiki>#</nowiki> 没有报错再重启

systemctl restart sshd

systemctl status sshd

ss -tlnp | grep sshd
|}
Rocky Linux 提供了 sshd -t 命令来预检配置文件语法，建议在重启之前先跑一下，避免因为配置错误导致服务起不来。

= 五、各系统操作对比速查 =
下面用一张表把三种系统的操作步骤做个对比，方便快速参考：
{| class="wikitable"
|'''操作步骤'''
|'''Ubuntu / Debian'''
|'''CentOS 7/8'''
|'''Rocky Linux 9'''
|-
|'''配置文件'''
|/etc/ssh/sshd_config
|/etc/ssh/sshd_config
|sshd_config.d/ 或主配置
|-
|'''SELinux'''
|无需处理
|semanage port -a ...
|semanage port -a ...
|-
|'''防火墙'''
|ufw allow 端口/tcp
|firewall-cmd ...
|firewall-cmd ...
|-
|'''重启服务'''
|systemctl restart sshd
|systemctl restart sshd
|systemctl restart sshd
|-
|'''预检命令'''
|sshd -t
|sshd -t
|sshd -t
|-
|'''包管理器'''
|apt
|yum
|dnf
|}

= 六、验证与连接测试 =
修改完成后，先不要关闭当前的 SSH 会话。另外开一个终端窗口，用新端口尝试连接：
{| class="wikitable"
|# Linux / macOS 终端

ssh -p 28456 root@你的IP地址

<nowiki>#</nowiki> Windows 使用 PuTTY / Xshell 等工具

<nowiki>#</nowiki> 在连接设置中将端口改为 28456 即可
|}
如果能成功连接，说明修改生效了。此时可以安全地关闭旧会话，并在配置文件中删掉旧端口（如果之前保留了两个端口的话）。

如果连接失败，不要慌。保持旧会话不关闭，回去检查以下几点：

• '''配置文件语法是否正确：'''运行 sshd -t 检查

• '''SELinux 是否放行了新端口：'''运行 semanage port -l | grep ssh 确认

• '''防火墙是否放行了新端口：'''运行 firewall-cmd --list-ports 或 ufw status 确认

• '''sshd 服务是否正常运行：'''运行 systemctl status sshd 查看

= 七、改坏了连不上怎么办 =
如果你不幸把自己锁在了门外（SSH 完全连不上），别急，这种情况在搬瓦工上是完全可以救回来的。

== 7.1 通过 KiwiVM Root shell 修复 ==
5. 登录搬瓦工官网，进入 KiwiVM 控制面板

6. '''点击左侧菜单的 Root shell - interactive'''，然后点击 Launch

7. 在弹出的 VNC 窗口中用 root 账号登录

8. 执行修复命令：还原备份文件或重新修改端口
{| class="wikitable"
|# 如果之前做了备份，直接还原

cp /etc/ssh/sshd_config.bak /etc/ssh/sshd_config

systemctl restart sshd

<nowiki>#</nowiki> 或者手动修改回正确的端口

vi /etc/ssh/sshd_config
|}

== 7.2 终极方案：重装系统 ==
如果实在搞不定，KiwiVM 面板还提供了一键重装系统的功能（Install new OS）。重装后所有数据会被清空，但至少 VPS 能恢复到可用状态。所以如果 VPS 上有重要数据，建议在修改端口之前先用快照（Snapshots）功能做一个备份。

= 八、额外安全建议 =
修改 SSH 端口只是服务器安全的第一步，建议在此基础上进一步加固：

• '''使用 SSH 密钥登录，禁用密码认证：'''在 sshd_config 中设置 PasswordAuthentication no，搭配密钥对登录，安全性大幅提升

• '''禁止 root 直接登录：'''创建普通用户，设置 PermitRootLogin no，通过 sudo 提权

• '''安装 fail2ban：'''自动封禁多次尝试暴力破解的 IP，减少被攻击风险

• '''定期更新系统：'''及时修补安全漏洞

• '''使用搬瓦工快照功能：'''定期备份，出问题可快速恢复

以上就是搬瓦工 VPS 修改 SSH 端口的完整教程。总结一下核心要点：Ubuntu 最简单，改配置重启服务即可；CentOS 和 Rocky Linux 需要额外处理 SELinux 和 firewalld；改之前一定先确认 KiwiVM Root shell 能用，留好退路。

如果在操作过程中遇到问题，可以在本站评论区留言，或者加入搬瓦工交流群一起讨论。

'''[https://www.banwagong.net/ 搬瓦工中文网]''' — 做专业的搬瓦工中文教程站

搬瓦工产品介绍 - 价格与功能全面比较

2026-02-17T12:08:12Z

Root：

= 前言 =
'''搬瓦工（BandwagonHost）'''是美国 IT7 公司旗下的知名 VPS 服务商，在国内用户群体中拥有很高的知名度。从最早几美元一年的"搬砖"入门机，到如今覆盖全球十余个数据中心、提供 CN2 GIA 高端线路的中高端产品线，搬瓦工的产品定位已经发生了很大的变化。

目前搬瓦工的套餐体系相对完善，但对于新手来说，面对官网密密麻麻的英文页面和各种套餐代号，确实不太容易分清楚。本文将按照套餐系列逐一介绍搬瓦工目前在售的全部产品线，包括价格、配置、线路、可选机房等关键信息，帮助大家快速找到适合自己的方案。

'''提示：'''搬瓦工支持支付宝付款，全中文流程购买教程可参考本站其他文章。购买前建议先通过测试 IP 测速，确认线路质量符合预期再下单。

= 一、套餐总览与快速对比 =
先给大家一个全局视角。搬瓦工目前在售的常规套餐大致可以分为以下几个系列，从入门到高端依次排列。下面这张表可以帮助你快速定位自己应该看哪个系列：
{| class="wikitable"
|'''套餐系列'''
|'''起步价'''
|'''最大带宽'''
|'''可选机房'''
|'''线路'''
|'''适合人群'''
|'''推荐指数'''
|-
|'''KVM 套餐'''
|$49.99/年
|1 Gbps
|8+
|CN2 GT
|入门学习
|★★★
|-
|'''CN2 GIA-E'''
|$169.99/年
|10 Gbps
|15+
|CN2 GIA
|建站/高速
|★★★★★
|-
|'''中国香港'''
|$89.99/月
|1 Gbps
|7+
|CN2 GIA
|极致体验
|★★★★
|-
|'''日本东京'''
|$89.99/月
|1.2 Gbps
|1
|CN2 GIA
|低延迟
|★★★★
|-
|'''日本大阪'''
|$49.99/月
|1.5 Gbps
|15+
|CN2 GIA
|性价比高端
|★★★★
|-
|'''迪拜套餐'''
|$19.99/月
|1 Gbps
|15+
|CN2 GIA
|中东业务
|★★★
|-
|'''限量版'''
|不定
|2.5 Gbps
|不定
|多种
|手快有
|★★★★
|}
'''一句话建议：'''预算有限选 KVM 入门，追求性价比首选 CN2 GIA-E，不差钱上中国香港。大部分用户买 CN2 GIA-E 就够了，能覆盖绝大多数使用场景。

= 二、KVM 套餐（入门之选） =

== 2.1 套餐定位 ==
KVM 套餐是搬瓦工目前价格最低的在售套餐系列，也是官方分类中的 "Basic VPS"。年付 $49.99 起步，折合人民币一天不到一块钱，非常适合新手用来学习 Linux、练手建站、或者对线路要求不高的轻量级应用。

这个系列的线路以 CN2 GT 为主，也就是电信的半程 CN2。简单来说就是去程走普通线路，回程走 CN2，相比普通 163 骨干网有一定优化，但跟 CN2 GIA 的全程高端线路还是有差距的。晚高峰期间可能会有一些波动，但日常使用基本够用。

== 2.2 配置与价格 ==
{| class="wikitable"
|'''CPU'''
|'''内存'''
|'''硬盘'''
|'''带宽'''
|'''月流量'''
|'''价格'''
|-
|2核
|1 GB
|20 GB SSD
|1 Gbps
|1 TB
|$49.99/年
|-
|3核
|2 GB
|40 GB SSD
|1 Gbps
|2 TB
|$52.99/半年 $99.99/年
|-
|4核
|4 GB
|80 GB SSD
|1 Gbps
|3 TB
|$19.99/月 $199.99/年
|-
|5核
|8 GB
|160 GB SSD
|1 Gbps
|4 TB
|$39.99/月 $399.99/年
|-
|6核
|16 GB
|320 GB SSD
|1 Gbps
|5 TB
|$79.99/月 $799.99/年
|}
'''可选机房：'''洛杉矶 DC2 AO、DC4 MCOM、DC8 ZNET、弗里蒙特、新泽西、纽约、荷兰等。注意目前已移除 DC3 CN2 机房。

'''点评：'''KVM 套餐最大的优势就是便宜，$49.99/年这个价格在同类产品中很有竞争力。缺点是不支持 CN2 GIA 机房，线路质量相比 CN2 GIA-E 套餐有明显差距。如果你只是想体验搬瓦工，或者纯粹学习 Linux，这个系列完全够用。但如果是正经建站或者对速度有要求，建议直接跳到 CN2 GIA-E。

= 三、CN2 GIA-E 套餐（性价比之王） =

== 3.1 套餐定位 ==
CN2 GIA-E 全称 CN2 GIA ECOMMERCE，也就是大家常说的"电子商务套餐"，是搬瓦工目前'''最推荐、性价比最高'''的套餐系列。官方分类为 "E-Commerce VPS"。

这个系列最大的特点是三网回程 CN2 GIA，电信走 CN2 GIA，联通走 CUP/AS10099，移动走 CMIN2，三网都有优化。并且带宽从 2.5Gbps 起步，最高可达 10Gbps，远超其他系列。

更重要的是，CN2 GIA-E 套餐购买后可以在多达 15 个以上的机房之间自由切换，包括 DC6 CN2 GIA-E、DC9 CN2 GIA、日本大阪软银、联通荷兰 EUNL_9、迪拜、纽约 CN2 GIA 等。相当于买一个套餐，享受全球多个高端机房，性价比拉满。

== 3.2 配置与价格 ==
{| class="wikitable"
|'''CPU'''
|'''内存'''
|'''硬盘'''
|'''带宽'''
|'''月流量'''
|'''价格'''
|-
|2核
|1 GB
|20 GB SSD
|2.5 Gbps
|1 TB
|$49.99/季 $169.99/年
|-
|3核
|2 GB
|40 GB SSD
|2.5 Gbps
|2 TB
|$89.99/季 $299.99/年
|-
|4核
|4 GB
|80 GB SSD
|5 Gbps
|3 TB
|$56.99/月 $549.99/年
|-
|6核
|8 GB
|160 GB SSD
|5 Gbps
|5 TB
|$86.99/月 $879.99/年
|-
|8核
|16 GB
|320 GB SSD
|10 Gbps
|8 TB
|$159.99/月 $1599.99/年
|}
'''可选机房（15+）：'''洛杉矶 DC6 CN2 GIA-E、DC9 CN2 GIA、DC1、圣何塞 CN2 GIA、纽约 CN2 GIA、加拿大温哥华 CN2 GIA、日本大阪软银 JPOS_1、联通荷兰 EUNL_9、荷兰 EUNL_2、迪拜 AEDXB_1、DC2 AO、DC4 MCOM、DC8 ZNET、弗里蒙特等。

'''点评：'''CN2 GIA-E 套餐是搬瓦工的核心产品，也是本站一直以来最推荐的套餐。$169.99/年看似不便宜，但考虑到 2.5Gbps 带宽、三网 CN2 GIA 回程、15+ 可选机房这些配置，在同类产品中几乎找不到对手。如果只能选一个套餐，闭眼买这个就行了。另外这个套餐支持 $49.99/季度付款，不确定的话先买一个季度试试也行。

= 四、中国香港 CN2 GIA 套餐（高端之选） =

== 4.1 套餐定位 ==
中国香港 CN2 GIA 套餐是搬瓦工的'''旗舰级产品'''，官方分类为 "Ultra VPS"。机房位于中国香港，接入 CN2 GIA 线路，国内访问延迟低至 30-50ms，几乎和国内服务器没什么区别。

香港套餐购买后还可以切换到日本东京 CN2 GIA、日本大阪 CN2 GIA、新加坡 CN2 GIA 以及美国 CN2 GIA 等多个高端机房，可选范围涵盖了搬瓦工所有最顶级的亚太机房。

当然，这个级别的体验也意味着相应的价格。月付 $89.99 起步，年付 $899.99，确实不是一般用户能承受的。但如果你的业务对延迟和稳定性有极高要求，那这个钱花得绝对值。

== 4.2 配置与价格 ==
{| class="wikitable"
|'''CPU'''
|'''内存'''
|'''硬盘'''
|'''带宽'''
|'''月流量'''
|'''价格'''
|-
|2核
|2 GB
|40 GB SSD
|1 Gbps
|500 GB
|$89.99/月 $899.99/年
|-
|4核
|4 GB
|80 GB SSD
|1 Gbps
|1 TB
|$155.99/月 $1559.99/年
|-
|6核
|8 GB
|160 GB SSD
|1 Gbps
|2 TB
|$299.99/月 $2999.99/年
|-
|8核
|16 GB
|320 GB SSD
|1 Gbps
|4 TB
|$589.99/月 $5899.99/年
|}
'''可选机房（7+）：'''中国香港 CN2 GIA [HKHK_8]、日本东京 CN2 GIA [JPTYO_8]、日本大阪 CN2 GIA [JPOS_6]、新加坡 CN2 GIA [SG_1]、洛杉矶 DC6/DC9 CN2 GIA、圣何塞 CN2 GIA 等。

'''点评：'''香港套餐的网络体验确实是搬瓦工所有产品中最顶级的，延迟低、速度快、稳定性好。购买后还能自由切换到东京、大阪、新加坡等亚太 CN2 GIA 机房，实际可用性很强。但价格门槛较高，建议只有真正需要极致体验、或者业务有硬性要求的用户再考虑。普通建站用 CN2 GIA-E 完全够了。

= 五、日本东京 CN2 GIA 套餐 =

== 5.1 套餐定位 ==
日本东京 CN2 GIA 套餐于 2021 年底上线，同样属于 "Ultra" 系列高端产品。机房位于日本东京，三网回程 CN2 GIA，国内延迟约 40-80ms，比美国机房低很多。

这个套餐最大的特点是三网都走 CN2 GIA，不像香港套餐那样联通和移动走各自的线路。所以如果你的用户群是三网混合的，东京 CN2 GIA 在三网体验的一致性上可能更好。

不过要注意，东京套餐目前购买后只能使用东京 CN2 GIA 机房 [JPTYO_8]，不支持迁移到其他机房。这一点和香港套餐有明显区别。

== 5.2 配置与价格 ==
{| class="wikitable"
|'''CPU'''
|'''内存'''
|'''硬盘'''
|'''带宽'''
|'''月流量'''
|'''价格'''
|-
|2核
|2 GB
|40 GB SSD
|1.2 Gbps
|500 GB
|$89.99/月 $899.99/年
|-
|4核
|4 GB
|80 GB SSD
|1.2 Gbps
|1 TB
|$155.99/月 $1559.99/年
|-
|6核
|8 GB
|160 GB SSD
|1.2 Gbps
|2 TB
|$299.99/月 $2999.99/年
|-
|8核
|16 GB
|320 GB SSD
|1.2 Gbps
|4 TB
|$589.99/月 $5899.99/年
|}
'''可选机房：'''仅日本东京 CN2 GIA [JPTYO_8]，不可迁移。

'''点评：'''东京 CN2 GIA 套餐的价格和香港套餐完全一样，但可选机房少了很多（只有东京一个），这是它比较吃亏的地方。不过如果你明确只需要日本东京机房，那三网 CN2 GIA 的一致性体验确实是优势。建议优先考虑香港套餐（可迁移到东京），除非东京机房对你有不可替代的意义。

= 六、日本大阪 CN2 GIA 套餐 =

== 6.1 套餐定位 ==
日本大阪 CN2 GIA 套餐相对低调，但实际上是一个非常值得关注的选择。它的线路跟东京一样是三网 CN2 GIA 回程，但价格只有东京套餐的大约一半，月付 $49.99 起步。

更值得一提的是，大阪 CN2 GIA 套餐购买后可以迁移到 CN2 GIA-E 套餐的全部机房，也就是说你不仅能用大阪 CN2 GIA 机房，还能切换到美国 DC6、DC9、日本软银、荷兰联通等十几个机房。这个设定让大阪套餐的性价比直接拉到了很高的水平。

== 6.2 配置与价格 ==
{| class="wikitable"
|'''CPU'''
|'''内存'''
|'''硬盘'''
|'''带宽'''
|'''月流量'''
|'''价格'''
|-
|2核
|2 GB
|40 GB SSD
|1.5 Gbps
|500 GB
|$49.99/月 $499.99/年
|-
|4核
|4 GB
|80 GB SSD
|1.5 Gbps
|1 TB
|$86.99/月 $869.99/年
|-
|6核
|8 GB
|160 GB SSD
|1.5 Gbps
|2 TB
|$159.99/月 $1599.99/年
|-
|8核
|16 GB
|320 GB SSD
|1.5 Gbps
|4 TB
|$329.99/月 $3299.99/年
|}
'''可选机房（15+）：'''日本大阪 CN2 GIA [JPOS_6]（默认）+ CN2 GIA-E 套餐的全部可迁移机房。

'''点评：'''大阪 CN2 GIA 套餐是高端套餐中的"性价比选手"。同样是三网 CN2 GIA，价格比香港和东京便宜一半，还能迁移到 CN2 GIA-E 的全部机房。如果你想要亚太 CN2 GIA 体验但预算有限，大阪套餐是很好的折中方案。

= 七、迪拜套餐 =

== 7.1 套餐定位 ==
迪拜套餐比较小众，关注度也相对较低。机房位于阿联酋迪拜 [AEDXB_1]，2022 年短暂上线后又下架，2024 年重新上线并稳定至今。

值得注意的是，搬瓦工近期已经将迪拜机房加入到 CN2 GIA-E 套餐的可迁移列表中。也就是说，如果你购买的是 CN2 GIA-E 套餐，现在也可以免费迁移到迪拜机房使用。这使得独立购买迪拜套餐的必要性大大降低。

== 7.2 配置与价格 ==
{| class="wikitable"
|'''CPU'''
|'''内存'''
|'''硬盘'''
|'''带宽'''
|'''月流量'''
|'''价格'''
|-
|2核
|1 GB
|20 GB SSD
|1 Gbps
|500 GB
|$19.99/月 $199.99/年
|-
|3核
|2 GB
|40 GB SSD
|1 Gbps
|1 TB
|$32.99/月 $329.99/年
|-
|4核
|4 GB
|80 GB SSD
|1 Gbps
|2 TB
|$56.99/月 $569.99/年
|-
|6核
|8 GB
|160 GB SSD
|1 Gbps
|3 TB
|$86.99/月 $869.99/年
|}
'''可选机房：'''迪拜 AEDXB_1 + CN2 GIA-E 全部可迁移机房。

'''点评：'''迪拜套餐目前的定位比较尴尬。因为 CN2 GIA-E 套餐已经可以免费迁移到迪拜机房了，所以除非你只需要迪拜且不想多花钱，否则直接买 CN2 GIA-E 更划算。如果你有中东方向的业务需求，这个机房倒是可以考虑。

= 八、CN2 GIA-E SLA 套餐 =
CN2 GIA-E SLA 套餐是搬瓦工近期推出的一个特殊版本，全称 ECOMMERCE SLA PLAN。相比常规 CN2 GIA-E 套餐，SLA 版本最大的特点是提供 '''99.99% 在线率保证'''，并且在 KiwiVM 后台增加了免费换 IP 功能（IP Test），对于需要高可用性的用户来说是一个加分项。

配置和价格方面，SLA 套餐与常规 CN2 GIA-E 基本持平或略高，具体以官网实际售价为准。可选机房与 CN2 GIA-E 套餐保持一致。

'''站长点评：'''SLA 套餐适合对在线率有严格要求、或者经常遇到 IP 被封需要换 IP 的用户。99.99% 的 SLA 承诺在低价 VPS 中很少见。如果你的网站或业务不能容忍长时间宕机，这个套餐值得多付一点钱。

= 九、限量版套餐 =
限量版套餐是搬瓦工非常有特色的一类产品，不定期上线，限量销售，卖完即止。价格通常比同级别常规套餐便宜不少，因此每次补货都非常抢手。

近年来搬瓦工推出过很多限量版套餐，包括但不限于：

• CN2 GIA-E 10G 限量版：$49.99/年，可用 CN2 GIA-E 全部机房，被称为"传家宝"套餐

• CN2 GIA-E 40G 限量版：$99.99/年，配置翻倍，性价比极高

• THE PLAN 限量版：$99/年，可选 18 个机房，配置和流量翻倍

• MINICHICKEN 限量版：$19/年，最低价，仅支持弗里蒙特机房

• BiggerBox Pro / MegaBox Pro：洛杉矶 DC1 机房，高端三网优化线路

• The Tokyo Plan：日本东京限量版，三网 CMI 直连

• SakuraBox：日本东京 DC39 机房，CMI 线路

限量版套餐的特点是不定时上线、限量销售、卖完即止。如果遇到价格合适的限量版，建议立刻下手，犹豫就没了。可以关注本站的补货通知群获取第一时间的补货信息。

'''站长点评：'''限量版套餐是搬瓦工"薅羊毛"的最佳机会。尤其是 CN2 GIA-E 10G 限量版，$49.99/年就能享受 CN2 GIA-E 全部机房，性价比碾压一切。缺点就是经常缺货，需要蹲补货通知。如果你有耐心等，限量版永远是最佳选择。

= 十、机房速度排行 =
搬瓦工的不同机房在国内的访问速度差异还是比较明显的。以下是根据实际测速结果整理的速度排行，供大家参考：
{| class="wikitable"
|'''排名'''
|'''机房/线路'''
|'''延迟范围'''
|'''适用场景'''
|-
|'''1'''
|中国香港 CN2 GIA [HKHK_8]
|30-50ms
|极致低延迟建站
|-
|'''2'''
|日本东京 CN2 GIA [JPTYO_8]
|40-80ms
|亚太高端业务
|-
|'''3'''
|日本大阪 CN2 GIA [JPOS_6]
|50-90ms
|日本方向高速
|-
|'''4'''
|日本大阪软银 [JPOS_1]
|60-100ms
|联通用户优选
|-
|'''5'''
|美国洛杉矶 DC6 CN2 GIA-E
|130-170ms
|建站性价比之王
|-
|'''6'''
|美国洛杉矶 DC9 CN2 GIA
|130-170ms
|建站稳定之选
|-
|'''7'''
|美国纽约 CN2 GIA [USNY_8]
|200-250ms
|北美/欧洲业务
|}
以上延迟数据为大致范围，实际情况会因地区、运营商、时段等因素有所不同。建议购买前先通过测试 IP 实际测一下自己的网络环境。

= 十一、购买建议总结 =
最后给大家总结一下不同需求对应的推荐方案，方便快速做决定：

1. '''纯学习/练手：'''KVM 套餐 $49.99/年，便宜够用

2. '''建站/日常使用（推荐）：'''CN2 GIA-E 套餐 $169.99/年起，三网 CN2 GIA，15+ 机房可选

3. '''极致低延迟/高端业务：'''中国香港 CN2 GIA 套餐 $89.99/月起，延迟低至 30ms

4. '''日本方向/亚太业务：'''大阪 CN2 GIA 套餐 $49.99/月起，高端线路+可迁移机房，性价比高

5. '''想省钱/愿意蹲补货：'''限量版套餐，尤其是 CN2 GIA-E 10G 限量版 $49.99/年

6. '''需要高可用/免费换 IP：'''CN2 GIA-E SLA 套餐，99.99% 在线率保证

不管选哪个套餐，搬瓦工的 KiwiVM 控制面板都是统一的，操作体验完全一致。后续如果配置不够用，也可以直接在后台升级到更高级的套餐，已付款金额会按比例折抵。

以上就是搬瓦工目前全部在售套餐的详细介绍和对比。本文会持续更新，如果搬瓦工有新的套餐上线或者价格调整，我会第一时间同步到这里。有任何疑问也欢迎在评论区留言，或者加入本站的交流群一起讨论。

'''[https://www.banwagong.net/ 搬瓦工中文网]''' — 做最专业的搬瓦工中文教程站
[[Category:100 BWH 简介 — BWH Introduction]]

搬瓦工产品介绍 - 价格与功能全面比较

2026-02-17T11:58:32Z

Root：初稿