# Proxy Stack — VLESS (WS+TLS / gRPC+TLS) with Caddy (Cloudflare/Alidns + caddy-l4)

该项目提供两种部署模式，并同时支持两种传输（WebSocket 与 gRPC）：

- **A. 标准模式（无 L4）**：`server/docker-compose.yml` 直接让 Caddy 占用 80/443；VLESS-WS 走 `/ray`，VLESS-gRPC 走 `/grpc`。适合“网站 + 代理共存”。
- **B. L4 前置模式**：`server/docker-compose-l4.yml` 用 caddy-l4 独占 80/443，根据 SNI 把 `DERPER`/其他 TLS 流量四层转发，`caddy-http` 监听 8443；适用于在 443 上承载多种非 HTTP TLS upstream（如 Tailscale derper）。

> 两种模式均保持 **复用 443 端口**；未来增加站点/服务仅需改 Caddyfile 或 l4.json。

---

## 目录
```
v2ray_proxy/
├─ README.md
├─ server/
│  ├─ Dockerfile.caddy-l4               # 自定义 Caddy（含 cloudflare/alidns/caddy-l4）
│  ├─ docker-compose.yml                # 模式 A（Caddy 直接 80/443）
│  ├─ docker-compose-l4.yml             # 模式 B（caddy-l4 占 80/443，caddy-http 8443）
│  ├─ caddy/
│  │  ├─ Caddyfile                      # 站点 + 反代：/ray → WS，/grpc → gRPC(h2c)
│  │  ├─ l4.json                        # 仅模式 B：L4 路由（SNI → upstream）
│  │  ├─ env/
│  │  │  ├─ caddy.env.example          # ACME 与 DNS Provider 示例
│  │  │  └─ caddy.env                  # 你的实际变量（ACME_EMAIL、CF_API_TOKEN 等）
│  │  └─ site/index.html                # 占位站点
│  └─ v2ray/config.json                 # 入站：10000(WS /ray)、10001(gRPC serviceName=grpc)
└─ client/
   ├─ docker-compose.yml
   ├─ v2ray-client.json                 # 默认：VLESS-WS /ray
   ├─ v2ray-client-grpc.json            # 备选：VLESS-gRPC /grpc
   └─ test-speed.ps1                    # 代理测速脚本（HTTP/SOCKS5）
```

---

## 1) 准备域名与证书环境变量

- DNS A 记录：将 `<YOUR_DOMAIN>` 指向 VPS 公网 IP（如需子域 `proxy.<YOUR_DOMAIN>`，请自行替换）。
- 将 `server/caddy/env/caddy.env.example` 复制为 `caddy.env` 并填入：
  - `ACME_EMAIL`：Let's Encrypt/ZeroSSL 证书邮箱
  - `CF_API_TOKEN`（可选）：Cloudflare DNS API Token
  - `ALIYUN_ACCESS_KEY_ID` / `ALIYUN_ACCESS_KEY_SECRET`（可选）：阿里云 DNS AK/SK
  - `DOMAIN`：你的域名（与上面解析一致）
  - `DERPER_HOST`（可选，L4 模式匹配用）

> 可同时放 Cloudflare 与阿里云变量，`Caddyfile` 内按需选择 DNS Provider。Cloudflare Token 至少授予 Zone:Read 与 Zone:DNS:Edit。

---

## 2) 模式 A（推荐，简单）：Caddy 直接占用 80/443

```bash
cd server
docker compose up -d --build
```

- 构建自定义 Caddy，并按 `caddy/Caddyfile` 配置站点与反代：
  - VLESS-WS：`/ray` → `v2ray:10000`
  - VLESS-gRPC：`/grpc` → `v2ray:10001`（h2c）
- 健康检查：访问 `https://<YOUR_DOMAIN>/_health` 返回 200。

---

## 3) 模式 B（进阶）：caddy-l4 前置 + caddy-http 监听 8443

```bash
cd server
docker compose -f docker-compose-l4.yml up -d --build
```

- `caddy-l4` 独占 80/443，按 `caddy/l4.json` 的 **SNI** 规则把 `DERPER_HOST` 直达，其他 TLS 走 `caddy-http:8443`。
- `caddy-http` 自动签证书，承担网站与 `/ray`、`/grpc`。

---

## 4) 客户端（选择 WS 或 gRPC 配置）

默认配置为 VLESS-WS：
```bash
cd client
docker compose up -d
# 本机代理：SOCKS5 127.0.0.1:1080；HTTP 127.0.0.1:8080
```

切换为 VLESS-gRPC 测试（将 gRPC 配置覆盖运行文件，或自行调整 compose）：
```bash
cd client
copy /Y v2ray-client-grpc.json v2ray-client.json   # Windows PowerShell 示例
docker compose restart
```

两端需保持一致：
- 服务器：`/ray` 对应 WS，`/grpc` 对应 gRPC（serviceName=grpc）
- 客户端：`v2ray-client.json` 使用 WS；`v2ray-client-grpc.json` 使用 gRPC

**Docker 构建走代理（可选）：**
```bash
DOCKER_BUILDKIT=1 docker build   --build-arg HTTP_PROXY=http://127.0.0.1:8080   --build-arg HTTPS_PROXY=http://127.0.0.1:8080   -t img:latest .
```

---

## 5) 测速与验证

- PowerShell 脚本：
```powershell
cd client
./test-speed.ps1 -Mode http -SizeMB 100    # 走 HTTP 代理测速
./test-speed.ps1 -Mode socks -SizeMB 100   # 走 SOCKS5 代理测速
```

- 容器内 speedtest-cli（通过代理）：
```bash
docker exec -it v2ray-client sh -c 'apk add --no-cache speedtest-cli >/dev/null 2>&1 || true; \
  export HTTPS_PROXY=http://127.0.0.1:8080; speedtest-cli --secure'
```

## 6) 常见问题
- 证书失败：检查 80/443 是否放行；DNS 是否生效；`caddy.env` 中 DNS Token 是否正确。
- ACME 限速：避免频繁重启触发过多签发；调试请用 Staging，正式证书就绪后保持稳定。
- 端口复用：在 `Caddyfile` 新增 `handle`/`route` 或在 `l4.json` 新增 SNI 分流；无需额外占端口。
- `/ray` 404：确保 `Caddyfile` 中 `/ray` 使用独立 `handle @vless_ws`，在静态站点 `handle` 之前匹配。
- Windows 本机连不上 1080/8080：重启 Docker/WSL；显式绑定 `127.0.0.1:端口:容器端口` 或改用高位端口。
- 性能：不同时间/节点有差异；gRPC 常较 WS 更稳（HTTP/2 多路复用、指纹更像常规流量），不保证一定更快。

> 法律合规自行确认；仅用于合法用途。

---

## 7) 运维与建议
- 去掉 compose `version` 字段以消除告警；为镜像固定版本标签（避免 `latest`）。
- 增加 `healthcheck`、资源限制；开启访问日志后可按路径过滤或降级日志级别。
- 将 UUID/域名/路径抽为环境变量，便于轮换；必要时前置 CDN 或使用 Reality/XTLS-Vision（更强抗探测，改动更大）。

## 8) 同步到服务器（示例）
```bash
rsync -avz --delete --progress -e "ssh -p 22" "C:/Users/pylyz/Documents/v2ray_proxy/" youruser@<YOUR_DOMAIN>:~/v2ray_proxy/
```