From 1245aedfd2ab59251e503a7f8a1726390d4355a0 Mon Sep 17 00:00:00 2001
From: JustMe <mr.toing@outlook.com>
Date: Fri, 16 Oct 2026 19:42:33 +0800
Subject: [PATCH] docs: record how to measure upload speed without the Vite
 proxy [CI]

---
 docs/deployment.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/docs/deployment.md b/docs/deployment.md
index 0c0b6c6..ea7151d 100644
--- a/docs/deployment.md
+++ b/docs/deployment.md
@@ -28,6 +28,20 @@ systemctl --user start webdrop.service
 
 本机开发前端仍可运行 `cd web && npm run dev`,Vite 会代理 `/api/v1` 到本地 API。公网部署时,在 API 前配置 HTTPS 反向代理;不要把未加密 HTTP 直接暴露到公网。只有当 API 端口仅能由可信代理访问时,才信任 forwarded headers。
 
+### 开发时测上传速度
+
+经 Vite 开发代理(`npm run dev` 默认)转发上传,速度上限约 20–25 MB/s,这是 Node 代理的限制,和应用本身无关。要测到真实速度,让前端直连后端:
+
+```sh
+# 后端:允许前端所在的来源跨域(端口按实际的前端端口填)
+WebDrop__CorsOrigins__0=http://127.0.0.1:5173 ASPNETCORE_URLS=http://127.0.0.1:5000 dotnet run --project server/src/WebDrop.Api --no-launch-profile
+
+# 前端:把 API 指向后端,不走代理
+cd web && VITE_WEBDROP_API_URL=http://127.0.0.1:5000/api/v1 npm run dev
+```
+
+本机实测直连约 90 MB/s(300 MB 随机文件 3.3 秒)。上传帧的限流和普通接口分开计数(`WebDrop:FrameRequestsPerMinute`,默认 6000/分钟),上传请求体用 Blob 发送(浏览器对字节数组请求体要多拷贝几次,会慢 5 倍以上)。
+
 ## 其他 Linux 主机
 
 构建 OCI 镜像: