服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务，不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动，严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外，不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- PuppyIP 服务仅面向海外合规企业及授权人员；境外 VPS、中转或教程步骤不改变地域和服务限制。
- 当前公开脚本为0.2.16，支持指定 Ubuntu、Debian 版本及架构，要求 root 权限和运行中的 systemd。
- 每批最多50条代理出口；空输入创建 VPS 本机直连节点，不能把它当住宅代理出口。
- 安装后导入完整 VLESS 链接或二维码；查看记录与实时检查分开，服务器侧正常不保证所有客户端、网站或 UDP 可用。
- 更换出口保留客户端身份，重置链接会使旧链接失效；暂停保留设置，更新和修改可能造成已有连接短暂重连。
先回答：这份脚本解决什么问题
这份教程面向已经有获授权的海外业务环境、准备在自己 VPS 上配置链式代理的人。PuppyIP Chain 用一个 VLESS 入站接收客户端连接，再按所选节点送往 VPS 本机出口或指定的 socks5 出口。一条链接对应一个出口，不是把全部出口随机混用，也不会把 VPS 公网 IP 变成住宅 IP。
PuppyIP 仅面向海外合规企业及其授权人员提供服务，不面向中国大陆地区开放或提供代理服务，严禁在中国大陆境内使用。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供服务。服务器和出口位于境外不改变这些限制；本文技术步骤不构成例外许可。
本文依据2026年10月6日实际读取的使用教程、README 和0.2.16脚本，整理安装与日常管理方法，没有执行安装、输入真实凭据或测试线路。前置环境和通用连接排错仍有各自用途，文末链接保留；这里重点回答如何安装、添加出口、导入链接和管理现有节点。
步骤一：核对系统、权限和准备材料
准备 VPS 地址、SSH 端口及本人有权使用的登录方式，确认系统和已有服务，再准备实际支持 socks5 的可用代理信息。教程推荐 Ubuntu 24.04 LTS（64位）；当前脚本支持原版 Ubuntu 22.04、24.04、26.04 LTS，以及 Debian 12、13，要求 apt-get、dpkg 等工具和运行中的 systemd。不能把所有 Linux 或没有 systemd 的容器都当作支持环境。
架构也要核对。当前源码识别 x86_64/amd64、aarch64/arm64，以及 armv7l/armv7，分别选取对应的 Xray 架构包。它们是脚本的架构映射，不表示任意 ARM 设备都能安装；发行版、服务管理和权限条件仍须同时满足。安装和管理命令要求 root 权限，非 root 用户使用本人获授权的 sudo 权限。
可按教程在 FinalShell 新建 SSH 连接，也可用自己的 SSH 工具。填写的是 VPS 商家提供的主机和 SSH 端口，不是代理出口端口。首次连接先确认目标和主机密钥，再进入服务器命令行。已有业务的 VPS 应先保留必要备份并安排维护时间；不要仅为安装教程盲目重装系统。
步骤二：在自己的 VPS 运行安装命令
打开文末 PuppyIP 使用教程，选择“VPS配置教程 → VPS 链式代理配置”，确认最新命令。当前一键命令是：bash <(curl -fsSL https://raw.githubusercontent.com/feng9254/xray-chain-installer/main/install.sh)。在本人获授权的 VPS 的 Bash 终端中运行，不是在代理账号密码框或普通浏览器地址栏输入。
这条命令会读取公开 main 分支并执行安装，要求你信任当时的脚本内容。严格复现的环境应先审阅明确提交的版本；公开可见不等于命令没有系统改动。脚本会检查平台、安装依赖并部署自己的 Xray 服务，也可能按内核和权限启用 BBR；BBR 不支持时的提示不等于线路已经不可用。
安装结束要记录终端给出的 VPS 入口与 TCP 端口。当前默认从62001–65534选取空闲端口，不要擅自假定入口固定为443或把 SSH 端口填进客户端。脚本不会替你修改云安全组或主机防火墙；由有权限的维护人员按最终端口处理，避免与现有网站或面板服务冲突。
步骤三：分清本机直连和批量代理出口
出现新增出口提示后，直接回车会创建使用 VPS 本机公网 IPv4 的直连节点；粘贴代理信息则创建该代理对应的节点。需要住宅出口时应粘贴实际交付信息，不能因为空回车也生成了链接，就认为已经接入住宅代理。更换已有出口时的空回车则表示保留原出口，不能混用两个提示的含义。
PuppyIP 用户可在“我的静态 IP”中确认资源可用，再复制分段格式。认证格式是 IP:端口:用户名:密码；当前脚本也支持无认证的 IP:端口。批量用空格或换行分隔，一次性粘贴整段，每批最多50条。这是单次批量上限，不是总节点数、速度或同时连接量承诺。
只有一组完全虚构的格式示例：203.0.113.10:1080:demo_user:demo_pass。地址为文档示例保留地址，账号密码也是假值，不能连接。当前脚本接受 IPv4 或域名作为代理主机，不接受 IPv6 字面量；用户名和密码不能包含空格或换行，密码中的冒号可保留。不要把完整 URI 的编码结果当成分段格式里的原始密码。
输入不回显字符属于隐藏输入机制，不等于没有粘贴成功。脚本会解析整批并逐条尝试出口验证，再生成候选配置；但当前源码在检测失败时还可能询问“仍要写入配置吗？”。检测失败应选择不同意并先排查，不能把强行写入视为验证成功。格式检查、服务部署和真实连通是不同结果。
步骤四：导入对应节点的链接或二维码
安装或新增完成后，终端会显示各节点的完整 vless:// 链接及二维码。将所选节点导入支持对应能力的客户端；README 的目标客户端包括使用近期 Xray-core 的 v2rayN，以及支持 VLESS 与 REALITY 的近期 Shadowrocket。不能据此承诺所有客户端或历史版本都兼容。
当前链接采用 VLESS、REALITY、Vision 和 TCP/RAW。多节点可以共用一个 VPS 入站端口，各自有独立身份和出口；客户端应选择自己要使用的节点。REALITY 不要求你另行申请传统公网 TLS 证书，但系统时间、SNI、公钥、Short ID 等仍须与链接一致。
链接和二维码包含连接凭据，只导入自己的获授权客户端，不公开转发。导入后还要在实际使用程序中确认请求确实采用该节点；成功导入只表示客户端接受了配置，不等于云安全组已放行、代理可用或目标网站允许访问。
步骤五：用实时检查区分记录和当前出口
安装后在 VPS 输入 puppyip 打开管理菜单，非 root 用户使用 sudo puppyip。菜单2用于查看线路、已保存出口、链接和二维码；已保存的 IP 是创建或修改时的记录，不是当前检测结果。需要确认当前状态，选择菜单7或运行 puppyip status。
状态检查先核对自己的服务、入口 TCP 端口和 Xray 配置，再检查已启用线路的当时 IPv4 出口。暂停线路显示未检测；取得出口而与保存值不同，会提示“与记录不一致”，不会自动替换节点。服务未运行、入口未监听、检测站不可达等应分别记录，不能把所有异常都归为代理密码错误。
这里的正常有范围：它是服务器侧的服务、配置和 TCP/IPv4 出口观察，不保证客户端到 VPS 的整个路径、所有目标网站或 UDP 正常。代理节点的普通 UDP 是否能转发还取决于实际代理服务等条件；检测通过也不代表目标账号或平台资格得到保证。完成后应在自己的实际客户端与允许测试的目标做必要验收。
日常管理：换出口、暂停和重置链接分别做什么
菜单1或 puppyip add 用于新增线路；菜单3或 puppyip edit 后选择节点，用于更换最终出口。按当前实现，更换出口保留 VPS 入口端口及节点的客户端身份，原链接无需重新导入。若同时修改备注，新显示名称可变化；不要把备注变化当成身份重置。多线路必须核对编号，不能凭列表位置猜节点。
菜单4暂停或启用线路，保留原身份、出口设置和链接；重新启用后可继续使用原链接。暂停不等于删除配置或清除旧密码。菜单6重置该节点的身份凭据，旧链接会失效，需要继续使用的设备都要导入新链接；代理出口设置不会因此自动更换。
菜单5删除指定线路，不能通过普通启用操作找回；当前不允许删除最后一条线路。临时不用优先考虑暂停，确认不再需要整个服务才考虑菜单10卸载。删除、重置和卸载有各自确认提示，按当次提示核对 y、n 与回车默认值，不把空回车统一当作同意。
更新与重连：管理菜单不是重新安装按钮
只想查看和管理已有线路，输入 puppyip。再次执行远程一键命令时，已安装环境可能先处理管理脚本更新，再进入新增出口步骤，不能把它当成只读查看命令。当前版本与旧版更新条件以仓库说明和终端提示为准，不需要为一般管理先卸载重装。
菜单9或 puppyip update 更新的是 Xray-core，与管理脚本版本不是同一件事。仓库另说明管理脚本的原地更新和 puppyip upgrade；更新前应核对既有状态与备份，不承诺任何不完整安装都能自动修复。
节点变更、暂停启用及更新会应用配置，并可能重启 PuppyIP 自己的 Xray 服务，已有连接可能短暂重连。其他节点身份保持不变不等于已有连接完全不受影响。安排可接受的维护时段；主菜单0退出只返回命令行，不会暂停线路或停止服务。
连接失败时先按路径定位
先区分 SSH 登录失败、系统不受支持、批量格式错误、VPS 到代理的验证失败、服务启动失败，以及客户端或目标网站失败。前几项发生在不同阶段，不能靠反复生成新链接解决。检测失败后保留脱敏错误与时间，确认问题后每次只改变一个条件。
客户端到 VPS 这一段先核对导入节点、入口端口和实际网络；VPS 到代理这一段核对主机、端口、认证、白名单及服务支持；最后再看目标地址的响应和权限。菜单7的服务器侧检测不能替代第一段和最后一段。通用 DNS、TCP、认证、TLS 和目标响应的详细分流见文末排错文章，本文不重复整套清单。
临时检测失败也可能来自检测站或网络，不足以证明出口永久失效。更换出口与重置身份要有明确目的，不用批量轮换来规避目标服务的规则，也不能因脚本写入成功就记录为实际业务验收成功。
凭据保管与后续使用记录
隐藏输入不代表凭据没有保存。代理密码会进入 VPS 本机受限权限的 Xray 配置及部署备份；VLESS 链接、二维码和备份同样需要保护。不要公开上传配置、日志、终端录屏或含凭据的诊断包；分享错误时只保留时间、版本、节点编号和已脱敏的现象。
记录脚本与客户端版本、出口类型、入口端口、当时检测结果和后续改动，有助于判断换出口、暂停、重置或升级的影响。脚本下载、命令复制、安装完成与真实连接验收分别记录。这里没有实际成功率、速度、排名或搜索量数据，也不将链式配置解释为匿名、零日志或访问任何网站的保证。
资料来源
常见问题
空回车生成的节点就是住宅代理吗？
不是。新增出口提示处空回车创建 VPS 本机直连节点，最终出口是 VPS 本机公网 IP；使用住宅代理应填写获授权的实际交付信息。更换已有出口提示处空回车则保留原出口，须按当前提示区分。
一次能添加多少条，能直接粘完整代理 URL 吗？
当前每批最多50条，使用分段格式并一次性粘贴，以空格或换行分隔。它不是完整 URI 输入框；支持 IPv4 或域名主机，不接受 IPv6 字面量，认证字段不能含空格或换行。上限不等于总节点容量或性能保证。
密码不显示是不是输入失败？
通常是隐藏输入机制。按提示粘贴整段后回车，再看解析与检测结果。隐藏显示不等于不存储，配置和备份仍可能含密码，不应公开截图或上传。
更换出口后要重新导入客户端链接吗？
按当前脚本，更换出口保留入口端口与节点身份，原链接无需重新导入；修改备注可能改变显示名称。重置节点身份则不同，旧链接失效，所有继续使用的设备需要导入新链接。
菜单显示正常就表示手机和所有网站都能用吗？
不能。菜单7检查服务器服务、入口、配置和当时 TCP/IPv4 出口；菜单2显示的只是已保存记录。还需在实际客户端验收；UDP、目标网站、账号权限和本地网络属于其他条件。
检测失败但可以确认写入，应继续吗？
不要把确认写入当成验证成功。当前源码可能在出口检测失败后询问是否仍写入；正常配置应选择不同意，先核对凭据、授权、网络与检测站等条件，解决后再继续。
暂停、删除和卸载能互相替代吗？
不能。暂停保留原节点与链接，可重新启用；删除移除选中节点，不能靠启用恢复；卸载删除服务和当前配置，历史备份另行确认。配置应用可能造成已有连接短暂重连，操作前先核对节点和维护影响。