zikai/zTools2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 补 Apache WebSocket 反代配置说明（/ws/ 须 proxy_wstunnel 透传）

Browse Source
This commit is contained in:
zikai
2026-07-21 15:12:15 +00:00
parent da7d2fb4b4
commit 1030801712
1 changed files with 10 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
README.md
View File

@@ -84,6 +84,16 @@ API 客户端拿到 JSON。可用 `?format=html` 或 `?format=json` 强制指定
Apache（`/etc/apache2/sites-available/f.zikai.wang-le-ssl.conf`）把 `f.zikai.wang` 反代到 Apache（`/etc/apache2/sites-available/f.zikai.wang-le-ssl.conf`）把 `f.zikai.wang` 反代到
`127.0.0.1:6867`（`ProxyPreserveHost On`），因此服务只绑 loopback。 `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 慢链路传输建议走 > **大文件/慢速 HTTP 上传：** Apache 代理段继承全局 `Timeout 300`。多 GB 慢链路传输建议走
> **分片上传**（`/upload` 页面或 `/api/files/chunk-uploads`，单片 4 MiB 在超时内可传完）或 > **分片上传**（`/upload` 页面或 `/api/files/chunk-uploads`，单片 4 MiB 在超时内可传完）或
> **SFTP**（完全绕过 HTTP 代理）。要提高 HTTP 上限可在 Apache vhost 加 `ProxyTimeout`/`Timeout`。 > **SFTP**（完全绕过 HTTP 代理）。要提高 HTTP 上限可在 Apache vhost 加 `ProxyTimeout`/`Timeout`。