diff --git a/README_CN.md b/README_CN.md index c8a30a4..c4f7f97 100644 --- a/README_CN.md +++ b/README_CN.md @@ -186,7 +186,7 @@ PMail 原版的协议登录流程与 Smail 不兼容,不能直接作为 Smail 2、后端: golang + MySQL/SQLite -后端代码位于 `backend/`;推荐使用 `deploy/build.ps1` 构建后,通过 `deploy/start-dev.ps1` 启动开发服务。 +后端代码位于 `backend/`;推荐使用 `deploy/build.ps1` 构建后,通过 `deploy/start-dev.ps1` 启动开发服务。当前开发端口固定分工为:前端使用 HTTP `80` 和 HTTPS `443`,后端 API 使用 `5201`;前端通过代理访问后端,浏览器统一打开 HTTPS 前端地址。 3、编译项目 diff --git a/backend/listen/cron_server/ssl_update.go b/backend/listen/cron_server/ssl_update.go index 72d6800..ef92725 100644 --- a/backend/listen/cron_server/ssl_update.go +++ b/backend/listen/cron_server/ssl_update.go @@ -78,10 +78,7 @@ func sslUpdateLoop() { // 新增:HTTP 就绪探测(最多等待 ~90 秒) func waitHTTPReady() bool { - port := 80 - if cfg := config.CurrentConfig(); cfg != nil && cfg.HttpPort > 0 { - port = cfg.HttpPort - } + port := config.CurrentHTTPConfig().Port if port < 1 || port > 65535 { log.Warnf("invalid HTTP port %d, skipping SSL update this round", port) return false diff --git a/docs/后端接口说明文档.md b/docs/后端接口说明文档.md index a05ad78..9576ec5 100644 --- a/docs/后端接口说明文档.md +++ b/docs/后端接口说明文档.md @@ -32,13 +32,13 @@ https://mail.example.com ``` -请替换为实际的 Smail Web 地址。开发环境也可以使用: +请替换为实际的 Smail Web 地址。开发环境通过前端 HTTPS 入口访问: ```text -http://127.0.0.1:80 +https://xuans.com ``` -生产环境应优先使用 HTTPS。 +开发后端 API 独立监听 `http://127.0.0.1:5201`,由前端开发服务代理 `/api` 和 `/attachments` 请求。浏览器不应绕过前端入口直接访问后端端口。生产环境应始终使用正式 HTTPS 入口。 ### 2.2 通用响应格式 @@ -767,4 +767,4 @@ Content-Disposition: attachment; filename="attachment"; filename*=UTF-8''report. - 邮件发送:`backend/controllers/email/send.go` - 统一 JSON 响应:`backend/dto/response/response.go` -原版对照来源为 PMail Wiki 的《后端接口文档》。原版文档仅作为历史兼容性参考,接口是否可调用以当前 Smail 路由和处理器实现为准。 \ No newline at end of file +原版对照来源为 PMail Wiki 的《后端接口文档》。原版文档仅作为历史兼容性参考,接口是否可调用以当前 Smail 路由和处理器实现为准。 diff --git a/frontend/README.md b/frontend/README.md index c28e866..d30e714 100644 --- a/frontend/README.md +++ b/frontend/README.md @@ -12,13 +12,13 @@ yarn yarn dev ``` -开发代理默认连接本机 HTTPS 后端 `https://127.0.0.1:443`。如果后端使用其他地址,请在 `frontend/.env.development` 中设置: +开发环境由前端占用 HTTP `80` 和 HTTPS `443`,后端 API 独立监听 `5201`。前端开发代理默认连接本机后端 `http://127.0.0.1:5201`。如果后端使用其他地址,请在 `frontend/.env.development` 中设置: ```env -VITE_DEV_BACKEND_URL=https://127.0.0.1:443 +VITE_DEV_BACKEND_URL=http://127.0.0.1:5201 ``` -自签名证书仅用于本地开发,代理不会校验证书链;生产环境应使用有效证书。 +前端开发服务使用 `config/ssl` 下的证书提供 HTTPS,HTTP `80` 只负责跳转到 HTTPS。生产环境应使用有效证书,并由正式 Web 服务器承载前端入口。 ### 生产构建