Xray 搭建个人 VPS
换服务器涉及的备份和恢复顺序记在云服务器迁移中,本文保留具体的安装与排障步骤;照片、文档的后续架构见存储与访问优化方案。
有了一台硅谷的 Ubuntu 服务器后,我想试着搭一条自己能用的代理连接。最初让我困惑的,不只是命令怎么敲,还有 UFW、VLESS、REALITY 和 SNI 各自负责什么。后来遇到客户端能启动、网页却打不开的问题,我才开始把“端口能连上”和“代理真的可用”分开检查。这篇笔记把操作过程和这些理解放在一起。
先画清楚:这条连接经过了谁
我这次采用的是 VLESS + REALITY + Vision,服务器运行 Xray-core。电脑和 Android 手机作为客户端,可以使用支持这套配置的 Clash 系应用,也可以用 v2rayN/v2rayNG。我把两台设备分配成不同的 UUID,日后只需撤销某一台设备的凭据。先把数据经过的几个环节画出来,配置字段就不那么零散了:
这几个组件的分工是:Clash 客户端负责本地流量接管、DNS 和规则分流,Xray 服务端负责认证、处理连接并转发请求。客户端和服务端不必是同一个程序,关键在于使用的内核支持相同配置;这里使用支持 VLESS/REALITY 的 Mihomo 内核。
| 项目 | 本次方案 | 说明 |
|---|---|---|
| 服务器 | 硅谷 · Ubuntu 24.04 · x86_64 | 2026-10-18 SSH 只读核验;部署前按下节复查 |
| 资源 | 2 核 / 1 GiB / 30 GiB | 规格来自控制台截图;SSH 可见内存约 894 MiB |
| 公网入口 | 47.77.230.47 / TCP 443 | 首次部署前确认空闲;2026-10-19 已验证 Xray 监听并可用 |
| 带宽 | 峰值 200 Mbps | 理论约 25 MB/s;实际受线路、开销、共享与时段影响 |
| 域名与证书 | 无需购买自己的域名或签发证书 | 需选定并验证一个 REALITY 目标站及其 SNI |
| 客户端文件 | windows.yaml / android.yaml;两份 VLESS 链接 | 分别用于 Clash 与 v2rayN/v2rayNG |
依据:Xray 项目 · REALITY · Mihomo VLESS
动手前,我先分清两层防火墙
2.1 在本机 PowerShell 登录
ssh root@47.77.230.47先说明命令的执行位置:下面的 Linux 命令是在 SSH 登录后的 Ubuntu 终端里运行;本地电脑的命令会单独标注。普通用户登录后,需要管理权限时先 sudo -i。修改网络设置时,保留一个已连上的 SSH 窗口,再用另一个窗口测试,避免改完才发现无法登录。
2.2 在服务器复查
cat /etc/os-release
uname -m
free -h
df -h /
ss -lntp 'sport = :443'
systemctl status xray --no-pager || true
timedatectl status
ufw status verbose这些检查用来确认系统、架构、资源、时间以及 443 的占用情况。首次部署使用的是 Ubuntu 24.04、x86_64;首次部署前需要确认 443 没被其他程序使用。现在已经部署完成,看到 Xray 监听反而是正常结果。首次配置脚本会拒绝覆盖已有有效配置;时间未同步时,可执行 timedatectl set-ntp true 后复查。
2.3 云控制台:先看现有入站规则
我当时在阿里云控制台已经看到了 TCP 22、80、443 和 ICMP 规则,并不需要再把同样的规则加一遍。这些入站允许规则决定哪些连接可以进入服务器,不是看到“443 已启用”就代表会拦截 443。对这套代理来说,我重点确认下面两个入口:
| 协议 / 端口 | 来源 | 用途 |
|---|---|---|
| TCP 443 | 0.0.0.0/0 | 电脑与手机连接;移动网络出口会变化 |
| TCP 22 | 保留现有可用规则 | SSH 维护;先确保不会锁住自己 |
入站检查之外,我也把出站依赖记下来:服务器需要 DNS、访问目标站,以及从 GitHub 下载文件;这套配置会使用 DNS 的 UDP/TCP 53。Xray 主方案不要求额外开放 UDP 443、80 或管理面板端口。云平台可能把公网 IP 映射到私网网卡,因此服务监听的是 0.0.0.0。
2.4 UFW 的 inactive,让我弄清了什么
# 仅在 UFW 已经启用时添加;不在本次部署中直接启用 UFW。
ufw allow 443/tcp comment 'Xray REALITY'
ufw status verbose我执行 ufw status verbose 时看到的是 inactive。这表示 UFW 没启用,并不表示阿里云控制台的防火墙也没启用;它们是两层不同的检查。未启用 UFW 时,ufw allow 只会保存规则,不会启用过滤,当时还没有启用 UFW。这是首次部署时的状态,后续加固或迁移后需要重新查看规则。如果机器另有 nftables/iptables 规则,还要另行检查。套餐里的峰值 200 Mbps 描述的是带宽,不能据此判断流量额度:流量额度、超额计费和续费需要单独确认;当时试用实例截图中的到期时间是 2026-11-16。
安装 Xray,也看看命令做了什么
安装这一步,我保留“先下载、看一下脚本,再执行”的顺序。后续复现时安装正式发布版,并记下实际版本,不把某个版本长期写成“最新版”。下面的命令里,install -d -m 700 用来创建目录并把权限设为仅所有者可访问;less 只是查看脚本内容,还没有执行安装。
apt-get update
apt-get install -y ca-certificates curl unzip python3 openssl
install -d -m 700 /root/xray-setup
curl -fL --retry 3 \
https://raw.githubusercontent.com/XTLS/Xray-install/main/install-release.sh \
-o /root/xray-setup/install-release.sh
less /root/xray-setup/install-release.sh我用 less 浏览文件,按 q 退出,再确认下载来源是官方仓库。安装后可以用下面的命令查看版本和 systemd 服务信息,排错时会用到:
bash /root/xray-setup/install-release.sh install --without-geodata
systemctl stop xray
/usr/local/bin/xray version
systemctl cat xray
systemctl show xray -p User -p Group -p AmbientCapabilities
/usr/local/bin/xray version > /root/xray-setup/installed-version.txt这里的 --without-geodata 省去服务端不需要的地域数据库:我的方案在客户端做中国规则分流,服务端使用明确的 IP 网段规则。安装器可能自动启动服务,所以这份流程先停下服务,等配置完成再启动。安装输出如果提示可以 apt purge curl unzip,只是提醒可移除依赖;我后面还要用这些工具,不会看到提示就立即卸载。
xray 用户,旧版可能使用 nobody。不要照旧教程追加 -u root。后面的配置脚本会读取实际 systemd 用户与组,设置配置读取权限;443 绑定依靠服务的 CAP_NET_BIND_SERVICE。| 路径 | 用途 |
|---|---|
/usr/local/bin/xray | 内核可执行文件 |
/usr/local/etc/xray/config.json | 包含服务端私钥的配置 |
/etc/systemd/system/xray.service | 服务单元,连同 drop-in 一起检查 |
/root/xray-private/ | 后续脚本生成的客户端文件与部署记录 |
端口明明通了,为什么还是连不上
我先把容易混在一起的字段拆开:客户端的“服务器地址”是自己的 47.77.230.47;SNI 是握手里使用的域名,另填一个字段。在这套 REALITY 配置里,服务端的 target、serverNames 与客户端的 servername / sni 需要对应。它不是把服务器地址改成另一个网站,也不要求我拥有这个域名。选目标站时,我按下面的条件逐项检查:
- 选择从这台服务器可达、证书有效、支持 TLS 1.3 的 HTTPS 站点,并优先选择支持 HTTP/2、网络位置接近的站点。
- 用下面命令检查基础 TLS,再以真实 REALITY 客户端验证。普通 TLS 检查成功,仍可能遇到内核对目标站的兼容限制。
- 同时检查目标域名的解析与托管情况。官方建议优先同 ASN 的目标;避免随意使用公共 CDN 站点。未认证的连接会转发到目标站,需要考虑其带宽开销与滥用风险。
www.microsoft.com 在这台服务器返回 Certificate: 8273,超过 Xray 26.3.27 所用 REALITY 的 8192 字节缓冲上限。结果是 443 可达、凭据正确、OpenSSL 成功,但客户端仍然 EOF。这让我意识到基础 TLS 测试还不够。改为 dl.google.com 并同步 SNI 后实测成功。此目标适用于本次已验证环境,不能保证永远可用。参见 官方 Issue #6356 与 该版本源码。# 本次环境已用 REALITY 实测通过;部署时仍应复查。
SNI='dl.google.com'
/usr/local/bin/xray tls ping "$SNI"
openssl s_client -connect "${SNI}:443" -servername "$SNI" \
-tls1_3 -alpn h2 -verify_return_error </dev/null
curl -I --max-time 15 "https://${SNI}/"我查看的是 TLS 版本、证书验证和 ALPN 输出,期待看到 TLS 1.3、验证成功和 h2。HTTP 的 200、重定向或站点自身的 403,要结合请求目的判断,不能单凭它们决定代理是否可用。TLS 测试失败时先换候选站检查;基础检查成功后,还需要真实 REALITY 客户端的验证。后面使用的 SNI 也要以实际验证结果为准。
把服务端和客户端的参数对应起来
为了减少重复填写参数,我在这篇笔记里保留了 configure_xray.py,可以直接下载,也能展开阅读源码。它只用于首次配置:在服务器本地生成密钥和两枚 UUID,验证配置、设置权限,再导出客户端文件。防火墙和服务启动不在脚本中处理,需要分别检查。
5.1 从 Windows 上传脚本
下面是 Windows PowerShell 的上传示例:
scp "D:\Desktop\Agent-Workspace\Xray部署指南\configure_xray.py" root@47.77.230.47:/root/xray-setup/configure_xray.py示例路径对应当时的目录;如果是从本页下载到“下载”文件夹,上传时要改成本机真实路径。换电脑后,需要根据文件的实际位置调整路径。
5.2 在 Ubuntu 生成配置
# 将域名改成第 4 节实际验证通过的 SNI。
python3 /root/xray-setup/configure_xray.py --sni 'dl.google.com'
ls -l /usr/local/etc/xray/config.json
ls -l /root/xray-private/
cat /root/xray-private/installed-version.txt脚本成功时会输出 Configuration validated。它遇到已有有效配置或已有 /root/xray-private 会拒绝继续,这是为了避免重复运行意外更换凭据。遇到这类提示,先检查已有配置;删除目录后重跑可能改变正在使用的凭据。
| 生成文件 | 用途 |
|---|---|
windows.yaml / android.yaml | Clash 系客户端导入,分别使用两枚 UUID |
windows.vless.txt / android.vless.txt | v2rayN/v2rayNG 导入链接 |
client-info.json | 人工核对参数,或导入本页离线配置工具 |
config-before-first-deploy.json | 安装后初始配置备份(存在时保存) |
文件权限分别是:服务端配置由 root 所有,实际服务组可读(0640);导出目录是 0700,文件是 0600。服务端私钥留在服务端。客户端文件虽然没有私钥,仍带有认证信息,因此只能放在自己的设备里,不能作为公开文章附件。
展开:服务端 JSON 结构与字段说明
为了看清各字段的位置,下面保留一个结构示例。REPLACE_* 都是占位符,不是能直接运行的配置;实际参数由脚本生成。此处服务端使用的传输名称是 raw,对应客户端的 tcp。
{
"log": {
"loglevel": "warning"
},
"dns": {
"servers": [
"1.1.1.1",
"8.8.8.8"
],
"queryStrategy": "UseIPv4"
},
"inbounds": [
{
"tag": "reality-in",
"listen": "0.0.0.0",
"port": 443,
"protocol": "vless",
"settings": {
"clients": [
{
"id": "REPLACE_WINDOWS_UUID",
"email": "windows",
"flow": "xtls-rprx-vision"
},
{
"id": "REPLACE_ANDROID_UUID",
"email": "android",
"flow": "xtls-rprx-vision"
}
],
"decryption": "none"
},
"streamSettings": {
"network": "raw",
"security": "reality",
"realitySettings": {
"show": false,
"target": "REPLACE_VERIFIED_SNI:443",
"xver": 0,
"serverNames": [
"REPLACE_VERIFIED_SNI"
],
"privateKey": "REPLACE_SERVER_PRIVATE_KEY",
"shortIds": [
"REPLACE_SHORT_ID"
]
}
}
}
],
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {
"domainStrategy": "UseIPv4"
}
},
{
"tag": "block",
"protocol": "blackhole",
"settings": {}
}
],
"routing": {
"domainStrategy": "IPOnDemand",
"rules": [
{
"type": "field",
"ip": [
"0.0.0.0/8",
"10.0.0.0/8",
"100.64.0.0/10",
"127.0.0.0/8",
"169.254.0.0/16",
"172.16.0.0/12",
"192.168.0.0/16",
"224.0.0.0/4",
"240.0.0.0/4",
"::/128",
"::1/128",
"fc00::/7",
"fe80::/10",
"ff00::/8"
],
"outboundTag": "block"
}
]
}
}读配置时,我重点看了两处:clients 分别给两台设备认证;decryption: none 不等于链路明文,这里由 REALITY 保护传输。routing 则限制认证连接访问服务端内网、环回和链路本地等网段,包括云元数据常用地址。这是应用转发规则,不是修改系统防火墙。
展开:配置脚本完整源码(可复制保存为 UTF-8)
#!/usr/bin/env python3
"""First-deployment configuration helper. Run on the Ubuntu server as root.
Does not install software, open firewall ports, or start/restart services.
"""
import argparse
import datetime
import ipaddress
import json
import os
from pathlib import Path
import re
import shutil
import subprocess
import tempfile
import uuid
import secrets
from urllib.parse import urlencode, quote
XRAY = "/usr/local/bin/xray"
CONFIG = Path("/usr/local/etc/xray/config.json")
EXPORT = Path("/root/xray-private")
BLOCKED = ["0.0.0.0/8", "10.0.0.0/8", "100.64.0.0/10", "127.0.0.0/8",
"169.254.0.0/16", "172.16.0.0/12", "192.168.0.0/16",
"224.0.0.0/4", "240.0.0.0/4", "::/128", "::1/128",
"fc00::/7", "fe80::/10", "ff00::/8"]
def command(*args):
return subprocess.check_output(args, text=True).strip()
def make_server(sni, private, ids, sid, port):
return {
"log": {"loglevel": "warning"},
"dns": {"servers": ["1.1.1.1", "8.8.8.8"], "queryStrategy": "UseIPv4"},
"inbounds": [{"tag": "reality-in", "listen": "0.0.0.0", "port": port,
"protocol": "vless", "settings": {"clients": [
{"id": ids[0], "email": "windows", "flow": "xtls-rprx-vision"},
{"id": ids[1], "email": "android", "flow": "xtls-rprx-vision"}],
"decryption": "none"},
"streamSettings": {"network": "raw", "security": "reality",
"realitySettings": {"show": False, "target": sni + ":443",
"xver": 0, "serverNames": [sni], "privateKey": private,
"shortIds": [sid]}}}],
"outbounds": [{"tag": "direct", "protocol": "freedom",
"settings": {"domainStrategy": "UseIPv4"}},
{"tag": "block", "protocol": "blackhole", "settings": {}}],
"routing": {"domainStrategy": "IPOnDemand", "rules": [
{"type": "field", "ip": BLOCKED, "outboundTag": "block"}]}
}
def make_uri(host, port, uid, sni, public, sid, label):
query = urlencode({"encryption": "none", "security": "reality", "sni": sni,
"fp": "chrome", "pbk": public, "sid": sid, "type": "tcp",
"flow": "xtls-rprx-vision", "spx": "/"})
return f"vless://{uid}@{host}:{port}?{query}#{quote(label)}"
def yaml_config(host, port, uid, sni, public, sid):
# JSON-quoted scalars are valid YAML. Rule providers are fetched via PROXY.
q = json.dumps
return f'''# Personal Mihomo profile; contains connection credentials.
mixed-port: 7890
allow-lan: false
bind-address: 127.0.0.1
mode: rule
log-level: info
ipv6: false
profile:
store-selected: true
dns:
enable: true
listen: 127.0.0.1:1053
ipv6: false
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"
- "*.local"
- "localhost"
default-nameserver:
- 223.5.5.5
- 119.29.29.29
proxy-server-nameserver:
- https://dns.alidns.com/dns-query
nameserver:
- "https://1.1.1.1/dns-query#PROXY"
nameserver-policy:
"rule-set:cn-domain":
- "https://dns.alidns.com/dns-query#DIRECT"
direct-nameserver:
- "https://dns.alidns.com/dns-query#DIRECT"
proxies:
- name: SiliconValley
type: vless
server: {q(host)}
port: {port}
uuid: {q(uid)}
network: tcp
tls: true
udp: true
packet-encoding: xudp
flow: xtls-rprx-vision
servername: {q(sni)}
client-fingerprint: chrome
reality-opts:
public-key: {q(public)}
short-id: {q(sid)}
proxy-groups:
- name: PROXY
type: select
proxies:
- SiliconValley
rule-providers:
cn-domain:
type: http
behavior: domain
format: mrs
url: https://raw.githubusercontent.com/MetaCubeX/meta-rules-dat/meta/geo/geosite/cn.mrs
path: ./ruleset/cn-domain.mrs
interval: 86400
proxy: PROXY
cn-ip:
type: http
behavior: ipcidr
format: mrs
url: https://raw.githubusercontent.com/MetaCubeX/meta-rules-dat/meta/geo/geoip/cn.mrs
path: ./ruleset/cn-ip.mrs
interval: 86400
proxy: PROXY
rules:
- IP-CIDR,{host}/32,DIRECT,no-resolve
- DOMAIN-SUFFIX,lan,DIRECT
- DOMAIN-SUFFIX,local,DIRECT
- DOMAIN,localhost,DIRECT
- IP-CIDR,127.0.0.0/8,DIRECT,no-resolve
- IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
- IP-CIDR,172.16.0.0/12,DIRECT,no-resolve
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- IP-CIDR,169.254.0.0/16,DIRECT,no-resolve
- IP-CIDR,100.64.0.0/10,DIRECT,no-resolve
- IP-CIDR6,::1/128,DIRECT,no-resolve
- IP-CIDR6,fc00::/7,DIRECT,no-resolve
- IP-CIDR6,fe80::/10,DIRECT,no-resolve
- RULE-SET,cn-domain,DIRECT
- RULE-SET,cn-ip,DIRECT
- AND,((NETWORK,UDP),(DST-PORT,443)),REJECT
- MATCH,PROXY
'''
def parse_keys(output):
found = {}
for line in output.splitlines():
if ":" not in line:
continue
label, value = line.split(":", 1)
label = re.sub(r"[^a-z]", "", label.lower())
if label == "privatekey":
found["private"] = value.strip()
elif label in ("password", "publickey", "passwordpublickey"):
found["public"] = value.strip()
if not all(re.fullmatch(r"[A-Za-z0-9_-]{43}", found.get(k, ""))
for k in ("private", "public")):
raise RuntimeError("Unrecognized x25519 output. Check installed version; no files written.")
return found["private"], found["public"]
def main():
import grp
import pwd
ap = argparse.ArgumentParser(description=__doc__)
ap.add_argument("--sni", required=True, help="Previously tested REALITY target hostname")
ap.add_argument("--host", default="47.77.230.47", help="Public IPv4 address")
ap.add_argument("--port", type=int, default=443)
args = ap.parse_args()
args.sni = args.sni.lower().rstrip(".")
if not re.fullmatch(r"(?=.{1,253}$)(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,63}", args.sni):
ap.error("--sni must be a hostname without https://, port, or path")
if not isinstance(ipaddress.ip_address(args.host), ipaddress.IPv4Address):
ap.error("This guide requires a public IPv4 address")
if not ipaddress.ip_address(args.host).is_global or not 1 <= args.port <= 65535:
ap.error("Invalid public address or port")
if os.geteuid() != 0:
ap.error("Run on the Ubuntu server as root")
os.umask(0o077)
if EXPORT.exists():
raise RuntimeError("/root/xray-private already exists. First-deployment helper will not rotate credentials.")
if CONFIG.exists() and CONFIG.read_text().strip() not in ("", "{}"):
raise RuntimeError("An existing configuration was found; back it up and review manually.")
service_user = command("systemctl", "show", "xray", "-p", "User", "--value")
if not service_user or service_user == "root":
raise RuntimeError("Expected an installed, non-root xray systemd service. Inspect systemctl cat xray.")
account = pwd.getpwnam(service_user)
service_group = command("systemctl", "show", "xray", "-p", "Group", "--value")
gid = grp.getgrnam(service_group).gr_gid if service_group else account.pw_gid
version = command(XRAY, "version")
private, public = parse_keys(command(XRAY, "x25519"))
ids = [str(uuid.uuid4()), str(uuid.uuid4())]
sid = secrets.token_hex(8)
server = make_server(args.sni, private, ids, sid, args.port)
CONFIG.parent.mkdir(parents=True, exist_ok=True)
# Validate before installing the configuration or changing its ownership.
with tempfile.TemporaryDirectory(prefix="xray-draft-") as tmp:
draft = Path(tmp) / "config.json"
draft.write_text(json.dumps(server, indent=2) + "\n")
subprocess.run([XRAY, "run", "-test", "-config", str(draft)], check=True)
EXPORT.mkdir(mode=0o700)
if CONFIG.exists():
shutil.copy2(CONFIG, EXPORT / "config-before-first-deploy.json")
shutil.copyfile(draft, CONFIG)
os.chown(CONFIG.parent, 0, gid)
os.chmod(CONFIG.parent, 0o750)
os.chown(CONFIG, 0, gid)
os.chmod(CONFIG, 0o640)
manifest = {"server": args.host, "port": args.port, "sni": args.sni,
"reality_password_public_key": public, "short_id": sid,
"windows_uuid": ids[0], "android_uuid": ids[1],
"flow": "xtls-rprx-vision", "fingerprint": "chrome"}
(EXPORT / "client-info.json").write_text(json.dumps(manifest, indent=2) + "\n")
(EXPORT / "installed-version.txt").write_text(version + "\n")
for device, uid in zip(("windows", "android"), ids):
(EXPORT / f"{device}.yaml").write_text(yaml_config(args.host, args.port, uid, args.sni, public, sid))
(EXPORT / f"{device}.vless.txt").write_text(make_uri(
args.host, args.port, uid, args.sni, public, sid, "SiliconValley-" + device) + "\n")
for path in EXPORT.iterdir():
os.chmod(path, 0o600)
# root-created staging files are now readable by the actual service account.
subprocess.run(["runuser", "-u", service_user, "--", XRAY, "run", "-test",
"-config", str(CONFIG)], check=True)
print("Configuration validated. Service has NOT been started/restarted.")
print("Client exports: /root/xray-private (root only). Private key stays in server config.")
print("Next: systemctl enable xray && systemctl restart xray")
if __name__ == "__main__":
main()xray x25519 的新输出可能叫 Password (PublicKey),旧输出可能叫 Password / PublicKey;它对应 Clash 的 public-key、VLESS 链接的 pbk。不要使用 Hash32,不要把服务端 PrivateKey 填给客户端。脚本已兼容这些名称。依据:VLESS 入站 · Xray 路由 · 当前 x25519 输出源码
服务启动之后,我还要检查什么
6.1 服务器启动与检查
/usr/local/bin/xray run -test -config /usr/local/etc/xray/config.json
systemctl enable xray
systemctl restart xray
systemctl status xray --no-pager -l
ss -lntp 'sport = :443'
journalctl -u xray -n 60 --no-pager这里需要同时看到 Configuration OK、active (running) 和 0.0.0.0:443。配置通过、进程运行、端口监听是不同的检查点;只看到其中一个成功,还不能跳到客户端测试。
6.2 Windows 测试 TCP 可达
Test-NetConnection 47.77.230.47 -Port 443这里预期看到 TcpTestSucceeded : True,但它只说明 TCP 端口可达,还不能证明 REALITY 认证成功。两者需要分开检查;直接用浏览器打开服务器 IP,也不是代理测试。Windows 的命令不能原样放进 Mac 终端,但“在本机测试公网入口”这个检查位置是一样的。
6.3 取回客户端文件
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\Downloads\xray-client"
scp root@47.77.230.47:/root/xray-private/windows.yaml "$env:USERPROFILE\Downloads\xray-client\"
scp root@47.77.230.47:/root/xray-private/android.yaml "$env:USERPROFILE\Downloads\xray-client\"
scp root@47.77.230.47:/root/xray-private/windows.vless.txt "$env:USERPROFILE\Downloads\xray-client\"
scp root@47.77.230.47:/root/xray-private/android.vless.txt "$env:USERPROFILE\Downloads\xray-client\"
scp root@47.77.230.47:/root/xray-private/client-info.json "$env:USERPROFILE\Downloads\xray-client\"取回文件以后,我只把 Android 对应的客户端文件传到手机,可以用 USB 或可信的文件传输方式。/usr/local/etc/xray/config.json 属于服务端配置,不应该拿来导入手机或作为订阅分享。
把配置导入电脑和手机
我遇到过“配置可以导入、客户端也能启动,但节点超时或网页打不开”的情况,所以把导入和验证分成了两步。下面分别整理 Windows 和 Android 的操作顺序;客户端界面可能变化,重点是内核支持、选中的配置和实际生效的代理模式。
Windows · Clash Verge Rev
- 从项目发布页安装适合系统架构的正式版。
- 在“订阅/配置”中导入本地文件
windows.yaml,选中启用;不同版本可能称“新建本地配置”。 - 确认模式为 Rule/规则,代理组
PROXY选择SiliconValley。 - 先打开“系统代理”,保持 TUN 关闭,验证浏览器与显式代理请求。
- 确需接管更多应用时,按客户端提示安装/启用服务模式,再打开 TUN。核对生成后的有效配置,避免界面覆盖 DNS、端口和规则。
Android · Clash Meta for Android
- 从项目发布页安装支持 Mihomo/Meta 的版本;常见手机使用 arm64-v8a。
- 在“配置/Profiles”中新建,从文件导入
android.yaml,启用该配置。 - 代理组选择
SiliconValley,点击启动并允许 Android 的 VPN 连接请求。 - 最初关闭分应用绕过,先确认测试应用确实被接管。与其他 VPN 同时运行通常会冲突。
- 验证 Wi-Fi、蜂窝网络切换;若后台频繁断开,为客户端调整电池优化/后台运行设置。
规则与 DNS 的实际行为
- 服务器 IP、局域网和私网地址直连;中国域名及 IP 规则命中时直连;其余走
PROXY。 - 中国规则来自 MetaCubeX 的
cn.mrs,首次联网下载,之后每 24 小时更新,下载请求显式走代理。第一次成功导入后检查规则集是否已加载。 - 海外默认 DNS 使用经
PROXY连接的 Cloudflare DoH;中国规则域名使用直连 AliDNS DoH。无需为服务器 IP 解析域名。 - 中国直连规则之后拦截剩余 UDP 443,促使常见浏览器回退 TCP,减少 QUIC 兼容问题;其他 UDP 通过 XUDP。特定游戏、语音应用仍需实际验证。
- YAML 设置
ipv6: false,但这不等于关闭系统 IPv6;仅启用系统代理也无法接管所有应用。需要更完整接管时使用 TUN/Android VPN,并实际检查 IPv6、DNS 与应用绕过情况。
cn-domain / cn-ip 下载错误。可暂时切到 Global/全局并选 SiliconValley 后刷新规则集;如果内核因缺少规则文件而无法启动,可临时删除 YAML 中 rule-providers、nameserver-policy 两段和两条 RULE-SET,先以“私网直连、其余代理”启动,成功后恢复原文件。不要把规则缺失误判为服务端故障。展开:Mihomo YAML 完整模板
这份完整 YAML 用来对照字段,REPLACE_* 需要换成对应设备的真实参数。实际导入可以使用服务器脚本或下面的离线工具生成文件,减少手工复制参数时的错误。
# Personal Mihomo profile; contains connection credentials.
mixed-port: 7890
allow-lan: false
bind-address: 127.0.0.1
mode: rule
log-level: info
ipv6: false
profile:
store-selected: true
dns:
enable: true
listen: 127.0.0.1:1053
ipv6: false
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"
- "*.local"
- "localhost"
default-nameserver:
- 223.5.5.5
- 119.29.29.29
proxy-server-nameserver:
- https://dns.alidns.com/dns-query
nameserver:
- "https://1.1.1.1/dns-query#PROXY"
nameserver-policy:
"rule-set:cn-domain":
- "https://dns.alidns.com/dns-query#DIRECT"
direct-nameserver:
- "https://dns.alidns.com/dns-query#DIRECT"
proxies:
- name: SiliconValley
type: vless
server: "47.77.230.47"
port: 443
uuid: "REPLACE_DEVICE_UUID"
network: tcp
tls: true
udp: true
packet-encoding: xudp
flow: xtls-rprx-vision
servername: "REPLACE_VERIFIED_SNI"
client-fingerprint: chrome
reality-opts:
public-key: "REPLACE_REALITY_PASSWORD"
short-id: "REPLACE_SHORT_ID"
proxy-groups:
- name: PROXY
type: select
proxies:
- SiliconValley
rule-providers:
cn-domain:
type: http
behavior: domain
format: mrs
url: https://raw.githubusercontent.com/MetaCubeX/meta-rules-dat/meta/geo/geosite/cn.mrs
path: ./ruleset/cn-domain.mrs
interval: 86400
proxy: PROXY
cn-ip:
type: http
behavior: ipcidr
format: mrs
url: https://raw.githubusercontent.com/MetaCubeX/meta-rules-dat/meta/geo/geoip/cn.mrs
path: ./ruleset/cn-ip.mrs
interval: 86400
proxy: PROXY
rules:
- IP-CIDR,47.77.230.47/32,DIRECT,no-resolve
- DOMAIN-SUFFIX,lan,DIRECT
- DOMAIN-SUFFIX,local,DIRECT
- DOMAIN,localhost,DIRECT
- IP-CIDR,127.0.0.0/8,DIRECT,no-resolve
- IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
- IP-CIDR,172.16.0.0/12,DIRECT,no-resolve
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- IP-CIDR,169.254.0.0/16,DIRECT,no-resolve
- IP-CIDR,100.64.0.0/10,DIRECT,no-resolve
- IP-CIDR6,::1/128,DIRECT,no-resolve
- IP-CIDR6,fc00::/7,DIRECT,no-resolve
- IP-CIDR6,fe80::/10,DIRECT,no-resolve
- RULE-SET,cn-domain,DIRECT
- RULE-SET,cn-ip,DIRECT
- AND,((NETWORK,UDP),(DST-PORT,443)),REJECT
- MATCH,PROXY可选:Windows TUN 的核心配置参考
Windows 上可以通过 Clash Verge Rev 的 TUN 开关启用,再对照下面的字段检查实际生效配置。Android 的 VPN 接管由客户端管理,这段 Windows 配置不能直接照搬过去。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
strict-route: true
dns-hijack:
- any:53
- tcp://any:53如与现有公司 VPN、虚拟网卡或内网 DNS 冲突,先关闭 TUN 恢复系统代理,再调整路由。浏览器自带安全 DNS 与 Android 私人 DNS 可能走独立加密连接,验收时先临时关闭以减少变量,再根据需要恢复并复测。
我留作参考的另一组客户端
v2rayN/v2rayNG 是另一组可选客户端,这里补充导入方法作为参考。同一台设备只启用一组客户端,避免系统代理或 VPN 冲突。需要注意:VLESS 链接导入的是节点,不会一并带上 Clash YAML 里的 DNS 和分流规则。下面是备用步骤,未覆盖所有客户端版本和网络的实测。
Windows · v2rayN
- 从项目发布页下载适合系统的正式版;使用包含内核的包,或按应用提示下载 Xray 内核。
- 打开
windows.vless.txt,复制整行,以“从剪贴板导入”添加节点。 - 选择节点为活动服务器,核对安全类型 REALITY、flow、SNI 与公钥。
- 先用“全局代理”路由预设配合“设置系统代理”验证,成功后再选择“绕过大陆”等合适预设。
- 确认本地 SOCKS/HTTP 端口,再按第 10 节验证。需要更多应用接管时再启用 TUN。
Android · v2rayNG
- 从项目发布页安装正式版。
- 复制
android.vless.txt整行,在应用“+”菜单从剪贴板导入。 - 选中节点,先使用全局路由测试,点击启动并允许系统 VPN 权限。
- 成功后再设置绕过大陆/局域网规则,核对 DNS、IPv6 和分应用设置。
- 如果通过二维码导入,可用可信的本地工具将链接生成二维码;不要将凭据交给在线二维码网站。
导入后人工核对这 8 项
| 字段 | 应填内容 |
|---|---|
| 地址 / 端口 | 47.77.230.47 / 443 |
| UUID | 该设备对应的 windows_uuid 或 android_uuid |
| 协议 / 加密字段 | VLESS / none |
| 传输 | TCP(与服务端 raw 对应),不启用额外 Mux |
| 安全 / flow | REALITY / xtls-rprx-vision |
| SNI / serverName | 第 4 节选定的域名,完全匹配 |
| Public key / Password / pbk | client-info.json 的 reality_password_public_key |
| Short ID / fingerprint | short_id / chrome |
不同版本的字段名称可能变化,可以用上表对照实际参数。导入后如果缺少 flow 或 REALITY 参数,先检查客户端及内核版本,再确认是否需要手动补填。
留一个方便核对参数的小工具
下面的工具可以重新生成客户端文件,也方便对照参数。可以导入 client-info.json,也可以手填;不需要服务端私钥。处理只在当前页面本地进行,不联网,也不写入浏览器存储,关闭或刷新后需要重新填写。
查看 Windows 配置与链接
下载前需要核对设备对应的 UUID。导出的文件和链接带有认证信息,只留在自己的设备上。
怎样才算真的连接成功
经历过“能启动但打不开网页”之后,我不再只看延迟数字或端口是否开放。下面是我整理的检查表,逐层确认请求到底走到了哪里;表里的手机双网络和重启检查,是完整复查时需要做的项目,不能用单次连通结果代替:
| 层次 | 操作 | 通过标准 |
|---|---|---|
| 服务 | systemctl + ss + journalctl | running,监听 TCP 443,无持续报错 |
| 入口 | Test-NetConnection | TcpTestSucceeded 为 True |
| 认证与转发 | 下面的显式 SOCKS 请求 | 能访问 HTTPS,出口显示服务器公网 IP 或实际云平台出口 |
| 规则 | 访问国内与海外网站,查看连接列表 | 国内显示 DIRECT,海外显示 PROXY/SiliconValley |
| DNS / IPv6 | 检查内核 DNS 日志与有效配置;测试实际出口 | 受接管请求按预期解析与转发,无意外直连路径 |
| 手机 | Wi-Fi、蜂窝网络分别测试 | 两种网络均可访问,切换后可恢复 |
| 恢复 | 客户端重启;维护窗口中可重启服务器 | Xray 开机启动,节点与规则恢复 |
10.1 Windows 的显式代理请求
这份 Clash 模板的 mixed-port 是 7890;如果用 v2rayN,要改成界面显示的实际 SOCKS 端口。Windows 下我保留 curl.exe 写法,避开 PowerShell 别名;socks5h 表示域名也交给代理链处理。
curl.exe --proxy socks5h://127.0.0.1:7890 --max-time 20 https://api.ipify.org
curl.exe --proxy socks5h://127.0.0.1:7890 --max-time 20 -I https://www.google.com
curl.exe --noproxy "*" --max-time 20 https://api.ipify.org第一条预期返回 47.77.230.47;如果云平台出口还有映射,就以服务器实际出口为准。第三条用来对比本机直连出口,但 TUN 开启时,--noproxy 也可能仍被接管,要关闭 TUN 后再比较。显式代理请求成功而浏览器失败时,排查重点就转到浏览器、系统代理和 DNS。
10.2 在服务器查看实际出口
curl -4 --max-time 15 https://api.ipify.org
printf '\n'
systemctl is-enabled xray
systemctl is-active xray我也把 DNS 结果和代理出口分开理解:测试站显示的可能是解析服务提供方,使用 Cloudflare DoH 时看到 Cloudflare 并不奇怪,也不能据此证明所有应用都没有绕过。速度则要结合不同时段和单连接表现比较,控制台的 200 Mbps 峰值并不代表每次访问都能达到。
连接异常时的排查顺序
从客户端超时这个问题出发,可以把排查分成端口、服务、握手、DNS 和应用接管几层。下面包含这次遇到的情况,也补充了常见故障的检查方向。先缩小范围,再改对应配置,比较容易判断哪一步起了作用。
| 现象 | 优先检查 | 下一步 |
|---|---|---|
| 443 连接超时 | 云防火墙、UFW、是否监听、当前网络 | 先在服务器 ss;再本机 Test-NetConnection;最后换手机蜂窝网络对比 |
| connection refused | 服务未启动、监听地址或端口不符 | systemctl status 与 journalctl;确认不是端口冲突 |
| 服务启动即退出 | JSON、密钥、配置权限、版本不兼容 | xray run -test;检查 systemctl cat xray 和服务账户读取权限 |
| TCP 通,节点握手失败 | UUID、Password/PublicKey、SID、SNI、flow、目标站和时间 | 逐项比对;不要使用 Hash32 或 PrivateKey。若版本 26.3.27 + Microsoft 目标且日志为 EOF,检查 Certificate 长度并参考第 4 节 |
| Clash 提示未知 VLESS/REALITY | 旧 Clash 内核或过旧客户端 | 使用支持该配置的 Mihomo/Meta 客户端并更新内核 |
| Clash 配置或规则加载失败 | YAML 缩进、规则下载、内核对 mrs 的支持 | 使用导出文件;查看 cn-domain/cn-ip 错误;按第 7 节临时简化启动 |
| 延迟有数值,网页打不开 | 实际认证、DNS、被测 URL 和分流 | 跑显式 socks5h 请求;延迟数字不代替出口验证 |
| 浏览器成功,其他软件失败 | 应用不遵循系统代理、UDP、分应用绕过 | 确认代理端口;按需启用 TUN/VPN 接管,关闭其他 VPN 后复测 |
| 开启 TUN 后内网或 SSH 断开 | 虚拟网卡、路由、内网 DNS 冲突 | 先关闭 TUN;保留服务器 IP 和私网直连,再逐项调整 |
| 手机后台断开 | 省电策略、VPN 被其他应用替换 | 允许后台运行;检查系统 VPN 状态,换网络验证 |
| 晚上明显变慢 | 跨境拥塞、套餐峰值、CPU与流量额度 | 先比较直连与代理、多个站点和时段;再决定是否测试 Hysteria 2 |
临时调高日志级别
日志线索不足时,可以先备份配置,再把 loglevel 从 warning 临时改成 info,校验后重启。用 journalctl -u xray -f 观察新日志,按 Ctrl + C 退出;排查结束再恢复 warning。日志可能包含访问目标,分享前要先检查内容。
systemctl cat xray
systemctl show xray -p User -p Group
namei -l /usr/local/etc/xray/config.json
/usr/local/bin/xray run -test -config /usr/local/etc/xray/config.json
journalctl -u xray -n 100 --no-pager
ss -lntp 'sport = :443'
ufw status verbose如果日志提示无法绑定 443,我先检查端口占用和 systemd 的 CAP_NET_BIND_SERVICE;提示 permission denied 时,再查目录遍历权限和配置的组读取权。直接改成 chmod 777 或 root 运行虽然看似省事,却让我无法知道真正缺的是哪一项权限。
连接可用之后,给维护留一份备忘
连接正常后,后续还可能涉及升级、撤销某台设备或停用服务。下面整理了相应的处理方法,作为维护参考;其中的回滚和卸载不属于本次连通测试。
12.1 每次改动前备份
BACKUP_DIR="/root/xray-backup/$(date +%Y%m%d-%H%M%S)"
install -d -m 700 "$BACKUP_DIR"
cp -a /usr/local/etc/xray/config.json "$BACKUP_DIR/config.json"
cp -a /usr/local/bin/xray "$BACKUP_DIR/xray"
systemctl cat xray > "$BACKUP_DIR/xray-unit.txt"
systemctl show xray -p User -p Group > "$BACKUP_DIR/service-account.txt"
cp -a /etc/systemd/system/xray.service "$BACKUP_DIR/xray.service"
if [ -d /etc/systemd/system/xray.service.d ]; then
cp -a /etc/systemd/system/xray.service.d "$BACKUP_DIR/"
fi
chmod -R go-rwx "$BACKUP_DIR"
printf 'Backup: %s\n' "$BACKUP_DIR"备份里包含私钥,我只把它留在 root 可读的位置。准备升级时,先记录版本和服务账户,再读对应的发行说明。下面的更新方式会保留已有服务定义;如果某次升级要求迁移服务,就需要另行核对。
12.2 更新与验证
curl -fL --retry 3 \
https://raw.githubusercontent.com/XTLS/Xray-install/main/install-release.sh \
-o /root/xray-setup/install-release.sh
less /root/xray-setup/install-release.sh
bash /root/xray-setup/install-release.sh install --without-geodata --no-update-service
/usr/local/bin/xray version
/usr/local/bin/xray run -test -config /usr/local/etc/xray/config.json
systemctl restart xray
systemctl status xray --no-pager -l更新可能触发服务重启,需要安排在可以短暂中断的时间。配置检查和代理出口测试都要重新做;其中任意一项失败,就按照备份恢复,而不是只看安装器是否退出成功。
12.3 回滚到某次备份
# 先替换为第 12.1 节真实存在的备份路径。
BACKUP_DIR='/root/xray-backup/REPLACE_TIMESTAMP'
test -f "$BACKUP_DIR/xray" && test -f "$BACKUP_DIR/config.json" || exit 1
systemctl stop xray
install -m 755 "$BACKUP_DIR/xray" /usr/local/bin/xray
cp -a "$BACKUP_DIR/config.json" /usr/local/etc/xray/config.json
/usr/local/bin/xray run -test -config /usr/local/etc/xray/config.json
systemctl start xray
systemctl status xray --no-pager -l这里记录的回滚会恢复内核和配置,适用于上面的 --no-update-service 更新方式。如果以后手动改过 systemd 单元或账户,我还需要按备份恢复对应设置、执行 systemctl daemon-reload 并核对权限,不能只换回一个 JSON 文件。
12.4 设备丢失或链接泄露
如果某台设备丢失或链接泄露,我可以在 settings.clients 中删除该设备,或替换它的 UUID;校验并重启后,旧 UUID 失效,另一台设备继续使用原配置。随后同步更新对应 YAML/VLESS 文件和 client-info.json。更换 REALITY 私钥或 short ID 则会影响两台设备,这也是我不把首次配置脚本当作日常更新工具的原因。
12.5 停用与卸载
# 先停用。保留文件,便于恢复。
systemctl disable --now xray
# 确认不再需要后,用已审核的官方安装脚本卸载内核与服务。
# remove 默认保留配置和日志;不要随意添加 --purge。
bash /root/xray-setup/install-release.sh remove停用时,我需要先确认哪些规则是专门为这次部署加的。只有 TCP 443 没有其他服务使用时,才考虑删除对应的 UFW 和云控制台规则;原本就存在的规则不能顺手清掉。配置、/root/xray-private、备份及客户端文件,再按实际保留需要处理。
12.6 后续扩展
我先把这套 TCP 方案用明白,暂时不把备用方案一起堆上去。如果以后确认是 TCP 性能问题,且本地到服务器 UDP 可达,再评估 Hysteria 2(UDP 443);它有独立的配置和证书验证要求,不属于这次记录。只有一台服务器时,也不能指望单个节点提供故障切换。
这次的收获,以及继续查资料的入口
这次排查让我更清楚地区分了“客户端能启动”“TCP 可达”“REALITY 认证成功”和“请求按预期转发”分开看。下一步我还想继续理解 DNS 和 TUN 对不同应用的影响。下面保留查资料的入口:原技术核对日期为 2026-10-19,文字更新于 2026-11-16;安装器、内核和界面可能变化,复现时仍要看实际版本与日志。
我保留下来的验证结果:2026-10-19,服务端 Xray 26.3.27、本机 Mihomo v1.19.21,改用 dl.google.com 后,经公网 443 的 REALITY 认证成功;api.ipify.org 返回 47.77.230.47,Google 检测接口返回 HTTP 204。这些结果对应当时的环境,不代表目标站会一直适用。页面没有嵌入真实凭据,可以离线阅读;实际运行客户端时,仍会按配置访问 DNS 和规则更新服务。