diff --git a/README.md b/README.md
index be9302a..2e7fe9e 100644
--- a/README.md
+++ b/README.md
@@ -84,6 +84,16 @@ API 客户端拿到 JSON。可用 `?format=html` 或 `?format=json` 强制指定
 Apache（`/etc/apache2/sites-available/f.zikai.wang-le-ssl.conf`）把 `f.zikai.wang` 反代到
 `127.0.0.1:6867`（`ProxyPreserveHost On`），因此服务只绑 loopback。
 
+> **WebSocket 反代**：记事本的实时同步走 `WS /ws/wb/{id}`，经 Apache 反代时必须用
+> `proxy_wstunnel` 模块单独透传 `/ws/` 路径，否则升级请求被当普通 GET 返回 404、前端反复
+> 「连接已关闭，重连中」。vhost 须在通用 `/` 规则**之前**加：
+> ```apache
+> ProxyPass        /ws/ ws://127.0.0.1:6867/ws/
+> ProxyPassReverse /ws/ ws://127.0.0.1:6867/ws/
+> ```
+> （外层 HTTPS 由 Apache 终结，Apache 到 uvicorn 之间是明文 `ws://`。）
+> 需启用 `proxy_wstunnel` 模块：`a2enmod proxy_wstunnel && systemctl reload apache2`。
+
 > **大文件/慢速 HTTP 上传：** Apache 代理段继承全局 `Timeout 300`。多 GB 慢链路传输建议走
 > **分片上传**（`/upload` 页面或 `/api/files/chunk-uploads`，单片 4 MiB 在超时内可传完）或
 > **SFTP**（完全绕过 HTTP 代理）。要提高 HTTP 上限可在 Apache vhost 加 `ProxyTimeout`/`Timeout`。