140 lines
5.8 KiB
Markdown
140 lines
5.8 KiB
Markdown
# 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/
|
||
```
|