使用 AI 智能体为家庭配置个人 VPN

目标与原帖展示的内容

目标是搭建自己和家人使用的个人 VPN，无需手动完成每项管理操作。帖子建议租用 VPS、提供智能体 SSH 访问，并为三位成员分别生成链接和二维码。

图片是工作流程示意图，不是已完成部署的截图，也不是可直接导入的配置。本指南在你的电脑上运行 OpenCode，通过 Void API 调用模型，并在你的 VPS 上执行获准的 SSH 命令。

阅读原始帖子（俄语）

1. 准备 VPS 与设备信息

需要你控制的 VPS、公网地址、受支持的 Linux 系统、SSH 端口、用户和认证方式。原帖以 VDSka 为例，VPS 费用独立于 Void API 余额。修改前确认能够使用主机面板的恢复控制台。

记录每个人的设备、操作系统和已有客户端，明确哪些应用直连、哪些流量走隧道。Hysteria 2 需要可用的 UDP；VLESS 的要求取决于传输方式和客户端支持。

帖子中的 VPS 提供商示例

2. 按 Void API 指南安装并接入 OpenCode

打开 Void API 的 OpenCode 接入指南。页面提供工具网站链接，以及服务商配置和启动步骤。如果尚未安装，沿该链接选择适合系统的安装方式，再返回配置 Void API。工具运行在用于管理 VPS 的电脑上。

在账户中创建 API 密钥并检查余额，为本次工作准备独立项目文件夹。下面直接复用 Void API 指南生成器的三个步骤：VOID_API_KEY、opencode.json 和启动。将 MODEL_ID 替换为目录中支持工具调用的真实模型 ID，真实密钥保留在环境变量中。

启动 OpenCode，执行 /models 并选择 Void API 模型。先测试简短回答，再让它列出项目文件，最后连接 VPS。401 应检查密钥和当前终端环境；余额或模型错误应回到账户与目录确认。

export VOID_API_KEY='void_your_key'

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "void-api": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Void API",
      "options": {
        "baseURL": "https://void-api.tech/v1",
        "apiKey": "{env:VOID_API_KEY}"
      },
      "models": {
        "MODEL_ID": {
          "name": "MODEL_ID",
          "attachment": true,
          "modalities": {
            "input": [
              "text",
              "image"
            ],
            "output": [
              "text"
            ]
          }
        }
      }
    }
  }
}

opencode
/models

Void API 的完整 OpenCode 指南·创建 API 密钥·账户余额·模型目录

3. 从智能体所在电脑验证 SSH

先使用主机提供的地址、端口和用户手动登录 SSH。如果要求首次修改密码，先在终端完成。使用密钥时，将公钥配置到 VPS，私钥保存在本机。

可以创建 family-vps 这样的本地 SSH 别名。下方示例属于 SSH 配置，不是 opencode.json。替换文档地址、用户、端口和密钥路径，再测试 ssh family-vps。向智能体提供别名即可，不需要把私钥或密码粘贴到提示词。

先让智能体只读检查系统、资源、占用端口、服务和防火墙。如果已有网站或应用，应提前说明，避免覆盖其配置或重装系统。

Host family-vps
  HostName 203.0.113.10
  User YOUR_SSH_USER
  Port 22
  IdentityFile ~/.ssh/family-vps

ssh family-vps

4. 向智能体说明任务

说明服务器属于你，并可通过 family-vps 访问。提供参与人数与设备信息，让智能体先询问缺失条件并提出方案，再执行配置。

下方是原帖任务的翻译，可按需要修改参与者描述。成果不仅是服务，还包括独立配置、设备说明和可重复部署流程。

为三位家庭成员在我的 VPS 上配置个人 VPN。
先检查服务器，再选择适合的 VLESS 或 Hysteria 2 方案。
配置服务、防火墙、安全更新和开机启动。
为三个人分别创建配置。
先询问每个人的设备和应用，再协助设置分流：指定本地应用和网站直连，其他选定流量通过 VPN。
提供连接链接、二维码和简短连接说明。
准备可重复部署流程，以便迁移到新服务器。

5. 检查环境后选择协议

要求智能体依据服务器系统、连接条件和设备客户端解释 VLESS 或 Hysteria 2 的选择。域名和证书要求随具体模式不同，不能假设所有方案一致。

方案应说明服务、端口、配置路径、更新和开机启动。更改防火墙时保留当前 SSH 端口。安装后检查服务状态与日志，而不只看安装器成功提示。

Xray 文档·Hysteria 2 文档

6. 为三个人生成独立配置和二维码

为每个人分别生成认证信息或配置，便于单独替换或撤销。提供清晰名称、连接链接，以及客户端支持的二维码。

在项目中保存简短说明、配置与成员的对应关系和连接文件。链接与二维码意味着服务器访问权限，应只交给对应成员，不要发布到公共案例或仓库。

7. 逐台连接设备

选择支持实际协议和系统的客户端，让智能体说明如何导入链接、扫描二维码和启用配置。不同平台可以使用不同客户端，但协议与配置格式必须兼容。

先导入一位成员的配置并验证，再重复到其他设备。导入失败时，先检查链接类型、客户端支持和配置完整性，不要随意重新生成配置。

8. 在设备客户端配置分流

原帖提出俄罗斯应用和网站直连，其他指定流量走隧道。具体客户端可能使用域名列表、应用规则或 TUN 等方式，因此必须先知道实际设备与程序。

准备一小组服务进行测试，让智能体解释每项匹配的规则，并结合客户端模式检查 DNS。安装服务器并不会自动为所有手机和电脑完成分流。

分别验证直连与 VPS 路径。分流控制流量经过的路径，不保证任何网站都可访问，也不能保证服务器 IP 不被封锁。此处描述个人安全连接场景。

9. 验证结果并保存报告

让智能体报告协议选择、服务、端口、配置路径、启动状态、成员配置和验证方法。在每台设备上测试连接、指定路由和重新连接行为。

确认 SSH 仍可用，并安排 VPS 重启后的验证。报错时提供准确时间与脱敏错误文本，便于查对应日志。生成二维码或展示原帖图片不等于连接已正常工作。

10. 准备重复部署与迁移

保存安装流程和 README，包含系统、依赖、服务、端口、防火墙与检查步骤。配置中的秘密信息应与公共说明分开保存。

迁移时先准备另一台 VPS、验证 SSH 并提供新别名。应用保存的流程，更新连接参数并测试所有设备，再停用旧服务器。可重复流程有帮助，但不保证瞬间迁移完成。

排查问题：应该告诉智能体什么

OpenCode 失败时，按 Void API 指南检查环境变量密钥、/v1 地址、模型 ID、余额和工具支持。SSH 失败时，先独立确认地址、端口、用户和本地认证。

配置可导入但无法连接时，提供系统、客户端版本、协议、尝试时间与脱敏错误；检查对应 TCP 或 UDP 端口、防火墙、日志和配置。如果只有部分应用异常，则单独检查路由与 DNS。

重装之前先定位故障层：模型访问、SSH、服务器服务、客户端配置或路由。修复具体原因可以保留已正常工作的设置。

Void API OpenCode 指南·API 参考文档·原始案例（俄语）

常见问题

更多大模型 API 使用指南

大模型 API 聚合平台：从俄罗斯接入 AI 模型·如何购买大模型 API 并估算调用费用·如何使用兑换码免费试用 AI API·大模型订阅还是按量付费 API：俄罗斯用户选择指南·热门与高性能 AI 模型：在线大模型使用量排行·Void Chat AI 聊天与智能体实际应用案例·使用 AI 审核网站 SEO 并制定改进计划·用 AI 创建 PDF：根据一张参考图制作五份标签·用 AI 规划旅行：中国行程与旅行 PDF·通过聊天让 Claude 辅助编辑 3D 模型