XHTTP-Installer 部署指南:利用 Vercel/Netlify 构建隐藏 IP 的 VLESS + XHTTP 代理

想要部署一个既能隐藏真实 IP,又无需复杂配置的 VLESS 代理?XHTTP-Installer 就是为此而生的。它通过 Vercel 或 Netlify 的 CDN Edge Function 作为中继层,将你的真实服务器 IP 隐藏在知名 CDN 之后,有效提升稳定性并防止 IP 暴露。

⚡ 核心特性

  • 无需复杂域名:仅需一个简单的 A 记录子域名。
  • 零 CLI 负担:自动安装并配置 Vercel/Netlify CLI。
  • 智能自修复:自动检测并解决 SSL、防火墙、Token 和环境变量问题。
  • 端到端验证:内置 xray-knife,在交付配置前确保链路真实畅通。
  • 隐藏服务器 IP:对外仅暴露 CDN 边缘节点。
  • 自动化 SSL:通过 acme.sh 自动申请 Let’s Encrypt 证书。

🔄 工作原理

流量路径客户端 (v2rayN/Hiddify等) -> CDN 边缘节点 (Vercel/Netlify) -> Xray 服务器 (Port 443) -> 互联网

在这种架构下,CDN 是唯一的公开层,你的 Xray 服务器处于隐藏状态。


📋 部署前准备

1. 服务器要求

  • 操作系统:Ubuntu 20.04+ (推荐 22.04)。
  • 权限:Root 或 sudo 权限。
  • 端口:80 (用于 SSL 申请) 和 443 (用于代理) 必须可用。
  • 资源:至少 1 vCPU + 1 GB RAM。
  • 注意:如果 80/443 端口被 Nginx 或 Apache 占用,请先停止相关服务。

2. 域名配置

准备一个子域名,并设置 A 记录 指向你的服务器 IP: ns.example.com -> 你的服务器 IP

3. CDN Token (二选一)


🚀 快速部署步骤

第一步:一键安装

SSH 连接到服务器,运行以下命令:

bash <(curl -fsSL https://raw.githubusercontent.com/avacocloud/XHTTP-Installer/main/install.sh)

提示:脚本会询问是否在 screen 中运行。如果你的网络不稳定,建议选 Y。如果断线,可用 screen -r xhttp 回到安装界面。

第二步:选择平台

在交互界面中选择你准备使用的中继平台: - 1) Vercel - 2) Netlify

第三步:填写配置信息

按照提示输入相关信息(直接回车可使用默认值): - Domain: 你的子域名 (如 ns.example.com)。 - Email: 用于 SSL 证书申请的邮箱。 - Inbound port: Xray 监听端口 (默认 443)。 - RELAY_PATH: 服务器端的入站路径 (默认 /api)。 - PUBLIC_RELAY_PATH: CDN 端的路径 (默认 /api)。 - Token: 粘贴你申请的 Vercel 或 Netlify Token。 - Project name: CDN 站点名称 (默认随机生成)。

第四步:获取配置

安装完成后,脚本会显示安装结果并直接给出 vless:// 链接。 复制该链接到你的客户端即可使用。


📱 客户端推荐

平台 推荐 App 导入方式
Windows v2rayN 服务器 -> 从剪贴板导入批量 URL
Android v2rayNG + -> 从剪贴板导入配置
iOS Streisand 自动检测剪贴板
Linux Nekoray 程序 -> 从剪贴板添加配置文件
全平台 Hiddify 添加 -> 从剪贴板添加

🛠️ 常见问题排查

  • Xray 权限报错 (permission denied on privkey.pem): 脚本通常会自动修复。如果需要手动修复,请执行:

    chmod 640 /etc/ssl/xhttp/你的域名/privkey.pem
    chgrp nobody /etc/ssl/xhttp/你的域名/privkey.pem
  • Netlify 返回 HTTP 500: 通常是 TARGET_DOMAIN 环境变量未正确设置。建议重新运行安装脚本。

  • 访问 Relay URL 返回 HTTP 404: 这是正常现象。因为 404 表示它不是一个普通网页,只有 VLESS 客户端发送正确的握手请求时才能建立连接。


🛡️ 道德与许可

本项目仅用于绕过不公正的限制和保护隐私。请勿用于恶意活动或攻击他人。 本项目采用 GNU GPL-3.0 许可。

本文由 BOSH 的博客助手 HerMes 整理 🐧
原文链接:https://github.com/avacocloud/XHTTP-Installer/blob/main/README_EN.md